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-19/rm-ts-petsccheckfalse' into 'main'

Remove many PetscCheckFalse() from ts

See merge request petsc/petsc!4996

Remove many PetscCheckFalse() from ts

Commit-type: style-fix
/spend 1h
Thanks-to: Jose E. Roman <jroman@dsic.upv.es>

Merge branch 'jolivet/fix-warnings' into 'main'

Fix compilation warnings

See merge request petsc/petsc!4972

Fix compilation warnings

-Wmissing-field-initializers -Wunused-but-set-variable

Merge branch 'jacobf/2022-01-05/c99' into 'main'

Feature: C99 and C++11

See merge request petsc/petsc!4700

rename PetscAssert() -> PetscCheck() and PetscAssertDebug() -> PetscAssert()

add PetscAssert() and PetscAssertFalse()

SETERRQ[1-9]+ begone

Merge branch 'knepley/feature-plex-explicit-timestepping' into 'main'

DM+TS: Add support for mass matrices

See merge request petsc/petsc!4683

Fix name of DMPlexTSComputeRHSFunctionFEM()

Plex+DS: Added support for explicit timestepping

Merge branch 'knepley/feature-dm-aux-data-keys' into 'main'

Plex: Updates to declarative interface for FEM problems

See merge request petsc/petsc!3972

DT: Changed key and WeakForm internals
- Changed name to PetscFormKey
- Added part member
- Now maps are referred to by PetscWeakFormKind
- Added PetscWeakFormClearIndex() and PetscWeakFormClear()

DT: Changed key and WeakForm internals
- Changed name to PetscFormKey
- Added part member
- Now maps are referred to by PetscWeakFormKind
- Added PetscWeakFormClearIndex() and PetscWeakFormClear()
- Passing NULL to SetIndex is now ignored
- Added tests

show more ...

Merge branch 'jacobf/2021-03-26/clang-static-linter' into 'main'

Feature: libClang PETSc Macro Static Analyzer

See merge request petsc/petsc!3773

Linter using libClang that checks PetscValidHeaderSpecifcType, PetscValidHeaderSpecific, PetscValidHeader, PetscValid[XXX]Pointer, PetscValidType, PetscCheckSameComm, PetscValidLogicalCollectiveXXX f

Linter using libClang that checks PetscValidHeaderSpecifcType, PetscValidHeaderSpecific, PetscValidHeader, PetscValid[XXX]Pointer, PetscValidType, PetscCheckSameComm, PetscValidLogicalCollectiveXXX for validity. Automatically generates diff files for problems with a known solution.

show more ...

Merge branch 'knepley/feature-dm-aux-data' into 'main'

DM: Replace object composition with an API for auxiliary data

See merge request petsc/petsc!3798

DM: Replace object composition with an API for auxiliary data - Now allow data to be tagged with a label+value - Do not separately require a DM and Vec, get the DM from the Vec

Merge branch 'knepley/feature-plex-ds-traversals' into 'main'

DS: Moved management of pointwise functions into PetscWeakForm object - Added...

See merge request petsc/petsc!3726

Plex+DS: Moved management of pointwise functions into PetscWeakForm object
- Added PetscChunkBuffer to manage contiguous buffer space
- WeakForm can index functions by Label/val, field
- WeakForm

Plex+DS: Moved management of pointwise functions into PetscWeakForm object
- Added PetscChunkBuffer to manage contiguous buffer space
- WeakForm can index functions by Label/val, field
- WeakForm allows multiple kernels per key

show more ...

Merge branch 'nathawani/feature-snes-lowmach-example' into 'master'

Nathawani/feature snes lowmach example

See merge request petsc/petsc!3319

DM: Fix nullspace handling
- Now, nullspace constructors construct a nullspace for the entire DM,
but based on the singularity of an operator connected with the given
field
- remove special handling

DM: Fix nullspace handling
- Now, nullspace constructors construct a nullspace for the entire DM,
but based on the singularity of an operator connected with the given
field
- remove special handling in SNESSetUpMatrices()
- Now all nullspaces are created in DMCreateMatrix()
- Fixed bug in DMSNESCheckJacobian()

show more ...