Remove the default CacheKeyBaseURL value, it doesn't have any.

Improve syntax highlight and hyper-links.

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

1 files changed, 21 insertions, 22 deletions

diff --git a/docs/manual/mod/mod_cache.xml b/docs/manual/mod/mod_cache.xml
index 4c91c35110..c4d739162e 100644
--- a/docs/manual/mod/mod_cache.xml
+++ b/docs/manual/mod/mod_cache.xml
@@ -179,7 +179,7 @@ LoadModule cache_module modules/mod_cache.so
   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 unpredictably.</p>
-  <p>To keep the thundering herd at bay, the <directive>CacheLock</directive>
+  <p>To keep the thundering herd at bay, the <directive module="mod_cache">CacheLock</directive>
   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>
   by other requests to either suppress an attempt to cache (someone else has
@@ -213,8 +213,8 @@ LoadModule cache_module modules/mod_cache.so
     <p>As a further safety mechanism, locks have a configurable maximum age.
     Once this age has been reached, the lock is removed, and a new request is
     given the opportunity to create a new lock. This maximum age can be set using
-    the <directive>CacheLockMaxAge</directive> directive, and defaults to 5
-    seconds.
+    the <directive module="mod_cache">CacheLockMaxAge</directive> directive, and defaults
+    to 5 seconds.
     </p>
   </section>
   <section>
@@ -250,8 +250,8 @@ LoadModule cache_module modules/mod_cache.so
   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 <directive module="mod_cache">CacheQuickHandler
-  </directive> directive can be set to <strong>off</strong>, and the server will
+  <p>To solve this problem the <directive module="mod_cache">CacheQuickHandler</directive>
+  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 authorization</strong> phases.</p>
 
@@ -355,8 +355,8 @@ manager</description>
     <var>url-string</var>. The cache storage manager is specified with the
     <var>cache_type</var> argument. The <directive>CacheEnable</directive>
     directive can alternatively be placed inside either
-    <directive type="section">Location</directive> or
-    <directive type="section">LocationMatch</directive> sections to indicate
+    <directive type="section" module="core">Location</directive> or
+    <directive type="section" module="core">LocationMatch</directive> sections to indicate
     the content is cacheable.
     <var>cache_type</var> <code>disk</code> instructs
     <module>mod_cache</module> to use the disk based storage manager
@@ -370,8 +370,8 @@ manager</description>
     actually processes the request. The order in which the storage managers are
     run is determined by the order of the <directive>CacheEnable</directive>
     directives in the configuration file. <directive>CacheEnable</directive>
-    directives within <directive type="section">Location</directive> or
-    <directive type="section">LocationMatch</directive> sections are processed
+    directives within <directive type="section" module="core">Location</directive> or
+    <directive type="section" module="core">LocationMatch</directive> sections are processed
     before globally defined <directive>CacheEnable</directive> directives.</p>
 
     <p>When acting as a forward proxy server, <var>url-string</var> must
@@ -438,7 +438,7 @@ CacheEnable  disk  http://.example.org/
       </highlight>
     </example>
 
-    <p>If used in a <directive type="section">Location</directive> directive,
+    <p>If used in a <directive type="section" modeul="core">Location</directive> 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>
 
@@ -517,7 +517,7 @@ CacheEnable  disk  http://.example.org/
 <usage>
     <p>The <directive>CacheDefaultExpire</directive> directive specifies a default time,
     in seconds, to cache a document if neither an expiry date nor last-modified date are provided
-    with the document. The value specified with the <directive>CacheMaxExpire</directive>
+    with the document. The value specified with the <directive module="mod_cache">CacheMaxExpire</directive>
     directive does <em>not</em> override this setting.</p>
 
     <highlight language="config">
@@ -547,7 +547,7 @@ header.</description>
     should be considered for caching, even without a last-modified date.
     If neither a last-modified date nor an expiry date are provided with
     the document then the value specified by the
-    <directive>CacheDefaultExpire</directive> directive will be used to
+    <directive module="mod_cache">CacheDefaultExpire</directive> directive will be used to
     generate an expiration date.</p>
 
     <highlight language="config">
@@ -565,7 +565,7 @@ header.</description>
 </contextlist>
 
 <usage>
-    <p>Ordinarily, requests containing a Cache-Control: no-cache or
+    <p>Ordinarily, requests containing a <code>Cache-Control: no-cache</code> or
     Pragma: no-cache header value will not be served from the cache.  The
     <directive>CacheIgnoreCacheControl</directive> directive allows this
     behavior to be overridden.  <directive>CacheIgnoreCacheControl On</directive>
@@ -640,7 +640,7 @@ LastModified date.</description>
     expiry-date would be 3:00pm + 1hour = 4:00pm.
 
     If the expiry-period would be longer than that set by
-    <directive>CacheMaxExpire</directive>, then the latter takes
+    <directive module="mod_cache">CacheMaxExpire</directive>, then the latter takes
     precedence.</p>
 
     <highlight language="config">
@@ -786,7 +786,7 @@ LastModified date.</description>
 </contextlist>
 
 <usage>
-    <p>Ordinarily, responses with Cache-Control: private header values will not
+    <p>Ordinarily, responses with <code>Cache-Control: private</code> header values will not
        be stored in the cache.  The <directive>CacheStorePrivate</directive>
        directive allows this behavior to be overridden.
        <directive>CacheStorePrivate</directive> On
@@ -819,7 +819,7 @@ LastModified date.</description>
 </contextlist>
 
 <usage>
-    <p>Ordinarily, requests or responses with Cache-Control: no-store header
+    <p>Ordinarily, requests or responses with <code>Cache-Control: no-store</code> header
        values will not be stored in the cache.  The
        <directive>CacheStoreNoStore</directive> directive allows this
        behavior to be overridden.  <directive>CacheStoreNoStore</directive> On
@@ -912,7 +912,7 @@ CacheLock on
   <compatibility>Apache HTTP Server 2.3.3 and later</compatibility>
 
   <usage>
-    <p>The <directive module="mod_cache">CacheQuickHandler</directive> directive
+    <p>The <directive>CacheQuickHandler</directive> directive
     controls the phase in which the cache is handled.</p>
 
     <p>In the default enabled configuration, the cache operates within the quick
@@ -961,7 +961,7 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
 <compatibility>Available in Apache 2.3.9 and later</compatibility>
 
 <usage>
-  <p>When the <directive module="mod_cache">CacheHeader</directive> directive
+  <p>When the <directive>CacheHeader</directive> 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 <directive type="section" module="core">Directory</directive>
@@ -1003,7 +1003,7 @@ CacheHeader on
 <compatibility>Available in Apache 2.3.9 and later</compatibility>
 
 <usage>
-  <p>When the <directive module="mod_cache">CacheDetailHeader</directive> directive
+  <p>When the <directive>CacheDetailHeader</directive> directive
   is switched on, an <strong>X-Cache-Detail</strong> header will be added to the response
   containing the detailed reason for a particular caching decision.</p>
 
@@ -1034,14 +1034,13 @@ CacheDetailHeader on
 <name>CacheKeyBaseURL</name>
 <description>Override the base URL of reverse proxied cache keys.</description>
 <syntax>CacheKeyBaseURL <var>URL</var></syntax>
-<default>CacheKeyBaseURL http://example.com</default>
 <contextlist><context>server config</context>
 <context>virtual host</context>
 </contextlist>
 <compatibility>Available in Apache 2.3.9 and later</compatibility>
 
 <usage>
-  <p>When the <directive module="mod_cache">CacheKeyBaseURL</directive> directive
+  <p>When the <directive>CacheKeyBaseURL</directive> directive
   is specified, the URL provided will be used as the base URL to calculate
   the URL of the cache keys in the reverse proxy configuration. When not specified,
   the scheme, hostname and port of the current virtual host is used to construct
@@ -1074,7 +1073,7 @@ CacheKeyBaseURL http://www.example.com/
 <compatibility>Available in Apache 2.3.9 and later</compatibility>
 
 <usage>
-  <p>When the <directive module="mod_cache">CacheStaleOnError</directive> directive
+  <p>When the <directive>CacheStaleOnError</directive> directive
   is switched on, and when stale data is available in the cache, the cache will
   respond to 5xx responses from the backend by returning the stale data instead of
   the 5xx response. While the Cache-Control headers sent by clients will be respected,