From: Joshua Slive Date: Sun, 30 Dec 2001 15:45:05 +0000 (+0000) Subject: Cleanup the ForceLanguagePriority docs. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ee39a4bc204228a35b6eb23b5280813512d3ccbc;p=apache Cleanup the ForceLanguagePriority docs. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@92667 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_negotiation.html b/docs/manual/mod/mod_negotiation.html index 386fb9bc75..048991a4e6 100644 --- a/docs/manual/mod/mod_negotiation.html +++ b/docs/manual/mod/mod_negotiation.html @@ -184,10 +184,12 @@

ForceLanguagePriority directive

- Syntax: ForceLanguagePriority - None | [Prefer] [Fallback]
+ None|Prefer|Fallback [Prefer|Fallback]
+ Default: + ForceLanguagePriority None
Context: server config, virtual host, directory, .htaccess
@@ -198,32 +200,36 @@ Module: mod_negotiation -

The ForceLanguagePriority directive uses the given - LanguagePriority to satisfy two common negotation results.

- -

ForceLanguagePriority Prefer uses LanguagePriority - to serve a one valid result, rather than returning an HTTP result 300, - MULTIPLE CHOICES, when there are several equally valid choices. - If the directives below were given, and the user's Accept-Language - header assigned en and de each as quality .500 (equally acceptable) - then then first matching variant, en, will be served;

- -
- LanguagePriority en fr de - ForceLanguagePriority Prefer -
- -

ForceLanguagePriority Fallback uses LanguagePriority - to serve a valid result, rather than returning an HTTP result 406, - NOT ACCEPTABLE. If the directives below were given, and the user's - Accept-Language only permitted an es langauge response, but such a - variant isn't found, then the first variant from the LanguagePriority - list below will be served;

- -
- LanguagePriority en fr de - ForceLanguagePriority Fallback -
+

The ForceLanguagePriority directive uses the given + LanguagePriority to satisfy + negotation where the server could otherwise not return a single + matching document.

+ +

ForceLanguagePriority Prefer uses + LanguagePriority to serve a one valid result, rather + than returning an HTTP result 300 (MULTIPLE CHOICES) when there + are several equally valid choices. If the directives below were + given, and the user's Accept-Language header assigned en and de + each as quality .500 (equally acceptable) then then first matching + variant, en, will be served.

+ +
+ LanguagePriority en fr de
+ ForceLanguagePriority Prefer +
+ +

ForceLanguagePriority Fallback uses + LanguagePriority to serve a valid result, rather than + returning an HTTP result 406 (NOT ACCEPTABLE). If the directives + below were given, and the user's Accept-Language only permitted an + es langauge response, but such a variant isn't found, then the + first variant from the LanguagePriority list below will be + served.

+ +
+ LanguagePriority en fr de
+ ForceLanguagePriority Fallback +

Both options, Prefer and Fallback, may be specified, so either the first matching variant from LanguagePriority will be served if more @@ -264,13 +270,15 @@ then foo.html.fr would be returned.

Note that this directive only has an effect if a 'best' - language cannot be determined by any other means. Correctly - implemented HTTP/1.1 requests will mean this directive has no - effect.

+ language cannot be determined by any other means or the ForceLanguagePriority directive + is not None. Correctly implemented HTTP/1.1 requests + will mean this directive has no effect.

See also: DefaultLanguage and - AddLanguage + href="./mod_mime.html#defaultlanguage">DefaultLanguage, + AddLanguage and + ForceLanguagePriority.