Fix/update/improve manual pages in snes directory

Minor changes to source code

Commit-type: housekeeping, documentation
/spend 8h

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-08-13/fix-man-include' into 'main'

Fix up manual pages in include/ including adding tick marks

See merge request petsc/petsc!5528

Fix up manual pages in include/ including adding tick marks

Commit-type: documentation
/spend 4h

Merge branch 'jeremy/context-destroy-fns' into 'main'

Add user context destroy functions

See merge request petsc/petsc!5252

context - wrap context in PetscContainer, add user context destroy routines for MatShell, DMSNES/DMTS function and jacobian

Merge branch 'stefanozampini/objpython-gettype' into 'main'

petsc4py: implement getters for python type

See merge request petsc/petsc!5417

petsc4py: implement getters for python type

Merge branch 'barry/2022-06-09/add-clear-names-no-ksp-linesearch' into 'main'

Add KSPNONE as alias for KSPPREONLY and SNESLINESEARCHNONE for SNESLINESEARCHBASIC

See merge request petsc/petsc!5326

Add SNESLINESEARCHNONE as alias for SNESLINESEARCHBASIC

Commit-type: usability
/spend 5m

Merge remote-tracking branch 'origin/release'

Merge branch 'jose/codespell-fixes' into 'release'

A few codespell fixes

See merge request petsc/petsc!5259

A few codespell fixes

Merge branch 'jczhang/feature-add-DMDASNESSetFunctionVecLocal' into 'main'

Do Form{Function, Objective, Jacobian}Local on GPU

See merge request petsc/petsc!5181

DMDASNES: add DMDASNESSetFunctionLocalVec() and friends

Merge branch 'barry/2022-05-03/cleanup-makefiles' into 'main'

remove unneeded stuff from makefiles

See merge request petsc/petsc!5211

Get values of makefile SOURCE etc from the file system instead of makefiles

Use SUBMANSEC from include files for manual sections instead of the makefile

Unfortunately this has to be one large commi

Get values of makefile SOURCE etc from the file system instead of makefiles

Use SUBMANSEC from include files for manual sections instead of the makefile

Unfortunately this has to be one large commit since the changes all have to be done at once

Commit-type: docs
/spend 10m

show more ...

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-01-05/c99' into 'main'

Feature: C99 and C++11

See merge request petsc/petsc!4700

deprecate PETSC_STATIC_INLINE

Merge branch 'heeho/feature-newtontrdc' into 'main'

Newton Trust Region Dogleg Cauchy nonlinear solver

See merge request petsc/petsc!4294

snes: Add new type SNESNEWTONTRDC for Newton Trust Region Dogleg Cauchy

Merge branch 'release'