convert fs publish to MQ
[oweals/gnunet.git] / src / include / gnunet_signal_lib.h
index 77a02f04a3e5568af716d281aef4870be4eb857a..08c72fb3a1bb0c3f21bee015ff1596fbf217f4c6 100644 (file)
@@ -1,6 +1,6 @@
 /*
      This file is part of GNUnet.
-     Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009 Christian Grothoff (and other contributing authors)
+     Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009 GNUnet e.V.
 
      GNUnet is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published
 */
 
 /**
- * @file include/gnunet_signal_lib.h
- * @brief functions related to signals
  * @author Christian Grothoff
+ *
+ * @file
+ * Functions related to signals
+ *
+ * @defgroup signal  Signal library
+ * Manage signal handlers.
+ * @{
  */
 
 #ifndef GNUNET_SIGNAL_LIB_H
@@ -41,6 +46,7 @@ extern "C"
  */
 struct GNUNET_SIGNAL_Context;
 
+
 /**
  * A signal handler.  Since different OSes have different signatures
  * for their handlers, the API only gives the most restrictive
@@ -49,7 +55,9 @@ struct GNUNET_SIGNAL_Context;
  * the implementation must guarantee that this handler is not called
  * for signals other than the one that it has been registered for.
  */
-typedef void (*GNUNET_SIGNAL_Handler) (void);
+typedef void
+(*GNUNET_SIGNAL_Handler) (void);
+
 
 /**
  * Install a signal handler that will be run if the
@@ -60,7 +68,9 @@ typedef void (*GNUNET_SIGNAL_Handler) (void);
  * @return context that can be used to restore, NULL on error
  */
 struct GNUNET_SIGNAL_Context *
-GNUNET_SIGNAL_handler_install (int signal, GNUNET_SIGNAL_Handler handler);
+GNUNET_SIGNAL_handler_install (int signal,
+                               GNUNET_SIGNAL_Handler handler);
+
 
 /**
  * Uninstall a previously installed signal hander.
@@ -92,4 +102,7 @@ GNUNET_SIGNAL_raise (const int sig);
 
 /* ifndef GNUNET_SIGNAL_LIB_H */
 #endif
+
+/** @} */  /* end of group */
+
 /* end of gnunet_signal_lib.h */