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

Merge branch 'maint'

Remove use of _ and __ in front of PETSc include guards. Reason: C99 Reserved Identifiers

Commit-type: portability-fix

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

Merged petsc/petsc into master

Merge branch 'master' into knepley/fix-plex-partition-parallel

* master: (414 commits)
very small updates to users manual
syntax is define(XXX) in examples tests not defined(XXX)
Increase patc

Merge branch 'master' into knepley/fix-plex-partition-parallel

* master: (414 commits)
very small updates to users manual
syntax is define(XXX) in examples tests not defined(XXX)
Increase patchlevel to 3.10.3
petsc4py: updat to latest maint snapshot with SNESTEST updates
Fix link for CUDA example in PETSc from GPUs.html page Minor fixes to installation instructions
Mat: Fixed types in Pardiso interface
Converted example comment to latex
This example crashes (for unknown reasons, probably related to the handling of extended derived types passed as arguments) with the PGI Fortran compiler
Remove outdated requires: from top of several examples
remove outdated test requires: command from top of source file
Fix the documentation for -ksp_gmres_cgs_refinement_type
Commit f20c2d659b168217cb455989f28afe052d71a64c broke lex.py so the users manual was no longer being built. There reverted the changes to lex.py
Plex: Add PetscPartitioner to fort list Suggested-by: Jiaoyan Li <Jiaoyan.Li@inl.gov>
Doc: Fix spelling Suggested-by: Manuel Colera Rico <m.colera@upm.es>
Mat ex88: check in double or quad precision only
Fix error with PetscComplex when PETSc is compiled with C and used in C++
configure: fix typo endwith -> endswith
Sys ex23: Migrated to ts_max_time in yaml file as well.
AO ex5: Fixed missing CHKERRQ();
Mat test ex88: add tests for MatMultAdd and MatMultTranposeAdd
...

Conflicts:
src/dm/impls/plex/examples/tests/ex12.c

show more ...

Merge branch 'master' into knepley/feature-snes-patch

Not sure if this has done the right thing because there are no tests
yet. Also, the fortran stubs break (it doesn't know what to do with
SNESCo

Merge branch 'master' into knepley/feature-snes-patch

Not sure if this has done the right thing because there are no tests
yet. Also, the fortran stubs break (it doesn't know what to do with
SNESCompositeType), and I don't know how to fix it.

show more ...

Merged petsc/petsc into master

Merged petsc/petsc into master

Merge branch 'stefano_zampini/fix-p4est-squashed' [PR #1229]

* stefano_zampini/fix-p4est-squashed:
Few fixes to the p4est/p8est implementations of DMForest.

DMForest: add transfer from base

Merge branch 'master' into knepley/feature-plex-sphere-mesh

* master: (2633 commits)
Bib: Added ref
SNES ex56: Update test output
add a citation to petsc.bib
Plex: Initialize variables
ini

Merge branch 'master' into knepley/feature-plex-sphere-mesh

* master: (2633 commits)
Bib: Added ref
SNES ex56: Update test output
add a citation to petsc.bib
Plex: Initialize variables
initialize ap as complained by the nightly tests
Plex ex3: Update to new point function API
initialize some variables as complained by nightly tests
SNES ex12: Mix misnaming Nf --> Nc
update tests
add tests
add MatView_SeqXAIJ_ASCII_structonly(); enable A->structure_only in MatSetValuesBlocked_SeqBAIJ
typo
fill-in some references
Bib: Fixed ref
Plex: Added PLY to file support
Plex: Adding PLY support
PetscDS: Turn off Fortran bindings for Constants
Plex tests: Updated to new point function API
SNES ex56: Moved tests to new format
DM: Allow field projection functions to take an array of scalars - This will allow us to pass in user data to kernels without void *, more efficiency than aux fields
...

Conflicts:
config/builder.py
include/petscdmplex.h
src/dm/impls/plex/examples/tests/ex1.c
src/dm/impls/plex/plexcreate.c
src/dm/impls/plex/plexgmsh.c
src/snes/examples/tutorials/ex63.c

show more ...

Merge branch 'master' into knepley/feature-plex-pragmatic-parallel

* master: (1379 commits)
Minor fixes for tchem examples due to changes in PETSc infrastructure
update webpage about API changes

Merge branch 'master' into knepley/feature-plex-pragmatic-parallel

* master: (1379 commits)
Minor fixes for tchem examples due to changes in PETSc infrastructure
update webpage about API changes
add help menu for MatCreateSubMatricesMPI()
rename struct Mat_SubMat -> Mat_SubSppt
add a little information to the manual about using tchem
rename MatCreateSubMatrixComposite -> MatCreateSubMatrixVirtual; Mat_SubMatrix -> Mat_SubVirtual
need to protect the \ passed on the makefile on my Mac
Bib: Updated ref
update src/mat/examples/tests/output/ex23_#.out
rename MatGetSubMat -> MatCreateSubMat
Mark MatCreateMPIAIJWithSplitArrays() and MatMPIAIJSetPreallocationCSR() with MAT_NO_OFF_PROC_ENTRIES
superlu: libray is installed in PREFIX/lib64 - fix this to use PREFIX/lib
backport fixes cc105cc3 2b35c90a - required for 3bf428d - that was backported from master - 80c96bb
'echo -n' fails on opensolaris/osx - so avoid using it.
fix diffs in nightlybuilds due to options in ~/.petscrc
add Kelley03 to src/docs/tex/petsc.bib
build: determine moudles, mpi.h used during buildtime and print in 'info'
fix analyzer warnings
fix build failure on opensolaris - where -lm from flibs is removed due to -lm in cxxlibs. But then - only flib gets used for some configure tests [blaslapack, parms]
config: prefer __restrict over C99 restrict keyword
...

show more ...

Merge remote-tracking branch 'origin/knepley/feature-fe-dual-apply' into tisaac/feature-fe-dual-apply

* origin/knepley/feature-fe-dual-apply: (75 commits)
Plex: Screwed up last fix
Plex: Fix ove

Merge remote-tracking branch 'origin/knepley/feature-fe-dual-apply' into tisaac/feature-fe-dual-apply

* origin/knepley/feature-fe-dual-apply: (75 commits)
Plex: Screwed up last fix
Plex: Fix overeager protection of function
PetscFE: Fixed declaration
Travis-CI: Attempt to solve issues with gfortran
Travis-CI: Use newer macOS image
clarify damping and other issues related to SNESLINESEARCHBASIC
change example in new harness to use simple partitioner so gets consistent output on all systems
remove unused function from test file
cleanup formatting in example, plus myrank not rank
all requires need to go on the same line in test definition otherwise they are skipped
missing - makes the manual page formatting wrong
The developer manual clearly states that MPI_Comm_size() returns size it doesn't return numProcs or other nonsense. Pretty soon you'll start using mype instead of rank?
fix typo and cut and paste error in docs
bugfix for !HYPRE
fix warning for ';;'
may switch to scalable only when B->cmap->N > 100000
MatLRC: store in the context the parallel matrices rather than the sequential ones
Bib: Add ref
set default algorithm based on B->cmap->N for MatMatMult_MPIAIJ_MPIAIJ()
Error in VecScatterView_MPI() had the meaning of from and to backwards
...

show more ...

Merge branch 'knepley/feature-plex-tests-new' into knepley/feature-fe-dual-apply

* knepley/feature-plex-tests-new: (73 commits)
Plex: Fix overeager protection of function
Travis-CI: Attempt to s

Merge branch 'knepley/feature-plex-tests-new' into knepley/feature-fe-dual-apply

* knepley/feature-plex-tests-new: (73 commits)
Plex: Fix overeager protection of function
Travis-CI: Attempt to solve issues with gfortran
Travis-CI: Use newer macOS image
clarify damping and other issues related to SNESLINESEARCHBASIC
change example in new harness to use simple partitioner so gets consistent output on all systems
remove unused function from test file
cleanup formatting in example, plus myrank not rank
all requires need to go on the same line in test definition otherwise they are skipped
missing - makes the manual page formatting wrong
The developer manual clearly states that MPI_Comm_size() returns size it doesn't return numProcs or other nonsense. Pretty soon you'll start using mype instead of rank?
fix typo and cut and paste error in docs
bugfix for !HYPRE
fix warning for ';;'
may switch to scalable only when B->cmap->N > 100000
MatLRC: store in the context the parallel matrices rather than the sequential ones
Bib: Add ref
set default algorithm based on B->cmap->N for MatMatMult_MPIAIJ_MPIAIJ()
Error in VecScatterView_MPI() had the meaning of from and to backwards
fix build warning as reported by the nightly tests
Update alquimia.py to use Glenn's branch that updates alquimia for pflotran xsdk
...

show more ...

Merge branch 'master' into knepley/feature-plex-tests-new

* master: (94 commits)
Plex: Fix overeager protection of function
Travis-CI: Attempt to solve issues with gfortran
Travis-CI: Use newe

Merge branch 'master' into knepley/feature-plex-tests-new

* master: (94 commits)
Plex: Fix overeager protection of function
Travis-CI: Attempt to solve issues with gfortran
Travis-CI: Use newer macOS image
clarify damping and other issues related to SNESLINESEARCHBASIC
change example in new harness to use simple partitioner so gets consistent output on all systems
remove unused function from test file
cleanup formatting in example, plus myrank not rank
missing - makes the manual page formatting wrong
The developer manual clearly states that MPI_Comm_size() returns size it doesn't return numProcs or other nonsense. Pretty soon you'll start using mype instead of rank?
fix typo and cut and paste error in docs
bugfix for !HYPRE
fix warning for ';;'
may switch to scalable only when B->cmap->N > 100000
MatLRC: store in the context the parallel matrices rather than the sequential ones
Bib: Add ref
set default algorithm based on B->cmap->N for MatMatMult_MPIAIJ_MPIAIJ()
Error in VecScatterView_MPI() had the meaning of from and to backwards
fix build warning as reported by the nightly tests
Update alquimia.py to use Glenn's branch that updates alquimia for pflotran xsdk
fix divide by zero exposed by 8534686b5096cd4c91a8f3895408b386c0628431 - and produced by petsc4py testsuite
...

Conflicts:
src/dm/impls/plex/examples/tests/ex13.c
src/dm/impls/plex/plexgmsh.c
src/snes/examples/tests/ex2.c
src/snes/examples/tests/output/ex2_3.out
src/snes/examples/tests/output/ex2_4.out
src/snes/examples/tests/output/ex2_5.out

show more ...

Merge branch 'master' into scott/test-harness-forloopfix

remove function prototypes in include file that don't exist and should not exist

fix some glitches in DMFOREST manual page documentation

Merge branch 'master' into barry/fix-successful-numerical-factorization-after-failure/master

The maint patch for the given problem cannot merge cleanly into next due to changes
in the same code in m

Merge branch 'master' into barry/fix-successful-numerical-factorization-after-failure/master

The maint patch for the given problem cannot merge cleanly into next due to changes
in the same code in master (the introduction of MatFactorGetError()) therefor need
to merge in master and use the new construct before merging to next

show more ...

Merge branch 'master' into psanan/pc-telescope-nearnullspace

Merge branch 'master' into stefano_zampini/feature-pcbddc-saddlepoint

Conflicts:
src/docs/website/documentation/changes/dev.html
src/ksp/ksp/examples/tutorials/ex59.c
src/ksp/pc/impls/bddc/bddc.c

Merge branch 'master' into stefano_zampini/feature-pcbddc-saddlepoint

Conflicts:
src/docs/website/documentation/changes/dev.html
src/ksp/ksp/examples/tutorials/ex59.c
src/ksp/pc/impls/bddc/bddc.c
src/ksp/pc/impls/bddc/bddcfetidp.c
src/ksp/pc/impls/bddc/bddcprivate.c
src/ksp/pc/impls/bddc/bddcschurs.c
src/mat/impls/is/matis.c
src/mat/impls/is/matis.h

show more ...

Merge branch 'tisaac/dm-feature-adapt-label'

Adds an optional interface for adapting a DM by a specified label. Good
support in DMP4est; DMPlex will at least refine (I need to see if
Triangle/Tetge

Merge branch 'tisaac/dm-feature-adapt-label'

Adds an optional interface for adapting a DM by a specified label. Good
support in DMP4est; DMPlex will at least refine (I need to see if
Triangle/Tetgen support point-deletion coarsening); no DMDA
implementation, but I might put in one that at least detects uniform
coarsening/refinement.

* tisaac/dm-feature-adapt-label:
Plex tests ex20: add names to output meshes
DMPlex tests ex20: fix bad dev/null'd output in makefile test
DMPlex: gotta root out that c99 before it corrupts our kids
DMPlex test ex20: added triangle and ctetgen regression tests for DMLabelAdapt()
DMRefine_Plex_Label(): move DMPlexRestoreTransitiveClosure() after loop
DMPlex: added test ex20 for DMAdaptLabel()
DMPlex: put ifdef guards around static function only used when packages present.
DMFOREST: fix initialization
DMPlex: fix __FUNC__ of recent change
DMAdaptFlag: added DM_ADAPT_DETERMINE
DMPlex: added DMAdaptLabel implementation for DMPlex
DMAdaptLabel: change second argument to actual label
DM: added DMAdaptLabel() interface

show more ...