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 'barry/2022-04-24/rm-petsccheckfalse-dm' into 'main'

Remove PetscCheckFalse from use in the src/dm directory

Closes #1141

See merge request petsc/petsc!5160

Merge remote-tracking branch 'origin/release'

Merge branch 'balay/u2204-fixes' into 'release'

Some fixes for ubuntu-22.04

See merge request petsc/petsc!5159

fix valgrind warning

not ok dm_impls_plex_tutorials-ex13_gyroid_1 # Error code: 10
==1339793== Conditional jump or move depends on uninitialised value(s)
==1339793== at 0x544AEE9: P

fix valgrind warning

not ok dm_impls_plex_tutorials-ex13_gyroid_1 # Error code: 10
==1339793== Conditional jump or move depends on uninitialised value(s)
==1339793== at 0x544AEE9: PetscKernel_A_gets_inverse_A_3 (dgefa3.c:86)
==1339793== by 0x5993329: TPSNearestPoint (plexcreate.c:2329)
==1339793== by 0x5998FCB: DMPlexCreateTPSMesh_Internal (plexcreate.c:2780)
==1339793== by 0x599A283: DMPlexCreateTPSMesh (plexcreate.c:2871)
==1339793== by 0x109B2A: main (ex13.c:24)
==1339793== Uninitialised value was created by a stack allocation
==1339793== at 0x5992981: TPSNearestPointResJac (plexcreate.c:2265)

show more ...

Remove PetscCheckFalse from use in the src/dm directory

Commit-type: housekeeping
/45m

Merge branch 'jacobf/2022-04-05/petscattrformat-all-the-rest' into 'main'

Enable PETSC_ATTRIBUTE_FORMAT()

See merge request petsc/petsc!5085

Enable PETSC_ATTRIBUTE_FORMAT()

Merge branch 'barry/2022-04-01/fix-petsc-options-begin-end/release' into 'main'

Remove bogus error returns from Begin/End() macros

See merge request petsc/petsc!5069

Cleanup of introduction of PetscCall()

* remove bogus error flags from XXXBegin()/End() macros such as PetscOptionsBegin()/End()

* rename for consistency certain XXXBegin()/End() macros such as Mat

Cleanup of introduction of PetscCall()

* remove bogus error flags from XXXBegin()/End() macros such as PetscOptionsBegin()/End()

* rename for consistency certain XXXBegin()/End() macros such as MatPreallocateInitialize()/Finalize()

* fix many lingering ierr = XXX that arose from multiline function calls

* sync slepc/hpddm - to use snapshots with the same changes

Commit-type: error-checking, style-fix
/spend 8h

show more ...

Merge branch 'jolivet/feature-less-checkfalse' into 'main'

Dividing by four the number of PetscCheckFalse()

See merge request petsc/petsc!5072

Remove some PetscCheckFalse()

Merge branch 'stefanozampini/fix-glvis-hosimplex' into 'main'

Fix high-order meshes viz

See merge request petsc/petsc!5037

DMPLEX: add doublet to the list of shapes

DMPlexCreateCoordinateSpace: do not attach FE since projection will think that coordinates are up-to-date

Merge branch 'haplav/section-improve-maxdof' into 'main'

PetscSection: Lazy maxDof calculation.

See merge request petsc/petsc!5025

DM_Plex: Remove maxConeSize and maxSupportSize.

They are only proxies for max dof of respective sections.

Merge branch 'jed/plex-tps-extrude-normal' into 'main'

DMPlex TPS: analytic normals for extrusion

See merge request petsc/petsc!5034

DMPlex TPS: use analytic normals

Modify DMPlexTransformExtrudeSetNormalFunction to handle orientation
itself. This is a simpler and more user-friendly interface than having
the user compare modify t

DMPlex TPS: use analytic normals

Modify DMPlexTransformExtrudeSetNormalFunction to handle orientation
itself. This is a simpler and more user-friendly interface than having
the user compare modify the provided normal in an orientation-preserving
way.

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 ...

pluck ~1000 low hanging PetscCheckFalse() -> PetscCheck() fruit

chkerr and friends wrapped

Merge branch 'knepley/feature-plex-homogenization-example' into 'main'

Plex: Added initial example for numerical homogenization

See merge request petsc/petsc!5004

Plex: Added 1D drawing
- Add 1D reodering