Updating to reflect current defaults

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

diff --git a/docs/manual/mod/mod_disk_cache.html.en b/docs/manual/mod/mod_disk_cache.html.en
index 2b0294ecc287521c443ca133a984480653e9aa10..e6f09a907bd58612977d5ebf4e3e8264fe97df8b 100644 (file)
--- a/docs/manual/mod/mod_disk_cache.html.en
+++ b/docs/manual/mod/mod_disk_cache.html.en
@@ -67,16 +67,19 @@
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_disk_cache</td></tr>
 </table>
     <p>The <code class="directive">CacheDirLength</code> directive sets the number
-    of characters for each subdirectory name in the cache hierarchy.</p>
+    of characters for each subdirectory name in the cache hierarchy. It can
+    be used in conjunction with <code class="directive">CacheDirLevels</code> to
+    determine the approximate structure of your cache hierarchy.</p>
+    <p>A high value for <code class="directive">CacheDirLength</code> combined
+    with a low value for <code class="directive">CacheDirLevels</code> will result in
+    a relatively flat hierarchy, with a large number of subdirectories at each
+    level.</p>
 
     <div class="note">
       <p>The result of <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code>* <code class="directive">CacheDirLength</code>
       must not be higher than 20.</p>
     </div>
 
-    <div class="example"><p><code>
-      CacheDirLength  4
-    </code></p></div>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -85,7 +88,7 @@
 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The number of levels of subdirectories in the
 cache.</td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CacheDirLevels <var>levels</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheDirLevels 3</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CacheDirLevels 2</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_disk_cache</td></tr>
@@ -93,6 +96,10 @@ cache.</td></tr>
     <p>The <code class="directive">CacheDirLevels</code> directive sets the number
     of subdirectory levels in the cache. Cached data will be saved this
     many directory levels below the <code class="directive"><a href="#cacheroot">CacheRoot</a></code> directory.</p>
+    <p>A high value for <code class="directive">CacheDirLevels</code> combined
+    with a low value for <code class="directive">CacheDirLength</code> will result in
+    a relatively deep hierarchy, with a small number of subdirectories at each
+    level.</p>
 
     <div class="note">
       <p>The result of <code class="directive">CacheDirLevels</code>*
@@ -100,9 +107,6 @@ cache.</td></tr>
       not be higher than 20.</p>
     </div>
 
-    <div class="example"><p><code>
-      CacheDirLevels  5
-    </code></p></div>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

diff --git a/docs/manual/mod/mod_disk_cache.xml b/docs/manual/mod/mod_disk_cache.xml
index 806fe0bb65d683750376c6ef7edfcc4d608571fc..de3df92ed982742a2a417f385f663a4fa72a7608 100644 (file)
--- a/docs/manual/mod/mod_disk_cache.xml
+++ b/docs/manual/mod/mod_disk_cache.xml
@@ -75,7 +75,7 @@ stored</description>
 <description>The number of levels of subdirectories in the
 cache.</description>
 <syntax>CacheDirLevels <var>levels</var></syntax>
-<default>CacheDirLevels 3</default>
+<default>CacheDirLevels 2</default>
 <contextlist><context>server config</context><context>virtual host</context>
 </contextlist>
 
@@ -84,6 +84,10 @@ cache.</description>
     of subdirectory levels in the cache. Cached data will be saved this
     many directory levels below the <directive module="mod_disk_cache"
     >CacheRoot</directive> directory.</p>
+    <p>A high value for <directive>CacheDirLevels</directive> combined
+    with a low value for <directive>CacheDirLength</directive> will result in
+    a relatively deep hierarchy, with a small number of subdirectories at each
+    level.</p>
 
     <note>
       <p>The result of <directive>CacheDirLevels</directive>*
@@ -91,9 +95,6 @@ cache.</description>
       not be higher than 20.</p>
     </note>
 
-    <example>
-      CacheDirLevels  5
-    </example>
 </usage>
 </directivesynopsis>
 
@@ -107,7 +108,13 @@ cache.</description>
 
 <usage>
     <p>The <directive>CacheDirLength</directive> directive sets the number
-    of characters for each subdirectory name in the cache hierarchy.</p>
+    of characters for each subdirectory name in the cache hierarchy. It can
+    be used in conjunction with <directive>CacheDirLevels</directive> to
+    determine the approximate structure of your cache hierarchy.</p>
+    <p>A high value for <directive>CacheDirLength</directive> combined
+    with a low value for <directive>CacheDirLevels</directive> will result in
+    a relatively flat hierarchy, with a large number of subdirectories at each
+    level.</p>
 
     <note>
       <p>The result of <directive module="mod_disk_cache"
@@ -115,9 +122,6 @@ cache.</description>
       must not be higher than 20.</p>
     </note>
 
-    <example>
-      CacheDirLength  4
-    </example>
 </usage>
 </directivesynopsis>