First pass at documenting assert preprocessor directives

ChangeLog.md

@@ -15,6 +15,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Multi-line continuation support for pFUnit macros (issue #532)
   - Assertion macros (e.g., `@assertEqual`) now support Fortran `&` line continuation
   - Whitespace is preserved exactly as written when joining continued lines
+- Fix documentation generation with Doxygen.
+  - Split single documentation file into pages for easier management.
+  - Add documentation missing for assertions.
+  - Added a failure message to the assertEqual test.
 
 ## [4.16.0] - 2026-02-23
 

bin/funit/tests/test_parser_assertions.py

@@ -27,12 +27,13 @@ def testMatchAtAssertEqual(self):
         self.assertTrue(atAssert.match("@assertEqual(a, b)"))
         self.assertTrue(atAssert.match("@assertequal(a, b)"))  # case insensitive
         self.assertTrue(atAssert.match("@ASSERTEQUAL(a, b)"))  # case insensitive
+        self.assertTrue(atAssert.match("@assertEqual(a, b, \"failure message\")"))
 
         parser.fileName = "foo.pfunit"
         parser.currentLineNumber = 8
-        atAssert.apply("   @assertEqual(1, 2)\n")
+        atAssert.apply("   @assertEqual(1, 2, \"failure message\")\n")
         self.assertEqual('#line 8 "foo.pfunit"\n', parser.outLines[0])
-        self.assertEqual("  call assertEqual(1, 2, &\n", parser.outLines[1])
+        self.assertEqual("  call assertEqual(1, 2, \"failure message\", &\n", parser.outLines[1])
         self.assertEqual(" & location=SourceLocation( &\n", parser.outLines[2])
         self.assertEqual(" & 'foo.pfunit', &\n", parser.outLines[3])
         self.assertEqual(" & 8)", parser.outLines[4])

documentation/.gitignore

@@ -1,2 +1,3 @@
 /.DS_Store
-/*.el
+/*.el
+documentation

documentation/CMakeLists.txt

@@ -209,13 +209,14 @@ if (${DOXYGEN_FOUND})
 endif ()
 
 if (ENABLE_BUILD_DOXYGEN)
-doxygen_add_docs(docs-internal
+doxygen_add_docs(documentation
   "${CMAKE_SOURCE_DIR}/bin"
   "${CMAKE_SOURCE_DIR}/documentation"
   "${CMAKE_SOURCE_DIR}/Examples"
   "${CMAKE_SOURCE_DIR}/src"
   "${CMAKE_SOURCE_DIR}/include"
   "${CMAKE_SOURCE_DIR}/tests"
   COMMENT "Generate pFUnit Fortran documentation"
+  CONFIG_FILE "${CMAKE_SOURCE_DIR}/documentation/doxygen.conf"
   )
 endif()