document prefer-language

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

diff --git a/docs/manual/content-negotiation.html.en b/docs/manual/content-negotiation.html.en
index 9baa73468071442b6b8d47a302b658e4bd129264..82ad33364871193b3d6d37c083e150dba41ef22e 100644 (file)
--- a/docs/manual/content-negotiation.html.en
+++ b/docs/manual/content-negotiation.html.en
@@ -480,6 +480,19 @@ Negotiation</a></li>
     specification and to work effectively with properly configured
     clients.</p>
 
+    <p>In order to support advanced techniques (such as Cookies or
+    special URL-paths) to determine the user's preferred language,
+    since Apache 2.1 <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> recognizes
+    the <a href="env.html">environment variable</a>
+    <code>prefer-language</code>. If it exists and contains an
+    appropriate language tag, <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> will
+    try to select a matching variant. If there's no such variant,
+    the normal negotiation process applies.</p>
+
+    <div class="example"><h3>Example</h3><p><code>
+      SetEnvIf Cookie "language=(.+)" prefer-language=$1
+    </code></p></div>
+
 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="extensions" id="extensions">Extensions to Transparent Content

diff --git a/docs/manual/content-negotiation.xml b/docs/manual/content-negotiation.xml
index ee7562b89d375b78730c479ef3379ce497a61ad2..8c5ee937ed612b3a9126d0fc815fde29345f4b5c 100644 (file)
--- a/docs/manual/content-negotiation.xml
+++ b/docs/manual/content-negotiation.xml
@@ -465,6 +465,19 @@
     This is necessary to maintain compliance with the HTTP/1.1
     specification and to work effectively with properly configured
     clients.</p>
+
+    <p>In order to support advanced techniques (such as Cookies or
+    special URL-paths) to determine the user's preferred language,
+    since Apache 2.1 <module>mod_negotiation</module> recognizes
+    the <a href="env.html">environment variable</a>
+    <code>prefer-language</code>. If it exists and contains an
+    appropriate language tag, <module>mod_negotiation</module> will
+    try to select a matching variant. If there's no such variant,
+    the normal negotiation process applies.</p>
+
+    <example><title>Example</title>
+      SetEnvIf Cookie "language=(.+)" prefer-language=$1
+    </example>
 </section>
 </section>