httpd-apreq-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j...@apache.org
Subject cvs commit: httpd-apreq-2/src groups.dox.in Makefile.am apreq.h apreq_cookie.h apreq_env.c apreq_env.h apreq_params.h apreq_version.h
Date Wed, 23 Jun 2004 02:22:29 GMT
joes        2004/06/22 19:22:29

  Modified:    .        CHANGES FAQ README STATUS configure.ac
               build    dox.foot dox.head doxygen.conf.in version_check.pl
               env      mod_apreq.c
               src      Makefile.am apreq.h apreq_cookie.h apreq_env.c
                        apreq_env.h apreq_params.h apreq_version.h
  Added:       src      groups.dox.in
  Log:
  Large-scale doxygen cleanups: add src/groups.dox.in to move doxygen formatting instructions
out of the header files.  Document the new directives for mod_apreq, and have doxygen build
manpages.  The manpages are currently unsuitable for installed documentation.
  
  Revision  Changes    Path
  1.43      +1 -1      httpd-apreq-2/CHANGES
  
  Index: CHANGES
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/CHANGES,v
  retrieving revision 1.42
  retrieving revision 1.43
  diff -u -r1.42 -r1.43
  --- CHANGES	21 Jun 2004 18:32:24 -0000	1.42
  +++ CHANGES	23 Jun 2004 02:22:28 -0000	1.43
  @@ -1,4 +1,4 @@
  -/** @page CHANGES
  +/** @page apreq_changes CHANGES
   @brief List of major changes.
   
   @section v2_04_dev Changes with libapreq2-2.04-dev
  
  
  
  1.2       +1 -1      httpd-apreq-2/FAQ
  
  Index: FAQ
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/FAQ,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- FAQ	21 Jun 2004 18:32:24 -0000	1.1
  +++ FAQ	23 Jun 2004 02:22:28 -0000	1.2
  @@ -1,4 +1,4 @@
  -/** @page FAQ
  +/** @page apreq_faq FAQ
   
   The FAQ ...
   
  
  
  
  1.8       +1 -1      httpd-apreq-2/README
  
  Index: README
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/README,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- README	14 Jun 2004 19:16:00 -0000	1.7
  +++ README	23 Jun 2004 02:22:28 -0000	1.8
  @@ -1,5 +1,5 @@
   
  -                    Apache HTTP Request Library
  +                    Apache HTTP Server Request Library
   
     What is it?
     -----------
  
  
  
  1.55      +2 -2      httpd-apreq-2/STATUS
  
  Index: STATUS
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/STATUS,v
  retrieving revision 1.54
  retrieving revision 1.55
  diff -u -r1.54 -r1.55
  --- STATUS	19 Jun 2004 20:03:59 -0000	1.54
  +++ STATUS	23 Jun 2004 02:22:28 -0000	1.55
  @@ -1,5 +1,5 @@
   Last modified at [$Date$]   -*-text-*-
  -/** @page STATUS
  +/** @page apreq_status STATUS
   
        2.04-dev under development
   
  
  
  
  1.20      +2 -1      httpd-apreq-2/configure.ac
  
  Index: configure.ac
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/configure.ac,v
  retrieving revision 1.19
  retrieving revision 1.20
  diff -u -r1.19 -r1.20
  --- configure.ac	21 Jun 2004 18:32:24 -0000	1.19
  +++ configure.ac	23 Jun 2004 02:22:28 -0000	1.20
  @@ -32,6 +32,7 @@
   dnl Checks for library functions.
   
   AC_APREQ
  -AC_CONFIG_FILES([Makefile src/Makefile env/Makefile glue/Makefile t/Makefile build/doxygen.conf])
  +AC_CONFIG_FILES([Makefile src/Makefile env/Makefile glue/Makefile t/Makefile])
  +AC_CONFIG_FILES([build/doxygen.conf src/groups.dox])
   AC_CONFIG_FILES([apreq2-config], [chmod +x apreq2-config])
   AC_OUTPUT
  
  
  
  1.2       +3 -2      httpd-apreq-2/build/dox.foot
  
  Index: dox.foot
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/build/dox.foot,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- dox.foot	21 Jun 2004 18:32:24 -0000	1.1
  +++ dox.foot	23 Jun 2004 02:22:28 -0000	1.2
  @@ -3,8 +3,9 @@
   Copyright &copy; 2003-2004 <a href="http://www.apache.org">The Apache Software
Foundation</a>.<br/>
   See <a href="LICENSE.html">LICENSE</a>.</p>
   <p class="menu">
  -   <a href="http://www.apache.org/">Apache Software Foundation</a> &gt;
<a href="http://httpd.apache.org">HTTP Server Project</a> &gt;
  -<a href="http://httpd.apache.org/apreq/">Request Library Subproject</a></p>
  +<span style="color:#aaa">page generated by <a href="http://www.doxygen.org/"><code>doxygen</code></a>
  +version $doxygenversion on $date</span>
  +</p>
   </div>
   </body>
   </html>
  
  
  
  1.2       +1 -1      httpd-apreq-2/build/dox.head
  
  Index: dox.head
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/build/dox.head,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- dox.head	21 Jun 2004 18:32:24 -0000	1.1
  +++ dox.head	23 Jun 2004 02:22:28 -0000	1.2
  @@ -1,7 +1,7 @@
   <html>
   <head>
     <link rel="stylesheet" type="text/css" href="dox.css" />
  -  <title>libapreq2 API Documentation</title> 
  +  <title>$projectname-$projectnumber: $title</title> 
   </head>
   <body>
   <div id="page-header">
  
  
  
  1.2       +8 -7      httpd-apreq-2/build/doxygen.conf.in
  
  Index: doxygen.conf.in
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/build/doxygen.conf.in,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- doxygen.conf.in	21 Jun 2004 18:32:24 -0000	1.1
  +++ doxygen.conf.in	23 Jun 2004 02:22:28 -0000	1.2
  @@ -1,5 +1,5 @@
  -PROJECT_NAME           = "@PACKAGE@-@VERSION@"
  -PROJECT_NUMBER         = "Shared Library Version @APREQ_DOTTED_VERSION@"
  +PROJECT_NAME           = "@PACKAGE@"
  +PROJECT_NUMBER         = "@VERSION@"
   
   OUTPUT_DIRECTORY       = docs
   OUTPUT_LANGUAGE        = English
  @@ -28,15 +28,15 @@
   WARN_FORMAT            = "$file:$line: $text"
   
   INPUT                  = . src env
  -FILE_PATTERNS          = *.c *.h CHANGES FAQ STATUS
  +FILE_PATTERNS          = *.c *.h *.dox CHANGES STATUS FAQ
   RECURSIVE              = NO
   EXCLUDE                = 
   EXCLUDE_SYMLINKS       = NO
   EXCLUDE_PATTERNS       = apreq_tables* \
                            apreq_config*
  -EXAMPLE_PATH           = ./
  -EXAMPLE_PATTERNS       = 
  -IMAGE_PATH             = ./build/feather.gif
  +EXAMPLE_PATH           = .
  +EXAMPLE_PATTERNS       = README INSTALL LICENSE NOTICE *.html *.man
  +IMAGE_PATH             = 
   SOURCE_BROWSER         = NO
   
   ALPHABETICAL_INDEX     = NO
  @@ -52,7 +52,8 @@
   
   GENERATE_LATEX         = NO
   GENERATE_RTF           = NO
  -GENERATE_MAN           = NO
  +GENERATE_MAN           = YES
  +MAN_LINKS              = NO
   GENERATE_XML           = NO
   GENERATE_AUTOGEN_DEF   = NO
   GENERATE_PERLMOD       = NO
  
  
  
  1.14      +2 -0      httpd-apreq-2/build/version_check.pl
  
  Index: version_check.pl
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/build/version_check.pl,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- version_check.pl	14 Jun 2004 19:16:01 -0000	1.13
  +++ version_check.pl	23 Jun 2004 02:22:28 -0000	1.14
  @@ -86,6 +86,8 @@
       version: $opts{version}
     Apache::Cookie:
       version: $opts{version}
  +  Apache::Upload:
  +    version: $opts{version}
   generated_by: $0
   EOT
           my %runtime_prereqs =  (
  
  
  
  1.53      +46 -20    httpd-apreq-2/env/mod_apreq.c
  
  Index: mod_apreq.c
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/env/mod_apreq.c,v
  retrieving revision 1.52
  retrieving revision 1.53
  diff -u -r1.52 -r1.53
  --- mod_apreq.c	21 Jun 2004 17:53:44 -0000	1.52
  +++ mod_apreq.c	23 Jun 2004 02:22:28 -0000	1.53
  @@ -80,34 +80,60 @@
   module AP_MODULE_DECLARE_DATA apreq_module;
   
   /**
  - * mod_apreq.c provides an input filter for using libapreq2
  + * @defgroup mod_apreq Apache 2.X Filter Module
  + * @ingroup apreq_env
  + * @brief mod_apreq - DSO that ties libapreq2 to Apache 2.X.
  + *
  + * mod_apreq provides an input filter for using libapreq2
    * (and allow its parsed data structures to be shared) within
  - * the Apache-2 webserver.  Using it, libapreq2 works properly
  + * the Apache 2.X webserver.  Using it, libapreq2 works properly
    * in every phase of the HTTP request, from translation handlers 
    * to output filters, and even for subrequests / internal redirects.
    *
  - * After installing mod_apreq, be sure your webserver's
  - * httpd.conf activates it on startup with a LoadModule directive:
  - * <pre><code>
  + * <hr>
  + *
  + * <h2>Activating mod_apreq in Apache 2.X</h2>
  + *
  + * Normally the installation process triggered by
  + * <code>% make install</code>
  + * will make the necessary changes to httpd.conf for you. In any case,
  + * after installing the mod_apreq.so module, be sure your webserver's
  + * httpd.conf activates it on startup with a LoadModule directive, e.g.
  + * @code
    *
  - *     LoadModule modules/mod_apreq.so
  + *     LoadModule    modules/mod_apreq.so
    *
  - * </code></pre>
  - * Normally the installation process triggered by '% make install'
  - * will make the necessary changes to httpd.conf for you.
  - * 
  - * XXX describe normal operation, effects of config settings, etc. 
  + * @endcode
    *
  - * @defgroup mod_apreq Apache-2 Filter Module
  - * @ingroup MODULES
  - * @brief mod_apreq.c: Apache-2 filter module
  + * <hr>
  + *
  + * <h2>Server Configuration Directives</h2>
  + *
  + * <TABLE class="qref"><CAPTION>Per-directory commands for mod_apreq</CAPTION>
  + * <TR><TH>Directive</TH><TH>Context</TH><TH>Default</TH><TH>Description</TH></TR>
  + * <TR class="odd"><TD>APREQ_MaxBody</TD><TD>directory</TD><TD>-1
(Unlimited)</TD><TD>
  + * Maximum number of bytes mod_apreq will send off to libapreq for parsing.  
  + * mod_apreq will log this event and remove itself from the filter chain.
  + * The APR_ENOSPC (XXX) error will be reported to libapreq2 users via the return 
  + * value of apreq_env_read().
  + * </TD></TR>
  + * <TR><TD>APREQ_MaxBrigade</TD><TD>directory</TD><TD>
#APREQ_MAX_BRIGADE_LEN </TD><TD>
  + * Maximum number of bytes apreq will allow to accumulate
  + * within a brigade.  Excess data will be spooled to a
  + * file bucket appended to the brigade.
  + * </TD></TR>
  + * <TR class="odd"><TD>APREQ_TempDir</TD><TD>directory</TD><TD>NULL</TD><TD>
  + * Sets the location of the temporary directory apreq will use to spool
  + * overflow brigade data (based on the APREQ_MaxBrigade setting).
  + * If left unset, libapreq2 will select a platform-specific location via apr_temp_dir_get().
  + * </TD></TR>
  + * </TABLE>
    * @{
    */
   
   
  -#define APREQ_MODULE_NAME "APACHE2"
  -#define APREQ_MODULE_MAGIC_NUMBER 20040621
  -
  +#define APREQ_MODULE_NAME               "APACHE2"
  +#define APREQ_MODULE_MAGIC_NUMBER       20040621
   
   static void apache2_log(const char *file, int line, int level, 
                           apr_status_t status, void *env, const char *fmt,
  @@ -274,7 +300,7 @@
       }
   }
   
  -/**
  +/*
    * Reads data directly into the parser.
    */
   
  @@ -641,6 +667,8 @@
   
       return NULL;
   }
  +/**
  + */
   
   static const command_rec apreq_cmds[] =
   {
  @@ -653,9 +681,7 @@
       {NULL}
   };
   
  -
   /** @} */
  -
   module AP_MODULE_DECLARE_DATA apreq_module =
   {
   	STANDARD20_MODULE_STUFF,
  
  
  
  1.18      +1 -0      httpd-apreq-2/src/Makefile.am
  
  Index: Makefile.am
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/src/Makefile.am,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- Makefile.am	15 Jun 2004 04:18:27 -0000	1.17
  +++ Makefile.am	23 Jun 2004 02:22:28 -0000	1.18
  @@ -1,5 +1,6 @@
   INCLUDES = @APR_INCLUDES@ @APU_INCLUDES@
   LIBS = @APR_LTLIBS@ @APU_LTLIBS@
  +EXTRA_DIST = groups.dox.in
   BUILT_SOURCES= @APR_LA@ @APU_LA@
   lib_LTLIBRARIES = libapreq2.la
   libapreq2_la_SOURCES = apreq.c apreq_version.c apreq_cookie.c \
  
  
  
  1.43      +11 -52    httpd-apreq-2/src/apreq.h
  
  Index: apreq.h
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/src/apreq.h,v
  retrieving revision 1.42
  retrieving revision 1.43
  diff -u -r1.42 -r1.43
  --- apreq.h	21 Jun 2004 17:49:18 -0000	1.42
  +++ apreq.h	23 Jun 2004 02:22:28 -0000	1.43
  @@ -26,47 +26,6 @@
    extern "C" {
   #endif 
   
  -/** @defgroup LIBRARY libapreq2     */
  -/** @defgroup MODULES Environments  */
  -/** @defgroup GLUE Language Bindings*/
  -
  -/**
  - * @mainpage
  - * Project Website: http://httpd.apache.org/apreq/
  - * @verbinclude README
  - */
  -
  -/** 
  - * @page LICENSE 
  - * @verbinclude LICENSE
  - */
  -/** 
  - * @page NOTICE
  - * @verbinclude NOTICE
  - */
  -/** 
  - * @page INSTALL 
  - * @verbinclude INSTALL
  - */
  -/**
  - * @defgroup XS Perl
  - * @ingroup GLUE
  - */
  -/** 
  - * @defgroup XS_Request Apache::Request
  - * @ingroup XS
  - * @htmlinclude Request.html
  - */
  -/** 
  - * @defgroup XS_Upload Apache::Upload
  - * @ingroup XS
  - * @htmlinclude Upload.html
  - */
  -/** 
  - * @defgroup XS_Cookie Apache::Cookie
  - * @ingroup XS
  - * @htmlinclude Cookie.html
  - */
   /**
    * The objects in apreq.h are used in various contexts:
    *
  @@ -77,16 +36,13 @@
    *    - simple time, date, & file-size converters
    * @file apreq.h
    * @brief Common functions, structures and macros.
  - */
  -/**
  - * @defgroup Utils Common functions, structures and macros
    * @ingroup libapreq2
  - * @{
    */
   
   #ifndef WIN32
   #define APREQ_DECLARE(d)                APR_DECLARE(d)
   #define APREQ_DECLARE_NONSTD(d)         APR_DECLARE_NONSTD(d)
  +#define APREQ_DECLARE_DATA
   #else
   #define APREQ_DECLARE(type)             __declspec(dllexport) type __stdcall
   #define APREQ_DECLARE_NONSTD(type)      __declspec(dllexport) type
  @@ -99,11 +55,14 @@
   
   #define APREQ_NELTS                     8
   #define APREQ_READ_AHEAD                (64 * 1024)
  -#define APREQ_MAX_BRIGADE_LEN           (256 * 1024)
  -
   /**
  - * libapreq-2's pre-extensible string type 
  - */
  + * Maximum amount of heap space a brigade may use before switching to file
  + * buckets
  +*/
  +#define APREQ_MAX_BRIGADE_LEN           (256 * 1024) 
  +                     
  +
  +/** @brief libapreq's pre-extensible string type */
   typedef struct apreq_value_t {
       const char    *name;    /**< value's name */
       apr_status_t   status;  /**< APR status, usually APR_SUCCESS or APR_INCOMPLETE*/
  @@ -401,10 +360,11 @@
   } while (0)
   
   
  -/* Copy a brigade.
  +/**
  + * Copy a brigade.
    * @param d (destination) Copied buckets are appended to this brigade.
    * @param s (source) Brigade to copy from.
  - * @remark s == d is undefined.
  + * @remark s == d produces Undefined Behavior.
    */
   
   #define APREQ_BRIGADE_COPY(d,s) do {                                \
  @@ -433,7 +393,6 @@
                                   const char *name, const apr_size_t nlen,
                                   const char **val, apr_size_t *vlen);
   
  -/** @} */
   
   #ifdef __cplusplus
    }
  
  
  
  1.24      +20 -18    httpd-apreq-2/src/apreq_cookie.h
  
  Index: apreq_cookie.h
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/src/apreq_cookie.h,v
  retrieving revision 1.23
  retrieving revision 1.24
  diff -u -r1.23 -r1.24
  --- apreq_cookie.h	21 Jun 2004 17:49:18 -0000	1.23
  +++ apreq_cookie.h	23 Jun 2004 02:22:28 -0000	1.24
  @@ -25,18 +25,22 @@
   #endif 
   
   /**
  - * Cookie and Jar functions.
  - *
    * @file apreq_cookie.h
    * @brief Cookies and Jars.
  - */
  -/**
  - *@defgroup cookies Cookies (request and response)
  - *@ingroup LIBRARY
  - * @{
  + * @ingroup libapreq2
  + *
  + * apreq_cookie.h describes a common server-side API for request (incoming)
  + * and response (outgoing) cookies.  It aims towards compliance with the 
  + * standard cookie specifications listed below.
  + *
  + * @see http://wp.netscape.com/newsref/std/cookie_spec.html
  + * @see http://www.ietf.org/rfc/rfc2109.txt
  + * @see http://www.ietf.org/rfc/rfc2964.txt
  + * @see http://www.ietf.org/rfc/rfc2965.txt
  + *
    */
   
  -/** Cookie Jar */
  +/** @brief This is the container class for libapreq cookies. */
   typedef struct apreq_jar_t {
       apr_table_t   *cookies;     /**< cookie table */
       void          *env;         /**< environment */
  @@ -63,18 +67,18 @@
   /** Maximum length of a single Set-Cookie(2) header */
   #define APREQ_COOKIE_MAX_LENGTH            4096
   
  -/** cookie XXX ... */
  +/** @brief Cookie type, supporting both Netscape and RFC cookie specifications.
  + */
   typedef struct apreq_cookie_t {
   
       apreq_cookie_version_t version; /**< RFC or Netscape compliant cookie */
   
  -    char           *path;
  -    char           *domain; 
  -    char           *port;
  -    unsigned        secure;
  -
  -    char           *comment;
  -    char           *commentURL;
  +    char           *path;        /**< Restricts url path */
  +    char           *domain;      /**< Restricts server domain */
  +    char           *port;        /**< Restricts server port */
  +    unsigned        secure;      /**< Notify browser of "https" requirement */
  +    char           *comment;     /**< RFC cookies may send a comment */
  +    char           *commentURL;  /**< RFC cookies may place an URL here */
       apr_time_t      max_age;     /**< total duration of cookie: -1 == session */
       apreq_value_t   v;           /**< "raw" cookie value */
   
  @@ -228,8 +232,6 @@
    *         APREQ_COOKIE_VERSION_NETSCAPE otherwise.
    */
   APREQ_DECLARE(apreq_cookie_version_t) apreq_ua_cookie_version(void *env);
  -
  -/** @} */
   
   #ifdef __cplusplus
    }
  
  
  
  1.8       +4 -3      httpd-apreq-2/src/apreq_env.c
  
  Index: apreq_env.c
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/src/apreq_env.c,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- apreq_env.c	19 Jun 2004 20:03:59 -0000	1.7
  +++ apreq_env.c	23 Jun 2004 02:22:28 -0000	1.8
  @@ -134,12 +134,13 @@
   
   
   /**
  + * @defgroup apreq_cgi Common Gateway Interface
  + * @ingroup apreq_env
  + * @brief CGI module included in the libapreq2 library.
  + *
    * CGI is the default environment module included in libapreq2...
    * XXX add more info here XXX
    *
  - * @defgroup CGI Common Gateway Interface
  - * @ingroup MODULES
  - * @brief apreq_env.c: libapreq2's default CGI module
    * @{
    */
   
  
  
  
  1.24      +5 -8      httpd-apreq-2/src/apreq_env.h
  
  Index: apreq_env.h
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/src/apreq_env.h,v
  retrieving revision 1.23
  retrieving revision 1.24
  diff -u -r1.23 -r1.24
  --- apreq_env.h	4 Jun 2004 22:02:11 -0000	1.23
  +++ apreq_env.h	23 Jun 2004 02:22:28 -0000	1.24
  @@ -67,11 +67,7 @@
   /**
    * @file apreq_env.h
    * @brief Logging and environment (module) declarations.
  - */
  -/**
  - * @defgroup ENV  Environment declarations
  - * @ingroup LIBRARY
  - * @{
  + * @ingroup libapreq2
    */
   
   /**
  @@ -230,8 +226,10 @@
   APREQ_DECLARE(apr_ssize_t) apreq_env_max_brigade(void *env, apr_ssize_t bytes);
   
   /**
  - * The environment structure, which must be fully defined
  - * for libapreq2 to operate properly in a given environment.
  + * This must be fully defined for libapreq2 to operate properly 
  + * in a given environment. Normally it is set once, with an apreq_env_module() 
  + * call during process initialization, and should remain fixed thereafter.
  + * @brief Vtable describing the necessary environment functions.
    */
   
   typedef struct apreq_env_t {
  @@ -284,7 +282,6 @@
    */
   #define apreq_env_magic_number (apreq_env_module(NULL)->magic_number)
   
  -/** @} */
   #ifdef __cplusplus
    }
   #endif
  
  
  
  1.32      +2 -9      httpd-apreq-2/src/apreq_params.h
  
  Index: apreq_params.h
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/src/apreq_params.h,v
  retrieving revision 1.31
  retrieving revision 1.32
  diff -u -r1.31 -r1.32
  --- apreq_params.h	21 Jun 2004 17:49:18 -0000	1.31
  +++ apreq_params.h	23 Jun 2004 02:22:28 -0000	1.32
  @@ -26,15 +26,9 @@
   
   /**
    * @file apreq_params.h
  - * @brief Request and param stuff.
  + * @brief Request parsing and parameter API
  + * @ingroup libapreq2
    */
  -/**
  - * @defgroup APREQ_PARAMS_H Request params
  - * @brief Foo
  - * @ingroup LIBRARY
  - * @{
  - */
  -
   
   /** Common data structure for params and file uploads */
   typedef struct apreq_param_t {
  @@ -386,7 +380,6 @@
   APREQ_DECLARE(apreq_parser_t *)apreq_parser(void *env,
                                               apreq_hook_t *hook);
   
  -/** @} */
   #ifdef __cplusplus
   }
   #endif
  
  
  
  1.15      +2 -0      httpd-apreq-2/src/apreq_version.h
  
  Index: apreq_version.h
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/src/apreq_version.h,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -r1.14 -r1.15
  --- apreq_version.h	21 Jun 2004 17:49:18 -0000	1.14
  +++ apreq_version.h	23 Jun 2004 02:22:28 -0000	1.15
  @@ -27,6 +27,7 @@
   /**
    * @file apreq_version.h
    * @brief Versioning API for libapreq
  + * @ingroup libapreq2
    *
    * There are several different mechanisms for accessing the version. There
    * is a string form, and a set of numbers; in addition, there are constants
  @@ -94,6 +95,7 @@
   #else
   #define APREQ_IS_DEV_STRING ""
   #endif
  +
   
   #ifdef __cplusplus
   }
  
  
  
  1.1                  httpd-apreq-2/src/groups.dox.in
  
  Index: groups.dox.in
  ===================================================================
  /**
   * @mainpage
   * Project Website: http://httpd.apache.org/apreq/
   *
   * @verbinclude README
   */
  
  /** 
   * @defgroup libapreq2 Apache Request Library
   * @brief libapreq2 Version @APREQ_DOTTED_VERSION@
   *
   * libapreq2 is a shared library based on the Apache
   * Portable Runtime libraries libapr and libaprutil.
   * @see http://apr.apache.org/
   *
   * @section apreq2_config Configuring libapreq2 Applications
   * This package includes <code>apreq2-config</code>, 
   * a configuration script for building applications
   * with libapreq2.  Run <code>apreq2-config --help</code>
   * to display its options. XXX add examples here XXX
   */
  
  /**
   * @defgroup apreq_env Environment Modules
   * @brief Environments included in @PACKAGE@-@VERSION@.
   *
   * XXX
   */
  
  /**
   * @defgroup apreq_ext Language Bindings
   * @brief libapreq2 APIs for programming languages other than C
   *
   * XXX
   */
  
  /** 
   * @page apreq_license LICENSE 
   * @verbinclude LICENSE
   */
  
  /** 
   * @page apreq_notice NOTICE
   * @verbinclude NOTICE
   */
  
  /** 
   * @page apreq_install INSTALL 
   * @verbinclude INSTALL
   */
  
  /**
   * @defgroup apreq_xs Perl
   * @brief XS Modules
   * @ingroup apreq_ext
  @manonly 
  .SH "SEE ALSO"
  .IX Header "SEE ALSO"
  \&\fIapreq_xs_request\fR\|(3), \fIapreq_xs_upload\fR\|(3), \fIapreq_xs_cookie\fR\|(3)
  @endmanonly
   */
  
  /**
   * @defgroup apreq_xs_request Apache::Request
   * @ingroup apreq_xs
   * @htmlinclude Request.html
   */
  
  /**
   * @defgroup apreq_xs_upload Apache::Upload
   * @ingroup apreq_xs
   * @htmlinclude Upload.html
   */
  
  /**
   * @defgroup apreq_xs_cookie Apache::Cookie
   * @ingroup apreq_xs
   * @htmlinclude Cookie.html
   */
  
  
  

Mime
View raw message