More manual page fixes

Merge branch 'jacobf/2023-03-11/clang-static-analyzer-fixes' into 'main'

Misc static analyzer bugs found

See merge request petsc/petsc!6176

Misc static analyzer bugs found

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-23/fix-sys-man' into 'main'

Fix up all manual pages in src/sys directory

See merge request petsc/petsc!5559

Fix up all manual pages in src/sys directory

Commit-type: documentation
/spend 10h

Merge branch 'jolivet/fix-style-one-liners' into 'main'

Remove braces from one-liners w/o PetscCall()

See merge request petsc/petsc!5561

Remove braces from one-liners w/o PetscCall()

Merge branch 'jolivet/fix-style-one-liners' into 'main'

Remove braces from one-liners

See merge request petsc/petsc!5557

Remove braces from one-liners

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 'jed/posix-memalign' into 'main'

Switch from memalign to posix_memalign

See merge request petsc/petsc!5429

Switch from memalign to posix_memalign

memalign is an obsolete function that is not implemented on FreeBSD,
OSX, or MSWIN. Being obsolete, it's also not handled by some memory
profilers. posix_memal

Switch from memalign to posix_memalign

memalign is an obsolete function that is not implemented on FreeBSD,
OSX, or MSWIN. Being obsolete, it's also not handled by some memory
profilers. posix_memalign is a standard and more widely implemented.

show more ...

Merge remote-tracking branch 'origin/release'

Merge branch 'avoid-ub-in-PetscMallocA' into 'release'

Avoid undefined behavior in PetscMallocA

See merge request petsc/petsc!5216

Avoid undefined behavior in PetscMallocA

If PetscMallocA is asked to allocate zero bytes, the subsequent logic to
assign the input pointers to the appropriate points in the allocated
block (which is

Avoid undefined behavior in PetscMallocA

If PetscMallocA is asked to allocate zero bytes, the subsequent logic to
assign the input pointers to the appropriate points in the allocated
block (which is NULL) invoke undefined behavior. Avoid this by
explicitly checking for this case and simply assigning NULL directly to
all output pointers.

Clang ubsan flags this at runtime as "applying zero offset to null
pointer" (https://reviews.llvm.org/D67122).

Fixes #1180.

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 'jolivet/feature-less-checkfalse' into 'main'

Dividing by four the number of PetscCheckFalse()

See merge request petsc/petsc!5072

Remove some PetscCheckFalse()

Merge branch 'jacobf/2022-03-27/fixup-mal-formatting' into 'main'

Fixup mal.c

See merge request petsc/petsc!5040