From 7f1987666fa9ffef6cfff0ceaf826c297a2d0de1 Mon Sep 17 00:00:00 2001
From: Mano Stienen <manostienen@gmail.com>
Date: Fri, 11 Jul 2008 05:02:47 +0200
Subject: [PATCH] moved documentation from rwlock.c to .h

---
 src/lib/rwlock.c | 33 ++++-----------------------------
 src/lib/rwlock.h | 33 +++++++++++++++++++++++++++++----
 2 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/src/lib/rwlock.c b/src/lib/rwlock.c
index 077ff9766..71e3c9dc8 100644
--- a/src/lib/rwlock.c
+++ b/src/lib/rwlock.c
@@ -34,11 +34,6 @@ LUMIERA_ERROR_DEFINE(RWLOCK_WLOCK, "wlock");
  */
 
 
-/**
- * Initialize a rwlock
- * @param self is a pointer to the rwlock to be initialized
- * @return self as given
- */
 LumieraRWLock
 lumiera_rwlock_init (LumieraRWLock self)
 {
@@ -49,11 +44,7 @@ lumiera_rwlock_init (LumieraRWLock self)
   return self;
 }
 
-/**
- * destroy a rwlock
- * @param self is a pointer to the rwlock to be initialized
- * @return self on success or NULL at error
- */
+
 LumieraRWLock
 lumiera_rwlock_destroy (LumieraRWLock self)
 {
@@ -68,13 +59,7 @@ lumiera_rwlock_destroy (LumieraRWLock self)
 
 
 
-/**
- * initialize a rwlockacquirer state
- * @param self rwlockacquirer to be initialized, must be an automatic variable
- * @param rwlock associated rwlock
- * @param state initial state of the mutex, either LUMIERA_RDLOCKED, LUMIERA_WRLOCKED or LUMIERA_UNLOCKED
- * @return self as given or NULL on error
- */
+
 LumieraRWLockacquirer
 lumiera_rwlockacquirer_init (LumieraRWLockacquirer self, LumieraRWLock rwlock, enum lumiera_lockstate state)
 {
@@ -118,12 +103,7 @@ lumiera_rwlockacquirer_init (LumieraRWLockacquirer self, LumieraRWLock rwlock, e
 }
 
 
-/**
- * readlock the rwlock.
- * must not already be locked
- * @param self rwlockacquirer associated with a rwlock
- * @return self as given or NULL on error
- */
+
 LumieraRWLockacquirer
 lumiera_rwlockacquirer_rdlock (LumieraRWLockacquirer self)
 {
@@ -149,12 +129,7 @@ lumiera_rwlockacquirer_rdlock (LumieraRWLockacquirer self)
 }
 
 
-/**
- * writelock the rwlock.
- * must not already be locked
- * @param self rwlockacquirer associated with a rwlock
- * @return self as given or NULL on error
- */
+
 LumieraRWLockacquirer
 lumiera_rwlockacquirer_wrlock (LumieraRWLockacquirer self)
 {
diff --git a/src/lib/rwlock.h b/src/lib/rwlock.h
index d58627dda..c51f78076 100644
--- a/src/lib/rwlock.h
+++ b/src/lib/rwlock.h
@@ -55,11 +55,19 @@ struct lumiera_rwlock_struct
 typedef struct lumiera_rwlock_struct lumiera_rwlock;
 typedef lumiera_rwlock* LumieraRWLock;
 
-
+/**
+ * Initialize a rwlock
+ * @param self is a pointer to the rwlock to be initialized
+ * @return self as given
+ */
 LumieraRWLock
 lumiera_rwlock_init (LumieraRWLock self);
 
-
+/**
+ * destroy a rwlock
+ * @param self is a pointer to the rwlock to be initialized
+ * @return self on success or NULL at error
+ */
 LumieraRWLock
 lumiera_rwlock_destroy (LumieraRWLock self);
 
@@ -88,14 +96,31 @@ lumiera_rwlockacquirer_ensureunlocked (LumieraRWLockacquirer self)
 #define lumiera_rwlockacquirer \
 lumiera_rwlockacquirer NOBUG_CLEANUP(lumiera_rwlockacquirer_ensureunlocked)
 
-
+/**
+ * initialize a rwlockacquirer state
+ * @param self rwlockacquirer to be initialized, must be an automatic variable
+ * @param rwlock associated rwlock
+ * @param state initial state of the mutex, either LUMIERA_RDLOCKED, LUMIERA_WRLOCKED or LUMIERA_UNLOCKED
+ * @return self as given or NULL on error
+ */
 LumieraRWLockacquirer
 lumiera_rwlockacquirer_init (LumieraRWLockacquirer self, LumieraRWLock rwlock, enum lumiera_lockstate state);
 
+/**
+ * readlock the rwlock.
+ * must not already be locked
+ * @param self rwlockacquirer associated with a rwlock
+ * @return self as given or NULL on error
+ */
 LumieraRWLockacquirer
 lumiera_rwlockacquirer_rdlock (LumieraRWLockacquirer self);
 
-
+/**
+ * writelock the rwlock.
+ * must not already be locked
+ * @param self rwlockacquirer associated with a rwlock
+ * @return self as given or NULL on error
+ */
 LumieraRWLockacquirer
 lumiera_rwlockacquirer_wrlock (LumieraRWLockacquirer self);