[PATCH 1/2] Add items to Doxygen groups

Sebastian Huber sebastian.huber at embedded-brains.de
Fri Sep 2 08:39:27 UTC 2022


---
 cpukit/include/rtems/fatal.h          |  2 ++
 cpukit/include/rtems/init.h           |  2 ++
 cpukit/include/rtems/rtems/cache.h    |  2 ++
 cpukit/include/rtems/rtems/config.h   |  2 ++
 cpukit/include/rtems/rtems/dpmem.h    |  2 ++
 cpukit/include/rtems/rtems/intr.h     |  2 ++
 cpukit/include/rtems/rtems/modes.h    |  2 ++
 cpukit/include/rtems/rtems/mp.h       |  2 ++
 cpukit/include/rtems/rtems/object.h   |  2 ++
 cpukit/include/rtems/rtems/options.h  |  2 ++
 cpukit/include/rtems/rtems/region.h   |  2 ++
 cpukit/include/rtems/rtems/status.h   |  2 ++
 cpukit/include/rtems/rtems/support.h  |  2 ++
 cpukit/include/rtems/rtems/tasks.h    | 36 ++++++++++++++-------------
 cpukit/include/rtems/rtems/types.h    |  2 ++
 cpukit/include/rtems/score/basedefs.h |  6 +++++
 16 files changed, 53 insertions(+), 17 deletions(-)

diff --git a/cpukit/include/rtems/fatal.h b/cpukit/include/rtems/fatal.h
index 37dd24fdd1..3711d41f70 100644
--- a/cpukit/include/rtems/fatal.h
+++ b/cpukit/include/rtems/fatal.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file defines the Fatal Error Manager API.
  */
 
diff --git a/cpukit/include/rtems/init.h b/cpukit/include/rtems/init.h
index a2c27658ba..90dfa3bf92 100644
--- a/cpukit/include/rtems/init.h
+++ b/cpukit/include/rtems/init.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file defines the Initialization Manager API.
  */
 
diff --git a/cpukit/include/rtems/rtems/cache.h b/cpukit/include/rtems/rtems/cache.h
index baaa10a99b..d0e5e9593c 100644
--- a/cpukit/include/rtems/rtems/cache.h
+++ b/cpukit/include/rtems/rtems/cache.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassicCache
+ *
  * @brief This header file defines the Cache Manager API.
  */
 
diff --git a/cpukit/include/rtems/rtems/config.h b/cpukit/include/rtems/rtems/config.h
index 1aade74a0f..18462b32a2 100644
--- a/cpukit/include/rtems/rtems/config.h
+++ b/cpukit/include/rtems/rtems/config.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file provides parts of the application configuration
  *   information API.
  */
diff --git a/cpukit/include/rtems/rtems/dpmem.h b/cpukit/include/rtems/rtems/dpmem.h
index 54c660fe35..a913cfef89 100644
--- a/cpukit/include/rtems/rtems/dpmem.h
+++ b/cpukit/include/rtems/rtems/dpmem.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassicDPMem
+ *
  * @brief This header file defines the Dual-Ported Memory Manager API.
  */
 
diff --git a/cpukit/include/rtems/rtems/intr.h b/cpukit/include/rtems/rtems/intr.h
index a96b0b7dc9..8128ff08af 100644
--- a/cpukit/include/rtems/rtems/intr.h
+++ b/cpukit/include/rtems/rtems/intr.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file defines the Interrupt Manager API.
  */
 
diff --git a/cpukit/include/rtems/rtems/modes.h b/cpukit/include/rtems/rtems/modes.h
index bbb18ac87b..6f70519756 100644
--- a/cpukit/include/rtems/rtems/modes.h
+++ b/cpukit/include/rtems/rtems/modes.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassicModes
+ *
  * @brief This header file provides the task modes API of the Task Manager.
  */
 
diff --git a/cpukit/include/rtems/rtems/mp.h b/cpukit/include/rtems/rtems/mp.h
index 74a65e7536..c2ff0e7db7 100644
--- a/cpukit/include/rtems/rtems/mp.h
+++ b/cpukit/include/rtems/rtems/mp.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file defines the Multiprocessing Manager API.
  */
 
diff --git a/cpukit/include/rtems/rtems/object.h b/cpukit/include/rtems/rtems/object.h
index 1de969c371..2f2513893e 100644
--- a/cpukit/include/rtems/rtems/object.h
+++ b/cpukit/include/rtems/rtems/object.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassicObject
+ *
  * @brief This header file provides the Object Services API.
  */
 
diff --git a/cpukit/include/rtems/rtems/options.h b/cpukit/include/rtems/rtems/options.h
index 60d90f997e..5328c383b5 100644
--- a/cpukit/include/rtems/rtems/options.h
+++ b/cpukit/include/rtems/rtems/options.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file provides the Classic API directive options.
  */
 
diff --git a/cpukit/include/rtems/rtems/region.h b/cpukit/include/rtems/rtems/region.h
index 298b73ab3d..2bffb6e705 100644
--- a/cpukit/include/rtems/rtems/region.h
+++ b/cpukit/include/rtems/rtems/region.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassicRegion
+ *
  * @brief This header file defines the Region Manager API.
  */
 
diff --git a/cpukit/include/rtems/rtems/status.h b/cpukit/include/rtems/rtems/status.h
index 429e5d4fbb..908088f813 100644
--- a/cpukit/include/rtems/rtems/status.h
+++ b/cpukit/include/rtems/rtems/status.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file provides the status codes of Classic API directives
  *   and support functions.
  */
diff --git a/cpukit/include/rtems/rtems/support.h b/cpukit/include/rtems/rtems/support.h
index f099036193..2da84d43bb 100644
--- a/cpukit/include/rtems/rtems/support.h
+++ b/cpukit/include/rtems/rtems/support.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file defines support services of the API.
  */
 
diff --git a/cpukit/include/rtems/rtems/tasks.h b/cpukit/include/rtems/rtems/tasks.h
index ba05d92531..6d643b7fbe 100644
--- a/cpukit/include/rtems/rtems/tasks.h
+++ b/cpukit/include/rtems/rtems/tasks.h
@@ -283,6 +283,25 @@ typedef struct {
   rtems_task_argument argument;
 } rtems_initialization_tasks_table;
 
+/* Generated from spec:/rtems/task/if/maximum-priority-impl */
+
+/**
+ * @ingroup RTEMSImplClassicTask
+ *
+ * @brief Returns the maximum priority of the scheduler with index zero.
+ */
+rtems_task_priority _RTEMS_Maximum_priority( void );
+
+/* Generated from spec:/rtems/task/if/maximum-priority */
+
+/**
+ * @ingroup RTEMSAPIClassicTasks
+ *
+ * @brief This runtime constant represents the lowest (least important) task
+ *   priority of the scheduler with index zero.
+ */
+#define RTEMS_MAXIMUM_PRIORITY _RTEMS_Maximum_priority()
+
 /* Generated from spec:/rtems/task/if/minimum-priority */
 
 /**
@@ -401,23 +420,6 @@ typedef bool( *rtems_task_visitor )( rtems_tcb *, void * );
  */
 #define RTEMS_YIELD_PROCESSOR WATCHDOG_NO_TIMEOUT
 
-/* Generated from spec:/score/if/maximum-priority */
-
-/**
- * @brief Returns the maximum priority of the scheduler with index zero.
- */
-rtems_task_priority _RTEMS_Maximum_priority( void );
-
-/* Generated from spec:/rtems/task/if/maximum-priority */
-
-/**
- * @ingroup RTEMSAPIClassicTasks
- *
- * @brief This runtime constant represents the lowest (least important) task
- *   priority of the scheduler with index zero.
- */
-#define RTEMS_MAXIMUM_PRIORITY _RTEMS_Maximum_priority()
-
 /* Generated from spec:/rtems/task/if/create */
 
 /**
diff --git a/cpukit/include/rtems/rtems/types.h b/cpukit/include/rtems/rtems/types.h
index caa75b4f0d..4779e61b9c 100644
--- a/cpukit/include/rtems/rtems/types.h
+++ b/cpukit/include/rtems/rtems/types.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSImplClassic
+ *
  * @brief This header file provides types used by the Classic API.
  */
 
diff --git a/cpukit/include/rtems/score/basedefs.h b/cpukit/include/rtems/score/basedefs.h
index 7a37299eee..d5a78f1950 100644
--- a/cpukit/include/rtems/score/basedefs.h
+++ b/cpukit/include/rtems/score/basedefs.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSScore
+ *
  * @brief This header file provides basic definitions used by the API and the
  *   implementation.
  */
@@ -426,6 +428,8 @@ extern "C" {
 /* Generated from spec:/score/if/assert-unreachable */
 
 /**
+ * @ingroup RTEMSScore
+ *
  * @brief Asserts that this program point is unreachable.
  */
 #if defined(RTEMS_DEBUG)
@@ -438,6 +442,8 @@ extern "C" {
   /* Generated from spec:/score/if/dequalify-types-not-compatible */
 
   /**
+   * @ingroup RTEMSScore
+   *
    * @brief A not implemented function to trigger compile time errors with an
    *   error message.
    */
-- 
2.35.3



More information about the devel mailing list