From: bugreport%peshkin.net <>
Date: Fri, 4 Apr 2008 11:47:00 +0000 (+0000)
Subject: Bug 177224: Update installation docs to note XUL and RDF MIME types
X-Git-Tag: bugzilla-3.1.3~180
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0d0367e54d4346e30a4d9f9e0e322e279ee44d4c;p=thirdparty%2Fbugzilla.git

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 c5f80721a0..b7b91489c6 100644
--- 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>