From e55729b390a483e96acbaf4b0d1cfba0109b44f0 Mon Sep 17 00:00:00 2001 From: "mozilla%colinogilvie.co.uk" <> Date: Fri, 4 Apr 2008 11:47:24 +0000 Subject: Bug 299145: Document new required perl modules Patch by me, r=mkanat --- docs/en/xml/Bugzilla-Guide.xml | 153 ++++++++++++++++++++--------------------- docs/en/xml/installation.xml | 95 +++++++++++++++++-------- 2 files changed, 144 insertions(+), 104 deletions(-) (limited to 'docs') diff --git a/docs/en/xml/Bugzilla-Guide.xml b/docs/en/xml/Bugzilla-Guide.xml index d6ff02c20..f0811db70 100644 --- a/docs/en/xml/Bugzilla-Guide.xml +++ b/docs/en/xml/Bugzilla-Guide.xml @@ -1,89 +1,96 @@ - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + - - - - + + + + + - Bugzilla Documentation"> - + - + + + - + - - - - + + + + + + + - + + ]> @@ -92,18 +99,11 @@ try to avoid clutter and feel free to waste space in the code to make it more re - The Bugzilla Guide - &bz-ver; <![%bz-devel;[Development ]]>Release + The Bugzilla Guide - &bz-ver; + <!-- BZ-DEVEL -->Development <!-- /BZ-DEVEL --> + Release - - Matthew - P. - Barnson - - - Jacob - Steenhagen - The Bugzilla Team @@ -111,24 +111,19 @@ try to avoid clutter and feel free to waste space in the code to make it more re - This is the documentation for Bugzilla, the mozilla.org - bug-tracking system. + This is the documentation for Bugzilla, a + bug-tracking system from mozilla.org. Bugzilla is an enterprise-class piece of software - that powers issue-tracking for hundreds of - organizations around the world, tracking millions of bugs. + that tracks millions of bugs and issues for hundreds of + organizations around the world. - - This documentation is maintained in DocBook 4.1.2 XML format. - Changes are best submitted as plain text or SGML diffs, attached - to a bug filed in the &bzg-bugs; compontent. + + The most current version of this document can always be found on the + Bugzilla + Documentation Page. - This is a development version of this guide. Information in it - is subject to change before the &bz-nextver; release of this guide - (which will correspond with the &bz-nextver; release of Bugzilla). - - ]]> + @@ -147,29 +142,32 @@ try to avoid clutter and feel free to waste space in the code to make it more re &about; - -&introduction; - - -&using; - &installation; &administration; + +&security; + + +&customization; + + +&using; + &faq; - -&database; + +&troubleshooting; &patches; - -&variants; + +&modules; &gfdl; @@ -198,8 +196,9 @@ sgml-local-ecat-files:nil sgml-minimize-attributes:nil sgml-namecase-general:t sgml-omittag:t -sgml-parent-document:("Bugzilla-Guide.sgml" "book" "chapter") +sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter") sgml-shorttag:t sgml-tag-region-if-active:t End: --> + diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml index 6446c70bd..b7e5b476b 100644 --- a/docs/en/xml/installation.xml +++ b/docs/en/xml/installation.xml @@ -1,5 +1,5 @@ - + Installing Bugzilla @@ -59,8 +59,7 @@ - Install MySQL - (&min-mysql-ver; or above) + Install a Database Engine @@ -100,33 +99,57 @@ As of this writing, that is Perl &newest-perl-ver;. -
- MySQL +
+ Database Engine + + 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. - Installed Version Test: mysql -V +
+ MySQL + Installed Version Test: mysql -V - - If you don't have it and your OS doesn't provide official packages, - visit . You need MySQL version - &min-mysql-ver; or higher. - + + If you don't have it and your OS doesn't provide official packages, + visit . You need MySQL version + &min-mysql-ver; or higher. + - - Many of the binary - versions of MySQL store their data files in - /var. - 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 configure. - + + Many of the binary + versions of MySQL store their data files in + /var. + 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 configure. + - 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. - - + 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. + +
+ +
+ PostgreSQL + Installed Version Test: psql -V + + + If you don't have it and your OS doesn't provide official packages, + visit . You need PostgreSQL + version &min-pg-ver; or higher. + + + 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. + +
+
@@ -301,7 +324,13 @@ DBD::mysql - (&min-dbd-mysql-ver;) + (&min-dbd-mysql-ver;) if using MySQL + + + + + + DBD::Pg (&min-dbd-pg-ver;) if using PostgreSQL @@ -329,6 +358,18 @@ Text::Wrap (&min-text-wrap-ver;) + + + + Mail::Mailer (&min-mail-mailer-ver;) + + + + + + Storable (&min-storable-ver;) + + Optional Perl modules: -- cgit v1.2.3-24-g4f1b