Bug 299145: Document new required perl modules

Patch by me, r=mkanat

diff --git a/docs/xml/Bugzilla-Guide.xml b/docs/xml/Bugzilla-Guide.xml
index 7c229113f73996d5dd026fd22e187c2d67ded460..f0811db706513d986789d450a55f375f207db2ae 100644 (file)
--- a/docs/xml/Bugzilla-Guide.xml
+++ b/docs/xml/Bugzilla-Guide.xml
@@ -44,6 +44,7 @@
 
 <!-- For minimum versions -->
 <!ENTITY min-mysql-ver "3.23.41">
+<!ENTITY min-pg-ver "7.3.x">
 <!ENTITY min-perl-ver "5.6.1">
 <!ENTITY min-perl-ver-win "5.8.1">
 <!ENTITY min-template-ver "2.08">
@@ -53,9 +54,12 @@
 <!ENTITY min-file-spec-ver "0.82">
 <!ENTITY min-data-dumper-ver "any">
 <!ENTITY min-dbd-mysql-ver "2.9003">
+<!ENTITY min-dbd-pg-ver "1.31">
 <!ENTITY min-dbi-ver "1.38">
 <!ENTITY min-date-format-ver "2.21">
 <!ENTITY min-cgi-ver "2.93">
+<!ENTITY min-mail-mailer-ver "1.65">
+<!ENTITY min-storable-ver "any">
 <!-- Optional modules -->
 <!ENTITY min-gd-ver "1.20">
 <!ENTITY min-gd-graph-ver "any">

diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index 7980a7182742418031847d5ceb95c4070376f9e1..29b8b79a4afc8f7ab72558e47340b76eaac51389 100644 (file)
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.93 2005/06/13 09:30:33 mozilla%colinogilvie.co.uk Exp $ -->
+<!-- $Id: installation.xml,v 1.94 2005/06/29 21:22:09 mozilla%colinogilvie.co.uk Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -59,8 +59,7 @@
         </para>
       </step>
       <step>
-        <para><link linkend="install-mysql">Install MySQL</link>
-        (&min-mysql-ver; or above)
+        <para><link linkend="install-database">Install a Database Engine</link>
         </para>
       </step>
       <step>
@@ -100,33 +99,57 @@
       As of this writing, that is Perl &newest-perl-ver;.</para>
     </section>
 
-    <section id="install-mysql">
-      <title>MySQL</title>
+    <section id="install-database">
+      <title>Database Engine</title>
+      
+      <para>From Bugzilla 2.20, support is included for using both the MySQL and
+      PostgreSQL database servers. You only require one of these systems to make
+      use of Bugzilla.</para>
 
-      <para>Installed Version Test: <filename>mysql -V</filename></para>
+      <section id="install-mysql">
+          <title>MySQL</title>
+          <para>Installed Version Test: <filename>mysql -V</filename></para>
       
-      <para>
-      If you don't have it and your OS doesn't provide official packages, 
-      visit <ulink url="http://www.mysql.com"/>. You need MySQL version
-      &min-mysql-ver; or higher.
-      </para>
+          <para>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <ulink url="http://www.mysql.com"/>. You need MySQL version
+          &min-mysql-ver; or higher.
+          </para>
       
-      <note>
-        <para> Many of the binary
-        versions of MySQL store their data files in 
-        <filename class="directory">/var</filename>.
-        On some Unix systems, this is part of a smaller root partition,
-        and may not have room for your bug database. To change the data
-         directory, you have to build MySQL from source yourself, and
-         set it as an option to <filename>configure</filename>.</para>
-      </note> 
+          <note>
+            <para> Many of the binary
+            versions of MySQL store their data files in 
+            <filename class="directory">/var</filename>.
+            On some Unix systems, this is part of a smaller root partition,
+            and may not have room for your bug database. To change the data
+            directory, you have to build MySQL from source yourself, and
+            set it as an option to <filename>configure</filename>.</para>
+          </note> 
            
-      <para>If you install from something other than a packaging/installation
-      system, such as .rpm (Redhat Package), .deb (Debian Package), .exe
-      (Windows Executable), or .msi (Microsoft Installer), make sure the MySQL
-      server is started when the machine boots.
-      </para>
-
+          <para>If you install from something other than a packaging/installation
+          system, such as .rpm (Redhat Package), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Microsoft Installer), make sure the MySQL
+          server is started when the machine boots.
+          </para>
+      </section>
+      
+      <section id="install-pg">
+          <title>PostgreSQL</title>
+          <para>Installed Version Test: <filename>psql -V</filename></para>
+      
+          <para>
+          If you don't have it and your OS doesn't provide official packages, 
+          visit <ulink url="http://www.postgresql.org/"/>. You need PostgreSQL
+          version &min-pg-ver; or higher.
+          </para>
+           
+          <para>If you install from something other than a packaging/installation
+          system, such as .rpm (Redhat Package), .deb (Debian Package), .exe
+          (Windows Executable), or .msi (Microsoft Installer), make sure the
+          PostgreSQL server is started when the machine boots.
+          </para>
+      </section>
+      
     </section>
     
     <section id="install-webserver">
@@ -301,7 +324,13 @@
         <listitem>
           <para>
             <link linkend="install-modules-dbd-mysql">DBD::mysql</link>
-            (&min-dbd-mysql-ver;)
+            (&min-dbd-mysql-ver;) if using MySQL
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            DBD::Pg (&min-dbd-pg-ver;) if using PostgreSQL
           </para>
         </listitem>
 
@@ -329,6 +358,18 @@
             Text::Wrap (&min-text-wrap-ver;)
           </para>
         </listitem>
+        
+        <listitem>
+          <para>
+            Mail::Mailer (&min-mail-mailer-ver;)
+          </para>
+        </listitem>
+        
+        <listitem>
+          <para>
+            Storable (&min-storable-ver;)
+          </para>
+        </listitem>
       </orderedlist>
 
       Optional Perl modules: