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

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 'barry/2022-06-23/docs-matgetownershiprangeis' into 'main'

docs for MPI rank ownership of matrix entries

See merge request petsc/petsc!5365

Fix missing entries/formatting in some manual pages

Commit-type: docs
/spend 10m

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-02-23/variadic-chkerr' into 'main'

Variadic CHKERRQ()

See merge request petsc/petsc!4889

The great renaming:

- CHKERRQ() -> PetscCall()
- CHKERRV() -> PetscCallVoid()
- CHKERRMPI() -> PetscCallMPI()
- CHKERRABORT() -> PetscCallAbort()
- CHKERRCONTINUE() -> PetscCallContinue()
- CHKERRXX

The great renaming:

- CHKERRQ() -> PetscCall()
- CHKERRV() -> PetscCallVoid()
- CHKERRMPI() -> PetscCallMPI()
- CHKERRABORT() -> PetscCallAbort()
- CHKERRCONTINUE() -> PetscCallContinue()
- CHKERRXX() -> PetscCallThrow()
- CHKERRCXX() -> PetscCallCXX()
- CHKERRCUDA() -> PetscCallCUDA()
- CHKERRCUBLAS() -> PetscCallCUBLAS()
- CHKERRCUSPARSE() -> PetscCallCUSPARSE()
- CHKERRCUSOLVER() -> PetscCallCUSOLVER()
- CHKERRCUFFT() -> PetscCallCUFFT()
- CHKERRCURAND() -> PetscCallCURAND()
- CHKERRHIP() -> PetscCallHIP()
- CHKERRHIPBLAS() -> PetscCallHIPBLAS()
- CHKERRHIPSOLVER() -> PetscCallHIPSOLVER()
- CHKERRQ_CEED() -> PetscCallCEED()
- CHKERR_FORTRAN_VOID_FUNCTION() -> PetscCallFortranVoidFunction()
- CHKERRMKL() -> PetscCallMKL()
- CHKERRMMG() -> PetscCallMMG()
- CHKERRMMG_NONSTANDARD() -> PetscCallMMG_NONSTANDARD()
- CHKERRCGNS() -> PetscCallCGNS()
- CHKERRPTSCOTCH() -> PetscCallPTSCOTCH()
- CHKERRSTR() -> PetscCallSTR()
- CHKERRTC() -> PetscCallTC()

show more ...

chkerr and friends wrapped

Merge branch 'jacobf/2022-01-05/c99' into 'main'

Feature: C99 and C++11

See merge request petsc/petsc!4700

add PetscDesignatedInitializer() and apply it PetscRandom_*, AO_*, Vec_Seq, and Vec_MPI

Merge branch 'jacobf/2021-09-04/petscdevice-cupminitialization' into 'main'

Replace current CUPM initialization with unified PetscDevice version

See merge request petsc/petsc!4310

- Replace the current CUPM initialization infrastructure with PetscDevice.
- Remove -petsc_use_default_null_stream and -[cuda|hip]_synchronize options
- Remove PetscCUDASynchronize and PetscHIPSynchr

- Replace the current CUPM initialization infrastructure with PetscDevice.
- Remove -petsc_use_default_null_stream and -[cuda|hip]_synchronize options
- Remove PetscCUDASynchronize and PetscHIPSynchronize
- Remove PetscCUDAInitialize(), PetscCUDAInitializeCheck(), PetscHIPInitialize(), and
PetscHIPInitializeCheck()
- Remove PetscCUBLASInitializeHandle(), PetscCUSOLVERDnInitializeHandle(),
PetscHIPBLASInitializeHandle(), and PetscHIPSOLVERInitializeHandle().
- Remove petsc_gputimer_begin and petsc_gputimer_begin
- Add -device_enable, -device_select and -device_view options
- Replace -[cuda|hip]_device with split options -device_enable_[cuda|hip] and -device_select_[cuda|hip]
- Replace -[cuda|hip]_view with -device_view_[cuda|hip]
- Add PetscDeviceInitType
- Add PetscDeviceInitialize() and PetscDeviceInitialized()
- Add PetscDeviceView()

show more ...

Merge branch 'barry/2021-04-12/support-for-nvhpc' into 'main'

These are fixes needed for clean builds with NVIDIA's HPC software toolkit

See merge request petsc/petsc!3882

Various fixes for NVIDIA's nvhpc toolkit

The nvhpc systems separates the CUDA math libaries and includes from the regular CUDA material
thus cuda.py has to detect and manage this separation automati

Various fixes for NVIDIA's nvhpc toolkit

The nvhpc systems separates the CUDA math libaries and includes from the regular CUDA material
thus cuda.py has to detect and manage this separation automatically.

Note also the nvhpc includes the MPI compilers in another directory which should be used with MPI.

Do not use outer C++ compiler as Kokkos compiler as that may not match the compiler used by nvcc, instead use the C++ compiler that nvcc uses. This is tricky because this compiler has to have access to the MPI headers since it sees all of the PETSc headers.

/spend 14h

show more ...

Merge branch 'jacobf/2021-05-13/promote-petscrandom-headers' into 'main'

move petscrandom headers to include/petsc/private

See merge request petsc/petsc!3971

move petscrandom headers to include/petsc/private

Merge branch 'stefanozampini/feature-vecrandom-minmax-device' into 'master'

Support VecSetRandom and VecMin/Max for VECCUDA

See merge request petsc/petsc!3578

PetscRandom: add CURAND support