]> granicus.if.org Git - apache/blobdiff - docs/manual/mod/mod_cache.html.en
Correct according to the comments in online doc
[apache] / docs / manual / mod / mod_cache.html.en
index e0ee864361f5edb9a0d4224c04110315ec5d3699..9736df276e6fb0fa0ea823bdca9708ee3f4639f8 100644 (file)
@@ -9,13 +9,13 @@
 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
-<script src="../style/scripts/prettify.js" type="text/javascript">
+<script src="../style/scripts/prettify.min.js" type="text/javascript">
 </script>
 
 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
 <body>
 <div id="page-header">
-<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
 <p class="apache">Apache HTTP Server Version 2.5</p>
 <img alt="" src="../images/feather.gif" /></div>
 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
     HTTP header with a 111 response code.</p>
 
     <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> requires the services of one or more
-    storage management modules. One storage management module is included in
+    storage management modules. The following storage management modules are included in
     the base Apache distribution:</p>
     <dl>
     <dt><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></dt>
 </ul><h3>See also</h3>
 <ul class="seealso">
 <li><a href="../caching.html">Caching Guide</a></li>
-</ul></div>
+</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="related" id="related">Related Modules and Directives</a></h2>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="sampleconf" id="sampleconf">Sample Configuration</a></h2>
-    <div class="example"><h3>Sample httpd.conf</h3><pre class="prettyprint lang-config">
-#
+    <div class="example"><h3>Sample httpd.conf</h3><pre class="prettyprint lang-config">#
 # Sample Cache Configuration
 #
 LoadModule cache_module modules/mod_cache.so
@@ -185,8 +184,7 @@ LoadModule cache_module modules/mod_cache.so
     
     # When acting as a proxy, don't cache the list of security updates
     CacheDisable http://security.update.server/update-list/
-&lt;/IfModule&gt;
-      </pre>
+&lt;/IfModule&gt;</pre>
 </div>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
@@ -198,7 +196,7 @@ LoadModule cache_module modules/mod_cache.so
   becomes stale, and the time the stale entity is fully refreshed. On a busy
   server, a significant number of requests might arrive during this time, and
   cause a <strong>thundering herd</strong> of requests to strike the backend
-  suddenly and unpredicably.</p>
+  suddenly and unpredictably.</p>
   <p>To keep the thundering herd at bay, the <code class="directive">CacheLock</code>
   directive can be used to define a directory in which locks are created for
   URLs <strong>in flight</strong>. The lock is used as a <strong>hint</strong>
@@ -239,16 +237,14 @@ LoadModule cache_module modules/mod_cache.so
   
   <h3>Example configuration</h3>
     
-    <div class="example"><h3>Enabling the cache lock</h3><pre class="prettyprint lang-config">
-#
+    <div class="example"><h3>Enabling the cache lock</h3><pre class="prettyprint lang-config">#
 # Enable the cache lock
 #
 &lt;IfModule mod_cache.c&gt;
     CacheLock on
     CacheLockPath /tmp/mod_cache-lock
     CacheLockMaxAge 5
-&lt;/IfModule&gt;
-      </pre>
+&lt;/IfModule&gt;</pre>
 </div>
   
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -265,14 +261,14 @@ LoadModule cache_module modules/mod_cache.so
   <p>While this mode offers the best performance, the administrator may find that
   under certain circumstances they may want to perform further processing on the
   request after the request is cached, such as to inject personalisation into the
-  cached page, or to apply authorisation restrictions to the content. Under these
+  cached page, or to apply authorization restrictions to the content. Under these
   circumstances, an administrator is often forced to place independent reverse
   proxy servers either behind or in front of the caching server to achieve this.</p>
 
-  <p>To solve this problem the <code class="directive"><a href="#cachequickhandler&#10;  ">CacheQuickHandler
+  <p>To solve this problem the <code class="directive"><a href="#cachequickhandler">CacheQuickHandler
   </a></code> directive can be set to <strong>off</strong>, and the server will
   process all phases normally handled by a non-cached request, including the
-  <strong>authentication and authorisation</strong> phases.</p>
+  <strong>authentication and authorization</strong> phases.</p>
 
   <p>In addition, the administrator may optionally specify the <strong>precise point
   within the filter chain</strong> where caching is to take place by adding the
@@ -282,11 +278,9 @@ LoadModule cache_module modules/mod_cache.so
   place the <strong>CACHE</strong> filter before the <strong>DEFLATE</strong>
   filter as in the example below:</p>
 
-  <pre class="prettyprint lang-config">
-# Cache content before optional compression
+  <pre class="prettyprint lang-config"># Cache content before optional compression
 CacheQuickHandler off
-AddOutputFilterByType CACHE;DEFLATE text/plain
-  </pre>
+AddOutputFilterByType CACHE;DEFLATE text/plain</pre>
 
 
   <p>Another option is to have content cached before personalisation is applied
@@ -294,11 +288,9 @@ AddOutputFilterByType CACHE;DEFLATE text/plain
   example templates containing tags understood by
   <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> are cached before being parsed:</p>
 
-  <pre class="prettyprint lang-config">
-# Cache content before mod_include and mod_deflate
+  <pre class="prettyprint lang-config"># Cache content before mod_include and mod_deflate
 CacheQuickHandler off
-AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
-  </pre>
+AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html</pre>
 
 
   <p>You may place the <strong>CACHE</strong> filter anywhere you wish within the
@@ -306,11 +298,9 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
   <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, but before being processed by
   <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>:</p>
 
-  <pre class="prettyprint lang-config">
-# Cache content between mod_include and mod_deflate
+  <pre class="prettyprint lang-config"># Cache content between mod_include and mod_deflate
 CacheQuickHandler off
-AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html
-  </pre>
+AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html</pre>
 
 
   <div class="warning"><h3>Warning:</h3>If the location of the
@@ -329,9 +319,7 @@ AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html
   <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> directive as
   follows:</p>
 
-  <pre class="prettyprint lang-config">
-    LogFormat "%{cache-status}e ..."
-  </pre>
+  <pre class="prettyprint lang-config">LogFormat "%{cache-status}e ..."</pre>
 
 
   <p>Based on the caching decision made, the reason is also written to the
@@ -349,12 +337,10 @@ AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html
   <p>This makes it possible to support conditional logging of cached requests
   as per the following example:</p>
 
-  <pre class="prettyprint lang-config">
-CustomLog cached-requests.log common env=cache-hit
+  <pre class="prettyprint lang-config">CustomLog cached-requests.log common env=cache-hit
 CustomLog uncached-requests.log common env=cache-miss
 CustomLog revalidated-requests.log common env=cache-revalidate
-CustomLog invalidated-requests.log common env=cache-invalidate
-  </pre>
+CustomLog invalidated-requests.log common env=cache-invalidate</pre>
 
 
   <p>For module authors, a hook called <var>cache_status</var> is available,
@@ -376,9 +362,7 @@ CustomLog invalidated-requests.log common env=cache-invalidate
     with the document. The value specified with the <code class="directive">CacheMaxExpire</code>
     directive does <em>not</em> override this setting.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheDefaultExpire 86400
-    </pre>
+    <pre class="prettyprint lang-config">CacheDefaultExpire 86400</pre>
 
 
 </div>
@@ -403,15 +387,13 @@ CustomLog invalidated-requests.log common env=cache-invalidate
   used by the service and client.</p>
 
   <p>If the normal handler is used, this directive may appear within a
-  <code class="directive"><a href="../mod/core.html#&lt;directory&gt;">&lt;Directory&gt;</a></code> or
-  <code class="directive"><a href="../mod/core.html#&lt;location&gt;">&lt;Location&gt;</a></code> directive. If the quick handler
+  <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> or
+  <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> directive. If the quick handler
   is used, this directive must appear within a server or virtual host context, otherwise
   the setting will be ignored.</p>
 
-  <pre class="prettyprint lang-config">
-# Enable the X-Cache-Detail header
-CacheDetailHeader on
-  </pre>
+  <pre class="prettyprint lang-config"># Enable the X-Cache-Detail header
+CacheDetailHeader on</pre>
 
 
   <div class="example"><p><code>
@@ -433,20 +415,16 @@ CacheDetailHeader on
     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> to <em>not</em> cache urls at or below
     <var>url-string</var>.</p>
 
-    <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">
-      CacheDisable /local_files
-      </pre>
+    <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">CacheDisable /local_files</pre>
 </div>
 
     <p>If used in a <code class="directive">&lt;Location&gt;</code> directive,
     the path needs to be specified below the Location, or if the word "on"
     is used, caching for the whole location will be disabled.</p>
 
-    <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">
-&lt;Location /foo&gt;
+    <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">&lt;Location /foo&gt;
     CacheDisable on
-&lt;/Location&gt;
-      </pre>
+&lt;/Location&gt;</pre>
 </div>
 
     <p>The <code>no-cache</code> environment variable can be set to
@@ -465,9 +443,11 @@ CacheDetailHeader on
 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable caching of specified URLs using a specified storage
 manager</td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheEnable <var>cache_type</var> [<var>url-string</var>]</code></td></tr>
-<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>A url-string of '/' applied to forward proxy content in 2.2 and
+ earlier.</td></tr>
 </table>
     <p>The <code class="directive">CacheEnable</code> directive instructs
     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> to cache urls at or below
@@ -493,42 +473,39 @@ manager</td></tr>
     <code class="directive">&lt;LocationMatch&gt;</code> sections are processed
     before globally defined <code class="directive">CacheEnable</code> directives.</p>
 
-    <p>When acting as a forward proxy server, <var>url-string</var> can
-    also be used to specify remote sites and proxy protocols which
-    caching should be enabled for.</p>
+    <p>When acting as a forward proxy server, <var>url-string</var> must 
+    minimally begin with a protocol for which caching should be enabled.</p>
 
-    <pre class="prettyprint lang-config">
-# Cache content
+    <pre class="prettyprint lang-config"># Cache content (normal handler only)
+CacheQuickHandler off
 &lt;Location /foo&gt;
     CacheEnable disk
 &lt;/Location&gt;
 
-# Cache regex
+# Cache regex (normal handler only)
+CacheQuickHandler off
 &lt;LocationMatch foo$&gt;
     CacheEnable disk
 &lt;/LocationMatch&gt;
 
-# Cache proxied url's
+# Cache all but forward proxy url's (normal or quick handler)
 CacheEnable  disk  /
 
-# Cache FTP-proxied url's
+# Cache FTP-proxied url's (normal or quick handler)
 CacheEnable  disk  ftp://
 
-# Cache content from www.example.org
-CacheEnable  disk  http://www.example.org/
-    </pre>
+# Cache forward proxy content from www.example.org (normal or quick handler)
+CacheEnable  disk  http://www.example.org/</pre>
 
 
     <p>A hostname starting with a <strong>"*"</strong> matches all hostnames with
     that suffix. A hostname starting with <strong>"."</strong> matches all
     hostnames containing the domain components that follow.</p>
 
-    <pre class="prettyprint lang-config">
-# Match www.example.org, and fooexample.org
+    <pre class="prettyprint lang-config"># Match www.example.org, and fooexample.org
 CacheEnable  disk  http://*example.org/
 # Match www.example.org, but not fooexample.org
-CacheEnable  disk  http://.example.org/
-    </pre>
+CacheEnable  disk  http://.example.org/</pre>
 
 
     <p> The <code>no-cache</code> environment variable can be set to
@@ -555,8 +532,8 @@ CacheEnable  disk  http://.example.org/
   <p>When the <code class="directive"><a href="#cacheheader">CacheHeader</a></code> directive
   is switched on, an <strong>X-Cache</strong> header will be added to the response
   with the cache status of this response. If the normal handler is used, this
-  directive may appear within a <code class="directive"><a href="../mod/core.html#&lt;directory&gt;">&lt;Directory&gt;</a></code>
-  or <code class="directive"><a href="../mod/core.html#&lt;location&gt;">&lt;Location&gt;</a></code> directive. If the quick
+  directive may appear within a <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>
+  or <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> directive. If the quick
   handler is used, this directive must appear within a server or virtual host
   context, otherwise the setting will be ignored.</p>
 
@@ -569,15 +546,11 @@ CacheEnable  disk  http://.example.org/
       server and was not served from cache.</dd>
   </dl>
 
-  <pre class="prettyprint lang-config">
-# Enable the X-Cache header
-CacheHeader on
-  </pre>
+  <pre class="prettyprint lang-config"># Enable the X-Cache header
+CacheHeader on</pre>
 
 
-  <pre class="prettyprint lang-config">
-    X-Cache: HIT from localhost
-  </pre>
+  <pre class="prettyprint lang-config">X-Cache: HIT from localhost</pre>
 
 
 
@@ -597,12 +570,9 @@ CacheHeader on
     <code class="directive">CacheIgnoreCacheControl</code> directive allows this
     behavior to be overridden.  <code class="directive">CacheIgnoreCacheControl On</code>
     tells the server to attempt to serve the resource from the cache even
-    if the request contains no-cache header values.  Resources requiring
-    authorization will <em>never</em> be cached.</p>
+    if the request contains no-cache header values.</p>  
 
-    <pre class="prettyprint lang-config">
-      CacheIgnoreCacheControl On
-    </pre>
+    <pre class="prettyprint lang-config">CacheIgnoreCacheControl On</pre>
 
 
     <div class="warning"><h3>Warning:</h3>
@@ -654,14 +624,10 @@ CacheHeader on
     behaviour), <code class="directive">CacheIgnoreHeaders</code> can be set to
     <code>None</code>.</p>
 
-    <div class="example"><h3>Example 1</h3><pre class="prettyprint lang-config">
-      CacheIgnoreHeaders Set-Cookie
-      </pre>
+    <div class="example"><h3>Example 1</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders Set-Cookie</pre>
 </div>
 
-    <div class="example"><h3>Example 2</h3><pre class="prettyprint lang-config">
-      CacheIgnoreHeaders None
-      </pre>
+    <div class="example"><h3>Example 2</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders None</pre>
 </div>
 
     <div class="warning"><h3>Warning:</h3>
@@ -694,9 +660,7 @@ header.</td></tr>
     <code class="directive">CacheDefaultExpire</code> directive will be used to
     generate an expiration date.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheIgnoreNoLastMod On
-    </pre>
+    <pre class="prettyprint lang-config">CacheIgnoreNoLastMod On</pre>
 
 
 </div>
@@ -719,9 +683,7 @@ header.</td></tr>
     view the request is treated as if having no query string when this
     directive is enabled.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheIgnoreQueryString On
-    </pre>
+    <pre class="prettyprint lang-config">CacheIgnoreQueryString On</pre>
 
 
 
@@ -753,14 +715,10 @@ header.</td></tr>
     <p><code>CacheIgnoreURLSessionIdentifiers None</code> clears the list of ignored
     identifiers. Otherwise, each identifier is added to the list.</p>
 
-    <div class="example"><h3>Example 1</h3><pre class="prettyprint lang-config">
-      CacheIgnoreURLSessionIdentifiers jsessionid
-      </pre>
+    <div class="example"><h3>Example 1</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers jsessionid</pre>
 </div>
 
-    <div class="example"><h3>Example 2</h3><pre class="prettyprint lang-config">
-      CacheIgnoreURLSessionIdentifiers None
-      </pre>
+    <div class="example"><h3>Example 2</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers None</pre>
 </div>
 
 
@@ -784,10 +742,8 @@ header.</td></tr>
   should be cached beneath the same cache key, a new base URL can be specified
   with this directive.</p>
 
-  <pre class="prettyprint lang-config">
-# Override the base URL of the cache key.
-CacheKeyBaseURL http://www.example.com/
-  </pre>
+  <pre class="prettyprint lang-config"># Override the base URL of the cache key.
+CacheKeyBaseURL http://www.example.com/</pre>
 
 
   <div class="warning">Take care when setting this directive. If two separate virtual
@@ -826,9 +782,7 @@ LastModified date.</td></tr>
     <code class="directive">CacheMaxExpire</code>, then the latter takes
     precedence.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheLastModifiedFactor 0.5
-    </pre>
+    <pre class="prettyprint lang-config">CacheLastModifiedFactor 0.5</pre>
 
 
 </div>
@@ -841,20 +795,19 @@ LastModified date.</td></tr>
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.2.15 and later</td></tr>
 </table>
   <p>The <code class="directive">CacheLock</code> directive enables the thundering herd lock
   for the given URL space.</p>
 
   <p>In a minimal configuration the following directive is all that is needed to
-  enable the thundering herd lock in the default system temp directory.</p>
+  enable the thundering herd lock in the default run-time file directory.</p>
 
-  <pre class="prettyprint lang-config">
-# Enable cache lock
-CacheLock on
-  </pre>
+  <pre class="prettyprint lang-config"># Enable cache lock
+CacheLock on</pre>
 
 
+  <p>Locks consist of empty files that only exist for stale URLs in flight, so this
+  is significantly less resource intensive than the traditional disk cache.</p>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -882,17 +835,15 @@ CacheLock on
 <table class="directive">
 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the lock path directory.</td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheLockPath <var>directory</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheLockPath /tmp/mod_cache-lock</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheLockPath mod_cache-lock</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 </table>
   <p>The <code class="directive">CacheLockPath</code> directive allows you to specify the
-  directory in which the locks are created. By default, the system's temporary
-  folder is used. Locks consist of empty files that only exist for stale URLs
-  in flight, so is significantly less resource intensive than the traditional
-  disk cache.</p>
-
+  directory in which the locks are created.  If <var>directory</var> is not an absolute
+  path, the location specified will be relative to the value of 
+  <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -910,9 +861,7 @@ CacheLock on
     server. Thus, documents will be out of date at most this number of seconds. This maximum
     value is enforced even if an expiry date was supplied with the document.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheMaxExpire 604800
-    </pre>
+    <pre class="prettyprint lang-config">CacheMaxExpire 604800</pre>
 
 
 </div>
@@ -931,9 +880,7 @@ CacheLock on
     server. This is only used if no valid expire time was supplied with the document.</p>
 
 
-    <pre class="prettyprint lang-config">
-      CacheMinExpire 3600
-    </pre>
+    <pre class="prettyprint lang-config">CacheMinExpire 3600</pre>
 
 
 </div>
@@ -960,12 +907,10 @@ CacheLock on
     <p>When disabled, the cache operates as a normal handler, and is subject to
     the full set of phases when handling a server request. While this mode is
     slower than the default, it allows the cache to be used in cases where full
-    processing is required, such as when content is subject to authorisation.</p>
+    processing is required, such as when content is subject to authorization.</p>
 
-    <pre class="prettyprint lang-config">
-# Run cache as a normal handler
-CacheQuickHandler off
-    </pre>
+    <pre class="prettyprint lang-config"># Run cache as a normal handler
+CacheQuickHandler off</pre>
 
 
     <p>It is also possible, when the quick handler is disabled, for the
@@ -973,11 +918,9 @@ CacheQuickHandler off
     caching is to be performed, by adding the <strong>CACHE</strong> filter to
     the chain.</p>
 
-    <pre class="prettyprint lang-config">
-# Cache content before mod_include and mod_deflate
+    <pre class="prettyprint lang-config"># Cache content before mod_include and mod_deflate
 CacheQuickHandler off
-AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
-    </pre>
+AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html</pre>
 
 
     <p>If the CACHE filter is specified more than once, the last instance will
@@ -1003,10 +946,8 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
   and the raw 5xx responses returned to the client on request, the 5xx response so
   returned to the client will not invalidate the content in the cache.</p>
 
-  <pre class="prettyprint lang-config">
-# Serve stale data on error.
-CacheStaleOnError on
-  </pre>
+  <pre class="prettyprint lang-config"># Serve stale data on error.
+CacheStaleOnError on</pre>
 
 
 
@@ -1030,9 +971,7 @@ CacheStaleOnError on
        the origin server, and the response may be fulfilled from cache
        if the backend resource has not changed.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheStoreExpired On
-    </pre>
+    <pre class="prettyprint lang-config">CacheStoreExpired On</pre>
 
 
 </div>
@@ -1051,12 +990,9 @@ CacheStaleOnError on
        <code class="directive">CacheStoreNoStore</code> directive allows this
        behavior to be overridden.  <code class="directive">CacheStoreNoStore</code> On
        tells the server to attempt to cache the resource even if it contains
-       no-store header values.  Resources requiring authorization will
-       <em>never</em> be cached.</p>
+       no-store header values.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheStoreNoStore On
-    </pre>
+    <pre class="prettyprint lang-config">CacheStoreNoStore On</pre>
 
 
     <div class="warning"><h3>Warning:</h3>
@@ -1087,12 +1023,9 @@ CacheStaleOnError on
        directive allows this behavior to be overridden.
        <code class="directive">CacheStorePrivate</code> On
        tells the server to attempt to cache the resource even if it contains
-       private header values.  Resources requiring authorization will
-       <em>never</em> be cached.</p>
+       private header values.</p>
 
-    <pre class="prettyprint lang-config">
-      CacheStorePrivate On
-    </pre>
+    <pre class="prettyprint lang-config">CacheStorePrivate On</pre>
 
 
     <div class="warning"><h3>Warning:</h3>
@@ -1113,10 +1046,27 @@ CacheStaleOnError on
 <a href="../fr/mod/mod_cache.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/mod/mod_cache.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
-</div><div id="footer">
-<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
-<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
-if (typeof(prettyPrint) !== undefined) {
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache.html';
+(function(w, d) {
+    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+        d.write('<div id="comments_thread"><\/div>');
+        var s = d.createElement('script');
+        s.type = 'text/javascript';
+        s.async = true;
+        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+    }
+    else {
+        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+    }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
     prettyPrint();
 }
 //--><!]]></script>