[PATCH 16/20] rtems: Canonicalize task event file documentation

[Sebastian Huber]

---
 cpukit/include/rtems/rtems/eventdata.h | 3 ++-
 cpukit/include/rtems/rtems/eventimpl.h | 2 +-
 cpukit/rtems/src/eventmp.c             | 8 +++++---
 cpukit/rtems/src/eventreceive.c        | 5 +++--
 cpukit/rtems/src/eventseize.c          | 5 +++--
 cpukit/rtems/src/eventsend.c           | 8 +++++---
 cpukit/rtems/src/eventsurrender.c      | 8 +++++---
 cpukit/rtems/src/systemeventreceive.c  | 5 +++--
 cpukit/rtems/src/systemeventsend.c     | 5 +++--
 9 files changed, 30 insertions(+), 19 deletions(-)

diff --git a/cpukit/include/rtems/rtems/eventdata.h b/cpukit/include/rtems/rtems/eventdata.h
index 16ff7a3981..fa69a2a932 100644
--- a/cpukit/include/rtems/rtems/eventdata.h
+++ b/cpukit/include/rtems/rtems/eventdata.h
@@ -3,7 +3,8 @@
  *
  * @ingroup ClassicEventImpl
  *
- * @brief Classic Event Manager Data Structures
+ * @brief This header file provides the API used by the Application
+ *   Configuration to define the configured Thread Control Block (TCB).
  */
 
 /* COPYRIGHT (c) 1989-2008.
diff --git a/cpukit/include/rtems/rtems/eventimpl.h b/cpukit/include/rtems/rtems/eventimpl.h
index 21a4884493..141ea46082 100644
--- a/cpukit/include/rtems/rtems/eventimpl.h
+++ b/cpukit/include/rtems/rtems/eventimpl.h
@@ -3,7 +3,7 @@
  *
  * @ingroup ClassicEventImpl
  *
- * @brief Classic Event Manager Implementation
+ * @brief This header file provides interfaces used by the event implementation.
  */
 
 /*  COPYRIGHT (c) 1989-2008.
diff --git a/cpukit/rtems/src/eventmp.c b/cpukit/rtems/src/eventmp.c
index ee971a720a..a31476af74 100644
--- a/cpukit/rtems/src/eventmp.c
+++ b/cpukit/rtems/src/eventmp.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Event MP Support
- *  @ingroup ClassicEventMP
+ * @ingroup ClassicEventMP
+ *
+ * @brief This source file contains the implementation of the task event MPCI
+ *   support.
  */
 
 /*
diff --git a/cpukit/rtems/src/eventreceive.c b/cpukit/rtems/src/eventreceive.c
index c638ec543c..fc5886b524 100644
--- a/cpukit/rtems/src/eventreceive.c
+++ b/cpukit/rtems/src/eventreceive.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicEventSet Event Set
+ * @ingroup ClassicEventImpl
  *
- * @brief  Constant used to receive the set of currently pending events in
+ * @brief This source file contains the implementation of
+ *   rtems_event_receive().
  */
 
 /*
diff --git a/cpukit/rtems/src/eventseize.c b/cpukit/rtems/src/eventseize.c
index 8230959ec0..874c142c1a 100644
--- a/cpukit/rtems/src/eventseize.c
+++ b/cpukit/rtems/src/eventseize.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicEvent Events
+ * @ingroup ClassicEventImpl
  *
- * @brief Event Manager Initialization
+ * @brief This source file contains the implementation of
+ *   _Event_Seize() and the task event MPCI support system initialization.
  */
 
 /*
diff --git a/cpukit/rtems/src/eventsend.c b/cpukit/rtems/src/eventsend.c
index cfd091c96d..470b7f4601 100644
--- a/cpukit/rtems/src/eventsend.c
+++ b/cpukit/rtems/src/eventsend.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Sends an Event Set to the Target Task
- *  @ingroup ClassicEvent
+ * @ingroup ClassicEventImpl
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_event_send().
  */
 
 /*
diff --git a/cpukit/rtems/src/eventsurrender.c b/cpukit/rtems/src/eventsurrender.c
index 49f77d2663..6cdaafaa97 100644
--- a/cpukit/rtems/src/eventsurrender.c
+++ b/cpukit/rtems/src/eventsurrender.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Surrender Event
- *  @ingroup ClassicEvent
+ * @ingroup ClassicEventImpl
+ *
+ * @brief This source file contains the implementation of
+ *   _Event_Surrender().
  */
 
 /*
diff --git a/cpukit/rtems/src/systemeventreceive.c b/cpukit/rtems/src/systemeventreceive.c
index ee2526072d..30e5adcd2c 100644
--- a/cpukit/rtems/src/systemeventreceive.c
+++ b/cpukit/rtems/src/systemeventreceive.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicEventSystem
+ * @ingroup ClassicEventImpl
  *
- * @brief rtems_event_system_receive() implementation.
+ * @brief This source file contains the implementation of
+ *   rtems_event_system_receive().
  */
 
 /*
diff --git a/cpukit/rtems/src/systemeventsend.c b/cpukit/rtems/src/systemeventsend.c
index e939d7700a..6a83ec4726 100644
--- a/cpukit/rtems/src/systemeventsend.c
+++ b/cpukit/rtems/src/systemeventsend.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicEventSystem
+ * @ingroup ClassicEventImpl
  *
- * @brief rtems_event_system_send() implementation.
+ * @brief This source file contains the implementation of
+ *   rtems_event_system_send().
  */
 
 /*
-- 
2.26.2