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 'stefanozampini-main-patch-23728' into 'main'

Fix deprecation of TaoSetHessianRoutine

Closes #1108

See merge request petsc/petsc!4861

Fix https://gitlab.com/petsc/petsc/-/issues/1108

Merge branch 'stefanozampini/tao-python' into 'main'

TAOPYTHON

See merge request petsc/petsc!4768

TAO: add TAOPYTHON class

deprecate Tao basic API to match SNES and TS paradigms
TaoSetFromOptions: call TaoLineSearchSetFromOptions

TAO: code formatting

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 'stefanozampini/unify-getctx' into 'main'

Unify XXGetYYContext calls

See merge request petsc/petsc!4212

Unify XXGetYYContext calls

always use void*

Merge branch 'barry/2021-05-16/fix-double-lines' into 'main'

Fix typos in source

See merge request petsc/petsc!3984

Remove all double blank lines from source

Commit-type: petsc-style
/2h

Merge branch 'denera/tao-auglag' into 'master'

TAO Augmented Lagrangian solver for generally constrained optimization problems

See merge request petsc/petsc!3581

TAOALMM implemented for generally constrained optimization

Merge branch 'denera/tao-qn-recycle-fixes' into 'master'

QN and CG history recycling interfaces

See merge request petsc/petsc!3549

unified recycle flags for Tao solvers with consistent set/get interfaces

Merge remote-tracking branch 'origin/release' into master

Merge branch 'jed/header-symbol-consistency' into 'release'

Remove interface declarations for functions that don't exist

See merge request petsc/petsc!3374

Remove interface declarations for functions that don't exist

Merge branch 'barry/2020-08-16/fix-source-formatting' into 'master'

Turn on checkbadSource test to generate an error when found; fix all source code that causes errors

See merge request petsc/petsc

Merge branch 'barry/2020-08-16/fix-source-formatting' into 'master'

Turn on checkbadSource test to generate an error when found; fix all source code that causes errors

See merge request petsc/petsc!3064

show more ...

Turn on checkbadSource test to generate an error when found; fix all source code that causes errors

Commit-type: portability-fix, testing-fix, style-fix, feature, maintainability
/spend 1.5h

Merge branch 'brgn_lm' into 'master'

Levenberg-Marquardt optimization using BRGN

See merge request petsc/petsc!2964

Levenberg-Marquardt optimization using BRGN.

Adds diag(J^T J) as a regularizer to BRGN (called "lm"). With this
regularizer, BRGN is equivalent to a Levenberg-Marquardt algorithm.