@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -25,6 +20,13 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+/*! \file

+ * \brief Parser :: Allow header

+ *

+ * \ingroup parser

+ */

+

+

 #include <stdlib.h>

 #include <string.h>

 #include "../dprint.h"

@@ -34,11 +36,11 @@

 #include "msg_parser.h"

-/*

+/*! \brief

  * This method is used to parse Allow header.

  *

- * params: msg : sip msg

- * returns 0 on success,

+ * \params  msg : sip msg

+ * \return 0 on success,

  *        -1 on failure.

  */

 int parse_allow_header(struct hdr_field* _hf)

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -24,6 +19,13 @@

  * along with this program; if not, write to the Free Software 

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+

+/*! \file

+ * \brief Parser :: Allow header

+ *

+ * \ingroup parser

+ */

+

 #ifndef PARSE_ALLOW_H

 #define PARSE_ALLOW_H

@@ -32,7 +34,7 @@

 #include "msg_parser.h"

-/* 

+/*! \brief

  * casting macro for accessing Allow body 

  */

 #define get_allow_methods(p_msg)							\

@@ -40,26 +42,26 @@

 struct allow_body {

-	unsigned int allow;     /* allow mask for the current hdr */

-	unsigned int allow_all; /* allow mask for the all allow hdr - it's

+	unsigned int allow;     /*!< allow mask for the current hdr */

+	unsigned int allow_all; /*!< allow mask for the all allow hdr - it's

 							 * set only for the first hdr in sibling

 							 * list*/

 };

-/*

+/*! \brief

  * Parse all Allow HFs

  */

 int parse_allow(struct sip_msg *msg);

-/*

+/*! \brief

  * Parse Allow HF body

  */

 int parse_allow_header(struct hdr_field* _h);

-/*

+/*! \brief

  * Release memory

  */

 void free_allow_body(struct allow_body **ab);

@@ -29,6 +29,13 @@

  *  2008-05-22  Initial version, get_body_part() is introduced (Miklos)

  */

+/*! \file

+ * \brief Parser :: Body handling

+ *

+ * \ingroup parser

+ */

+

+

 #include "../trim.h"

 #include "parser_f.h"

 #include "parse_content.h"

@@ -36,7 +43,7 @@

 #include "keys.h"

 #include "parse_body.h"

-/* returns the value of boundary parameter from the Contect-Type HF */

+/*! \brief returns the value of boundary parameter from the Contect-Type HF */

 static inline int get_boundary_param(struct sip_msg *msg, str *boundary)

 {

 	str	s;

@@ -91,7 +98,7 @@ static inline int get_boundary_param(struct sip_msg *msg, str *boundary)

 	return 0;

 }

-/* search the next boundary in the buffer */

+/*! \brief search the next boundary in the buffer */

 static inline char *search_boundary(char *buf, char *buf_end, str *boundary)

 {

 	char *c;

@@ -110,7 +117,7 @@ static inline char *search_boundary(char *buf, char *buf_end, str *boundary)

 	return NULL;

 }

-/* extract the body of a part from a multipart SIP msg body */

+/*! \brief extract the body of a part from a multipart SIP msg body */

 inline static char *get_multipart_body(char *buf,

 					char *buf_end,

 					str *boundary,

@@ -155,13 +162,13 @@ error:

 }

-/* macros from parse_hname2.c */

+/*! \brief macros from parse_hname2.c */

 #define READ(val) \

 (*(val + 0) + (*(val + 1) << 8) + (*(val + 2) << 16) + (*(val + 3) << 24))

 #define LOWER_DWORD(d) ((d) | 0x20202020)

-/* Returns the pointer within the msg body to the given type/subtype,

+/*! \brief Returns the pointer within the msg body to the given type/subtype,

  * and sets the length of the body part.

  * The result can be the whole msg body, or a part of a multipart body.

  */

@@ -25,11 +25,17 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  *

  */

+/*! \file

+ * \brief Parser :: Body handling

+ *

+ * \ingroup parser

+ */

+

 #ifndef PARSE_BODY_H

 #define PARSE_BODY_H

-/* Returns the pointer within the msg body to the given type/subtype,

+/*! \brief Returns the pointer within the msg body to the given type/subtype,

  * and sets the length.

  * The result can be the whole msg body, or a part of a multipart body.

  */

@@ -11,11 +11,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -35,6 +30,12 @@

  *		some remaining characters (Miklos)

  */

+/*! \file

+ * \brief Parser :: Content part

+ *

+ * \ingroup parser

+ */

+

 #include <stdio.h>

 #include <stdlib.h>

@@ -53,15 +54,15 @@

 	( (isalpha((int)_c_)?(((_c_)|0x20)==(_cs_)):((_c_)==(_cs_)))==1 )

-/*

+/*! \brief

  * Node of the type's tree; this tree contains all the known types;

  */

 typedef struct type_node_s {

-	char c;                      /* char contained by this node */

-	unsigned char final;         /* says what mime type/subtype was detected

-	                              * if string ends at this node */

-	unsigned char nr_sons;       /* the number of sub-nodes */

-	int next;                    /* the next sibling node */

+	char c;                      /*!< char contained by this node */

+	unsigned char final;         /*!< says what mime type/subtype was detected

+	                              *!< if string ends at this node */

+	unsigned char nr_sons;       /*!< the number of sub-nodes */

+	int next;                    /*!< the next sibling node */

 }type_node_t;

@@ -379,9 +380,11 @@ error:

-/* returns: > 0 mime found

- *          = 0 hdr not found

- *          =-1 error */

+/*! \brief

+ * \return

+ *  	-   > 0 mime found

+ *      -   = 0 hdr not found

+ *      -   =-1 error */

 int parse_content_type_hdr( struct sip_msg *msg )

 {

 	char *end;

@@ -485,7 +488,8 @@ error:

 	return -1;

 }

-/* returns: > 0 ok

+/*! \brief

+ * returns: > 0 ok

  *          = 0 hdr not found

  *          = -1 error */

 int parse_accept_hdr( struct sip_msg *msg )

@@ -11,11 +11,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -26,6 +21,13 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+/*! \file

+ * \brief Parser :: Content

+ *

+ * \ingroup parser

+ */

+

+

 #ifndef _PARSE_CONTENT_H

 #define _PARSE_CONTENT_H

@@ -39,9 +41,10 @@ struct mime_type {

-/*

- * Mimes types/subtypes that are recognize

+/*! \name MimeTypes

+ * Mimes types/subtypes that are recognized

  */

+/*! { */

 #define TYPE_TEXT            1

 #define TYPE_MESSAGE         2

 #define TYPE_APPLICATION     3

@@ -66,34 +69,35 @@ struct mime_type {

 #define SUBTYPE_ALL          0xfe

 #define SUBTYPE_UNKNOWN      0xff

+/*! } */

-/* taken from PA module - will be useful here */

+/*! \brief taken from PA module - will be useful here */

 #define MIMETYPE(x_,y_) ((TYPE_##x_ << 16) | (SUBTYPE_##y_))

-/*

+/*! \brief

  * Maximum number of mimes allowed in Accept header 

  */

 #define MAX_MIMES_NR         128

-/*

+/*! \brief

  * returns the content-length value of a sip_msg as an integer

  */

 #define get_content_length(_msg_)   ((long)((_msg_)->content_length->parsed))

-/*

+/*! \brief

  * returns the content-type value of a sip_msg as an integer

  */

 #define get_content_type(_msg_)   ((int)(long)((_msg_)->content_type->parsed))

-/*

+/*! \brief

  * returns the accept values of a sip_msg as an null-terminated array

  * of integer

  */

 #define get_accept(_msg_) ((int*)((_msg_)->accept->parsed))

-/*

+/*! \brief

  * parse the body of the Content-Type header. It's value is also converted

  * as int.

  * Returns:   n (n>0)  : the found type

@@ -104,7 +108,7 @@ int parse_content_type_hdr( struct sip_msg *msg);

 int parse_accept_body(struct hdr_field *hdr);

-/*

+/*! \brief

  * parse the body of the Accept header. It's values are also converted

  * as an null-terminated array of ints.

  * Returns:   1 : OK

@@ -114,14 +118,14 @@ int parse_accept_body(struct hdr_field *hdr);

 int parse_accept_hdr( struct sip_msg *msg );

-/*

+/*! \brief

  *  parse the body of a Content_-Length header. Also tries to recognize the

  *  type specified by this header (see th above defines).

  *  Returns the first chr after the end of the header.

  */

 char* parse_content_length( char* buffer, char* end, int* len);

-/*

+/*! \brief

  * Sets the mime type from the body of a Content-Type header

  */

 char* decode_mime_type(char *start, char *end, unsigned int *mime_type);

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -30,6 +25,13 @@

  * 2003-01-22 zero-termination in CSeq eliminated (jiri)

  */

+/*! \file

+ * \brief Parser :: Cseq header field handling

+ *

+ * \ingroup parser

+ */

+

+

 #include "../comp_defs.h"

 #include "parse_cseq.h"

@@ -39,10 +41,6 @@

 #include "parse_methods.h"

 #include "../mem/mem.h"

-/*

- * Parse CSeq header field

- */

-

 /*BUGGY*/

 char* parse_cseq(char *buf, char* end, struct cseq_body* cb)

 {

@@ -25,6 +25,13 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+/*! \file

+ * \brief Parser :: Parse CSEQ header

+ *

+ * \ingroup parser

+ */

+

+

 #ifndef PARSE_CSEQ

 #define PARSE_CSEQ

@@ -33,24 +40,24 @@

 struct cseq_body{

-	int error;  /* Error code */

-	str number; /* CSeq number */

-	str method; /* Associated method */

-	unsigned int method_id; /* Associated method ID */

+	int error;  /*!< Error code */

+	str number; /*!< CSeq number */

+	str method; /*!< Associated method */

+	unsigned int method_id; /*!< Associated method ID */

 };

-/* casting macro for accessing CSEQ body */

+/*! \brief casting macro for accessing CSEQ body */

 #define get_cseq(p_msg) ((struct cseq_body*)(p_msg)->cseq->parsed)

-/*

+/*! \brief

  * Parse CSeq header field

  */

 char* parse_cseq(char *buf, char* end, struct cseq_body* cb);

-/*

+/*! \brief

  * Free all associated memory

  */

 void free_cseq(struct cseq_body* cb);

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -25,6 +20,13 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+/*! \file

+ * \brief Parser :: Date header

+ *

+ * \ingroup parser

+ */

+

+

 #include <string.h>

 #include "parse_date.h"

@@ -48,7 +50,7 @@ inline static int char2int (char *p, int *t)

 	return 0;

 }

-/*

+/*! \brief

  * Converts a RFC 1123 formatted date string to stuct tm

  */

 static int rfc1123totm (char *stime, struct tm *ttm ) {

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -25,6 +20,13 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+/*! \file

+ * \brief Parser :: Date header

+ *

+ * \ingroup parser

+ */

+

+

 #ifndef PARSE_DATE

 #define PARSE_DATE

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -25,6 +20,13 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+/*! \file

+ * \brief Parser :: Definitions

+ *

+ * \ingroup parser

+ */

+

+

 #ifndef PARSE_DEF_H

 #define PARSE_DEF_H

@@ -11,11 +11,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -29,6 +24,12 @@

  * 2003-09-09 created (bogdan)

  */

+/*! \file

+ * \brief Parser :: Content-Disposition header

+ *

+ * \ingroup parser

+ */

+

 #include <stdio.h>

 #include <stdlib.h>

@@ -41,7 +42,7 @@

-/* parse a string that supposed to be a disposition and fills up the structure

+/*! \brief parse a string that supposed to be a disposition and fills up the structure

  * Returns: -1 : error

  *           o : success */

 int parse_disposition( str *s, struct disposition *disp)

@@ -346,7 +347,7 @@ error:

-/* Frees the entire disposition structure (params + itself) */

+/*! \brief Frees the entire disposition structure (params + itself) */

 void free_disposition( struct disposition **disp)

 {

 	struct disposition_param *param;

@@ -363,7 +364,7 @@ void free_disposition( struct disposition **disp)

-/* looks inside the message, gets the Content-Disposition hdr, parse it, builds

+/*! \brief looks inside the message, gets the Content-Disposition hdr, parse it, builds

  * and fills a disposition structure for it what will be attached to hdr as

  * parsed link.

  * Returns:  -1 : error

@@ -413,7 +414,7 @@ error:

 }

-/* Prints recursive a disposition structure */

+/*! \brief Prints recursive a disposition structure */

 void print_disposition( struct disposition *disp)

 {

 	struct disposition_param *param;

@@ -11,11 +11,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -29,6 +24,13 @@

  * 2003-09-09 created (bogdan)

  */

+/*! \file

+ * \brief Parser :: Content-Disposition header

+ *

+ * \ingroup parser

+ */

+

+

 #ifndef _PARSE_DISPOSITION_H_

 #define _PARSE_DISPOSITION_H_

@@ -54,7 +56,7 @@ struct disposition {

 };

-/* looks inside the message, gets the Content-Disposition hdr, parse it, builds

+/*! \brief looks inside the message, gets the Content-Disposition hdr, parse it, builds

  * and fills a disposition structure for it what will be attached to hdr as

  * parsed link.

  * Returns:  -1 : error

@@ -64,16 +66,16 @@ struct disposition {

 int parse_content_disposition( struct sip_msg *msg );

-/* parse a string that supposed to be a disposition and fills up the structure

+/*! \brief parse a string that supposed to be a disposition and fills up the structure

  * Returns: -1 : error

  *           o : success */

 int parse_disposition( str *s, struct disposition *disp);

-/* Frees the entire disposition structure (params + itself) */

+/*! \brief Frees the entire disposition structure (params + itself) */

 void free_disposition( struct disposition **disp);

-/* Prints recursive a disposition structure */

+/*! \brief Prints recursive a disposition structure */

 void print_disposition( struct disposition *disp);

 #endif

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -24,6 +19,13 @@

  * along with this program; if not, write to the Free Software 

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+

+/*! \file

+ * \brief Parser :: Diversion header

+ * 

+ * \ingroup parser

+ */

+

 #include <stdlib.h>

 #include <string.h> 

@@ -34,7 +36,7 @@

 #include "parse_to.h"

 #include "msg_parser.h"

-/*

+/*! \brief

  * This method is used to parse DIVERSION header.

  *

  * params: msg : sip msg

@@ -78,7 +80,7 @@ int parse_diversion_header(struct sip_msg *msg)

 }

-/**

+/*! \brief

  * Get the value of a given diversion parameter

  */

 str *get_diversion_param(struct sip_msg *msg, str* name)

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -24,6 +19,13 @@

  * along with this program; if not, write to the Free Software 

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+

+/*! \file

+ * \brief Parser :: Diversion header

+ * 

+ * \ingroup parser

+ */

+

 #ifndef PARSE_DIVERSION_H

 #define PARSE_DIVERSION_H

@@ -31,16 +33,16 @@

 #include "msg_parser.h"

-/* casting macro for accessing Diversion body */

+/*! \brief casting macro for accessing Diversion body */

 #define get_diversion(p_msg)  ((struct to_body*)(p_msg)->diversion->parsed)

-/*

+/*! \brief

  * Diversion header field parser

  */

 int parse_diversion_header(struct sip_msg *msg);

-/**

+/*! \brief

  * Get the value of a given diversion parameter

  */

 str *get_diversion_param(struct sip_msg *msg, str* name);

@@ -2,10 +2,6 @@

  * $Id$

  *

  * Event header field body parser.

- * The parser was written for Presence Agent module only.

- * it recognize presence package only, no sub-packages, no parameters

- * It should be replaced by a more generic parser if sub-packages or

- * parameters should be parsed too.

  *

  * Copyright (C) 2001-2003 FhG Fokus

  *

@@ -16,11 +12,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -35,6 +26,17 @@

  * 2003-04-26 ZSW (jiri)

  */

+/*! \file

+ * \brief Parser :: Event header field body parser.

+ *

+ * The parser was written for Presence Agent module only.

+ * it recognize presence package only, no sub-packages, no parameters

+ * It should be replaced by a more generic parser if sub-packages or

+ * parameters should be parsed too.

+ *

+ * \ingroup parser

+ */

+

 #include "parse_event.h"

 #include "../mem/mem.h"    /* pkg_malloc, pkg_free */

@@ -141,7 +143,7 @@ int event_parser(char* s, int len, event_t* e)

 }

-/*

+/*! \brief

  * Parse Event header field body

  */

 int parse_event(struct hdr_field* _h)

@@ -171,7 +173,7 @@ int parse_event(struct hdr_field* _h)

 }

-/*

+/*! \brief

  * Free all memory

  */

 void free_event(event_t** _e)

@@ -184,7 +186,7 @@ void free_event(event_t** _e)

 }

-/*

+/*! \brief

  * Print structure, for debugging only

  */

 void print_event(event_t* e)

@@ -10,11 +10,6 @@

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version

  *

- * For a license to use the ser software under conditions

- * other than those described here, or to purchase support for this

- * software, please contact iptel.org by e-mail at the following addresses:

- *    info@iptel.org

- *

  * ser is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

@@ -25,6 +20,13 @@

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  */

+/*! \file

+ * \brief Parser :: Event header field body parser.

+ *

+ *

+ * \ingroup parser

+ */

+

 #ifndef PARSE_EVENT_H

 #define PARSE_EVENT_H

@@ -31,6 +31,14 @@

  * 2003-04-26 ZSW (jiri)

  */

+/*! \file

+ * \brief Parser :: Expires header field body parser.

+ *

+ *

+ * \ingroup parser

+ */

+

+

 #include "parse_expires.h"

 #include <stdio.h>          /* printf */

@@ -99,7 +107,7 @@ static inline int expires_parser(char* _s, int _l, exp_body_t* _e)

 }

-/*

+/*! \brief

  * Parse expires header field body

  */

 int parse_expires(struct hdr_field* _h)

@@ -129,7 +137,7 @@ int parse_expires(struct hdr_field* _h)

 }

-/*

+/*! \brief

  * Free all memory associated with exp_body_t

  */

 void free_expires(exp_body_t** _e)

@@ -139,7 +147,7 @@ void free_expires(exp_body_t** _e)

 }

-/*

+/*! \brief

  * Print exp_body_t content, for debugging only

  */