posix: Doxygen Enhancement Task #2

http://www.google-melange.com/gci/task/view/google/gci2012/7988213

1 files changed, 7 insertions, 17 deletions

diff --git a/cpukit/posix/src/mqueuenotify.c b/cpukit/posix/src/mqueuenotify.c
index 9909fae4fa..5387335c33 100644
--- a/cpukit/posix/src/mqueuenotify.c
+++ b/cpukit/posix/src/mqueuenotify.c
@@ -1,16 +1,11 @@
-/*
- *  NOTE:  The structure of the routines is identical to that of POSIX
- *         Message_queues to leave the option of having unnamed message
- *         queues at a future date.  They are currently not part of the
- *         POSIX standard but unnamed message_queues are.  This is also
- *         the reason for the apparently unnecessary tracking of
- *         the process_shared attribute.  [In addition to the fact that
- *         it would be trivial to add pshared to the mq_attr structure
- *         and have process private message queues.]
- *
- *         This code ignores the O_RDONLY/O_WRONLY/O_RDWR flag at open
- *         time.
+/**
+ * @file
  *
+ * @brief Notify Process that a Message is Available on a Queue
+ * @ingroup POSIX_MQUEUE
+ */
+
+/*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).
  *
@@ -57,11 +52,6 @@ static void _POSIX_Message_queue_Notify_handler(
   _CORE_message_queue_Set_notify( &the_mq->Message_queue, NULL, NULL );
 }
 
-/*
- *  15.2.6 Notify Process that a Message is Available on a Queue,
- *         P1003.1b-1993, p. 280
- */
-
 int mq_notify(
   mqd_t                  mqdes,
   const struct sigevent *notification