From f05a6c1db92cd1984c35d29e8be30de5d97aaee9 Mon Sep 17 00:00:00 2001 From: Joshua Slive Date: Sun, 6 Apr 2003 18:16:11 +0000 Subject: [PATCH] The content-negotiation docs are a little misleading about what the RFC says. PR: 18443 git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@99271 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/content-negotiation.html.en | 11 ++++------- docs/manual/content-negotiation.xml | 11 ++++------- 2 files changed, 8 insertions(+), 14 deletions(-) diff --git a/docs/manual/content-negotiation.html.en b/docs/manual/content-negotiation.html.en index fbbf07d08d..6e48c23923 100644 --- a/docs/manual/content-negotiation.html.en +++ b/docs/manual/content-negotiation.html.en @@ -410,7 +410,7 @@ Negotiation

Accept: image/*, */*

would indicate that any type starting "image/" is acceptable, - as is any other type (so the first "image/*" is redundant). + as is any other type. Some browsers routinely send wildcards in addition to explicit types they can handle. For example:

@@ -419,11 +419,8 @@ Negotiation

The intention of this is to indicate that the explicitly listed types are preferred, but if a different representation is - available, that is ok too. However under the basic algorithm, - as given above, the */* wildcard has exactly equal preference - to all the other types, so they are not being preferred. The - browser should really have sent a request with a lower quality - (preference) value for *.*, such as:

+ available, that is ok too. Using explicit quality values, + what the browser really wants is something like:

Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01

@@ -439,7 +436,7 @@ Negotiation preferred over matches against "*/*". If any media type on the Accept: header contains a q factor, these special values are not applied, so requests from browsers which send the - correct information to start with work as expected.

+ explicit information to start with work as expected.

Language Negotiation Exceptions

diff --git a/docs/manual/content-negotiation.xml b/docs/manual/content-negotiation.xml index 5cba72ae83..13de47dc34 100644 --- a/docs/manual/content-negotiation.xml +++ b/docs/manual/content-negotiation.xml @@ -395,7 +395,7 @@ Accept: image/*, */*

would indicate that any type starting "image/" is acceptable, - as is any other type (so the first "image/*" is redundant). + as is any other type. Some browsers routinely send wildcards in addition to explicit types they can handle. For example:

@@ -404,11 +404,8 @@

The intention of this is to indicate that the explicitly listed types are preferred, but if a different representation is - available, that is ok too. However under the basic algorithm, - as given above, the */* wildcard has exactly equal preference - to all the other types, so they are not being preferred. The - browser should really have sent a request with a lower quality - (preference) value for *.*, such as:

+ available, that is ok too. Using explicit quality values, + what the browser really wants is something like:

Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01 @@ -424,7 +421,7 @@ preferred over matches against "*/*". If any media type on the Accept: header contains a q factor, these special values are not applied, so requests from browsers which send the - correct information to start with work as expected.

+ explicit information to start with work as expected.

Language Negotiation Exceptions -- 2.50.1