You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@apache.org on 2008/12/24 16:07:12 UTC

svn commit: r729317 - in /httpd/httpd/trunk/docs/manual: env.html.en env.xml mod/mod_cache.html.en mod/mod_cache.xml

Author: covener
Date: Wed Dec 24 07:07:11 2008
New Revision: 729317

URL: http://svn.apache.org/viewvc?rev=729317&view=rev
Log:
document no-cache envvar

Modified:
    httpd/httpd/trunk/docs/manual/env.html.en
    httpd/httpd/trunk/docs/manual/env.xml
    httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en
    httpd/httpd/trunk/docs/manual/mod/mod_cache.xml

Modified: httpd/httpd/trunk/docs/manual/env.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/env.html.en?rev=729317&r1=729316&r2=729317&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/env.html.en (original)
+++ httpd/httpd/trunk/docs/manual/env.html.en Wed Dec 24 07:07:11 2008
@@ -283,6 +283,15 @@
 
     
 
+    <h3><a name="no-cache" id="no-cache">no-cache</a></h3>
+
+        <p>When set, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will not save an otherwise
+        cacheable response.  This environment variable does not influence
+        whether a response already in the cache will be served for the current 
+        request.</p>
+
+    
+
     <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
         
 

Modified: httpd/httpd/trunk/docs/manual/env.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/env.xml?rev=729317&r1=729316&r2=729317&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/env.xml (original)
+++ httpd/httpd/trunk/docs/manual/env.xml Wed Dec 24 07:07:11 2008
@@ -324,6 +324,15 @@
 
     </section>
 
+    <section id="no-cache"><title>no-cache</title>
+
+        <p>When set, <module>mod_cache</module> will not save an otherwise
+        cacheable response.  This environment variable does not influence
+        whether a response already in the cache will be served for the current 
+        request.</p>
+
+    </section>
+
     <section id="nokeepalive">
         <title>nokeepalive</title>
 

Modified: httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en?rev=729317&r1=729316&r2=729317&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en Wed Dec 24 07:07:11 2008
@@ -143,6 +143,13 @@
       CacheDisable /local_files
     </code></p></div>
 
+    <p> The <code>no-cache</code> environment variable can be set to 
+    disable caching on a finer grained set of resources.</p>
+
+<h3>See also</h3>
+<ul>
+<li><a href="../env.html">Environment Variables in Apache</a></li>
+</ul>
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="CacheEnable" id="CacheEnable">CacheEnable</a> <a name="cacheenable" id="cacheenable">Directive</a></h2>
@@ -181,7 +188,14 @@
       CacheEnable  disk  http://www.apache.org/<br />
     </code></p></div>
 
+    <p> The <code>no-cache</code> environment variable can be set to 
+    disable caching on a finer grained set of resources.</p>
 
+
+<h3>See also</h3>
+<ul>
+<li><a href="../env.html">Environment Variables in Apache</a></li>
+</ul>
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="CacheIgnoreCacheControl" id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</a> <a name="cacheignorecachecontrol" id="cacheignorecachecontrol">Directive</a></h2>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_cache.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_cache.xml?rev=729317&r1=729316&r2=729317&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_cache.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_cache.xml Wed Dec 24 07:07:11 2008
@@ -132,7 +132,11 @@
       CacheEnable  disk  http://www.apache.org/<br />
     </example>
 
+    <p> The <code>no-cache</code> environment variable can be set to 
+    disable caching on a finer grained set of resources.</p>
+
 </usage>
+<seealso><a href="../env.html">Environment Variables in Apache</a></seealso>
 </directivesynopsis>
 
 <directivesynopsis>
@@ -150,8 +154,11 @@
     <example><title>Example</title>
       CacheDisable /local_files
     </example>
-</usage>
 
+    <p> The <code>no-cache</code> environment variable can be set to 
+    disable caching on a finer grained set of resources.</p>
+</usage>
+<seealso><a href="../env.html">Environment Variables in Apache</a></seealso>
 </directivesynopsis>
 <directivesynopsis>
 <name>CacheMaxExpire</name>



Re: svn commit: r729317 - in /httpd/httpd/trunk/docs/manual: env.html.en env.xml mod/mod_cache.html.en mod/mod_cache.xml

Posted by Eric Covener <co...@gmail.com>.
On Mon, Jun 8, 2009 at 7:37 PM, William A. Rowe, Jr.
<wr...@rowe-clan.net> wrote:
> Nope; As far as "2.4" documentation, there's really no need IMHO, but
> I guess it's nice for folks making a transition.

Spot-checking, looks like it's best to have/add it matching in trunk
for consistency.

-- 
Eric Covener
covener@gmail.com

Re: svn commit: r729317 - in /httpd/httpd/trunk/docs/manual: env.html.en env.xml mod/mod_cache.html.en mod/mod_cache.xml

Posted by "William A. Rowe, Jr." <wr...@rowe-clan.net>.
Eric Covener wrote:
> On Mon, Jun 8, 2009 at 5:35 PM, William A. Rowe, Jr.
> <wr...@rowe-clan.net> wrote:
>> -1; please stop committing documentation updates without introducing
>> the appropriate compatibility notes!
>>
>> As this is already on our site, for an unreleased version, it looks
>> particularly stupid.
> 
> 2.2.x has the compatability note in env.xml but not in the text added
> to CacheDisable.  There is a see-also link from the latter to the
> former.
> 
> Is adding the same compatability note to mod_cache.xml sufficient or
> do you suggest something else?

Yes, adding this to mod_cache.xml would be sufficient.

> Is there a trunk issue (the quoted change) re: compatability notes?
> If so, can you elaborate?

Nope; As far as "2.4" documentation, there's really no need IMHO, but
I guess it's nice for folks making a transition.

Re: svn commit: r729317 - in /httpd/httpd/trunk/docs/manual: env.html.en env.xml mod/mod_cache.html.en mod/mod_cache.xml

Posted by Eric Covener <co...@gmail.com>.
On Mon, Jun 8, 2009 at 5:35 PM, William A. Rowe, Jr.
<wr...@rowe-clan.net> wrote:
> -1; please stop committing documentation updates without introducing
> the appropriate compatibility notes!
>
> As this is already on our site, for an unreleased version, it looks
> particularly stupid.

2.2.x has the compatability note in env.xml but not in the text added
to CacheDisable.  There is a see-also link from the latter to the
former.

Is adding the same compatability note to mod_cache.xml sufficient or
do you suggest something else?

Is there a trunk issue (the quoted change) re: compatability notes?
If so, can you elaborate?

-- 
Eric Covener
covener@gmail.com

Re: svn commit: r729317 - in /httpd/httpd/trunk/docs/manual: env.html.en env.xml mod/mod_cache.html.en mod/mod_cache.xml

Posted by "William A. Rowe, Jr." <wr...@rowe-clan.net>.
-1; please stop committing documentation updates without introducing
the appropriate compatibility notes!

As this is already on our site, for an unreleased version, it looks
particularly stupid.

Bill



covener@apache.org wrote:
> Author: covener
> Date: Wed Dec 24 07:07:11 2008
> New Revision: 729317
> 
> URL: http://svn.apache.org/viewvc?rev=729317&view=rev
> Log:
> document no-cache envvar
> 
> Modified:
>     httpd/httpd/trunk/docs/manual/env.html.en
>     httpd/httpd/trunk/docs/manual/env.xml
>     httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en
>     httpd/httpd/trunk/docs/manual/mod/mod_cache.xml
> 
> Modified: httpd/httpd/trunk/docs/manual/env.html.en
> URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/env.html.en?rev=729317&r1=729316&r2=729317&view=diff
> ==============================================================================
> --- httpd/httpd/trunk/docs/manual/env.html.en (original)
> +++ httpd/httpd/trunk/docs/manual/env.html.en Wed Dec 24 07:07:11 2008
> @@ -283,6 +283,15 @@
>  
>      
>  
> +    <h3><a name="no-cache" id="no-cache">no-cache</a></h3>
> +
> +        <p>When set, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will not save an otherwise
> +        cacheable response.  This environment variable does not influence
> +        whether a response already in the cache will be served for the current 
> +        request.</p>
> +
> +    
> +
>      <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
>          
>  
> 
> Modified: httpd/httpd/trunk/docs/manual/env.xml
> URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/env.xml?rev=729317&r1=729316&r2=729317&view=diff
> ==============================================================================
> --- httpd/httpd/trunk/docs/manual/env.xml (original)
> +++ httpd/httpd/trunk/docs/manual/env.xml Wed Dec 24 07:07:11 2008
> @@ -324,6 +324,15 @@
>  
>      </section>
>  
> +    <section id="no-cache"><title>no-cache</title>
> +
> +        <p>When set, <module>mod_cache</module> will not save an otherwise
> +        cacheable response.  This environment variable does not influence
> +        whether a response already in the cache will be served for the current 
> +        request.</p>
> +
> +    </section>
> +
>      <section id="nokeepalive">
>          <title>nokeepalive</title>
>  
> 
> Modified: httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en
> URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en?rev=729317&r1=729316&r2=729317&view=diff
> ==============================================================================
> --- httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en (original)
> +++ httpd/httpd/trunk/docs/manual/mod/mod_cache.html.en Wed Dec 24 07:07:11 2008
> @@ -143,6 +143,13 @@
>        CacheDisable /local_files
>      </code></p></div>
>  
> +    <p> The <code>no-cache</code> environment variable can be set to 
> +    disable caching on a finer grained set of resources.</p>
> +
> +<h3>See also</h3>
> +<ul>
> +<li><a href="../env.html">Environment Variables in Apache</a></li>
> +</ul>
>  </div>
>  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
>  <div class="directive-section"><h2><a name="CacheEnable" id="CacheEnable">CacheEnable</a> <a name="cacheenable" id="cacheenable">Directive</a></h2>
> @@ -181,7 +188,14 @@
>        CacheEnable  disk  http://www.apache.org/<br />
>      </code></p></div>
>  
> +    <p> The <code>no-cache</code> environment variable can be set to 
> +    disable caching on a finer grained set of resources.</p>
>  
> +
> +<h3>See also</h3>
> +<ul>
> +<li><a href="../env.html">Environment Variables in Apache</a></li>
> +</ul>
>  </div>
>  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
>  <div class="directive-section"><h2><a name="CacheIgnoreCacheControl" id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</a> <a name="cacheignorecachecontrol" id="cacheignorecachecontrol">Directive</a></h2>
> 
> Modified: httpd/httpd/trunk/docs/manual/mod/mod_cache.xml
> URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_cache.xml?rev=729317&r1=729316&r2=729317&view=diff
> ==============================================================================
> --- httpd/httpd/trunk/docs/manual/mod/mod_cache.xml (original)
> +++ httpd/httpd/trunk/docs/manual/mod/mod_cache.xml Wed Dec 24 07:07:11 2008
> @@ -132,7 +132,11 @@
>        CacheEnable  disk  http://www.apache.org/<br />
>      </example>
>  
> +    <p> The <code>no-cache</code> environment variable can be set to 
> +    disable caching on a finer grained set of resources.</p>
> +
>  </usage>
> +<seealso><a href="../env.html">Environment Variables in Apache</a></seealso>
>  </directivesynopsis>
>  
>  <directivesynopsis>
> @@ -150,8 +154,11 @@
>      <example><title>Example</title>
>        CacheDisable /local_files
>      </example>
> -</usage>
>  
> +    <p> The <code>no-cache</code> environment variable can be set to 
> +    disable caching on a finer grained set of resources.</p>
> +</usage>
> +<seealso><a href="../env.html">Environment Variables in Apache</a></seealso>
>  </directivesynopsis>
>  <directivesynopsis>
>  <name>CacheMaxExpire</name>
> 
> 
> 
>