[rtems commit] posix: Doxygen Enhancement Task #3

Gedare Bloom gedare at rtems.org
Wed Dec 19 14:44:39 UTC 2012


Module:    rtems
Branch:    master
Commit:    9889d5172446acbc69b97fc74a44449c4d2b5351
Changeset: http://git.rtems.org/rtems/commit/?id=9889d5172446acbc69b97fc74a44449c4d2b5351

Author:    Ayush Awasthi <kolaveridi87 at gmail.com>
Date:      Wed Dec 19 09:49:08 2012 -0500

posix: Doxygen Enhancement Task #3

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

---

 cpukit/posix/src/aio_error.c                    |    7 +++++++
 cpukit/posix/src/aio_fsync.c                    |    7 +++++++
 cpukit/posix/src/cancelrun.c                    |    7 +++++++
 cpukit/posix/src/condattrsetpshared.c           |    7 +++++++
 cpukit/posix/src/conddefaultattributes.c        |    7 +++++++
 cpukit/posix/src/fork.c                         |    7 +++++++
 cpukit/posix/src/kill_r.c                       |    7 +++++++
 cpukit/posix/src/killinfo.c                     |    7 +++++++
 cpukit/posix/src/mutexattrgetpshared.c          |    7 +++++++
 cpukit/posix/src/mutexgetprioceiling.c          |    7 +++++++
 cpukit/posix/src/mutexsetprioceiling.c          |    7 +++++++
 cpukit/posix/src/prwlockinit.c                  |    7 +++++++
 cpukit/posix/src/pthreadattrgetschedparam.c     |    7 +++++++
 cpukit/posix/src/pthreadattrsetstackaddr.c      |    7 +++++++
 cpukit/posix/src/pthreadsigmask.c               |    7 +++++++
 cpukit/posix/src/ptimer.c                       |    7 +++++++
 cpukit/posix/src/sched_rr_get_interval.c        |    7 +++++++
 cpukit/posix/src/semaphoretranslatereturncode.c |    7 +++++++
 cpukit/posix/src/seminit.c                      |    7 +++++++
 cpukit/posix/src/sigaction.c                    |    7 +++++++
 20 files changed, 140 insertions(+), 0 deletions(-)

diff --git a/cpukit/posix/src/aio_error.c b/cpukit/posix/src/aio_error.c
index 1765f21..e29c836 100644
--- a/cpukit/posix/src/aio_error.c
+++ b/cpukit/posix/src/aio_error.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Returns the error status for the Asynchronous I/O request
+ * @ingroup POSIX
+ */
+
 /*
  * Copyright 2010, Alin Rus <alin.codejunkie at gmail.com> 
  * 
diff --git a/cpukit/posix/src/aio_fsync.c b/cpukit/posix/src/aio_fsync.c
index 7021082..0330076 100644
--- a/cpukit/posix/src/aio_fsync.c
+++ b/cpukit/posix/src/aio_fsync.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Syncing of all Outstanding Asynchronous I/O Operations
+ * @ingroup POSIX
+ */
+
 /*
  * Copyright 2010, Alin Rus <alin.codejunkie at gmail.com> 
  * 
diff --git a/cpukit/posix/src/cancelrun.c b/cpukit/posix/src/cancelrun.c
index 9174928..39a8de7 100644
--- a/cpukit/posix/src/cancelrun.c
+++ b/cpukit/posix/src/cancelrun.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Executes a thread's cancellation handlers
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2008.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/condattrsetpshared.c b/cpukit/posix/src/condattrsetpshared.c
index f010038..4e00c92 100644
--- a/cpukit/posix/src/condattrsetpshared.c
+++ b/cpukit/posix/src/condattrsetpshared.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Initialize Condition Variable Attributes
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/conddefaultattributes.c b/cpukit/posix/src/conddefaultattributes.c
index 7cca0bc..32ec64d 100644
--- a/cpukit/posix/src/conddefaultattributes.c
+++ b/cpukit/posix/src/conddefaultattributes.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Condition variable Attributes structure
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/fork.c b/cpukit/posix/src/fork.c
index ec24f05..4cfccf4 100644
--- a/cpukit/posix/src/fork.c
+++ b/cpukit/posix/src/fork.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Inoperable implementation of fork() for POSIX threads
+ * @ingroup POSIX
+ */
+
 /*
  *  fork() - POSIX 1003.1b 3.1.1
  *
diff --git a/cpukit/posix/src/kill_r.c b/cpukit/posix/src/kill_r.c
index 301c060..739fed7 100644
--- a/cpukit/posix/src/kill_r.c
+++ b/cpukit/posix/src/kill_r.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Send a Signal to a Process
+ * @ingroup POSIX
+ */
+
 /*
  *  3.3.2 Send a Signal to a Process, P1003.1b-1993, p. 68
  *
diff --git a/cpukit/posix/src/killinfo.c b/cpukit/posix/src/killinfo.c
index 95a2459..b7b556d 100644
--- a/cpukit/posix/src/killinfo.c
+++ b/cpukit/posix/src/killinfo.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Send a Signal to a Process
+ * @ingroup POSIX
+ */
+
 /*
  *  kill() support routine
  *
diff --git a/cpukit/posix/src/mutexattrgetpshared.c b/cpukit/posix/src/mutexattrgetpshared.c
index beeae9b..d32ef83 100644
--- a/cpukit/posix/src/mutexattrgetpshared.c
+++ b/cpukit/posix/src/mutexattrgetpshared.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Obtaining process-shared Attribute Value from the Attributes Object
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/mutexgetprioceiling.c b/cpukit/posix/src/mutexgetprioceiling.c
index a0390b9..21287e2 100644
--- a/cpukit/posix/src/mutexgetprioceiling.c
+++ b/cpukit/posix/src/mutexgetprioceiling.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Returns the Current Priority Ceiling of the Mutex
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/mutexsetprioceiling.c b/cpukit/posix/src/mutexsetprioceiling.c
index d873805..b11c457 100644
--- a/cpukit/posix/src/mutexsetprioceiling.c
+++ b/cpukit/posix/src/mutexsetprioceiling.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Changes the Priority Ceiling of a Mutex and Releases it
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2009.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/prwlockinit.c b/cpukit/posix/src/prwlockinit.c
index 2cba7d6..61825fe 100644
--- a/cpukit/posix/src/prwlockinit.c
+++ b/cpukit/posix/src/prwlockinit.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Allocate resources to use the read-write lock and Initialize it
+ * @ingroup POSIX
+ */
+
 /*
  *  POSIX RWLock Manager -- Destroy a RWLock Instance
  *
diff --git a/cpukit/posix/src/pthreadattrgetschedparam.c b/cpukit/posix/src/pthreadattrgetschedparam.c
index 7ec55a3..eee962f 100644
--- a/cpukit/posix/src/pthreadattrgetschedparam.c
+++ b/cpukit/posix/src/pthreadattrgetschedparam.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Returns Scheduling Parameter Attributes of Thread Attributes Object
+ * @ingroup POSIX
+ */
+
 /*
  *  13.5.1 Thread Creation Scheduling Attributes, P1003.1c/Draft 10, p. 120
  *
diff --git a/cpukit/posix/src/pthreadattrsetstackaddr.c b/cpukit/posix/src/pthreadattrsetstackaddr.c
index 3c3b2b0..1696bb9 100644
--- a/cpukit/posix/src/pthreadattrsetstackaddr.c
+++ b/cpukit/posix/src/pthreadattrsetstackaddr.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Sets the Thread Creation stackaddr Attribute in the attr Object
+ * @ingroup POSIX
+ */
+
 /*
  *  16.1.1 Thread Creation Attributes, P1003.1c/Draft 10, p, 140
  *
diff --git a/cpukit/posix/src/pthreadsigmask.c b/cpukit/posix/src/pthreadsigmask.c
index b424dab..9d47e44 100644
--- a/cpukit/posix/src/pthreadsigmask.c
+++ b/cpukit/posix/src/pthreadsigmask.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Examine and/or change the calling thread's signal mask
+ * @ingroup POSIX
+ */
+
 /*
  *  3.3.5 Examine and Change Blocked Signals, P1003.1b-1993, p. 73
  *
diff --git a/cpukit/posix/src/ptimer.c b/cpukit/posix/src/ptimer.c
index 2e35267..1d5ac62 100644
--- a/cpukit/posix/src/ptimer.c
+++ b/cpukit/posix/src/ptimer.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Process Timer
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2008.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/sched_rr_get_interval.c b/cpukit/posix/src/sched_rr_get_interval.c
index 5fb2774..b73f60f 100644
--- a/cpukit/posix/src/sched_rr_get_interval.c
+++ b/cpukit/posix/src/sched_rr_get_interval.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Limits for Scheduling Parameter
+ * @ingroup POSIX
+ */
+
 /*
  *  13.3.6 Get Scheduling Parameter Limits, P1003.1b-1993, p. 258
  *
diff --git a/cpukit/posix/src/semaphoretranslatereturncode.c b/cpukit/posix/src/semaphoretranslatereturncode.c
index 2f1af1d..2c54b9f 100644
--- a/cpukit/posix/src/semaphoretranslatereturncode.c
+++ b/cpukit/posix/src/semaphoretranslatereturncode.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief POSIX Semaphore Code Translation Error
+ * @ingroup POSIX
+ */
+
 /*
  *  POSIX Semaphore Error Translation
  *
diff --git a/cpukit/posix/src/seminit.c b/cpukit/posix/src/seminit.c
index 42dd040..be7056d 100644
--- a/cpukit/posix/src/seminit.c
+++ b/cpukit/posix/src/seminit.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Initializing of an Unnamed Semaphore
+ * @ingroup POSIX
+ */
+
 /*
  *  COPYRIGHT (c) 1989-2007.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/posix/src/sigaction.c b/cpukit/posix/src/sigaction.c
index 9fb04a0..b290655 100644
--- a/cpukit/posix/src/sigaction.c
+++ b/cpukit/posix/src/sigaction.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Allows calling process to examine action of a Specific Signal
+ * @ingroup POSIX
+ */
+
 /*
  *  3.3.4 Examine and Change Signal Action, P1003.1b-1993, p. 70
  *




More information about the vc mailing list