]> granicus.if.org Git - apache/blobdiff - include/http_config.h
Add the missing minor bump of r550519.
[apache] / include / http_config.h
index c523f5e4a840762e6544ae56633b822933c59a04..820a9facafc6c1378f2361177b3be87a070b91d3 100644 (file)
@@ -1,59 +1,26 @@
-/* ====================================================================
- * The Apache Software License, Version 1.1
+/* Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
  *
- * Copyright (c) 2000-2001 The Apache Software Foundation.  All rights
- * reserved.
+ *     http://www.apache.org/licenses/LICENSE-2.0
  *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * 1. Redistributions of source code must retain the above copyright
- *    notice, this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright
- *    notice, this list of conditions and the following disclaimer in
- *    the documentation and/or other materials provided with the
- *    distribution.
- *
- * 3. The end-user documentation included with the redistribution,
- *    if any, must include the following acknowledgment:
- *       "This product includes software developed by the
- *        Apache Software Foundation (http://www.apache.org/)."
- *    Alternately, this acknowledgment may appear in the software itself,
- *    if and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Apache" and "Apache Software Foundation" must
- *    not be used to endorse or promote products derived from this
- *    software without prior written permission. For written
- *    permission, please contact apache@apache.org.
- *
- * 5. Products derived from this software may not be called "Apache",
- *    nor may "Apache" appear in their name, without prior written
- *    permission of the Apache Software Foundation.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
- * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
- * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
- * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- * SUCH DAMAGE.
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many
- * individuals on behalf of the Apache Software Foundation.  For more
- * information on the Apache Software Foundation, please see
- * <http://www.apache.org/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file http_config.h
+ * @brief Apache Configuration
  *
- * Portions of this software are based upon public domain software
- * originally written at the National Center for Supercomputing Applications,
- * University of Illinois, Urbana-Champaign.
+ * @defgroup APACHE_CORE_CONFIG Configuration
+ * @ingroup  APACHE_CORE
+ * @{
  */
 
 #ifndef APACHE_HTTP_CONFIG_H
 extern "C" {
 #endif
 
-/**
- * @package Apache Configuration
- */
-
 /*
  * The central data structures around here...
  */
@@ -78,96 +41,125 @@ extern "C" {
 
 /**
  * How the directives arguments should be parsed.
- * @tip Note that for all of these except RAW_ARGS, the config routine is
+ * @remark Note that for all of these except RAW_ARGS, the config routine is
  *      passed a freshly allocated string which can be modified or stored
- *      or whatever... it's only necessary to do pstrdup() stuff with
- * <PRE>
- *    RAW_ARGS --               cmd_func parses command line itself 
- *    TAKE1    --               one argument only 
- *    TAKE2    --               two arguments only 
- *    ITERATE  --               one argument, occuring multiple times
- *                              * (e.g., IndexIgnore)
- *    ITERATE2 --               two arguments, 2nd occurs multiple times
- *                              * (e.g., AddIcon)
- *    FLAG     --               One of 'On' or 'Off' 
- *    NO_ARGS  --               No args at all, e.g. </Directory> 
- *    TAKE12   --               one or two arguments 
- *    TAKE3    --               three arguments only 
- *    TAKE23   --               two or three arguments
- *    TAKE123  --               one, two or three arguments 
- *    TAKE13   --               one or three arguments 
- * </PRE>
- * @defvar enum cmd_how
+ *      or whatever...
  */
 enum cmd_how {
-    RAW_ARGS,                  /* cmd_func parses command line itself */
-    TAKE1,                     /* one argument only */
-    TAKE2,                     /* two arguments only */
-    ITERATE,                   /* one argument, occuring multiple times
+    RAW_ARGS,                  /**< cmd_func parses command line itself */
+    TAKE1,                     /**< one argument only */
+    TAKE2,                     /**< two arguments only */
+    ITERATE,                   /**< one argument, occuring multiple times
                                 * (e.g., IndexIgnore)
                                 */
-    ITERATE2,                  /* two arguments, 2nd occurs multiple times
+    ITERATE2,                  /**< two arguments, 2nd occurs multiple times
                                 * (e.g., AddIcon)
                                 */
-    FLAG,                      /* One of 'On' or 'Off' */
-    NO_ARGS,                   /* No args at all, e.g. </Directory> */
-    TAKE12,                    /* one or two arguments */
-    TAKE3,                     /* three arguments only */
-    TAKE23,                    /* two or three arguments */
-    TAKE123,                   /* one, two or three arguments */
-    TAKE13                     /* one or three arguments */
+    FLAG,                      /**< One of 'On' or 'Off' */
+    NO_ARGS,                   /**< No args at all, e.g. </Directory> */
+    TAKE12,                    /**< one or two arguments */
+    TAKE3,                     /**< three arguments only */
+    TAKE23,                    /**< two or three arguments */
+    TAKE123,                   /**< one, two or three arguments */
+    TAKE13,                    /**< one or three arguments */
+    TAKE_ARGV                  /**< an argc and argv are passed */
 };
-
+/**
+ * This structure is passed to a command which is being invoked,
+ * to carry a large variety of miscellaneous data which is all of
+ * use to *somebody*...
+ */
 typedef struct cmd_parms_struct cmd_parms;
 
-#ifdef AP_DEBUG
+#if defined(AP_HAVE_DESIGNATED_INITIALIZER) || defined(DOXYGEN)
 
+/** 
+ * All the types of functions that can be used in directives
+ * @internal
+ */
 typedef union {
+    /** function to call for a no-args */
     const char *(*no_args) (cmd_parms *parms, void *mconfig);
+    /** function to call for a raw-args */
     const char *(*raw_args) (cmd_parms *parms, void *mconfig,
                             const char *args);
+    /** function to call for a argv/argc */
+    const char *(*take_argv) (cmd_parms *parms, void *mconfig,
+                            int argc, char *const argv[]);
+    /** function to call for a take1 */
     const char *(*take1) (cmd_parms *parms, void *mconfig, const char *w);
+    /** function to call for a take2 */
     const char *(*take2) (cmd_parms *parms, void *mconfig, const char *w,
                          const char *w2);
+    /** function to call for a take3 */
     const char *(*take3) (cmd_parms *parms, void *mconfig, const char *w,
                          const char *w2, const char *w3);
+    /** function to call for a flag */
     const char *(*flag) (cmd_parms *parms, void *mconfig, int on);
 } cmd_func;
 
+/** This configuration directive does not take any arguments */
 # define AP_NO_ARGS    func.no_args
+/** This configuration directive will handle it's own parsing of arguments*/
 # define AP_RAW_ARGS   func.raw_args
+/** This configuration directive will handle it's own parsing of arguments*/
+# define AP_TAKE_ARGV  func.take_argv
+/** This configuration directive takes 1 argument*/
 # define AP_TAKE1      func.take1
+/** This configuration directive takes 2 arguments */
 # define AP_TAKE2      func.take2
+/** This configuration directive takes 3 arguments */
 # define AP_TAKE3      func.take3
+/** This configuration directive takes a flag (on/off) as a argument*/
 # define AP_FLAG       func.flag
 
+/** method of declaring a directive with no arguments */
 # define AP_INIT_NO_ARGS(directive, func, mconfig, where, help) \
     { directive, { .no_args=func }, mconfig, where, RAW_ARGS, help }
+/** method of declaring a directive with raw argument parsing */
 # define AP_INIT_RAW_ARGS(directive, func, mconfig, where, help) \
     { directive, { .raw_args=func }, mconfig, where, RAW_ARGS, help }
+/** method of declaring a directive with raw argument parsing */
+# define AP_INIT_TAKE_ARGV(directive, func, mconfig, where, help) \
+    { directive, { .take_argv=func }, mconfig, where, TAKE_ARGV, help }
+/** method of declaring a directive which takes 1 argument */
 # define AP_INIT_TAKE1(directive, func, mconfig, where, help) \
     { directive, { .take1=func }, mconfig, where, TAKE1, help }
+/** method of declaring a directive which takes multiple arguments */
 # define AP_INIT_ITERATE(directive, func, mconfig, where, help) \
     { directive, { .take1=func }, mconfig, where, ITERATE, help }
+/** method of declaring a directive which takes 2 arguments */
 # define AP_INIT_TAKE2(directive, func, mconfig, where, help) \
     { directive, { .take2=func }, mconfig, where, TAKE2, help }
+/** method of declaring a directive which takes 1 or 2 arguments */
 # define AP_INIT_TAKE12(directive, func, mconfig, where, help) \
     { directive, { .take2=func }, mconfig, where, TAKE12, help }
+/** method of declaring a directive which takes multiple 2 arguments */
 # define AP_INIT_ITERATE2(directive, func, mconfig, where, help) \
     { directive, { .take2=func }, mconfig, where, ITERATE2, help }
+/** method of declaring a directive which takes 1 or 3 arguments */
+# define AP_INIT_TAKE13(directive, func, mconfig, where, help) \
+    { directive, { .take3=func }, mconfig, where, TAKE13, help }
+/** method of declaring a directive which takes 2 or 3 arguments */
 # define AP_INIT_TAKE23(directive, func, mconfig, where, help) \
     { directive, { .take3=func }, mconfig, where, TAKE23, help }
+/** method of declaring a directive which takes 1 to 3 arguments */
+# define AP_INIT_TAKE123(directive, func, mconfig, where, help) \
+    { directive, { .take3=func }, mconfig, where, TAKE123, help }
+/** method of declaring a directive which takes 3 arguments */
 # define AP_INIT_TAKE3(directive, func, mconfig, where, help) \
     { directive, { .take3=func }, mconfig, where, TAKE3, help }
+/** method of declaring a directive which takes a flag (on/off) as a argument*/
 # define AP_INIT_FLAG(directive, func, mconfig, where, help) \
     { directive, { .flag=func }, mconfig, where, FLAG, help }
 
-#else
+#else /* AP_HAVE_DESIGNATED_INITIALIZER */
 
 typedef const char *(*cmd_func) ();
 
 # define AP_NO_ARGS  func
 # define AP_RAW_ARGS func
+# define AP_TAKE_ARGV func
 # define AP_TAKE1    func
 # define AP_TAKE2    func
 # define AP_TAKE3    func
@@ -177,6 +169,8 @@ typedef const char *(*cmd_func) ();
     { directive, func, mconfig, where, RAW_ARGS, help }
 # define AP_INIT_RAW_ARGS(directive, func, mconfig, where, help) \
     { directive, func, mconfig, where, RAW_ARGS, help }
+# define AP_INIT_TAKE_ARGV(directive, func, mconfig, where, help) \
+    { directive, func, mconfig, where, TAKE_ARGV, help }
 # define AP_INIT_TAKE1(directive, func, mconfig, where, help) \
     { directive, func, mconfig, where, TAKE1, help }
 # define AP_INIT_ITERATE(directive, func, mconfig, where, help) \
@@ -187,20 +181,24 @@ typedef const char *(*cmd_func) ();
     { directive, func, mconfig, where, TAKE12, help }
 # define AP_INIT_ITERATE2(directive, func, mconfig, where, help) \
     { directive, func, mconfig, where, ITERATE2, help }
+# define AP_INIT_TAKE13(directive, func, mconfig, where, help) \
+    { directive, func, mconfig, where, TAKE13, help }
 # define AP_INIT_TAKE23(directive, func, mconfig, where, help) \
     { directive, func, mconfig, where, TAKE23, help }
+# define AP_INIT_TAKE123(directive, func, mconfig, where, help) \
+    { directive, func, mconfig, where, TAKE123, help }
 # define AP_INIT_TAKE3(directive, func, mconfig, where, help) \
     { directive, func, mconfig, where, TAKE3, help }
 # define AP_INIT_FLAG(directive, func, mconfig, where, help) \
     { directive, func, mconfig, where, FLAG, help }
 
-#endif
+#endif /* AP_HAVE_DESIGNATED_INITIALIZER */
 
-typedef struct command_struct command_rec; 
 /**
  * The command record structure.  Each modules can define a table of these
  * to define the directives it will implement.
  */
+typedef struct command_struct command_rec; 
 struct command_struct {
     /** Name of this command */
     const char *name;
@@ -218,60 +216,53 @@ struct command_struct {
     const char *errmsg;
 };
 
-/* The allowed locations for a configuration directive are the union of
+/**
+ * @defgroup ConfigDirectives Allowed locations for configuration directives.
+ *
+ * The allowed locations for a configuration directive are the union of
  * those indicated by each set bit in the req_override mask.
  *
- * (req_override & RSRC_CONF)   => *.conf outside <Directory> or <Location>
- * (req_override & ACCESS_CONF) => *.conf inside <Directory> or <Location>
- * (req_override & OR_AUTHCFG)  => *.conf inside <Directory> or <Location>
- *                                 and .htaccess when AllowOverride AuthConfig
- * (req_override & OR_LIMIT)    => *.conf inside <Directory> or <Location>
- *                                 and .htaccess when AllowOverride Limit
- * (req_override & OR_OPTIONS)  => *.conf anywhere
- *                                 and .htaccess when AllowOverride Options
- * (req_override & OR_FILEINFO) => *.conf anywhere
- *                                 and .htaccess when AllowOverride FileInfo
- * (req_override & OR_INDEXES)  => *.conf anywhere
- *                                 and .htaccess when AllowOverride Indexes
- */
-#define OR_NONE 0
-#define OR_LIMIT 1
-#define OR_OPTIONS 2
-#define OR_FILEINFO 4
-#define OR_AUTHCFG 8
-#define OR_INDEXES 16
-#define OR_UNSET 32
-#define ACCESS_CONF 64
-#define RSRC_CONF 128
-#define EXEC_ON_READ 256
+ * @{
+ */
+#define OR_NONE 0             /**< *.conf is not available anywhere in this override */
+#define OR_LIMIT 1          /**< *.conf inside <Directory> or <Location>
+                               and .htaccess when AllowOverride Limit */
+#define OR_OPTIONS 2         /**< *.conf anywhere
+                                and .htaccess when AllowOverride Options */
+#define OR_FILEINFO 4        /**< *.conf anywhere
+                               and .htaccess when AllowOverride FileInfo */
+#define OR_AUTHCFG 8         /**< *.conf inside <Directory> or <Location>
+                               and .htaccess when AllowOverride AuthConfig */
+#define OR_INDEXES 16        /**< *.conf anywhere
+                               and .htaccess when AllowOverride Indexes */
+#define OR_UNSET 32          /**< unset a directive (in Allow) */
+#define ACCESS_CONF 64       /**< *.conf inside <Directory> or <Location> */
+#define RSRC_CONF 128       /**< *.conf outside <Directory> or <Location> */
+#define EXEC_ON_READ 256     /**< force directive to execute a command 
+                which would modify the configuration (like including another
+                file, or IFModule */
+/** this directive can be placed anywhere */
 #define OR_ALL (OR_LIMIT|OR_OPTIONS|OR_FILEINFO|OR_AUTHCFG|OR_INDEXES)
 
+/** @} */
+
 /**
  * This can be returned by a function if they don't wish to handle
  * a command. Make it something not likely someone will actually use
  * as an error code.
- * @defvar DECLINE_CMD "\a\b"
  */
 #define DECLINE_CMD "\a\b"
 
-typedef struct ap_configfile_t ap_configfile_t;
 /** Common structure for reading of config files / passwd files etc. */
+typedef struct ap_configfile_t ap_configfile_t;
 struct ap_configfile_t {
-    /** a getc()-like function
-     *  @deffunc int getch(void *param) */
-    int (*getch) (void *param);        
-    /** a fgets()-like function 
-     *  @deffunc void *getstr(void *buf, size_t bufsize, void *param)*/
+    int (*getch) (void *param);            /**< a getc()-like function */
     void *(*getstr) (void *buf, size_t bufsiz, void *param);
-    /** a close hander function 
-     *  @deffunc int close(void *param)*/
-    int (*close) (void *param);        
-    /** the argument passed to getch/getstr/close */
-    void *param;
-    /** the filename / description */
-    const char *name;
-    /** current line number, starting at 1 */
-    unsigned line_number;
+                                   /**< a fgets()-like function */
+    int (*close) (void *param);            /**< a close handler function */
+    void *param;                    /**< the argument passed to getch/getstr/close */
+    const char *name;               /**< the filename / description */
+    unsigned line_number;           /**< current line number, starting at 1 */
 };
 
 /**
@@ -285,8 +276,10 @@ struct cmd_parms_struct {
     /** Which allow-override bits are set */
     int override;
     /** Which methods are <Limit>ed */
-    int limited;
+    apr_int64_t limited;
+    /** methods which are limited */
     apr_array_header_t *limited_xmethods;
+    /** methods which are xlimited */
     ap_method_list_t *xlimited;
 
     /** Config file structure. */
@@ -315,14 +308,17 @@ struct cmd_parms_struct {
     struct ap_conf_vector_t *context;
     /** directive with syntax error */
     const ap_directive_t *err_directive;
+
+    /** Which allow-override-opts bits are set */
+    int override_opts;
 };
 
-typedef struct module_struct module;
 /**
  * Module structures.  Just about everything is dispatched through
  * these, directly or indirectly (through the command and handler
  * tables).
  */
+typedef struct module_struct module;
 struct module_struct {
     /** API version, *not* module version; check that module is 
      * compatible with this version of the server.
@@ -350,7 +346,6 @@ struct module_struct {
     /** Function to allow MPMs to re-write command line arguments.  This
      *  hook is only available to MPMs.
      *  @param The process that the server is running in.
-     *  @deffunc void rewrite_args(process_rec *process);
      */
     void (*rewrite_args) (process_rec *process);
     /** Function to allow all modules to create per directory configuration
@@ -358,7 +353,6 @@ struct module_struct {
      *  @param p The pool to use for all allocations.
      *  @param dir The directory currently being processed.
      *  @return The per-directory structure created
-     *  @deffunc void *create_dir_config(apr_pool_t *p, char *dir)
      */
     void *(*create_dir_config) (apr_pool_t *p, char *dir);
     /** Function to allow all modules to merge the per directory configuration
@@ -367,7 +361,6 @@ struct module_struct {
      *  @param base_conf The directory structure created for the parent directory.
      *  @param new_conf The directory structure currently being processed.
      *  @return The new per-directory structure created
-     *  @deffunc void *merge_dir_config(apr_pool_t *p, void *base_conf, void *new_conf)
      */
     void *(*merge_dir_config) (apr_pool_t *p, void *base_conf, void *new_conf);
     /** Function to allow all modules to create per server configuration
@@ -375,7 +368,6 @@ struct module_struct {
      *  @param p The pool to use for all allocations.
      *  @param s The server currently being processed.
      *  @return The per-server structure created
-     *  @deffunc void *create_server_config(apr_pool_t *p, server_rec *dir)
      */
     void *(*create_server_config) (apr_pool_t *p, server_rec *s);
     /** Function to allow all modules to merge the per server configuration
@@ -384,9 +376,9 @@ struct module_struct {
      *  @param base_conf The directory structure created for the parent directory.
      *  @param new_conf The directory structure currently being processed.
      *  @return The new per-directory structure created
-     *  @deffunc void *merge_dir_config(apr_pool_t *p, void *base_conf, void *new_conf)
      */
-    void *(*merge_server_config) (apr_pool_t *p, void *base_conf, void *new_conf);
+    void *(*merge_server_config) (apr_pool_t *p, void *base_conf, 
+                                  void *new_conf);
 
     /** A command_rec table that describes all of the directives this module
      * defines. */
@@ -397,12 +389,14 @@ struct module_struct {
      *  register an interest in a specific step in processing the current
      *  request.
      *  @param p the pool to use for all allocations
-     *  @deffunc void register_hooks(void)
      */
     void (*register_hooks) (apr_pool_t *p);
 };
 
-/* Initializer for the first few module slots, which are only
+/**
+ * @defgroup ModuleInit Module structure initializers
+ *
+ * Initializer for the first few module slots, which are only
  * really set up once we start running.  Note that the first two slots
  * provide a version check; this should allow us to deal with changes to
  * the API. The major number should reflect changes to the API handler table
@@ -410,10 +404,13 @@ struct module_struct {
  * additions of functionality to the existing API. (the server can detect
  * an old-format module, and either handle it back-compatibly, or at least
  * signal an error). See src/include/ap_mmn.h for MMN version history.
+ * @{
  */
 
+/** The one used in Apache 1.3, which will deliberately cause an error */
 #define STANDARD_MODULE_STUFF  this_module_needs_to_be_ported_to_apache_2_0
 
+/** Use this in all standard modules */
 #define STANDARD20_MODULE_STUFF        MODULE_MAGIC_NUMBER_MAJOR, \
                                MODULE_MAGIC_NUMBER_MINOR, \
                                -1, \
@@ -423,6 +420,7 @@ struct module_struct {
                                MODULE_MAGIC_COOKIE, \
                                 NULL      /* rewrite args spot */
 
+/** Use this only in MPMs */
 #define MPM20_MODULE_STUFF     MODULE_MAGIC_NUMBER_MAJOR, \
                                MODULE_MAGIC_NUMBER_MINOR, \
                                -1, \
@@ -431,12 +429,13 @@ struct module_struct {
                                NULL, \
                                MODULE_MAGIC_COOKIE
 
+/** @} */
 
 /* CONFIGURATION VECTOR FUNCTIONS */
 
+/** configuration vector structure */
 typedef struct ap_conf_vector_t ap_conf_vector_t;
 
-#ifdef AP_DEBUG
 /**
  * Generic accessors for other modules to get at their own module-specific
  * data
@@ -444,7 +443,6 @@ typedef struct ap_conf_vector_t ap_conf_vector_t;
  *        usually r->per_dir_config or s->module_config
  * @param m The module to get the data for.
  * @return The module-specific data
- * @deffunc void *ap_get_module_config(const ap_conf_vector_t *cv, module *m)
  */
 AP_DECLARE(void *) ap_get_module_config(const ap_conf_vector_t *cv,
                                         const module *m);
@@ -456,12 +454,11 @@ AP_DECLARE(void *) ap_get_module_config(const ap_conf_vector_t *cv,
  *        usually r->per_dir_config or s->module_config
  * @param m The module to set the data for.
  * @param val The module-specific data to set
- * @deffunc void ap_set_module_config(ap_conf_vector_t *cv, const module *m, void *val)
  */
 AP_DECLARE(void) ap_set_module_config(ap_conf_vector_t *cv, const module *m,
                                       void *val);
 
-#else /* AP_DEBUG */
+#if !defined(AP_DEBUG)
 
 #define ap_get_module_config(v,m)      \
     (((void **)(v))[(m)->module_index])
@@ -477,10 +474,10 @@ AP_DECLARE(void) ap_set_module_config(ap_conf_vector_t *cv, const module *m,
  * @param struct_ptr pointer into a given type
  * @param arg The argument to the directive
  * @return An error string or NULL on success
- * @deffunc const char *ap_set_string_slot(cmd_parms *cmd, void *struct_ptr, const char *arg)
  */
-AP_DECLARE_NONSTD(const char *) ap_set_string_slot(cmd_parms *cmd, void *struct_ptr,
-                                                  const char *arg);
+AP_DECLARE_NONSTD(const char *) ap_set_string_slot(cmd_parms *cmd, 
+                                                   void *struct_ptr,
+                                                   const char *arg);
 
 /**
  * Generic command handling function for integers
@@ -488,7 +485,6 @@ AP_DECLARE_NONSTD(const char *) ap_set_string_slot(cmd_parms *cmd, void *struct_
  * @param struct_ptr pointer into a given type
  * @param arg The argument to the directive
  * @return An error string or NULL on success
- * @deffunc const char *ap_set_int_slot(cmd_parms *cmd, void *struct_ptr, const char *arg)
  */
 AP_DECLARE_NONSTD(const char *) ap_set_int_slot(cmd_parms *cmd, 
                                                 void *struct_ptr,
@@ -503,7 +499,6 @@ AP_DECLARE_NONSTD(const char *) ap_set_int_slot(cmd_parms *cmd,
  * @param   cmd     Pointer to the cmd_parms structure passed to the
  *                  directive handler.
  * @return  0 if the method is not limited in the current scope
- * @deffunc ap_method_is_limited(cmd_parms *cmd, const char *method)
  */
 AP_DECLARE(int) ap_method_is_limited(cmd_parms *cmd, const char *method);
 
@@ -514,38 +509,52 @@ AP_DECLARE(int) ap_method_is_limited(cmd_parms *cmd, const char *method);
  * @param struct_ptr pointer into a given type
  * @param arg The argument to the directive
  * @return An error string or NULL on success
- * @deffunc const char *ap_set_string_slot_lower(cmd_parms *cmd, void *struct_ptr, const char *arg)
  */
 AP_DECLARE_NONSTD(const char *) ap_set_string_slot_lower(cmd_parms *cmd, 
-                                                        void *struct_ptr, const char *arg);
+                                                         void *struct_ptr, 
+                                                         const char *arg);
 /**
  * Generic command handling function for flags
  * @param cmd The command parameters for this directive
  * @param struct_ptr pointer into a given type
  * @param arg The argument to the directive (either 1 or 0)
  * @return An error string or NULL on success
- * @deffunc const char *ap_set_flag_slot(cmd_parms *cmd, void *struct_ptr, int arg)
  */
-AP_DECLARE_NONSTD(const char *) ap_set_flag_slot(cmd_parms *cmd, void *struct_ptr, int arg);
+AP_DECLARE_NONSTD(const char *) ap_set_flag_slot(cmd_parms *cmd, 
+                                                 void *struct_ptr, 
+                                                 int arg);
 /**
  * Generic command handling function for files
  * @param cmd The command parameters for this directive
  * @param struct_ptr pointer into a given type
  * @param arg The argument to the directive
  * @return An error string or NULL on success
- * @deffunc const char *ap_set_file_slot(cmd_parms *cmd, void *struct_ptr, const char *arg)
  */
-AP_DECLARE_NONSTD(const char *) ap_set_file_slot(cmd_parms *cmd, void *struct_ptr, const char *arg);
-
+AP_DECLARE_NONSTD(const char *) ap_set_file_slot(cmd_parms *cmd, 
+                                                 void *struct_ptr, 
+                                                 const char *arg);
+/**
+ * Generic command handling function to respond with cmd->help as an error
+ * @param cmd The command parameters for this directive
+ * @param struct_ptr pointer into a given type
+ * @param arg The argument to the directive
+ * @return The cmd->help value as the error string
+ * @tip This allows simple declarations such as;
+ * <pre>
+ *     AP_INIT_RAW_ARGS("Foo", ap_set_deprecated, NULL, OR_ALL, 
+ *         "The Foo directive is no longer supported, use Bar"),
+ * </pre>
+ */
+AP_DECLARE_NONSTD(const char *) ap_set_deprecated(cmd_parms *cmd, 
+                                                  void *struct_ptr, 
+                                                  const char *arg);
 /**
- * For modules which need to read config files, open logs, etc. ...
- * this returns the fname argument if it begins with '/'; otherwise
- * it relativizes it wrt server_root.
- * @param p pool to allocate data out of
+ * For modules which need to read config files, open logs, etc. this returns
+ * the canonical form of fname made absolute to ap_server_root.
+ * @param p pool to allocate data from
  * @param fname The file name
- * @deffunc const char *ap_server_root_relative(apr_pool_t *p, const char *fname)
  */
-AP_DECLARE(const char *) ap_server_root_relative(apr_pool_t *p, const char *fname);
+AP_DECLARE(char *) ap_server_root_relative(apr_pool_t *p, const char *fname);
 
 /* Finally, the hook for dynamically loading modules in... */
 
@@ -553,9 +562,8 @@ AP_DECLARE(const char *) ap_server_root_relative(apr_pool_t *p, const char *fnam
  * Add a module to the server
  * @param m The module structure of the module to add
  * @param p The pool of the same lifetime as the module
- * @deffunc void ap_add_module(module *m, apr_pool_t *p)
  */
-AP_DECLARE(void) ap_add_module(module *m, apr_pool_t *p);
+AP_DECLARE(const char *) ap_add_module(module *m, apr_pool_t *p);
 
 /**
  * Remove a module from the server.  There are some caveats:
@@ -564,66 +572,52 @@ AP_DECLARE(void) ap_add_module(module *m, apr_pool_t *p);
  * only ever call this function when you are invalidating almost
  * all our current data. I.e. when doing a restart.
  * @param m the module structure of the module to remove
- * @deffunc void ap_remove_module(module *m)
  */
 AP_DECLARE(void) ap_remove_module(module *m);
 /**
  * Add a module to the chained modules list and the list of loaded modules
  * @param m The module structure of the module to add
  * @param p The pool with the same lifetime as the module
- * @deffunc void ap_add_loaded_module(module *m, apr_pool_t *p)
  */
-AP_DECLARE(void) ap_add_loaded_module(module *mod, apr_pool_t *p);
+AP_DECLARE(const char *) ap_add_loaded_module(module *mod, apr_pool_t *p);
 /**
  * Remove a module fromthe chained modules list and the list of loaded modules
  * @param m the module structure of the module to remove
- * @deffunc void ap_remove_loaded_module(module *m)
  */
 AP_DECLARE(void) ap_remove_loaded_module(module *mod);
-/**
- * Add a module to the list of loaded module based on the name of the
- * module
- * @param name The name of the module
- * @param p The pool valid for the lifetime of the module
- * @return 1 on success, 0 on failure
- * @deffunc int ap_add_named_module(const char *name, apr_pool_t *p)
- */
-AP_DECLARE(int) ap_add_named_module(const char *name, apr_pool_t *p);
 /**
  * Find the name of the specified module
  * @param m The module to get the name for
  * @return the name of the module
- * @deffunc const char *ap_find_module_name(module *m)
  */
 AP_DECLARE(const char *) ap_find_module_name(module *m);
 /**
  * Find a module based on the name of the module
  * @param name the name of the module
  * @return the module structure if found, NULL otherwise
- * @deffunc module *ap_find_linked_module(const char *name)
  */
 AP_DECLARE(module *) ap_find_linked_module(const char *name);
 
 /**
  * Open a ap_configfile_t as apr_file_t
  * @param ret_cfg open ap_configfile_t struct pointer
- * @param p The pool to allocate the structure out of
+ * @param p The pool to allocate the structure from
  * @param name the name of the file to open
- * @deffunc apr_status_t ap_pcfg_openfile(ap_configfile_t **ret_cfg, apr_pool_t *p, const char *name)
  */
-AP_DECLARE(apr_status_t) ap_pcfg_openfile(ap_configfile_t **ret_cfg, apr_pool_t *p, const char *name);
+AP_DECLARE(apr_status_t) ap_pcfg_openfile(ap_configfile_t **ret_cfg, 
+                                          apr_pool_t *p, const char *name);
 
 /**
  * Allocate a ap_configfile_t handle with user defined functions and params 
- * @param p The pool to allocate out of
+ * @param p The pool to allocate from
  * @param descr The name of the file
  * @param param The argument passed to getch/getstr/close
  * @param getc_func The getch function
  * @param gets_func The getstr function
  * @param close_func The close function
- * @deffunc ap_configfile_t *ap_pcfg_open_custom(apr_pool_t *p, const char *descr, void *param, int(*getc_func)(void*), void *(*gets_func) (void *buf, size_t bufsiz, void *param), int(*close_func)(void *param))
  */
-AP_DECLARE(ap_configfile_t *) ap_pcfg_open_custom(apr_pool_t *p, const char *descr,
+AP_DECLARE(ap_configfile_t *) ap_pcfg_open_custom(apr_pool_t *p, 
+    const char *descr,
     void *param,
     int(*getc_func)(void*),
     void *(*gets_func) (void *buf, size_t bufsiz, void *param),
@@ -635,7 +629,6 @@ AP_DECLARE(ap_configfile_t *) ap_pcfg_open_custom(apr_pool_t *p, const char *des
  * @param bufsize size of the buffer
  * @param cfp File to read from
  * @return 1 on success, 0 on failure
- * @deffunc int ap_cfg_getline(char *buf, size_t bufsize, ap_configfile_t *cfp)
  */
 AP_DECLARE(int) ap_cfg_getline(char *buf, size_t bufsize, ap_configfile_t *cfp);
 
@@ -643,7 +636,6 @@ AP_DECLARE(int) ap_cfg_getline(char *buf, size_t bufsize, ap_configfile_t *cfp);
  * Read one char from open configfile_t, increase line number upon LF 
  * @param cfp The file to read from
  * @return the character read
- * @deffunc int ap_cfg_getc(ap_configfile_t *cfp)
  */
 AP_DECLARE(int) ap_cfg_getc(ap_configfile_t *cfp);
 
@@ -651,7 +643,6 @@ AP_DECLARE(int) ap_cfg_getc(ap_configfile_t *cfp);
  * Detach from open ap_configfile_t, calling the close handler
  * @param cfp The file to close
  * @return 1 on sucess, 0 on failure
- * @deffunc int ap_cfg_closefile(ap_configfile_t *cfp)
  */
 AP_DECLARE(int) ap_cfg_closefile(ap_configfile_t *cfp);
 
@@ -660,28 +651,27 @@ AP_DECLARE(int) ap_cfg_closefile(ap_configfile_t *cfp);
  * of this data is forgotten immediately.  
  * @param cmd The cmd_parms to pass to the directives inside the container
  * @param directive The directive name to read until
- * @retrn Error string on failure, NULL on success
- * @deffunc const char *ap_soak_end_container(cmd_parms *cmd, char *directive)
+ * @return Error string on failure, NULL on success
  */
 AP_DECLARE(const char *) ap_soak_end_container(cmd_parms *cmd, char *directive);
 
 /**
  * Read all data between the current <foo> and the matching </foo> and build
- * a config tree out of it
- * @param p pool to allocate out of
- * @param temp_pool Temporary pool to allocate out of
+ * a config tree from it
+ * @param p pool to allocate from
+ * @param temp_pool Temporary pool to allocate from
  * @param parms The cmd_parms to pass to all directives read
  * @param current The current node in the tree
  * @param curr_parent The current parent node
  * @param orig_directive The directive to read until hit.
  * @return Error string on failure, NULL on success
- * @deffunc char *ap_build_cont_config(apr_pool_t *p, apr_pool_t *temp_pool, cmd_parms *parms, ap_directive_t **current, ap_directive_t **curr_parent, char *orig_directive)
 */
-const char * ap_build_cont_config(apr_pool_t *p, apr_pool_t *temp_pool,
-                                  cmd_parms *parms,
-                                  ap_directive_t **current,
-                                  ap_directive_t **curr_parent,
-                                  char *orig_directive);
+AP_DECLARE(const char *) ap_build_cont_config(apr_pool_t *p, 
+                                              apr_pool_t *temp_pool,
+                                              cmd_parms *parms,
+                                              ap_directive_t **current,
+                                              ap_directive_t **curr_parent,
+                                              char *orig_directive);
 
 /**
  * Build a config tree from a config file
@@ -690,12 +680,11 @@ const char * ap_build_cont_config(apr_pool_t *p, apr_pool_t *temp_pool,
  * @param temp_pool The temporary pool
  * @param conftree Place to store the root node of the config tree
  * @return Error string on erro, NULL otherwise
- * @deffunc const char *ap_build_config(cmd_parms *parms, apr_pool_t *conf_pool, apr_pool_t *temp_pool, ap_directive_t **conftree)
  */
 AP_DECLARE(const char *) ap_build_config(cmd_parms *parms,
-                                        apr_pool_t *conf_pool,
-                                        apr_pool_t *temp_pool,
-                                        ap_directive_t **conftree);
+                                         apr_pool_t *conf_pool,
+                                         apr_pool_t *temp_pool,
+                                         ap_directive_t **conftree);
 
 /**
  * Walk a config tree and setup the server's internal structures
@@ -703,42 +692,46 @@ AP_DECLARE(const char *) ap_build_config(cmd_parms *parms,
  * @param parms The cmd_parms to pass to all functions
  * @param section_vector The per-section config vector.
  * @return Error string on error, NULL otherwise
- * @deffunc const char *ap_walk_config(ap_directive_t *conftree, cmd_parms *parms, ap_conf_vector_t *section_vector)
  */
 AP_DECLARE(const char *) ap_walk_config(ap_directive_t *conftree,
-                                       cmd_parms *parms,
+                                        cmd_parms *parms,
                                         ap_conf_vector_t *section_vector);
 
 /**
- * ap_check_cmd_context() definitions: 
- * @param cmd The cmd_context to check
- * @param forbidden Where the command is forbidden.  One of:
- * <PRE>
- *                NOT_IN_VIRTUALHOST
- *                NOT_IN_LIMIT
- *                NOT_IN_DIRECTORY
- *                NOT_IN_LOCATION
- *                NOT_IN_FILES
- *                NOT_IN_DIR_LOC_FILE
- *                GLOBAL_ONLY
- * </PRE>
+ * @defgroup ap_check_cmd_context Check command context
+ * @{
+ */
+/**
+ * Check the context a command is used in.
+ * @param cmd The command to check
+ * @param forbidden Where the command is forbidden.
  * @return Error string on error, NULL on success
- * @deffunc const char *ap_check_cmd_context(cmd_parms *cmd, unsigned forbidden)
  */
-AP_DECLARE(const char *) ap_check_cmd_context(cmd_parms *cmd, unsigned forbidden);
+AP_DECLARE(const char *) ap_check_cmd_context(cmd_parms *cmd, 
+                                              unsigned forbidden);
 
-/* ap_check_cmd_context():              Forbidden in: */
-#define  NOT_IN_VIRTUALHOST     0x01 /* <Virtualhost> */
-#define  NOT_IN_LIMIT           0x02 /* <Limit> */
-#define  NOT_IN_DIRECTORY       0x04 /* <Directory> */
-#define  NOT_IN_LOCATION        0x08 /* <Location> */
-#define  NOT_IN_FILES           0x10 /* <Files> */
-#define  NOT_IN_DIR_LOC_FILE    (NOT_IN_DIRECTORY|NOT_IN_LOCATION|NOT_IN_FILES) /* <Directory>/<Location>/<Files>*/
-#define  GLOBAL_ONLY            (NOT_IN_VIRTUALHOST|NOT_IN_LIMIT|NOT_IN_DIR_LOC_FILE)
+#define  NOT_IN_VIRTUALHOST     0x01 /**< Forbidden in <Virtualhost> */
+#define  NOT_IN_LIMIT           0x02 /**< Forbidden in <Limit> */
+#define  NOT_IN_DIRECTORY       0x04 /**< Forbidden in <Directory> */
+#define  NOT_IN_LOCATION        0x08 /**< Forbidden in <Location> */
+#define  NOT_IN_FILES           0x10 /**< Forbidden in <Files> */
+/** Forbidden in <Directory>/<Location>/<Files>*/
+#define  NOT_IN_DIR_LOC_FILE    (NOT_IN_DIRECTORY|NOT_IN_LOCATION|NOT_IN_FILES) 
+/** Forbidden in <VirtualHost>/<Limit>/<Directory>/<Location>/<Files> */
+#define  GLOBAL_ONLY            (NOT_IN_VIRTUALHOST|NOT_IN_LIMIT|NOT_IN_DIR_LOC_FILE) 
 
+/** @} */
 
 #ifdef CORE_PRIVATE
 
+/**
+ * @brief This structure is used to assign symbol names to module pointers
+ */
+typedef struct {
+    const char *name;
+    module *modp;
+} ap_module_symbol_t;
+
 /**
  * The topmost module in the list
  * @defvar module *ap_top_module
@@ -750,6 +743,11 @@ AP_DECLARE_DATA extern module *ap_top_module;
  * @defvar module *ap_prelinked_modules[]
  */
 AP_DECLARE_DATA extern module *ap_prelinked_modules[];
+/**
+ * Array of all statically linked modulenames (symbols)
+ * @defvar ap_module_symbol_t ap_prelinked_modulenames[]
+ */
+AP_DECLARE_DATA extern ap_module_symbol_t ap_prelinked_module_symbols[];
 /**
  * Array of all preloaded modules
  * @defvar module *ap_preloaded_modules[]
@@ -763,7 +761,7 @@ AP_DECLARE_DATA extern module **ap_loaded_modules;
 
 /* For mod_so.c... */
 /** Run a single module's two create_config hooks
- *  @param p the pool to allocate out of
+ *  @param p the pool to allocate from
  *  @param s The server to configure for.
  *  @param m The module to configure
  */
@@ -774,46 +772,43 @@ AP_DECLARE(void) ap_single_module_configure(apr_pool_t *p, server_rec *s,
 /**
  * Add all of the prelinked modules into the loaded module list
  * @param process The process that is currently running the server
- * @deffunc void ap_setup_prelinked_modules(process_rec *process)
  */
-AP_DECLARE(void) ap_setup_prelinked_modules(process_rec *process);
+AP_DECLARE(const char *) ap_setup_prelinked_modules(process_rec *process);
 
 /**
- *Show the preloaded configuration directives, the help string explaining
+ * Show the preloaded configuration directives, the help string explaining
  * the directive arguments, in what module they are handled, and in
  * what parts of the configuration they are allowed.  Used for httpd -h.
- * @deffunc void ap_show_directives(void)
  */
 AP_DECLARE(void) ap_show_directives(void);
 
 /** 
  * Show the preloaded module names.  Used for httpd -l. 
- * @deffunc void ap_show_modules(void)
  */
 AP_DECLARE(void) ap_show_modules(void);
 
 /** 
  * Show the MPM name.  Used in reporting modules such as mod_info to
  * provide extra information to the user
- * @deffunc const char *ap_show_mpm(void)
  */
 AP_DECLARE(const char *) ap_show_mpm(void);
 
 /**
  * Read all config files and setup the server
  * @param process The process running the server
- * @param temp_pool A pool to allocate temporary data out of.
+ * @param temp_pool A pool to allocate temporary data from.
  * @param config_name The name of the config file
  * @param conftree Place to store the root of the config tree
  * @return The setup server_rec list.
- * @deffunc server_rec *ap_read_config(process_rec *process, apr_pool_t *temp_pool, const char *config_name, ap_directive_t **conftree)
  */
-AP_DECLARE(server_rec *) ap_read_config(process_rec *process, apr_pool_t *temp_pool, const char *config_name, ap_directive_t **conftree);
+AP_DECLARE(server_rec *) ap_read_config(process_rec *process, 
+                                        apr_pool_t *temp_pool, 
+                                        const char *config_name, 
+                                        ap_directive_t **conftree);
 
 /**
  * Run all rewrite args hooks for loaded modules
  * @param process The process currently running the server
- * @deffunc void ap_run_rewrite_args(process_rec *process)
  */
 AP_DECLARE(void) ap_run_rewrite_args(process_rec *process);
 
@@ -821,32 +816,30 @@ AP_DECLARE(void) ap_run_rewrite_args(process_rec *process);
  * Run the register hooks function for a specified module
  * @param m The module to run the register hooks function fo
  * @param p The pool valid for the lifetime of the module
- * @deffunc void ap_register_hooks(module *m, apr_pool_t *p)
  */
 AP_DECLARE(void) ap_register_hooks(module *m, apr_pool_t *p);
 
 /**
  * Setup all virtual hosts
- * @param p The pool to allocate out of
+ * @param p The pool to allocate from
  * @param main_server The head of the server_rec list
- * @deffunc void ap_fixup_virtual_hosts(apr_pool_t *p, server_rec *main_server)
  */
-AP_DECLARE(void) ap_fixup_virtual_hosts(apr_pool_t *p, server_rec *main_server);
+AP_DECLARE(void) ap_fixup_virtual_hosts(apr_pool_t *p, 
+                                        server_rec *main_server);
 
 /* For http_request.c... */
 
 /**
  * Setup the config vector for a request_rec
- * @param p The pool to allocate the config vector out of
+ * @param p The pool to allocate the config vector from
  * @return The config vector
  */
-AP_DECLARE(ap_conf_vector_t*) ap_create_request_config(apr_pool_t *p);
+AP_CORE_DECLARE(ap_conf_vector_t*) ap_create_request_config(apr_pool_t *p);
 
 /**
  * Setup the config vector for per dir module configs
- * @param p The pool to allocate the config vector out of
+ * @param p The pool to allocate the config vector from
  * @return The config vector
- * @deffunc ap_conf_vector_t *ap_create_per_dir_config(apr_pool_t *p)
  */
 AP_CORE_DECLARE(ap_conf_vector_t *) ap_create_per_dir_config(apr_pool_t *p);
 
@@ -856,17 +849,17 @@ AP_CORE_DECLARE(ap_conf_vector_t *) ap_create_per_dir_config(apr_pool_t *p);
  * @param base The base directory config structure
  * @param new_conf The new directory config structure
  */
-ap_conf_vector_t *ap_merge_per_dir_configs(apr_pool_t *p,
+AP_CORE_DECLARE(ap_conf_vector_t*) ap_merge_per_dir_configs(apr_pool_t *p,
                                            ap_conf_vector_t *base,
                                            ap_conf_vector_t *new_conf);
 
 /* For http_connection.c... */
 /**
  * Setup the config vector for a connection_rec
- * @param p The pool to allocate the config vector out of
+ * @param p The pool to allocate the config vector from
  * @return The config vector
  */
-ap_conf_vector_t *ap_create_conn_config(apr_pool_t *p);
+AP_CORE_DECLARE(ap_conf_vector_t*) ap_create_conn_config(apr_pool_t *p);
 
 /* For http_core.c... (<Directory> command and virtual hosts) */
 
@@ -879,20 +872,24 @@ ap_conf_vector_t *ap_create_conn_config(apr_pool_t *p);
  * @param access_name The list of possible names for .htaccess files
  * int The status of the current request
  */
-int ap_parse_htaccess(ap_conf_vector_t **result, request_rec *r, int override,
-                      const char *path, const char *access_name);
+AP_CORE_DECLARE(int) ap_parse_htaccess(ap_conf_vector_t **result, 
+                                       request_rec *r, int override,
+                                       int override_opts,
+                                       const char *path, 
+                                       const char *access_name);
 
 /**
  * Setup a virtual host
- * @param p The pool to allocate all memory out of
+ * @param p The pool to allocate all memory from
  * @param hostname The hostname of the virtual hsot
  * @param main_server The main server for this Apache configuration
  * @param ps Place to store the new server_rec
  * return Error string on error, NULL on success
- * @deffunc const char *ap_init_virtual_host(apr_pool_t *p, const char *hostname, server_rec *main_server, server_rec **ps)
  */
-AP_CORE_DECLARE(const char *) ap_init_virtual_host(apr_pool_t *p, const char *hostname,
-                               server_rec *main_server, server_rec **);
+AP_CORE_DECLARE(const char *) ap_init_virtual_host(apr_pool_t *p, 
+                                                   const char *hostname,
+                                                   server_rec *main_server, 
+                                                   server_rec **ps);
 
 /**
  * Process the config file for Apache
@@ -902,8 +899,11 @@ AP_CORE_DECLARE(const char *) ap_init_virtual_host(apr_pool_t *p, const char *ho
  * @param p Pool for general allocation
  * @param ptem Pool for temporary allocation
  */
-void ap_process_resource_config(server_rec *s, const char *fname, 
-                 ap_directive_t **conftree, apr_pool_t *p, apr_pool_t *ptemp);
+AP_DECLARE(const char *) ap_process_resource_config(server_rec *s,
+                                                    const char *fname,
+                                                    ap_directive_t **conftree,
+                                                    apr_pool_t *p,
+                                                    apr_pool_t *ptemp);
 
 /**
  * Process all directives in the config tree
@@ -911,9 +911,12 @@ void ap_process_resource_config(server_rec *s, const char *fname,
  * @param conftree The config tree to process
  * @param p The pool for general allocation
  * @param ptemp The pool for temporary allocations
+ * @return OK if no problems
  */
-AP_DECLARE(void) ap_process_config_tree(server_rec *s, ap_directive_t *conftree,
-                                        apr_pool_t *p, apr_pool_t *ptemp);
+AP_DECLARE(int) ap_process_config_tree(server_rec *s,
+                                       ap_directive_t *conftree,
+                                       apr_pool_t *p,
+                                       apr_pool_t *ptemp);
 
 /* Module-method dispatchers, also for http_request.c */
 /**
@@ -922,7 +925,7 @@ AP_DECLARE(void) ap_process_config_tree(server_rec *s, ap_directive_t *conftree,
  * @param r The current request
  * @return The status of the current request
  */
-int ap_invoke_handler(request_rec *r);
+AP_CORE_DECLARE(int) ap_invoke_handler(request_rec *r);
 
 /* for mod_perl */
 
@@ -931,18 +934,18 @@ int ap_invoke_handler(request_rec *r);
  * @param name The directive to search for
  * @param cmds The table to search
  * @return The directive definition of the specified directive
- * @deffunc const command_rec *ap_find_command(const char *name, const command_rec *cmds)
  */
-AP_CORE_DECLARE(const command_rec *) ap_find_command(const char *name, const command_rec *cmds);
+AP_CORE_DECLARE(const command_rec *) ap_find_command(const char *name, 
+                                                     const command_rec *cmds);
 
 /**
  * Find a given directive in a list module
  * @param cmd_name The directive to search for
  * @param mod The module list to search
  * @return The directive definition of the specified directive
- * @deffunc const command_rec *ap_find_command_in_modules(const char *cmd_name,module **mod)
  */
-AP_CORE_DECLARE(const command_rec *) ap_find_command_in_modules(const char *cmd_name, module **mod);
+AP_CORE_DECLARE(const command_rec *) ap_find_command_in_modules(const char *cmd_name, 
+                                                                module **mod);
 
 /**
  * Ask a module to create per-server and per-section (dir/loc/file) configs
@@ -954,7 +957,6 @@ AP_CORE_DECLARE(const command_rec *) ap_find_command_in_modules(const char *cmd_
  * @param mod The module which is defining the config data.
  * @param pconf A pool for all configuration allocations.
  * @return The (new) per-section config data.
- * @deffunc void *ap_set_config_vectors(server_rec *server, ap_conf_vector_t *section_vector, const char *dir, module *mod, apr_pool_t *pconf)
  */
 AP_CORE_DECLARE(void *) ap_set_config_vectors(server_rec *server,
                                               ap_conf_vector_t *section_vector,
@@ -969,7 +971,6 @@ AP_CORE_DECLARE(void *) ap_set_config_vectors(server_rec *server,
  * Run the header parser functions for each module
  * @param r The current request
  * @return OK or DECLINED
- * @deffunc int ap_run_header_parser(request_rec *r)
  */
 AP_DECLARE_HOOK(int,header_parser,(request_rec *r))
 
@@ -978,9 +979,28 @@ AP_DECLARE_HOOK(int,header_parser,(request_rec *r))
  * @param pconf The config pool
  * @param plog The logging streams pool
  * @param ptemp The temporary pool
- * @deffunc void ap_run_pre_config(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t *ptemp)
+ * @return OK or DECLINED on success anything else is a error
+ */
+AP_DECLARE_HOOK(int,pre_config,(apr_pool_t *pconf,apr_pool_t *plog,
+                                apr_pool_t *ptemp))
+
+/**
+ * Run the check_config function for each module
+ * @param pconf The config pool
+ * @param plog The logging streams pool
+ * @param ptemp The temporary pool
+ * @return OK or DECLINED on success anything else is a error
+ */
+AP_DECLARE_HOOK(int,check_config,(apr_pool_t *pconf, apr_pool_t *plog,
+                                  apr_pool_t *ptemp, server_rec *s))
+
+/**
+ * Run the test_config function for each module; this hook is run
+ * only if the server was invoked to test the configuration syntax.
+ * @param pconf The config pool
+ * @param s The list of server_recs
  */
-AP_DECLARE_HOOK(void,pre_config,(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t *ptemp))
+AP_DECLARE_HOOK(void,test_config,(apr_pool_t *pconf, server_rec *s))
 
 /**
  * Run the post_config function for each module
@@ -988,9 +1008,10 @@ AP_DECLARE_HOOK(void,pre_config,(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t *
  * @param plog The logging streams pool
  * @param ptemp The temporary pool
  * @param s The list of server_recs
- * @deffunc void ap_run_post_config(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t *ptemp, server_rec *s)
+ * @return OK or DECLINED on success anything else is a error
  */
-AP_DECLARE_HOOK(void,post_config,(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t *ptemp,server_rec *s))
+AP_DECLARE_HOOK(int,post_config,(apr_pool_t *pconf,apr_pool_t *plog,
+                                 apr_pool_t *ptemp,server_rec *s))
 
 /**
  * Run the open_logs functions for each module
@@ -998,23 +1019,22 @@ AP_DECLARE_HOOK(void,post_config,(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t
  * @param plog The logging streams pool
  * @param ptemp The temporary pool
  * @param s The list of server_recs
- * @deffunc void ap_run_open_logs(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t *ptemp, server_rec *s)
+ * @return OK or DECLINED on success anything else is a error
  */
-AP_DECLARE_HOOK(void,open_logs,(apr_pool_t *pconf,apr_pool_t *plog,apr_pool_t *ptemp,server_rec *s))
+AP_DECLARE_HOOK(int,open_logs,(apr_pool_t *pconf,apr_pool_t *plog,
+                               apr_pool_t *ptemp,server_rec *s))
 
 /**
  * Run the child_init functions for each module
  * @param pchild The child pool
  * @param s The list of server_recs in this server 
- * @deffunc void ap_run_child_init(apr_pool_t *pchild, server_rec *s)
  */
 AP_DECLARE_HOOK(void,child_init,(apr_pool_t *pchild, server_rec *s))
 
 /**
  * Run the handler functions for each module
  * @param r The request_rec
- * @tip non-wildcard handlers should HOOK_MIDDLE, wildcard HOOK_LAST
- * @deffunc void ap_run_handler(request_rec *r)
+ * @remark non-wildcard handlers should HOOK_MIDDLE, wildcard HOOK_LAST
  */
 AP_DECLARE_HOOK(int,handler,(request_rec *r))
 
@@ -1022,17 +1042,19 @@ AP_DECLARE_HOOK(int,handler,(request_rec *r))
  * Run the quick handler functions for each module. The quick_handler
  * is run before any other requests hooks are called (location_walk,
  * directory_walk, access checking, et. al.). This hook was added
- * to provide a quick way to serve content out of a URI keyed cache.
+ * to provide a quick way to serve content from a URI keyed cache.
+ * 
  * @param r The request_rec
- * @deffunc void ap_run_quick_handler(request_rec *r)
+ * @param lookup_uri Controls whether the caller actually wants content or not.
+ * lookup is set when the quick_handler is called out of 
+ * ap_sub_req_lookup_uri()
  */
-AP_DECLARE_HOOK(int,quick_handler,(request_rec *r))
+AP_DECLARE_HOOK(int,quick_handler,(request_rec *r, int lookup_uri))
 
 /**
  * Retrieve the optional functions for each module.
  * This is run immediately before the server starts. Optional functions should
  * be registered during the hook registration phase.
- * @deffunc void ap_run_optional_fn_retrieve(void)
  */
 AP_DECLARE_HOOK(void,optional_fn_retrieve,(void))
 
@@ -1041,3 +1063,4 @@ AP_DECLARE_HOOK(void,optional_fn_retrieve,(void))
 #endif
 
 #endif /* !APACHE_HTTP_CONFIG_H */
+/** @} */