From: Astrid Malo <kess@apache.org>
Date: Tue, 27 May 2003 21:22:21 +0000 (+0000)
Subject: document prefer-language
X-Git-Tag: 2.0.46~6
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0297ad261acfce9c5e0303d358d624fe0a953a2a;p=thirdparty%2Fapache%2Fhttpd.git

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 9baa7346807..82ad3336487 100644
--- 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 ee7562b89d3..8c5ee937ed6 100644
--- 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>