Minor PetscDeviceContextGetStreamHandle() documentation spelling fixes and copy-edits

Convert all header guards to pragma once

Merge branch 'barry/2023-08-10/cannot-destroy-persistant-objects' into 'main'

(1) Fix error return codes for PetscHeaderCreate/Destroy() Cannot use || on them (2) do not allow destroying PETSC_VIEWE

Merge branch 'barry/2023-08-10/cannot-destroy-persistant-objects' into 'main'

(1) Fix error return codes for PetscHeaderCreate/Destroy() Cannot use || on them (2) do not allow destroying PETSC_VIEWER_STDOUT_SELF etc

See merge request petsc/petsc!6804

show more ...

Fix error return codes for PetscHeaderDestroy() Cannot use || on them

Commit-type: error-checking

Merge branch 'jczhang/2023-08-08/feature-hypre-device-matzerorows' into 'main'

Support MatZeroRows on MatHYPRE on device

See merge request petsc/petsc!6790

Sys: add PetscGetCurrentCUDA/HIPStream()

Use std::weak_ptr to ensure destroyed device contexts are not accessed

The various PetscXXXRegisterFinalize() should execute finalizers in reverse order of registration

Profiling: Switch logging over to the new PetscLogHandler infrastructure

- Move data structures only needed by the default logger now (Action,
Object) to logdefault.c

- Create petsclogdeprecated.

Profiling: Switch logging over to the new PetscLogHandler infrastructure

- Move data structures only needed by the default logger now (Action,
Object) to logdefault.c

- Create petsclogdeprecated.h and petsc/private/logimpldeprecated.h
for publicly visible symbols that are now deprecated. Yes,
lots of symbols in petsc/private/logimpl.h were not only visible
but had docstrings.

- The macros PetscLogEventBegin(), PetscLogEventEnd(),
PetscLogEventSync(), PetscLogObjectCreate(), and
PetscLogObjectDestroy() now looks through the log handlers
in PetscLogHandlers, sees if they have they appropriate
callbacks (Exposed in PetscLogHandlerHot), and calls them.
Up to 4 log handlers can run simultaneously.

- All queries about the registered things now go through
petsc_log_state.

- Output functions dispatch to the appropriate PetscLogHandler

- There is no need for xmllogevent.c, xmlviewer.c, eventlog.c,
classlog.c, and stagelog.c anymore. Some orphaned functions
(PetscLogSetThreshold(), PetscLogEventSetDof(),
PetscLogEventSetError(), PetscASend(), PetscARecv(), PetscAReduce())

- PetscFEOpenCLLogResidual() did some intrusive things related
to the old logging infrastruture: the private header
for the default log handler is now imported into feopencl.c
so that it can do equivalent things with the new infrastructure.

- PetscLogPauseCurrentEvent_Internal() is replaced with
PetscLogEventsPause()

Deprecated symbols include:

- All functions related to PetscStageLog and the resizable array structs
that it contained.

- The legacy EventBegin()/EventEnd() callbacks.

- PetscLogAllBegin(), which actually reported less information than
PetscLogDefaultBegin() because it was not kept up-to-date with
regards to GPU profiling.

show more ...

Rename PetscValidPointer -> PetscAssertPointer

Deploy new PetscValidPointer, remove PetscValidXXXPointer

extern template CUPM Interface and SolverInterface as well

Fix -Wextra-semi-stmt

Manual linter fixes: sys

Lint apply: sys