Create system for automatically adding References: section when {cite} appears in the manual page

Merge remote-tracking branch 'origin/release'

Docs: fix typos and missing back ticks

PCFIELDSPLIT: do not dereference NULL in PCFieldSplitGetSchurPre()

Fix missing new lines at the end of PetscInfo() calls

Track levels of nesting of KSP, for example KSPBJACOBI has nesting 1 higher than the calling KSP

... and apply it

Rename PetscValidPointer -> PetscAssertPointer

Deploy new PetscValidPointer, remove PetscValidXXXPointer

PCApplyTranspose_FieldSplit(): fix Schur complement implementation

Reported-by: Chris Douglas <douglas@ladhyx.polytechnique.fr>

[0]PETSC ERROR: --------------------- Error Message -----------------

PCApplyTranspose_FieldSplit(): fix Schur complement implementation

Reported-by: Chris Douglas <douglas@ladhyx.polytechnique.fr>

[0]PETSC ERROR: --------------------- Error Message --------------------------------------------------------------
[0]PETSC ERROR: Object is in wrong state
[0]PETSC ERROR: Mat object's type is not set: Argument # 1
[0]PETSC ERROR: #1 MatGetFactorAvailable() at src/mat/interface/matrix.c:4820
[0]PETSC ERROR: #2 PCGetDefaultType_Private() at src/ksp/pc/interface/precon.c:25
[0]PETSC ERROR: #3 PCSetUp() at src/ksp/pc/interface/precon.c:1109
[0]PETSC ERROR: #4 KSPSetUp() at src/ksp/ksp/interface/itfunc.c:406
[0]PETSC ERROR: #5 KSPSolve_Private() at src/ksp/ksp/interface/itfunc.c:826
[0]PETSC ERROR: #6 KSPSolveTranspose() at src/ksp/ksp/interface/itfunc.c:1122
[0]PETSC ERROR: #7 PCApplyTranspose_FieldSplit() at src/ksp/pc/impls/fieldsplit/fieldsplit.c:1487
[0]PETSC ERROR: #8 PCApplyTranspose() at src/ksp/pc/interface/precon.c:715
[0]PETSC ERROR: #9 KSP_PCApply() at include/petsc/private/kspimpl.h:380
[0]PETSC ERROR: #10 KSPInitialResidual() at src/ksp/ksp/interface/itres.c:63
[0]PETSC ERROR: #11 KSPSolve_GMRES() at src/ksp/ksp/impls/gmres/gmres.c:226
[0]PETSC ERROR: #12 KSPSolve_Private() at src/ksp/ksp/interface/itfunc.c:900
[0]PETSC ERROR: #13 KSPSolveTranspose() at src/ksp/ksp/interface/itfunc.c:1122
[0]PETSC ERROR: #14 main() at ex9.c:80
[0]PETSC ERROR: Reached the main program with an out-of-range error code 1. This should never happen

show more ...

Lint apply: ksp

Merge branch 'barry/2023-06-15/add-fortran-file-viewer' into 'main'

Allow one to attach a PETSCVIEWERASCII to a Fortran file unit

See merge request petsc/petsc!6607

HAVE_FORTRAN should be USE_FORTRAN_BINDINGS since it is about generating the Fortran bindings, not about if the Fortran compiler exists