Merge remote-tracking branch 'origin/release'

Merge branch 'barry/2024-11-26/improve-man-pages/release' into 'release'

Improve some manual pages in KSP/SNES

See merge request petsc/petsc!8071

Improve some manual pages in KSP/SNES

Merge branch 'zach/snes-arc-length' into 'main'

SNES: Add SNESNEWTONAL for Newton's method with arc length continuation

See merge request petsc/petsc!7502

SNES: Add SNESNEWTONAL for Newton's method with arc length continuation

Merge branch 'nathawani/feature-amr-using-flux-norm' into 'main'

SNES ex27: Poisson problem using primal and mixed form for error estimator using flux norm

See merge request petsc/petsc!7674

DMAdaptor: Add monitoring
- Add DMAdaptorMonitor(), DMAdaptorMonitorSet(), DMAdaptorMonitorCancel(), DMAdaptorMonitorSetFromOptions()
- Add DMAdaptorMonitorError(), DMAdaptorMonitorErrorDraw(), DMA

DMAdaptor: Add monitoring
- Add DMAdaptorMonitor(), DMAdaptorMonitorSet(), DMAdaptorMonitorCancel(), DMAdaptorMonitorSetFromOptions()
- Add DMAdaptorMonitorError(), DMAdaptorMonitorErrorDraw(), DMAdaptorMonitorErrorDrawLGCreate(), DMAdaptorMonitorErrorDrawLG()
- Add DMAdaptorMonitorRegister(), DMAdaptorMonitorRegisterAll(), DMAdaptorMonitorRegisterDestroy()

show more ...

DMAdaptor: Complete overhaul
- Add CLASSID and type registration
- Add error estimates based upon a mixed problem
- Add DMAdaptorSetType(), DMAdaptorGetType(), DMAdaptorRegister(), DMAdaptorRegisterA

DMAdaptor: Complete overhaul
- Add CLASSID and type registration
- Add error estimates based upon a mixed problem
- Add DMAdaptorSetType(), DMAdaptorGetType(), DMAdaptorRegister(), DMAdaptorRegisterAll(), DMAdaptorRegisterDestroy()
- Add DMAdaptorGetMixedSetupFunction() and DMAdaptorSetMixedSetupFunction()

show more ...

Merge remote-tracking branch 'origin/release'

Merge branch 'barry/2023-11-22/fix-some-manualpages/release' into 'release'

Improve SNES manual pages

See merge request petsc/petsc!7049

Fix some manual pages focusing on SNES

Merge branch 'jolivet/rm-first-empty-line' into 'main'

Remove first and last empty lines

See merge request petsc/petsc!6892

Remove first and last empty lines

Merge branch 'barry/2023-02-19/fix-snes-man-pages' into 'main'

Fix a bunch of SNES man pages

See merge request petsc/petsc!6094

Fix a bunch of SNES man pages

Commit-type: documentation

Merge branch 'rmills/fix-SNES_Setup-to-SNES_SetUp/release' into 'main'

Change SNES_Setup event to SNES_SetUp

See merge request petsc/petsc!6058

Change SNES_Setup event to SNES_SetUp, to be consistent with KSP_SetUp, PC_SetUp, etc.

Merge branch 'jacobf/2022-12-10/petscerrorcode-nodiscard' into 'main'

Feature: Non-discardable PetscErrorCode

See merge request petsc/petsc!5923

Make PetscErrorCode a non-discardable enum

Merge branch 'jacobf/2022-09-21/2-bike-2-shed' into 'main'

Feature: Bicycle Storage Facility 2

See merge request petsc/petsc!5661

source code format changes due to .clang-format changes

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