httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From traw...@apache.org
Subject svn commit: r1082933 - /httpd/httpd/trunk/docs/manual/developer/new_api_2_4.xml
Date Fri, 18 Mar 2011 14:21:02 GMT
Author: trawick
Date: Fri Mar 18 14:21:01 2011
New Revision: 1082933

URL: http://svn.apache.org/viewvc?rev=1082933&view=rev
Log:
describe the ap_log_error(...,ap_server_conf,...) idiom

Modified:
    httpd/httpd/trunk/docs/manual/developer/new_api_2_4.xml

Modified: httpd/httpd/trunk/docs/manual/developer/new_api_2_4.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/developer/new_api_2_4.xml?rev=1082933&r1=1082932&r2=1082933&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/developer/new_api_2_4.xml (original)
+++ httpd/httpd/trunk/docs/manual/developer/new_api_2_4.xml Fri Mar 18 14:21:01 2011
@@ -286,6 +286,18 @@
        <code>ap_log_*</code> without additional wrappers. In this way, the
        code will remain compatible with HTTPD 2.0 and 2.2.</p>
 
+    <p>A <code>server_rec</code> pointer must be passed to 
+       <code>ap_log_error()</code> when called after startup.  This
+       was always appropriate, but there are even more limitations with
+       a <code>NULL</code> <code>server_rec</code> in 2.4 than in
+       previous releases.  Beginning with 2.3.12, the global variable
+       <code>ap_server_conf</code> can always be used as
+       the <code>server_rec</code> parameter, as it will be
+       <code>NULL</code> only when it is valid to pass <code>NULL</code>
+       to <code>ap_log_error()</code>.  <code>ap_server_conf</code>
+       should be used only when a more appropriate <code>server_rec</code>
+       is not available.</p> 
+
     <p>Consider the following changes to take advantage of the new
        <code>APLOG_TRACE1..8</code> log levels:</p>
        <ul>



Mime
View raw message