Improve the manual pages for adebug.c

Commit-type: documentation

-start_in_debugger can behave confusingly if the input is not a tty. This checks for that case and prints a very useful error message

Reported-by: Getnet Betrie <d.getnet@gmail.com>

PetscTraceBackErrorHandler: do not assume errors can be raised only once

users can do

ierr = some_petsc_call_that_fail()
ierr = some_other_petsc_call_that_fail()

and only care about the second err

PetscTraceBackErrorHandler: do not assume errors can be raised only once

users can do

ierr = some_petsc_call_that_fail()
ierr = some_other_petsc_call_that_fail()

and only care about the second error code but want a clean traceback

show more ...

petscsys: move xmmintrin.h out of public header

This is only needed in a few source files and most already included more
specialized headers. The *mmintrin.h headers are not standard C and
disrupt s

petscsys: move xmmintrin.h out of public header

This is only needed in a few source files and most already included more
specialized headers. The *mmintrin.h headers are not standard C and
disrupt some tooling (such as libclang-14). It probably also takes some
time and disk traffic to include in every compilation unit.

show more ...

Fix trivial typos etc in some manual pages

Also remove manual page for SNESNGSFunction since it does not exist

Update some discussions in the users manual

Also fix 32bit, 64bit, 32 bit, 64 bit throughout and blas and blas/lapack

Format the ftn-custom files with clang-format. Apparently no particular reason we did not format them initially

Fix typos

Fix some documentation and typos

Merge branch 'barry/2023-03-27/fix-typo-setterrabort-missing-petsccalla' into 'main'

Cleanup some manual pages for error handle, especially wrt Fortran usage

See merge request petsc/petsc!6241

Cleanup some manual pages for error handle, especially wrt Fortran usage

Commit-type: documentation
Reported-by: jacob Faibussowitsch <jacob.fai@gmail.com>

More manual page fixes

Remove need for seperate lib/petsc/conf/test file by merging with rules file

Commit-type: maintainability

non-test and tutorial makefiles only need rules.doc not the full rules

Commit-type: documentation