From: Stefan Fritsch <sf@apache.org>
Date: Tue, 26 Jul 2011 09:47:51 +0000 (+0000)
Subject: Document the weird semantics of ap_find_command_in_modules()
X-Git-Tag: 2.3.14^2~19
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ec8235ddbfacfcfc42930f52c4ce85fae7196a32;p=apache

Document the weird semantics of ap_find_command_in_modules()


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1151045 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/include/http_config.h b/include/http_config.h
index 4c5098af59..ab7de2792b 100644
--- a/include/http_config.h
+++ b/include/http_config.h
@@ -1169,10 +1169,13 @@ AP_CORE_DECLARE(const command_rec *) ap_find_command(const char *name,
                                                      const command_rec *cmds);
 
 /**
- * Find a given directive in a list module
+ * Find a given directive in a list of modules.
  * @param cmd_name The directive to search for
- * @param mod The module list to search
- * @return The directive definition of the specified directive
+ * @param mod Pointer to the first module in the linked list; will be set to
+ *            the module providing cmd_name
+ * @return The directive definition of the specified directive.
+ *         *mod will be changed to point to the module containing the
+ *         directive.
  */
 AP_CORE_DECLARE(const command_rec *) ap_find_command_in_modules(const char *cmd_name,
                                                                 module **mod);