From 474747ca982de536470ff3f4daca11dd3fb42bf9 Mon Sep 17 00:00:00 2001
From: Jeff Trawick <trawick@apache.org>
Date: Sat, 4 Aug 2012 12:16:58 +0000
Subject: [PATCH] mention migration from ap_requires() and to
 ap_runtime_dir_relative()

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1369300 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/developer/new_api_2_4.xml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/manual/developer/new_api_2_4.xml b/docs/manual/developer/new_api_2_4.xml
index ec231eda20c..0f537b20687 100644
--- a/docs/manual/developer/new_api_2_4.xml
+++ b/docs/manual/developer/new_api_2_4.xml
@@ -433,6 +433,14 @@
           would not have had a chance to enable support for this
           function.</dd>
 
+      <dt><code>ap_requires()</code></dt>
+      <dd>The core server now provides better infrastructure for handling
+          <directive module="mod_authz_core">Require</directive> configuration.
+          Register an auth provider function for each supported entity using
+          <code>ap_register_auth_provider()</code>.  The function will be
+          called as necessary during <directive>Require</directive>
+          processing.  (Consult bundled modules for detailed examples.)</dd>
+
       <dt><code>ap_server_conf->process->pool</code>
       userdata</dt>
       <dd>
@@ -542,6 +550,15 @@
 
     <dt>Implement cleanups which clear pointer variables</dt>
     <dd>Use <code>ap_pool_cleanup_set_null()</code>.</dd>
+
+    <dt>Create run-time files such as shared memory files, pid files,
+    etc.</dt>
+    <dd>Use <code>ap_runtime_dir_relative()</code> so that the global
+    configuration for the location of such files, either by the
+    DEFAULT_REL_RUNTIMEDIR compile setting or the
+    <directive module="core">DefaultRuntimeDir</directive> directive,
+    will be respected.  <em>Apache httpd 2.4.2 and above.</em></dd>
+
     </dl>
   </section>
 
-- 
2.47.3