Bug 177224: Update installation docs to note XUL and RDF MIME types

patch by mkanat
r=justdave, a=justdave

diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
index c5f80721a0c5a27348310f7f43a10432e5d317b8..b7b91489c60976e398d69afddff01de2a0ac812c 100644 (file)
--- a/docs/en/xml/installation.xml
+++ b/docs/en/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.69 2008/04/04 06:46:59 jocuri%softhome.net Exp $ -->
+<!-- $Id: installation.xml,v 1.70 2008/04/04 06:47:00 bugreport%peshkin.net Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -1334,6 +1334,30 @@
       compromised. For this reason it is recommended that you create a user
       account for each daemon.
       </para>
+    </section>
+    <section id="apache-addtype">
+      <title>Serving Alternate Formats with the right MIME type</title>
+
+      <para>
+        Some Bugzilla pages have alternate formats, other than just plain
+        <acronym>HTML</acronym>. In particular, a few Bugzilla pages can 
+        output their contents as either <acronym>XUL</acronym> (a special 
+        Mozilla format, that looks like a program <acronym>GUI</acronym>) 
+        or <acronym>RDF</acronym> (a type of structured <acronym>XML</acronym> 
+        that can be read by various programs).
+      </para>
+      <para>
+        In order for your users to see these pages correctly, Apache must 
+        send them with the right <acronym>MIME</acronym> type. To do this, 
+        add the following lines to your Apache configuration, either in the 
+        <computeroutput>&lt;VirtualHost&gt;</computeroutput> section for your
+        Bugzilla, or in the <computeroutput>&lt;Directory&gt;</computeroutput>
+        section for your Bugzilla:
+      </para>
+      <para>
+        <screen>AddType application/vnd.mozilla.xul+xml .xul
+AddType text/xml .rdf</screen>
+      </para>
     </section>    
   </section>