You are viewing a plain text version of this content. The canonical link for it is here.

Posted to cvs@httpd.apache.org by rb...@apache.org on 2022/02/23 14:38:20 UTC

svn commit: r1898347 - /httpd/httpd/trunk/include/http_config.h

Author: rbowen
Date: Wed Feb 23 14:38:20 2022
New Revision: 1898347

URL: http://svn.apache.org/viewvc?rev=1898347&view=rev
Log:
Resolves BZ65861 - clarify post_config api doc

Modified:
    httpd/httpd/trunk/include/http_config.h

Modified: httpd/httpd/trunk/include/http_config.h
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/include/http_config.h?rev=1898347&r1=1898346&r2=1898347&view=diff
==============================================================================
--- httpd/httpd/trunk/include/http_config.h (original)
+++ httpd/httpd/trunk/include/http_config.h Wed Feb 23 14:38:20 2022
@@ -1350,6 +1350,16 @@ AP_DECLARE_HOOK(void,test_config,(apr_po
 
 /**
  * Run the post_config function for each module
+ *
+ * The function might be called multiple times.  @a pconf, @a plog, and
+ * @a ptemp may be cleared and/or destroyed between calls.
+ *
+ * The function will be called zero or one times with the server's state being
+ * #AP_SQ_MS_CREATE_PRE_CONFIG, and will be called one or more times with
+ * the server's state being #AP_SQ_MS_CREATE_CONFIG.
+ *
+ * @see ap_state_query(), #AP_SQ_MAIN_STATE
+ *
  * @param pconf The config pool
  * @param plog The logging streams pool
  * @param ptemp The temporary pool