X-Git-Url: http://git.pk910.de/?a=blobdiff_plain;f=include%2Fircd_handler.h;h=23318124a92d65b444c950890c01f4c999db1cf7;hb=refs%2Fheads%2Fupstream-ssl;hp=6201811df75b96030fbd9fe805e60da5dafcf31b;hpb=ae91ef6320f611af74e70a0db2620c338fbaa7d5;p=ircu2.10.12-pk.git

diff --git a/include/ircd_handler.h b/include/ircd_handler.h
index 6201811..2331812 100644
--- a/include/ircd_handler.h
+++ b/include/ircd_handler.h
@@ -16,8 +16,10 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- *
- * $Id$
+ */
+/** @file
+ * @brief Message handler types and definitions.
+ * @version $Id$
  */
 #ifndef INCLUDED_ircd_handler_h
 #define INCLUDED_ircd_handler_h
@@ -27,24 +29,24 @@ struct Client;
 /*
  * MessageHandler
  */
+/** Enumerated type for client message handlers. */
 typedef enum HandlerType {
-  UNREGISTERED_HANDLER,
-  CLIENT_HANDLER,
-  SERVER_HANDLER,
-  OPER_HANDLER,
-  SERVICE_HANDLER,
-  LAST_HANDLER_TYPE
+  UNREGISTERED_HANDLER, /**< Used for unregistered clients. */
+  CLIENT_HANDLER,       /**< Used for local users. */
+  SERVER_HANDLER,       /**< Used for server conections. */
+  OPER_HANDLER,         /**< Used for IRC operators. */
+  SERVICE_HANDLER,      /**< Used for services connections. */
+  LAST_HANDLER_TYPE     /**< NUmber of handler types. */
 } HandlerType;
 
-/*
- * MessageHandler function
- * Params:
- * struct Client* cptr   - connection message originated from
- * struct Client* sptr   - source of message, may be different from cptr
- * int            parc   - parameter count
- * char*          parv[] - parameter vector
+/**
+ * MessageHandler function.
+ * @param[in] cptr Client that sent us the message.
+ * @param[in] sptr Original source of message.
+ * @param[in] parc Number of arguments.
+ * @param[in] parv Argument vector.
  */
-typedef int (*MessageHandler)(struct Client*, struct Client*, int, char*[]);
+typedef int (*MessageHandler)(struct Client* cptr, struct Client* sptr, int parc, char*parv[]);
 
 
 #endif /* INCLUDED_ircd_handler_h */