Return-Path: 
 <cvs-return-13655-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 7880 invoked by uid 500); 24 Oct 2002 18:56:23 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
list-post: <mailto:cvs@httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 7869 invoked by uid 500); 24 Oct 2002 18:56:23 -0000
Delivered-To: apmail-httpd-2.0-cvs@apache.org
Date: 24 Oct 2002 18:56:18 -0000
Message-ID: <20021024185618.9300.qmail@icarus.apache.org>
From: rederpj@apache.org
To: httpd-2.0-cvs@apache.org
Subject: cvs commit: httpd-2.0/docs/manual/mod mod_disk_cache.xml
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

rederpj     2002/10/24 11:56:18

  Modified:    docs/manual/mod mod_disk_cache.xml
  Log:
  Change the CacheRoot processing to check for a required
  value at config time. This saves a lot of wasted processing
  if the mod_disk_cache module is loaded but no CacheRoot
  was provided. This fix also adds code to log an error
  and avoid useless pallocs and procesing when the computed
  cache file name cannot be opened. This also updates the
  docs accordingly.  [Paul J. Reder]
  
  Revision  Changes    Path
  1.2       +10 -5     httpd-2.0/docs/manual/mod/mod_disk_cache.xml
  
  Index: mod_disk_cache.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_disk_cache.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- mod_disk_cache.xml	13 Aug 2002 23:01:13 -0000	1.1
  +++ mod_disk_cache.xml	24 Oct 2002 18:56:18 -0000	1.2
  @@ -24,14 +24,19 @@
   
   <directivesynopsis>
   <name>CacheRoot</name>
  -<description>The directory to store cache files</description>
  +<description>The directory root under which cache files are stored</description>
   <syntax>CacheRoot <em>directory</em></syntax>
   <default>none</default>
   <contextlist><context>server config</context></contextlist>
   
   <usage>
       <p>The <directive>CacheRoot</directive> directive defines the name of the directory
  -    on the disk to contain cache files. What is happening if not set ?</p>
  +    on the disk to contain cache files. If the mod_disk_cache module has been loaded
  +    or compiled in to the Apache server, this directive <em>must</em> be defined. Failing to
  +    provide a value for <directive>CacheRoot</directive> will result in a configuration
  +    file processing error. The <directive>CacheDirLevels</directive> and
  +    <directive>CacheDirLength</directive> directives define the structure of the directories
  +    under the specified root directory.</p>
   
   <example>
     CacheRoot c:/cacheroot <br />
  @@ -47,14 +52,14 @@
   <contextlist><context>server config</context></contextlist>
   
   <usage>
  -    <p>The <directive>MCacheSize</directive> directive sets the desired disk space
  +    <p>The <directive>CacheSize</directive> directive sets the desired disk space
       usage of the cache, in KBytes (1024-byte units). This directive does not put a 
       hard limit on the size of the cache. The garbage collector will delete files
       until the usage is at or below the settings. Always use a value that is lower
       than the available disk space.</p>
   
   <example>
  -  MCacheSize  5000000 <br />
  +  CacheSize  5000000 <br />
   </example>
   </usage>
   </directivesynopsis>
  @@ -256,4 +261,4 @@
   </usage>
   </directivesynopsis>
   
  -</modulesynopsis>
  \ No newline at end of file
  +</modulesynopsis>