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 'jczhang/feature-better-error-trace' into 'main'

Print error trace in format of filename:line

See merge request petsc/petsc!3733

SYS: print errors with filename:line

So that it is easier to open with other tools such as vim, vscode

Merge branch 'barry/2020-09-26/error-mans' into 'master'

Improve manual pages for PetscError() and the various error handlers including...

See merge request petsc/petsc!3249

Improve manual pages for PetscError() and the various error handlers including providing cross links in the manual pages

Commit-type: documentation
/spend 45m

Merge branch 'jczhang/feature-nice-mpi-abort' into 'master'

Provide a nicer MPI_Abort

See merge request petsc/petsc!2137

Replace MPI_Abort with PETSCABORT

Merge branch 'master' into 'barry/2019-08-22/fix-fblaslapack-for-nag'

# Conflicts:
# lib/petsc/conf/test

Merge branch 'barry/2019-09-04/feature-nan-malloc' into 'master'

Add code to initialize PetscMalloc() memory with Nan. Simplify and clarify the...

See merge request petsc/petsc!2017

Fixed spelling mistakes, removed out-dated references to PetscMalloc() options and functions, added PetscMalloc() changes to dev.html

Commit-type: style-fix, documentation
Reported-by: Jed Brown <je

Fixed spelling mistakes, removed out-dated references to PetscMalloc() options and functions, added PetscMalloc() changes to dev.html

Commit-type: style-fix, documentation
Reported-by: Jed Brown <jed@jedbrown.org>

show more ...

Add code to initialize PetscMalloc() memory with Nan. Simplify and clarify the options for controlling PetscMalloc() debugging.

This now trivially detects an error that lay undetected in ts/examples

Add code to initialize PetscMalloc() memory with Nan. Simplify and clarify the options for controlling PetscMalloc() debugging.

This now trivially detects an error that lay undetected in ts/examples/tutorials/multistage/ex5.c for months

Commit-type: style-fix, feature, documentation

show more ...

Merge remote-tracking branch 'origin/psanan/docs-remove-manconcepts' [PR #1733]

Man pages: remove Concepts: fields

These fields were previously stripped from the man pages by logic removed in
21a59cba2737d49dc2f0bd12c08db0d2a3f3f209

Remove these fields from all man pages (but

Man pages: remove Concepts: fields

These fields were previously stripped from the man pages by logic removed in
21a59cba2737d49dc2f0bd12c08db0d2a3f3f209

Remove these fields from all man pages (but not from examples).

This is accomplished with GNU sed (gsed on OS X), with the following commands.
*Warning* that this type of command can corrupt a .git directory,
so be cautious in reusing or modifying these commands. They first look
for and delete matching lines with a following line consisting of only whitespace,
and then delete any remaining matching lines.

find src -type f -not -path "*/examples/*" -not -name "*.html" -not -name "*.bib" -exec gsed -i '/Concepts:/ {N; /\n\s*$/d}' {} +
find src -type f -not -path "*/examples/*" -not -name "*.html" -not -name "*.bib" -exec gsed -i '/Concepts:/d' {} +
find include -type f -not -path "*/examples/*" -not -name "*.html" -not -name "*.bib" -exec gsed -i '/Concepts:/ {N; /\n\s*$/d}' {} +
find include -type f -not -path "*/examples/*" -not -name "*.html" -not -name "*.bib" -exec gsed -i '/Concepts:/d' {} +

Hints on the sed command obtained from: https://unix.stackexchange.com/questions/100754/how-to-delete-a-specific-line-and-the-following-blank-line-using-gnu-sed

show more ...

Merge commit 'd47bf9aaf1e5266cc3f0ff499f934c85788965a9' into jed/fix-matcreatempibaij/maint

Obtain changed (v3.5) handling of MatMPIBAIJSetPreallocationCSR to match
documentation.

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 branch 'barry/remove-funct'

Remove the use and definition of __FUNCT__ throughout the code

Since all modern C/C++ compilers provide this functionality we no longer need to provide it manually in PETSc
Time: 1.5 hours
Thanks-t

Remove the use and definition of __FUNCT__ throughout the code

Since all modern C/C++ compilers provide this functionality we no longer need to provide it manually in PETSc
Time: 1.5 hours
Thanks-to: Andreas Mang <andreas@ices.utexas.edu>

show more ...

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

Conflicts:
src/ksp/pc/impls/bddc/bddc.c
src/ksp/pc/impls/bddc/bddcgraph.c
src/ksp/pc/impls/bddc/bddcprivate.c
src/ksp/pc/imp

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

Conflicts:
src/ksp/pc/impls/bddc/bddc.c
src/ksp/pc/impls/bddc/bddcgraph.c
src/ksp/pc/impls/bddc/bddcprivate.c
src/ksp/pc/impls/bddc/bddcscalingbasic.c
src/ksp/pc/impls/bddc/bddcschurs.c
src/mat/impls/is/matis.c

show more ...

Merge branch 'master' into barry/add-pcfieldsplit-logevent

Merge branch 'master' into barry/add-pcreset-hypre-for-master

Needed to move PCDestroy_HYPRE() added to master to PCReset_HYPRE() since that was introduced
as a bug fix for maint

Merge branch 'master' into hongzh/checkpointing

Manual merges for a couple of PetscOptions changes in master

Merge remote-tracking branch 'origin/knepley/feature-plex-add-time' into tisaac/dmforest

Both branches changeds DM projection behavior, so I wanted to sort it
out before merging

* origin/knepley/fe

Merge remote-tracking branch 'origin/knepley/feature-plex-add-time' into tisaac/dmforest

Both branches changeds DM projection behavior, so I wanted to sort it
out before merging

* origin/knepley/feature-plex-add-time: (59 commits)
SNES ex69: Updated to new function API, fixed test output
SNES ex75: Fixed for new function API
add fortran stub for TSMonitorLGSetTransform() and fix TSMonitorLG for multiple fields but no names provided for fields
add -binary_write_double so __float128 precision can save as double to binary files
TSClone() did not clone Fortran function pointers hence some TS methods would fail if functions provided in Fortan
petsc4py: update to snapshot with 'barry/petscoptions-object' changes
fix bad merge that introduced 2 copies of the MPI_Comm_free()
update example to use MAT_INPLACE_MATRIX, not REUSE
incorrect addition of float to PetscInt
update for new PetscOptions API
TS ex18: Fixed function API and test output
Function now takes PetscOptions as first argument, this was missed during the first round of updates
bugfix for MatSetOption_Elemental()
fix test example no change output that was missing a line
fixes for new PetscOptions.. API that are needed based on problems with nightly build
Plex ex3: Use new function API
SNES ex62: Use new function API
SNES ex12: Use new function API
Plex: Fixed unused options in examples
Plex+DMDA: Add time to signatures
...

show more ...

Merge branch 'master' into pr391/zianekhodja/lilia/tsirm/master

Merge branch 'master' into knepley/feature-plex-add-time

* master: (57 commits)
add fortran stub for TSMonitorLGSetTransform() and fix TSMonitorLG for multiple fields but no names provided for fie

Merge branch 'master' into knepley/feature-plex-add-time

* master: (57 commits)
add fortran stub for TSMonitorLGSetTransform() and fix TSMonitorLG for multiple fields but no names provided for fields
add -binary_write_double so __float128 precision can save as double to binary files
TSClone() did not clone Fortran function pointers hence some TS methods would fail if functions provided in Fortan
petsc4py: update to snapshot with 'barry/petscoptions-object' changes
fix bad merge that introduced 2 copies of the MPI_Comm_free()
update example to use MAT_INPLACE_MATRIX, not REUSE
incorrect addition of float to PetscInt
update for new PetscOptions API
Function now takes PetscOptions as first argument, this was missed during the first round of updates
bugfix for MatSetOption_Elemental()
fix test example no change output that was missing a line
fixes for new PetscOptions.. API that are needed based on problems with nightly build
mark variable as unused so compiler doesn't warn about unused value
configure: use 'git cat-file -e' to check for existance of a commit in localrepo. ['git rev-parse' does not give error for a hash thats not in repo]
petsc4py: revert to manually syncing petsc4py with petsc master changes
configure: revert gitcommit default value to Null. If a pacakge using giturl does not change this value - raise an error
fix: revert change in a44bcdf that breaks with pgf90
update test output for fixed to hypre interface that now actually pass the interp vectors to BoomerAMG
fixes for merge from Jed's branch that should have been merged into master months ago!
Add to changes dev.html file the change to the PetscOptions routines
...

show more ...