]> granicus.if.org Git - apache/commitdiff
At long last, promote mod_cache and friends out of experimental/.
authorJustin Erenkrantz <jerenkrantz@apache.org>
Sat, 27 Nov 2004 19:06:48 +0000 (19:06 +0000)
committerJustin Erenkrantz <jerenkrantz@apache.org>
Sat, 27 Nov 2004 19:06:48 +0000 (19:06 +0000)
Also, take quick pass through docs files to remove experimental label for them.

Reviewed by: Paul Querna, Bill Stoddard, Justin Erenkrantz

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

26 files changed:
CHANGES
STATUS
docs/manual/mod/mod_cache.xml
docs/manual/mod/mod_disk_cache.xml
docs/manual/mod/mod_mem_cache.xml
modules/cache/NWGNUdsk_cach [moved from modules/experimental/NWGNUdsk_cach with 100% similarity]
modules/cache/NWGNUmem_cach [moved from modules/experimental/NWGNUmem_cach with 100% similarity]
modules/cache/NWGNUmod_cach [moved from modules/experimental/NWGNUmod_cach with 100% similarity]
modules/cache/cache_cache.c [moved from modules/experimental/cache_cache.c with 100% similarity]
modules/cache/cache_cache.h [moved from modules/experimental/cache_cache.h with 100% similarity]
modules/cache/cache_hash.c [moved from modules/experimental/cache_hash.c with 100% similarity]
modules/cache/cache_hash.h [moved from modules/experimental/cache_hash.h with 100% similarity]
modules/cache/cache_pqueue.c [moved from modules/experimental/cache_pqueue.c with 100% similarity]
modules/cache/cache_pqueue.h [moved from modules/experimental/cache_pqueue.h with 100% similarity]
modules/cache/cache_storage.c [moved from modules/experimental/cache_storage.c with 100% similarity]
modules/cache/cache_util.c [moved from modules/experimental/cache_util.c with 100% similarity]
modules/cache/config.m4
modules/cache/mod_cache.c [moved from modules/experimental/mod_cache.c with 100% similarity]
modules/cache/mod_cache.dsp [moved from modules/experimental/mod_cache.dsp with 100% similarity]
modules/cache/mod_cache.h [moved from modules/experimental/mod_cache.h with 100% similarity]
modules/cache/mod_cache.imp [moved from modules/experimental/mod_cache.imp with 100% similarity]
modules/cache/mod_disk_cache.c [moved from modules/experimental/mod_disk_cache.c with 100% similarity]
modules/cache/mod_disk_cache.dsp [moved from modules/experimental/mod_disk_cache.dsp with 100% similarity]
modules/cache/mod_mem_cache.c [moved from modules/experimental/mod_mem_cache.c with 100% similarity]
modules/cache/mod_mem_cache.dsp [moved from modules/experimental/mod_mem_cache.dsp with 100% similarity]
modules/experimental/config.m4

diff --git a/CHANGES b/CHANGES
index 5621ca41385908c7032e713db641182e9bac6a18..a5b5572016228f5f63795bd1ae2679ffecb41bcf 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -2,8 +2,10 @@ Changes with Apache 2.1.2-dev
 
   [Remove entries to the current 2.0 section below, when backported]
 
+  *) mod_cache/mod_mem_cache/mod_disk_cache: Move out of experimental.
+
   *) Upgraded PCRE to version 5.0. [Brian Pane]
-  
+
   *) mod_cgid: Catch configuration problem where two web server instances
      share same ServerRoot but admin forgot to use ScriptSock.
      [Jeff Trawick]
diff --git a/STATUS b/STATUS
index 62000bb87f548b99e4940c598e856e3b70783d12..02ce71922f89d09cc64eca3520cc950197cd85ac 100644 (file)
--- a/STATUS
+++ b/STATUS
@@ -37,35 +37,6 @@ RELEASE SHOWSTOPPERS:
 
 CURRENT VOTES:
 
-    * Promote mod_cache from experimental to non-experimental
-      status (keep issues noted below in EXPERIMENTAL MODULES as
-      items to be addressed as a supported module).
-      +1: jerenkrantz, pquerna, stoddard
-      +0: jim, bnicholes
-      -1:
-          There are a couple of problems that need to be resolved
-      before this module is moved out of experimental. 
-      1) We need to at least review and comment on the RFC violations
-      2) Resolve issue of how to cache page fragements (or perhaps -if- we
-      want to cache page fragements). Today, mod_cache/mod_mem_cache
-      will cache #include 'virtual' requests (but not #include 'file' 
-      requests). This was accomplished by making CACHE_IN a
-      CONTENT_SET-1 filter to force it to run before the SUBREQ_CORE
-      filter.  But now responses cannot be cached that include the
-      effects of having been run through CONTENT_SET filters
-      (mod_deflate, mod_expires, etc).  We could rerun all the
-      CONTENT_SET filters on the cached response, but this will not
-      work in all cases. For example, mod_expires relies on installing
-      the EXPIRATION filter during fixups. Contents served out of
-      mod_cache (out of the quick_handler) bypass -all- the request
-      line server hooks (Ryan really hated this. It is great for
-      performance, but bad because of the complications listed above).
-
-      jerenkrantz: I think it's time.  We've done a *lot* of work to it, and
-                   we think most of the blatant RFC violations are now gone.
-                   mod_cache just belongs in cache/.  There may still be bugs,
-                   but not likely to be major ones.
-
     * httpd-std.conf and friends
 
       a) httpd-std.conf should be tailored by install (from src or
@@ -478,12 +449,20 @@ WISH LIST
 
     * mod_cache: Handle ESI tags.
 
-EXPERIMENTAL MODULES:
-
-    Experimental modules should eventually be be promoted to fully supported
-    status or removed from the repository entirely (ie, the
-    'experiment' failed). This section tracks what needs to happen to 
-    get the modules promoted to fully supported status.
+    * mod_cache: Resolve issue of how to cache page fragements (or perhaps
+      -if- we want to cache page fragements). Today, mod_cache/mod_mem_cache
+      will cache #include 'virtual' requests (but not #include 'file'
+      requests). This was accomplished by making CACHE_IN a
+      CONTENT_SET-1 filter to force it to run before the SUBREQ_CORE
+      filter.  But now responses cannot be cached that include the
+      effects of having been run through CONTENT_SET filters
+      (mod_deflate, mod_expires, etc).  We could rerun all the
+      CONTENT_SET filters on the cached response, but this will not
+      work in all cases. For example, mod_expires relies on installing
+      the EXPIRATION filter during fixups. Contents served out of
+      mod_cache (out of the quick_handler) bypass -all- the request
+      line server hooks (Ryan really hated this. It is great for
+      performance, but bad because of the complications listed above).
 
     mod_cache/mod_mem_cache/mod_disk_cache:
 
@@ -508,6 +487,13 @@ EXPERIMENTAL MODULES:
       HTTP or SNMP?
       jerenkrantz says: Yawn.  Who cares.
 
+EXPERIMENTAL MODULES:
+
+    Experimental modules should eventually be be promoted to fully supported
+    status or removed from the repository entirely (ie, the
+    'experiment' failed). This section tracks what needs to happen to 
+    get the modules promoted to fully supported status.
+
 PRs that have been suspended forever waiting for someone to
 put them into 'the next release':
 
index 7ff3a294f5c1f21afab182f10f4aa7668f114576..9f672caa13eea3014afb4802684091eae23138cf 100644 (file)
 
 <name>mod_cache</name>
 <description>Content cache keyed to URIs.</description>
-<status>Experimental</status>
 <sourcefile>mod_cache.c</sourcefile>
 <identifier>cache_module</identifier>
 
 <summary>
-    <note type="warning">
-      This module is experimental. Documentation is still under development...
-    </note>
-
     <p><module>mod_cache</module> implements an <a
     href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> compliant HTTP
     content cache that can be used to cache either local or proxied content.
       <directivelist>
         <directive module="mod_disk_cache">CacheRoot</directive>
         <directive module="mod_disk_cache">CacheSize</directive>
-        <directive module="mod_disk_cache">CacheGcInterval</directive>
         <directive module="mod_disk_cache">CacheDirLevels</directive>
         <directive module="mod_disk_cache">CacheDirLength</directive>
-        <directive module="mod_disk_cache">CacheExpiryCheck</directive>
         <directive module="mod_disk_cache">CacheMinFileSize</directive>
         <directive module="mod_disk_cache">CacheMaxFileSize</directive>
-        <directive module="mod_disk_cache">CacheTimeMargin</directive>
-        <directive module="mod_disk_cache">CacheGcDaily</directive>
-        <directive module="mod_disk_cache">CacheGcUnused</directive>
-        <directive module="mod_disk_cache">CacheGcClean</directive>
-        <directive module="mod_disk_cache">CacheGcMemUsage</directive>
         <directive module="mod_mem_cache">MCacheSize</directive>
         <directive module="mod_mem_cache">MCacheMaxObjectCount</directive>
         <directive module="mod_mem_cache">MCacheMinObjectSize</directive>
         &lt;IfModule mod_disk_cache.c&gt;<br />
         <indent>
           CacheRoot c:/cacheroot<br />
-          CacheSize 256<br />
           CacheEnable disk  /<br />
           CacheDirLevels 5<br />
           CacheDirLength 3<br />
index 83c8e7c0fc1c2a8d4a6e31ad366504da570e1414..3541333cacab60dbc741fa189f470628f779db1a 100644 (file)
 
 <name>mod_disk_cache</name>
 <description>Content cache storage manager keyed to URIs</description>
-<status>Experimental</status>
 <sourcefile>mod_disk_cache.c</sourcefile>
 <identifier>disk_cache_module</identifier>
 
 <summary>
-    <note type="warning">
-      This module is experimental. Documentation is still under development...
-    </note>
-
     <p><module>mod_disk_cache</module> implements a disk based storage
-    manager. It is primarily of use in conjunction with
-    <module>mod_proxy</module>.</p>
+    manager. It is primarily of use in conjunction
+    <module>mod_cache</module>.</p>
 
     <p>Content is stored in and retrieved from the cache using URI based
     keys. Content with access protection is not cached.</p>
index 7a84ccc783883ed23c11535a6a46baf44c2a8046..839baba90854bfa3f42f40db86f2ef701e258de2 100644 (file)
 
 <name>mod_mem_cache</name>
 <description>Content cache keyed to URIs</description>
-<status>Experimental</status>
 <sourcefile>mod_mem_cache.c</sourcefile>
 <identifier>mem_cache_module</identifier>
 
 <summary>
-    <note type="warning">
-      This module is experimental. Documentation is still under
-      development...
-    </note>
-
     <p>This module <em>requires</em> the service of <module
     >mod_cache</module>. It acts as a support module for <module
     >mod_cache</module> and provides a memory based storage manager.
index cdec8c56eb174394d1c750182acd944aef235be1..9572e06d5bdf7e7bd63fedda183c7bdef48f95e3 100644 (file)
@@ -6,4 +6,21 @@ APACHE_MODPATH_INIT(cache)
 
 APACHE_MODULE(file_cache, File cache, , , no)
 
+dnl #  list of object files for mod_cache
+cache_objs="dnl
+mod_cache.lo dnl
+cache_storage.lo dnl
+cache_util.lo dnl
+"
+dnl #  list of object files for mod_mem_cache
+mem_cache_objs="dnl
+mod_mem_cache.lo dnl
+cache_cache.lo dnl
+cache_pqueue.lo dnl
+cache_hash.lo dnl
+"
+APACHE_MODULE(cache, dynamic file caching, $cache_objs, , no)
+APACHE_MODULE(disk_cache, disk caching module, , , no)
+APACHE_MODULE(mem_cache, memory caching module, $mem_cache_objs, , no)
+
 APACHE_MODPATH_FINISH
index 2266904c0143f946e9aefa9db5f02e0d44237242..c5bfacd6dbf538a8d4d90343d9e98bc62a7f0931 100644 (file)
@@ -9,22 +9,6 @@ else
     APACHE_MODULE(charset_lite, character set translation, , , no)
 fi
 
-dnl #  list of object files for mod_cache
-cache_objs="dnl
-mod_cache.lo dnl
-cache_storage.lo dnl
-cache_util.lo dnl
-" 
-dnl #  list of object files for mod_mem_cache
-mem_cache_objs="dnl
-mod_mem_cache.lo dnl
-cache_cache.lo dnl
-cache_pqueue.lo dnl
-cache_hash.lo dnl
-" 
-APACHE_MODULE(cache, dynamic file caching, $cache_objs, , no)
-APACHE_MODULE(disk_cache, disk caching module, , , no)
-APACHE_MODULE(mem_cache, memory caching module, $mem_cache_objs, , no)
 APACHE_MODULE(example, example and demo module, , , no)
 APACHE_MODULE(case_filter, example uppercase conversion filter, , , no)
 APACHE_MODULE(case_filter_in, example uppercase conversion input filter, , , no)