diff --git a/modules/database/src/ioc/db/dbUnitTest.h b/modules/database/src/ioc/db/dbUnitTest.h
index 9f5fdae21..c1e4fcd89 100644
--- a/modules/database/src/ioc/db/dbUnitTest.h
+++ b/modules/database/src/ioc/db/dbUnitTest.h
@@ -6,13 +6,6 @@
 * in file LICENSE that is included with this distribution.
  \*************************************************************************/
 
-/** @file dbUnitTest.h
- * @brief Helpers for unittests of process database
- * @author Michael Davidsaver, Ralph Lange
- *
- * @see @ref dbunittest
- */
-
 #ifndef EPICSUNITTESTDB_H
 #define EPICSUNITTESTDB_H
 
@@ -204,7 +197,11 @@ DBCORE_API void testGlobalUnlock(void);
 }
 #endif
 
-/** @page dbunittest Unit testing of record processing
+/** @file dbUnitTest.h
+ * @brief Helpers for unittests of process database
+ * @author Michael Davidsaver, Ralph Lange
+ *
+ * @section dbunittest Unit testing of record processing
  *
  * @see @ref epicsUnitTest.h
  *
diff --git a/modules/libcom/src/iocsh/initHooks.h b/modules/libcom/src/iocsh/initHooks.h
index 1373ca771..2febc0331 100644
--- a/modules/libcom/src/iocsh/initHooks.h
+++ b/modules/libcom/src/iocsh/initHooks.h
@@ -8,7 +8,9 @@
 * in file LICENSE that is included with this distribution.
 \*************************************************************************/
 
-/** @page inithooks IOC lifecycle callback hooks.
+/** @file initHooks.h
+ *
+ * @section inithooks IOC lifecycle callback hooks.
  *
  * initHookRegister() allows external code to be called at certains points (initHookState)
  * during IOC startup and shutdown.