Merge branch 'barry/2026-02-09/docs-dm' into 'main'

Add a bit more discussion of DM and their commonalities to the docs

See merge request petsc/petsc!9018

Add a bit more discussion of DM and their commonalities to the docs

Merge remote-tracking branch 'origin/release'

Merge branch 'jrwrigh/section_docs' into release

docs: Add user manual documentation of PetscSection

See merge request petsc/petsc!7766

docs: Add user manual documentation of PetscSection

Merge branch 'barry/2024-04-29/add-fortran-enums' into 'main'

Major updates to Fortran interface

See merge request petsc/petsc!7517

Fortran 90: fully embrace After 34 years!

- deprecate use of 'F90' in Fortran function names
- use Fortran pointers when appropriate
- the new Fortran API is not backward compatible with previous ve

Fortran 90: fully embrace After 34 years!

- deprecate use of 'F90' in Fortran function names
- use Fortran pointers when appropriate
- the new Fortran API is not backward compatible with previous versions!
- also clean up inconsistent PETSc code detected by new Fortran generation tools
- drop use of bfort
- automatically generate all the Fortran PETSc objects, enums etc from the include files
- generate most of the Fortran interface definitions and functions from the source code
- simplify the number and organization of Fortran modules

Co-authored-by: Jose E. Roman <jroman@dsic.upv.es>

show more ...

Merge branch 'jacobf/2023-08-17/header-guard-check' into 'main'

Check header guards

See merge request petsc/petsc!6822

Convert all header guards to pragma once

Merge branch 'barry/2023-02-26/fix-vec-man-pages' into 'main'

Fix Vec and IS manual pages

See merge request petsc/petsc!6123

Fix Vec, SF, Section and IS manual pages

Commit-type: documentation

Merge remote-tracking branch 'origin/release'

Merge branch 'jolivet/fix-typo' into 'release'

Winter cleaning

See merge request petsc/petsc!5948

Fix some typos

Merge remote-tracking branch 'origin/release'

Merge branch 'knepley-main-patch-87292' into 'release'

Doc: Update doc for Section about "ghost" points

See merge request petsc/petsc!5298

Doc: Update doc for Section about "ghost" points

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

Feature: Bicycle Storage Facility 2

See merge request petsc/petsc!5661

Transform all header-guards into ifndefs to make clang-format ignore them for preprocessor indentation

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