From: Graham Leggett <minfrin@apache.org>
Date: Wed, 13 Oct 2010 18:43:23 +0000 (+0000)
Subject: Ooh look, new and shiny things in v2.4.
X-Git-Tag: 2.3.9~325
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6c1f4e708a609ee7d3c12eb476f9f5c659d8095f;p=apache

Ooh look, new and shiny things in v2.4.


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

diff --git a/docs/manual/developer/new_api_2_4.xml b/docs/manual/developer/new_api_2_4.xml
index 48fa28c4a6..fc7a69eb71 100644
--- a/docs/manual/developer/new_api_2_4.xml
+++ b/docs/manual/developer/new_api_2_4.xml
@@ -174,12 +174,28 @@
     <p>Introduces the new provider framework for authn and authz</p>
   </section>
 
+  <section id="mod_cache">
+    <title>mod_cache (changed)</title>
+    <p>Introduces a commit_entity() function to the cache provider interface,
+    allowing atomic writes to cache. Add a cache_status() hook to report
+    the cache decision. Remove all private structures and functions from the
+    public mod_cache.h header file.</p>
+  </section>
+
   <section id="mod_core">
     <title>mod_core (NEW!)</title>
     <p>This introduces low-level APIs to send arbitrary headers,
     and exposes functions to handle HTTP OPTIONS and TRACE.</p>
   </section>
 
+  <section id="mod_disk_cache">
+    <title>mod_disk_cache (changed)</title>
+    <p>Changes the disk format of the disk cache to support atomic cache
+    updates without locking. The device/inode pair of the body file is
+    embedded in the header file, allowing confirmation that the header
+    and body belong to one another.</p>
+  </section>
+
   <section id="mod_request">
     <title>mod_request (NEW!)</title>
     <p>The API for <module>mod_request</module>, to make input data
diff --git a/docs/manual/new_features_2_4.xml b/docs/manual/new_features_2_4.xml
index aa26f81f49..67c34cdd65 100644
--- a/docs/manual/new_features_2_4.xml
+++ b/docs/manual/new_features_2_4.xml
@@ -81,6 +81,22 @@
       <dt><module>mod_proxy_fcgi</module></dt>
 
       <dd>FastCGI Protocol backend for <module>mod_proxy</module></dd>
+
+      <dt><module>mod_cache</module></dt>
+
+      <dd><module>mod_cache</module> can now cache HEAD requests.</dd>
+
+      <dd>Where possible, <module>mod_cache</module> directives can now be set
+      per directory, instead of per server.</dd>
+
+      <dd>The base URL of cached URLs can be customised, so that a cluster of
+      caches can share the same endpoint URL prefix.</dd>
+
+      <dd><module>mod_cache</module> is now capable of serving stale cached
+      data when a backend is unavailable (error 5xx).</dd>
+
+      <dd><module>mod_cache</module> can now insert HIT/MISS/REVALIDATE into
+      an X-Cache header.</dd>
     </dl>
   </section>
 
@@ -89,6 +105,16 @@
     <dl>
         <dt>fcgistarter</dt>
         <dd>FastCGI deamon starter utility</dd>
+        <dt>htcacheclean</dt>
+        <dd>Current cached URLs can now be listed, with optional metadata
+        included.</dd>
+        <dd>Allow explicit deletion of individual cached URLs from the
+        cache.</dd>
+        <dd>File sizes can now be rounded up to the given block size, making
+        the size limits map more closely to the real size on disk.</dd>
+        <dd>Cache size can now be limited by the number of inodes, instead
+        of or in addition to being limited by the size of the files on
+        disk.</dd>
     </dl>
   </section>
 
@@ -133,6 +159,13 @@
       files, and a memcache distributed cache are currently
       supported.</dd>
 
+      <dt>Cache Status Hook Added</dt>
+      
+      <dd>The <module>mod_cache</module> module now includes a new
+      <code>cache_status</code> hook, which is called when the caching
+      decision becomes known. A default implementation is provided
+      which adds an optional <code>X-Cache</code> and
+      <code>X-Cache-Detail</code> header to the response.</dd>
     </dl>
 
     <p>The developer documentation contains a