posix: Doxygen Enhancement Task #9

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

cpukit/posix/src/aio_misc.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Actual request being processed
+ * @ingroup POSIX
+ */
+
 /*
  * Copyright 2010-2011, Alin Rus <alin.codejunkie@gmail.com> 
  * 

cpukit/posix/src/aio_return.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Final return status for Asynchronous I/O request pointed to by aiobcp
+ * @ingroup POSIX
+ */
+
 /*
  * Copyright 2010, Alin Rus <alin.codejunkie@gmail.com> 
  * 

cpukit/posix/src/alarm.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief System Generates Signal for process after realtime seconds elapsed
+ * @ingroup POSIX
+ */
+
 /*
  *  3.4.1 Schedule Alarm, P1003.1b-1993, p. 79
  */

cpukit/posix/src/barrierattrdestroy.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function shall Destroy a Barrier Attribues Object
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/clockgetenableattr.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Clock get Enable Attribute Access
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/clockgetres.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Returns the Resolution of any Clock
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/execv.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Inoperable implementation of execv for POSIX threads
+ * @ingroup POSIX
+ */
+
 /*
  *  execv() - POSIX 1003.1b 3.1.2
  *

cpukit/posix/src/keydelete.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Deletes Thread-specific Data Key Previously Returned by keycreate.c
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/mqueuesendsupp.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief POSIX Message Queue and Send Support
+ * @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/mutexattrgettype.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function gets the Mutex Type Attribute
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2009.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/mutexlock.c

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

cpukit/posix/src/pbarrierinit.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Call to Function Enables Reinitializing of the Barrier
+ * @ingroup POSIX
+ */
+
 /*
  *  POSIX Barrier Manager -- Initialize a Barrier Instance
  *

cpukit/posix/src/pspininit.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief POSIX Function Initializes a Spinlock Instance
+ * @ingroup POSIX
+ */
+
 /*
  *  POSIX Spinlock Manager -- Initialize a Spinlock Instance
  *

cpukit/posix/src/pthreadattrsetinheritsched.c

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

cpukit/posix/src/pthreadcreate.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Starts a New Thread in The Calling Process
+ * @ingroup POSIX
+ */
+
 /*
  *  16.1.2 Thread Creation, P1003.1c/Draft 10, p. 144
  */

cpukit/posix/src/rwlockattrinit.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Initialises a RWLock Attributes object attr with the default value
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/sched_getscheduler.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Returns Scheduling Policy of the process specified by pid
+ * @ingroup POSIX
+ */
+
 /*
  *  13.3.4 Get Scheduling Policy, P1003.1b-1993, p. 256
  *

cpukit/posix/src/semaphore.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief POSIX Function Initializes Semaphore Manager
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2008.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/semopen.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Function Creates New POSIX semaphore or Opens an existing Semaphore
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).

cpukit/posix/src/sigsuspend.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Replacing signal mask with *sigmask and suspending calling process
+ * @ingroup POSIX
+ */
+
 /*
  *  3.3.7 Wait for a Signal, P1003.1b-1993, p. 75
  *