httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From iga...@apache.org
Subject svn commit: r998553 - in /httpd/httpd/trunk/docs/manual/mod: mod_mime.html.en mod_mime.xml
Date Sat, 18 Sep 2010 21:41:05 GMT
Author: igalic
Date: Sat Sep 18 21:41:04 2010
New Revision: 998553

URL: http://svn.apache.org/viewvc?rev=998553&view=rev
Log:
Explanation on how to prioritize mime-types on the serverside with AddType.

Modified:
    httpd/httpd/trunk/docs/manual/mod/mod_mime.html.en
    httpd/httpd/trunk/docs/manual/mod/mod_mime.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_mime.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_mime.html.en?rev=998553&r1=998552&r2=998553&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_mime.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_mime.html.en Sat Sep 18 21:41:04 2010
@@ -537,8 +537,13 @@ type</td></tr>
     type</a> 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 <code class="directive"><a href="#typesconfig">TypesConfig</a></code>
directive).</p>
+    <var>extension</var>.</p>
+
+    <div class="note">
+      It is recommended that new media types be added using the
+      <code class="directive">AddType</code> directive rather than changing the

+      <code class="directive"><a href="#typesconfig">TypesConfig</a></code>
file.
+    </div>
     
     <div class="example"><h3>Example</h3><p><code>
       AddType image/gif .gif
@@ -550,17 +555,24 @@ type</td></tr>
       AddType image/jpeg jpeg jpg jpe
     </code></p></div>
 
-    <div class="note">
-      It is recommended that new media types be added using the
-      <code class="directive">AddType</code> directive rather than changing the

-      <code class="directive"><a href="#typesconfig">TypesConfig</a></code>
file.
-    </div>
-
     <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 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>'s
+    <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
+    can be achieved by qualifying a <var>media-type</var> with
+    <code>qs</code>:</p>
+
+    <div class="example"><h3>Example</h3><p><code>
+      Addtype application/rss+xml;qs=0.8 .xml
+    </code></p></div>
+
+    <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 
@@ -570,6 +582,7 @@ type</td></tr>
 <h3>See also</h3>
 <ul>
 <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
+<li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
 </ul>
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"
/></a></div>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_mime.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_mime.xml?rev=998553&r1=998552&r2=998553&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_mime.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_mime.xml Sat Sep 18 21:41:04 2010
@@ -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>



Mime
View raw message