[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