source code format changes due to .clang-format changes

Merge branch 'barry/2022-08-23/fix-sys-man' into 'main'

Fix up all manual pages in src/sys directory

See merge request petsc/petsc!5559

Fix up all manual pages in src/sys directory

Commit-type: documentation
/spend 10h

Merge branch 'barry/2022-08-21/clang-format-source' into 'main'

format repository with clang-format

See merge request petsc/petsc!5541

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

Merge branch 'barry/2022-06-24/linenumbers-petscstack' into 'main'

Fixes/improvements for PETSc stack handling

See merge request petsc/petsc!5368

Add PETSc CI mode to allow better handling of errors and system dependent output when running in test harness

-petsc_ci - automatically set for all runs in test harness

-petsc_ci_portable_error_out

Add PETSc CI mode to allow better handling of errors and system dependent output when running in test harness

-petsc_ci - automatically set for all runs in test harness

-petsc_ci_portable_error_output - ensures all error messages (when possible are system and compiler information),
should be only used in tests that are explicitly testing the error handling

This allows proper comparisons of runs on different machines and when errors are intentionally triggered to test error handling

Commit-type: error-checking, testing-fix
/spend 5h

show more ...

Cleanup and unify naming of PetscCall routines

Commit-type: housekeeping
/spend 10m

Fix handling of PetscStack for callback functions and external package calls (and update slepc in sync)

Information was often wrong; incorrect filenames and line numbers removed

Also unified naming

Fix handling of PetscStack for callback functions and external package calls (and update slepc in sync)

Information was often wrong; incorrect filenames and line numbers removed

Also unified naming for callback function stack frames

Commit-type: error-checking, debugability
/spend 2h

show more ...

Improve and fix manual pages related to PetscStack usage

Commit-type: documentation
/spend 1h

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 'jacobf/2021-09-16/petscstack-on-the-stack' into 'main'

Move PetscStack onto the stack

See merge request petsc/petsc!4321

PetscStack is on the stack now, removing the need to 'initialize' it so it can always be
used. The entire API has also been intern'ed since it is only internally used in select
instances.

Merge branch 'jczhang/feature-tune-file-line-output' into 'main'

Sys: dump filename and linenumber in filename:linenumber

See merge request petsc/petsc!4236

Sys: dump filename and linenumber in filename:linenumber

So that in supported IDEs such as VS Code one can click the url-like filename:linenumber to go to that line

Merge branch 'stefanozampini/checkstack' into 'main'

Check Push/Pop

See merge request petsc/petsc!4077

PetscStack : check for correct push/pop

Enforce checkstack for CI jobs
Fixes from testsuite

Merge branch 'jolivet/feature-mpich-3.4.2' into 'main'

MPICH 3.4.2

See merge request petsc/petsc!4045

Minor fixes

Unneeded dependency for Htool + typo

Merge branch 'barry/2021-05-16/fix-double-lines' into 'main'

Fix typos in source

See merge request petsc/petsc!3984

Remove all double blank lines from source

Commit-type: petsc-style
/2h