Mention force-no-vary in the content-negotiation docs.

PR: 23798

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

diff --git a/docs/manual/content-negotiation.html.en b/docs/manual/content-negotiation.html.en
index a9c8aeab6f17c7eaca21b3dbd2b0c5f5c46a203b..ffee21b1bc1e9650b89d348f2ff4d35c6e90f001 100644 (file)
--- a/docs/manual/content-negotiation.html.en
+++ b/docs/manual/content-negotiation.html.en
@@ -651,6 +651,14 @@ factors to 5 decimal places before choosing the best variant.</p>
     negotiation. This directive can be given in the server config or
     virtual host, and takes no arguments. It has no effect on requests
     from HTTP/1.1 clients.</p>
+
+    <p>For HTTP/1.1 clients, Apache sends a <code>Vary</code> HTTP
+    response header to indicate the negotiation dimensions for the
+    response.  Caches can use this information to determine whether a
+    subsequent request can be served from the local copy.  To
+    encourage a cache to use the local copy regardless of the
+    negotiation dimensions, set the <code>force-no-vary</code> <a href="env.html#special">environment variable</a>.</p>
+
 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="more" id="more">More Information</a></h2>

diff --git a/docs/manual/content-negotiation.xml b/docs/manual/content-negotiation.xml
index 07f5e07ca1e92b07ddb45d4d9f076a3441519185..fdced7de62fe8cb37e1a053bc1cf181992b5ba7e 100644 (file)
--- a/docs/manual/content-negotiation.xml
+++ b/docs/manual/content-negotiation.xml
@@ -634,6 +634,15 @@ factors to 5 decimal places before choosing the best variant.</p>
     negotiation. This directive can be given in the server config or
     virtual host, and takes no arguments. It has no effect on requests
     from HTTP/1.1 clients.</p>
+
+    <p>For HTTP/1.1 clients, Apache sends a <code>Vary</code> HTTP
+    response header to indicate the negotiation dimensions for the
+    response.  Caches can use this information to determine whether a
+    subsequent request can be served from the local copy.  To
+    encourage a cache to use the local copy regardless of the
+    negotiation dimensions, set the <code>force-no-vary</code> <a
+    href="env.html#special">environment variable</a>.</p>
+
 </section>
 
 <section id="more"><title>More Information</title>