clang-format: convert PETSc sources to comply with clang-format

Merge branch 'psanan/docs-sphinx-man-pages' into 'main'

Integrate Man Pages into Sphinx Docs

Closes #1132 and #1015

See merge request petsc/petsc!4989

Docs: bulk add backticks to .seealso man page fields

```python
import os
import re
import fileinput

def _process_word(word):
comma = "," if word.endswith(",") else ""
return "`%s`%s" % (wor

Docs: bulk add backticks to .seealso man page fields

```python
import os
import re
import fileinput

def _process_word(word):
comma = "," if word.endswith(",") else ""
return "`%s`%s" % (word.rstrip(","), comma)

def _process_stripped_line(line):
return " ".join(map(_process_word, line.split()))

start_pattern = re.compile(r"^( *\.seealso:? )(.*$)")

def process_file(filename_full):
with fileinput.FileInput(filename_full, inplace=True) as f:
in_block = False
for line in f:
line_stripped = line.strip()
# end ".seealso blocks" on a blank line or C-style comment close
line_modified = None
if not line_stripped:
in_block = False
elif line_stripped.endswith("*/"):
in_block = False
else:
match = re.match(start_pattern,
line) # not stripped line
if match:
indent = " " * len(match.group(1))
in_block = True
line_modified = match.group(
1) + _process_stripped_line(
match.group(2).strip())
elif in_block:
line_modified = indent + _process_stripped_line(
line_stripped)
if line_modified:
print(line_modified) # prints to the file
else:
print(line, end="") # prints to the file

BASE_DIRS = ["src", "include"]
EXT = [".c", ".cxx", ".cpp", ".cu", ".h", ".hpp", ".hxx"]
EXCLUDE_DIRS = ["tests", "tutorials", "ftn-auto", "ftn-custom", "benchmarks"]

def main():
""" Process everything """
for base in BASE_DIRS:
for root, dirs, files in os.walk(base):
for filename in files:
if os.path.splitext(filename)[1] in EXT:
filename_full = os.path.join(root, filename)
print("FILE ---", filename_full)
process_file(filename_full)
for exclude_dir in EXCLUDE_DIRS:
if exclude_dir in dirs:
dirs.remove(exclude_dir)

if __name__ == "__main__":
main()
```

show more ...

Merge branch 'jacobf/2022-02-23/variadic-chkerr' into 'main'

Variadic CHKERRQ()

See merge request petsc/petsc!4889

The great renaming:

- CHKERRQ() -> PetscCall()
- CHKERRV() -> PetscCallVoid()
- CHKERRMPI() -> PetscCallMPI()
- CHKERRABORT() -> PetscCallAbort()
- CHKERRCONTINUE() -> PetscCallContinue()
- CHKERRXX

The great renaming:

- CHKERRQ() -> PetscCall()
- CHKERRV() -> PetscCallVoid()
- CHKERRMPI() -> PetscCallMPI()
- CHKERRABORT() -> PetscCallAbort()
- CHKERRCONTINUE() -> PetscCallContinue()
- CHKERRXX() -> PetscCallThrow()
- CHKERRCXX() -> PetscCallCXX()
- CHKERRCUDA() -> PetscCallCUDA()
- CHKERRCUBLAS() -> PetscCallCUBLAS()
- CHKERRCUSPARSE() -> PetscCallCUSPARSE()
- CHKERRCUSOLVER() -> PetscCallCUSOLVER()
- CHKERRCUFFT() -> PetscCallCUFFT()
- CHKERRCURAND() -> PetscCallCURAND()
- CHKERRHIP() -> PetscCallHIP()
- CHKERRHIPBLAS() -> PetscCallHIPBLAS()
- CHKERRHIPSOLVER() -> PetscCallHIPSOLVER()
- CHKERRQ_CEED() -> PetscCallCEED()
- CHKERR_FORTRAN_VOID_FUNCTION() -> PetscCallFortranVoidFunction()
- CHKERRMKL() -> PetscCallMKL()
- CHKERRMMG() -> PetscCallMMG()
- CHKERRMMG_NONSTANDARD() -> PetscCallMMG_NONSTANDARD()
- CHKERRCGNS() -> PetscCallCGNS()
- CHKERRPTSCOTCH() -> PetscCallPTSCOTCH()
- CHKERRSTR() -> PetscCallSTR()
- CHKERRTC() -> PetscCallTC()

show more ...

chkerr and friends wrapped

Merge branch 'barry/2022-03-13/fix-some-manualpages/release' into 'main'

Improve generation of manual pages/fix a variety of manul pages basic formatting

See merge request petsc/petsc!4969

doc: fix References: section

Notation:
. * - text
or
. year - text

Merge remote-tracking branch 'origin/maint'

Merge branch 'jed/sneslinesearch-type/maint' into 'maint'

Jed/sneslinesearch type/maint

See merge request petsc/petsc!2692

SNES: only change linesearch type when not already set

This is necessary to allow users to SNESLineSearchSetType before SNESSetFromOptions.

Merge branch 'rmills/doc-misc-small-fixes' into 'master'

Rmills/doc misc small fixes

See merge request petsc/petsc!2070

Small copy edits to SNESASPIN manual page.

Merge branch 'jczhang/sf-more-opts' [PR #1567]

* jczhang/sf-more-opts:
Add more optimizations in SF and use it as the default for VecScatter.

Do not scatter to the same vector at the same time

In vecscatter, the target vector is write-locked

Merge remote-tracking branch 'origin/maint'

Merged in barry/fix-nasm-uses-ksp/maint (pull request #1557)

The SNESNASM nonlinear preconditioner doesn't ever use the KSP solver therefor should never turn on the usesksp flag. The setting of this

Merged in barry/fix-nasm-uses-ksp/maint (pull request #1557)

The SNESNASM nonlinear preconditioner doesn't ever use the KSP solver therefor should never turn on the usesksp flag. The setting of this flag made the SNESASPIN solver that uses the SNESNASM solver incorrectly have SNESNASM process the options for the KS

show more ...

The SNESNASM nonlinear preconditioner doesn't ever use the KSP solver therefor
should never turn on the usesksp flag. The setting of this flag made the SNESASPIN solver
that uses the SNESNASM solver

The SNESNASM nonlinear preconditioner doesn't ever use the KSP solver therefor
should never turn on the usesksp flag. The setting of this flag made the SNESASPIN solver
that uses the SNESNASM solver incorrectly have SNESNASM process the options for the
KSP and view it in SNESView() which could lead to users incorrectly believing the
solver was being used. Also added more text to the manual pages for these objects
to clarify how they function and interact with the Jacobian.

Commit-type: bug-fix, documentation

show more ...

Merge branch 'master' into jpusztay/feature-swarm-symplectic-example

Merge branch 'master' into jpustay/feature-swarm-example

Merged petsc/petsc into master

Merged petsc/petsc into master

Merge branch 'master' into knepley/feature-dm-nearnullspace

* master: (219 commits)
petsc4py: update with VecScatter API changes
remove duplicate code
petsc4py: update to version 3.10.0
fixe

Merge branch 'master' into knepley/feature-dm-nearnullspace

* master: (219 commits)
petsc4py: update with VecScatter API changes
remove duplicate code
petsc4py: update to version 3.10.0
fixed typos in documentation
fixed typos in documentation
Fix some remaining Register()s to call InitializePackage()
Remove memory leaks of XXXRegister() is called but XXX object is never used
Add to PCTFS manual page that it does not work for complex numbers
Stray , in manual page that should be .
Only register MPI3 VecScatter if they are built
clarification of KSPSetComputeInitialGuess()
Add missing makefiles for VecScatter implementations
Changed VecScatterCreate() to take a communicator and return scatter as other first class PETSc objects do. Changed old VecScatterCreate() to VecScatterCreateWithData()
Added VecScatterSetUp() and converted implementations to use it to compute scatter information
Pull "MPI1" and "MPI3" specific code out of common VecScatter impls code This allows future implementations to use the common code also without changing the common code
Seperate VecScatter implementation code into three subdirectories seq, mpi1, and mpi3
doc: fix author list in manual wrt 6402aee
doc: fix LOCDIR wrt broken URL from MatHYPRESetPreallocation.html
ifort: ifx compile error with --with-mpi=0
changes/310.html: merged two TAO sections
...

Conflicts:
src/dm/interface/dm.c

show more ...

Merge branch 'master' into knepley/feature-ksp-ex10-transpose

* master: (219 commits)
petsc4py: update with VecScatter API changes
remove duplicate code
petsc4py: update to version 3.10.0
fi

Merge branch 'master' into knepley/feature-ksp-ex10-transpose

* master: (219 commits)
petsc4py: update with VecScatter API changes
remove duplicate code
petsc4py: update to version 3.10.0
fixed typos in documentation
fixed typos in documentation
Fix some remaining Register()s to call InitializePackage()
Remove memory leaks of XXXRegister() is called but XXX object is never used
Add to PCTFS manual page that it does not work for complex numbers
Stray , in manual page that should be .
Only register MPI3 VecScatter if they are built
clarification of KSPSetComputeInitialGuess()
Add missing makefiles for VecScatter implementations
Changed VecScatterCreate() to take a communicator and return scatter as other first class PETSc objects do. Changed old VecScatterCreate() to VecScatterCreateWithData()
Added VecScatterSetUp() and converted implementations to use it to compute scatter information
Pull "MPI1" and "MPI3" specific code out of common VecScatter impls code This allows future implementations to use the common code also without changing the common code
Seperate VecScatter implementation code into three subdirectories seq, mpi1, and mpi3
doc: fix author list in manual wrt 6402aee
doc: fix LOCDIR wrt broken URL from MatHYPRESetPreallocation.html
ifort: ifx compile error with --with-mpi=0
changes/310.html: merged two TAO sections
...

Conflicts:
src/ksp/ksp/interface/itfunc.c

show more ...

Merged petsc/petsc into master