Doxygen'ify parse.h

diff --git a/src/ngircd/parse.h b/src/ngircd/parse.h
index 3acab7d53fbf25d3e8a0b700e94af714ec7d8ac1..0c6f8a66d07e4d299f4bb66025c3aec3fae7ee6b 100644 (file)
--- a/src/ngircd/parse.h
+++ b/src/ngircd/parse.h
@@ -19,22 +19,24 @@
 
 #include "portab.h"
 
-typedef struct _REQUEST                        /* vgl. RFC 2812, 2.3 */
+/** A single IRC request ("command"). See RFC 2812 section 2.3 for details. */
+typedef struct _REQUEST
 {
-       char *prefix;                   /* Prefix */
-       char *command;                  /* IRC-Befehl */
-       char *argv[15];                 /* Parameter (max. 15: 0..14) */
-       int argc;                       /* Anzahl vorhandener Parameter */
+       char *prefix;                   /**< Prefix */
+       char *command;                  /**< IRC command */
+       char *argv[15];                 /**< Parameters, at most 15 (0..14) */
+       int argc;                       /**< Number of given paramaters */
 } REQUEST;
 
-
+/** IRC command handling structure */
 typedef struct _COMMAND
 {
-       const char *name;               /* command name */
+       const char *name;               /**< Command name */
        bool (*function) PARAMS(( CLIENT *Client, REQUEST *Request ));
-       CLIENT_TYPE type;               /* valid client types (bit mask) */
-       long lcount, rcount;            /* number of local and remote calls */
-       long bytes;                     /* number of bytes created */
+                                       /**< Function to handle this command */
+       CLIENT_TYPE type;               /**< Valid client types (bit mask) */
+       long lcount, rcount;            /**< Number of local and remote calls */
+       long bytes;                     /**< Number of bytes created */
 } COMMAND;
 
 GLOBAL bool Parse_Request PARAMS((CONN_ID Idx, char *Request ));