X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=signal.c;h=f8be2f4612002214f669fa74ce92390866b0dc90;hp=0490a3a1f10a0897c311bc144ba7ce876652fb14;hb=93ea9f34dcb35755568e6c94f9b9445fd4d1984a;hpb=bdf3b7573b4a2ef6a84bdf34442063b32977f54e

diff --git a/signal.c b/signal.c
index 0490a3a1..f8be2f46 100644
--- a/signal.c
+++ b/signal.c
@@ -73,7 +73,7 @@ static void generic_signal_handler(int s)
  * one otherwise. If and only if the function returns one, the content of \a
  * pid is meaningful.
  *
- * \sa waitpid(2)
+ * \sa waitpid(2).
  */
 int para_reap_child(pid_t *pid)
 {
@@ -110,12 +110,15 @@ void para_reap_children(void)
 }
 
 /**
- * wrapper around signal(2)
- * \param sig the number of the signal to catch
+ * Wrapper around signal(2).
+ *
+ * \param sig The number of the signal to catch.
  *
  * This installs the generic signal handler for the given signal.
+ *
  * \return This function returns 1 on success and \p -E_SIGNAL_SIG_ERR on errors.
- * \sa signal(2)
+ *
+ * \sa signal(2).
  */
 int para_install_sighandler(int sig)
 {
@@ -152,7 +155,7 @@ int para_next_signal(void)
 }
 
 /**
- * Close the signal pipe.
+ * Close the write end of the signal pipe.
  */
 void para_signal_shutdown(void)
 {