Explanation on how to prioritize mime-types on the serverside with AddType.

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

1 files changed, 21 insertions, 9 deletions

diff --git a/docs/manual/mod/mod_mime.xml b/docs/manual/mod/mod_mime.xml
index c94681ea7e..d9091a1fc3 100644
--- a/docs/manual/mod/mod_mime.xml
+++ b/docs/manual/mod/mod_mime.xml
@@ -529,9 +529,13 @@ type</description>
     type</glossary> to use for filenames containing
     <var>extension</var>. This mapping is added to any already in
     force, overriding any mappings that already exist for the same
-    <var>extension</var>. This directive can be used to add mappings
-    not listed in the media types file (see the <directive
-    module="mod_mime">TypesConfig</directive> directive).</p>
+    <var>extension</var>.</p>
+
+    <note>
+      It is recommended that new media types be added using the
+      <directive>AddType</directive> directive rather than changing the 
+      <directive module="mod_mime">TypesConfig</directive> file.
+    </note>
     
     <example><title>Example</title>
       AddType image/gif .gif
@@ -543,18 +547,25 @@ type</description>
       AddType image/jpeg jpeg jpg jpe
     </example>
 
-    <note>
-      It is recommended that new media types be added using the
-      <directive>AddType</directive> directive rather than changing the 
-      <directive module="mod_mime">TypesConfig</directive> file.
-    </note>
-
     <p>The <var>extension</var> argument is case-insensitive and can
     be specified with or without a leading dot. Filenames may have <a
     href="#multipleext">multiple extensions</a> and the
     <var>extension</var> argument will be compared against each of
     them.</p>
 
+    <p>A simmilar effect to <module>mod_negotiation</module>'s
+    <directive module="mod_negotiation">LanguagePriority</directive>
+    can be achieved by qualifying a <var>media-type</var> with
+    <code>qs</code>:</p>
+
+    <example><title>Example</title>
+      Addtype application/rss+xml;qs=0.8 .xml
+    </example>
+
+    <p>This is useful in situations, <em>e.g.</em> when a client
+    requesting <code>Accept: */*</code> can not actually processes
+    the content returned by the server.</p>
+
     <p>This directive primarily configures the content types generated for
     static files served out of the filesystem.  For resources other than 
     static files, where the generator of the response typically specifies 
@@ -562,6 +573,7 @@ type</description>
 
 </usage>
 <seealso><directive module="core">ForceType</directive></seealso>
+<seealso><module>mod_negotiation</module></seealso>
 </directivesynopsis>
 
 <directivesynopsis>