Add comments describing the redefinition

diff --git a/.clang-format b/.clang-format
index 3d294fafa2809315a0a730e7aab803002c599480..8704ab69cd2c58ee97eba013f85af76a29b3e144 100644 (file)
--- a/.clang-format
+++ b/.clang-format
@@ -127,6 +127,8 @@ IncludeCategories:
 # should not be caught here
   - Regex: "<[a-z_]+>"
     Priority: 100000
+# make sure that "../tests.h" appears before all other local include files
+# such that replacing Assert in tests also applies to the testing header files.
   - Regex: "\\.\\./tests\\.h"
     Priority: 200000
 

diff --git a/tests/tests.h b/tests/tests.h
index 5de7e366e8fed2fd4524caee1ebe87ac6cb276a8..749f462425eef0dee660f27b50d4c8287169109b 100644 (file)
--- a/tests/tests.h
+++ b/tests/tests.h
@@ -64,6 +64,10 @@ struct DisableWindowsDebugRuntimeDialog
 } deal_II_windows_crt_dialog;
 #endif
 
+// Redefine Assert as AssertThrow to make sure that the code is tested similarly
+// in Release mode and in Debug mode. clang-format makes sure that this file is
+// included after all regular header files but before all the other local header
+// files.
 #undef Assert
 #define Assert AssertThrow