#1340 Fix Doxygen warnings.

Sources/ThirdParty/Wrappers/Petsc/SnesMacro.hpp

@@ -11,6 +11,11 @@
 #ifndef MOREFEM_x_THIRD_PARTY_x_WRAPPERS_x_PETSC_x_SNES_MACRO_HPP_
 # define MOREFEM_x_THIRD_PARTY_x_WRAPPERS_x_PETSC_x_SNES_MACRO_HPP_
 
+
+// ============================
+//! \cond IGNORE_BLOCK_IN_DOXYGEN
+// ============================
+
 # ifdef MOREFEM_NO_TRAP_SNES_EXCEPTION
 
 #  define MOREFEM_TRAP_SNES_EXCEPTION_TRY
@@ -18,6 +23,11 @@
 
 # else // MOREFEM_NO_TRAP_SNES_EXCEPTION
 
+/*!
+ * If the macro is not defined, in standard SnesInterface functions exceptions are caught and transformed into
+ * Petsc error codes. This prevent libc++ abi issues if exceptions are thrown from one of functions fed to Petsc
+ * through a pointer.
+ */
 #  define MOREFEM_TRAP_SNES_EXCEPTION_TRY try
 #  define MOREFEM_TRAP_SNES_EXCEPTION_CATCH(Snes) \
     catch(const std::exception& e) \
@@ -29,4 +39,9 @@
 # endif // MOREFEM_NO_TRAP_SNES_EXCEPTION
 
 
+// ============================
+//! \endcond IGNORE_BLOCK_IN_DOXYGEN
+// ============================
+
+
 #endif // MOREFEM_x_THIRD_PARTY_x_WRAPPERS_x_PETSC_x_SNES_MACRO_HPP_