Add a bit more discussion of DM and their commonalities to the docs

feat(section): Add PetscSectionDistributeData()

This is a copy/paste of `DMPlexDistributeData()`, but brought up to the
PetscSection interface because the routine is completely generic

Co-authored-

feat(section): Add PetscSectionDistributeData()

This is a copy/paste of `DMPlexDistributeData()`, but brought up to the
PetscSection interface because the routine is completely generic

Co-authored-by: Barry Smith <bsmith@mcs.anl.gov>

show more ...

section: Allow NULL array in `PetscSectionArrayView()`

Only if the section storage size is 0, otherwise raise error.

fix(section): Use PetscReal for non-standard FP

Compile errors when using `--with-scalar-type=complex --with-precision=__float128` due to illegal cast:
```
petsc/src/vec/is/section/interface/section

fix(section): Use PetscReal for non-standard FP

Compile errors when using `--with-scalar-type=complex --with-precision=__float128` due to illegal cast:
```
petsc/src/vec/is/section/interface/section.c:2630:65: error: invalid cast from type 'PetscScalar' {aka '__complex__ _Float128'} to type 'double'
2630 | PetscCall(PetscViewerASCIISynchronizedPrintf(viewer, " %g", (double)((PetscScalar *)array)[index]));
| ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
```

Also changed the function name to be more reflection of what it does.

Reported-by: Jose E. Roman <jroman@dsic.upv.es>

show more ...

section: Implement ArrayView function, use for PetscSectionVecView

Deprecate MPIU_BOOL which used to be for PETSc' enum Bool but now is just MPI_C_BOOL so no longer needs its own name

Remove unnecessary braces around one-liners

git grep -lE "[ ]*(if|for|while) \(.*\) {[^;]*;[^;]*}$" -- '*.c' '*.cxx' '*.cu' '*.h' '*.hpp' '*.cpp' | xargs sed -i '' -E 's#([ ]*)(if|for|while) \((.*)\

Remove unnecessary braces around one-liners

git grep -lE "[ ]*(if|for|while) \(.*\) {[^;]*;[^;]*}$" -- '*.c' '*.cxx' '*.cu' '*.h' '*.hpp' '*.cpp' | xargs sed -i '' -E 's#([ ]*)(if|for|while) \((.*)\) {([^;]*);([^;]*)}$#\1\2 \(\3\)\4;\5#'

show more ...

Convert some SETERRQ() to PetscCheck()