posix: Doxygen Enhancement Task #6

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

cpukit/posix/src/cleanuppop.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Removes Routine from Top of Calling Thread's stack and Invoke it 
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2008.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/execl.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Process will get Executed and then Terminated by execl
+ * @ingroup POSIX
+ */
+
 /*
  *  execl() - POSIX 1003.1b 3.1.2
  *

cpukit/posix/src/keyfreememory.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief POSIX Function Keys Free Memory 
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2010.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/lio_listio.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Initiates a List of I/O Requests with Single Function Call 
+ * @ingroup POSIX
+ */
+
 /*
  *  6.7.4 List Directed I/O, P1003.1b-1993, p. 158
  *

cpukit/posix/src/mqueuesend.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Adds Message Pointed by msg_ptr to Message Queue Reffered by mqdes 
+ * @ingroup POSIX
+ */
+
 /*
  *  NOTE:  The structure of the routines is identical to that of POSIX
  *         Message_queues to leave the option of having unnamed message

cpukit/posix/src/mutexlocksupp.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Support Call to function Enables Locking of Mutex Object 
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/prwlocktimedwrlock.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function applies a Write lock to RWLock referenced by rwlock 
+ * @ingroup POSIX
+ */
+
 /*
  *  POSIX RWLock Manager -- Attempt to Obtain a Write Lock on a RWLock Instance
  *

cpukit/posix/src/pspinunlock.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Unlocks a Spin Lock Object
+ * @ingroup POSIX
+ */
+
 /*
  *  POSIX Spinlock Manager -- Wait at a Spinlock
  *

cpukit/posix/src/pthreadattrgetscope.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function gets the Contentionscope Attribute in the attr object 
+ * @ingroup POSIX
+ */
+
 /*
  *  13.5.1 Thread Creation Scheduling Attributes, P1003.1c/Draft 10, p. 120
  *

cpukit/posix/src/pthreadattrgetstack.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Gets the Thread Creation Stack Attributes in the attr 
+ * @ingroup POSIX
+ */
+
 /*
  *  16.1.1 Thread Creation Attributes
  *

cpukit/posix/src/pthreadattrsetstacksize.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Sets the Thread Creation Stacksize Attribute in the attr object 
+ * @ingroup POSIX
+ */
+
 /*
  *  16.1.1 Thread Creation Attributes, P1003.1c/Draft 10, p, 140
  *

cpukit/posix/src/pthreadjoin.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Suspends Execution of Calling Thread until Target Thread Terminates 
+ * @ingroup POSIX
+ */
+
 /*
  *  16.1.3 Wait for Thread Termination, P1003.1c/Draft 10, p. 147
  *

cpukit/posix/src/pthreadonce.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Call to function by Thread will call init_routine with no Arguments
+ * @ingroup POSIX
+ */
+
 /*
  *  16.1.8 Dynamic Package Initialization, P1003.1c/Draft 10, p. 154
  *

cpukit/posix/src/rwlockattrdestroy.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Destroys a read-write lock Attributes object 
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/sched_setparam.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Sets Scheduling Parameters Associated with Scheduling Policies 
+ * @ingroup POSIX
+ */
+
 /*
  *  13.3.1 Set Scheduling Parameters, P1003.1b-1993, p. 252
  *

cpukit/posix/src/semaphorecreatesupp.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function does Actual creation and Initialization of POSIX Semaphore 
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2009.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/setcanceltype.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Sets the Cancelability Type of Calling Thread to value given in type 
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2009.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/signal_2.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief POSIX Function Installs signal Handler
+ * @ingroup POSIX
+ */
+
 /*
  *  signal(2) - Install signal handler
  *

cpukit/posix/src/timergettime.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Fetches State of POSIX Per-Process Timers
+ * @ingroup POSIX
+ */
+
 /*
  *  14.2.4 Per-Process Timers, P1003.1b-1993, p. 267
  *

cpukit/posix/src/timersettime.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Arms or Disarms the Timer Identified by timerid 
+ * @ingroup POSIX
+ */
+
 /*
  *  14.2.4 Per-Process Timers, P1003.1b-1993, p. 267
  *