From: Joshua Slive <slive@apache.org>
Date: Sat, 1 Nov 2003 00:46:53 +0000 (+0000)
Subject: Mention force-no-vary in the content-negotiation docs.
X-Git-Tag: pre_ajp_proxy~1089
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6b34245b4eed031840d12ef5fb23073bd8a92560;p=thirdparty%2Fapache%2Fhttpd.git

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 a9c8aeab6f1..ffee21b1bc1 100644
--- 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 07f5e07ca1e..fdced7de62f 100644
--- 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>