Changeset ace9358 in mainline

Timestamp:

2008-05-12T18:51:05Z (17 years ago)

Author:

Jakub Jermar <jakub@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

83512f21

Parents:

34b3ce3

Message:

Formatting improvements.

File:

• kernel/generic/src/synch/waitq.c (modified) (9 diffs)

kernel/generic/src/synch/waitq.c

@@ -61 +61 @@
  * Initialize wait queue.
  *
- * @param wq Pointer to wait queue to be initialized.
+ * @param wq            Pointer to wait queue to be initialized.
  */
 void waitq_initialize(waitq_t *wq)
@@ -72 +72 @@
 /** Handle timeout during waitq_sleep_timeout() call
  *
- * This routine is called when waitq_sleep_timeout() timeouts.
+ * This routine is called when waitq_sleep_timeout() times out.
  * Interrupts are disabled.
  *
@@ -80 +80 @@
  * timeout at all.
  *
- * @param data Pointer to the thread that called waitq_sleep_timeout().
+ * @param data          Pointer to the thread that called waitq_sleep_timeout().
  */
 void waitq_sleep_timed_out(void *data)
@@ -124 +124 @@
  * If the thread is not found sleeping, no action is taken.
  *
- * @param t Thread to be interrupted.
+ * @param t             Thread to be interrupted.
  */
 void waitq_interrupt_sleep(thread_t *t)
@@ -235 +235 @@
  * and interrupts disabled.
  *
- * @param wq Wait queue.
- *
- * @return Interrupt level as it existed on entry to this function.
+ * @param wq            Wait queue.
+ *
+ * @return              Interrupt level as it existed on entry to this function.
  */
 ipl_t waitq_sleep_prepare(waitq_t *wq)
@@ -273 +273 @@
  * lock is released.
  *
- * @param wq Wait queue.
- * @param rc Return code of waitq_sleep_timeout_unsafe().
- * @param ipl Interrupt level returned by waitq_sleep_prepare().
+ * @param wq            Wait queue.
+ * @param rc            Return code of waitq_sleep_timeout_unsafe().
+ * @param ipl           Interrupt level returned by waitq_sleep_prepare().
  */
 void waitq_sleep_finish(waitq_t *wq, int rc, ipl_t ipl)
@@ -293 +293 @@
  *
  * This function implements logic of sleeping in a wait queue.
- * This call must be preceeded by a call to waitq_sleep_prepare()
- * and followed by a call to waitq_slee_finish().
- *
- * @param wq See waitq_sleep_timeout().
- * @param usec See waitq_sleep_timeout().
- * @param flags See waitq_sleep_timeout().
- *
- * @return See waitq_sleep_timeout().
+ * This call must be preceded by a call to waitq_sleep_prepare()
+ * and followed by a call to waitq_sleep_finish().
+ *
+ * @param wq            See waitq_sleep_timeout().
+ * @param usec          See waitq_sleep_timeout().
+ * @param flags         See waitq_sleep_timeout().
+ *
+ * @return              See waitq_sleep_timeout().
  */
 int waitq_sleep_timeout_unsafe(waitq_t *wq, uint32_t usec, int flags)
@@ -385 +385 @@
  * timeout.
  *
- * @param wq    Pointer to wait queue.
- * @param mode  Wakeup mode.
+ * @param wq            Pointer to wait queue.
+ * @param mode          Wakeup mode.
  */
 void waitq_wakeup(waitq_t *wq, wakeup_mode_t mode)
@@ -406 +406 @@
  * assumes wq->lock is already locked and interrupts are already disabled.
  *
- * @param wq    Pointer to wait queue.
- * @param mode  If mode is WAKEUP_FIRST, then the longest waiting thread,
- *              if any, is woken up. If mode is WAKEUP_ALL, then all
- *              waiting threads, if any, are woken up. If there are no
- *              waiting threads to be woken up, the missed wakeup is
- *              recorded in the wait queue.
+ * @param wq            Pointer to wait queue.
+ * @param mode          If mode is WAKEUP_FIRST, then the longest waitingi
+ *                      thread, if any, is woken up. If mode is WAKEUP_ALL, then
+ *                      all waiting threads, if any, are woken up. If there are
+ *                      no waiting threads to be woken up, the missed wakeup is
+ *                      recorded in the wait queue.
  */
 void _waitq_wakeup_unsafe(waitq_t *wq, wakeup_mode_t mode)