diff options
| -rw-r--r-- | docs/en/xml/Bugzilla-Guide.xml | 117 | ||||
| -rw-r--r-- | docs/en/xml/installation.xml | 4 |
2 files changed, 59 insertions, 62 deletions
diff --git a/docs/en/xml/Bugzilla-Guide.xml b/docs/en/xml/Bugzilla-Guide.xml index 5afb83951..686bdb462 100644 --- a/docs/en/xml/Bugzilla-Guide.xml +++ b/docs/en/xml/Bugzilla-Guide.xml @@ -1,4 +1,4 @@ -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" [ +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ <!-- Include macros --> <!ENTITY about SYSTEM "about.xml"> @@ -9,82 +9,87 @@ <!ENTITY glossary SYSTEM "glossary.xml"> <!ENTITY installation SYSTEM "installation.xml"> <!ENTITY administration SYSTEM "administration.xml"> +<!ENTITY security SYSTEM "security.xml"> <!ENTITY using SYSTEM "using.xml"> <!ENTITY integration SYSTEM "integration.xml"> -<!ENTITY future SYSTEM "future.xml"> <!ENTITY index SYSTEM "index.xml"> -<!ENTITY database SYSTEM "database.xml"> +<!ENTITY customization SYSTEM "customization.xml"> +<!ENTITY troubleshooting SYSTEM "troubleshooting.xml"> <!ENTITY patches SYSTEM "patches.xml"> -<!ENTITY variants SYSTEM "variants.xml"> <!ENTITY introduction SYSTEM "introduction.xml"> -<!ENTITY revhistory SYSTEM "revhistory.xml"> +<!ENTITY modules SYSTEM "modules.xml"> <!-- Things to change for a stable release: * bz-ver to current stable * bz-nexver to next stable * bz-date to the release date - * bz-devel to "IGNORE" + * Remove the BZ-DEVEL comments - COMPILE DOCS AND CHECKIN - Also, tag and tarball before completing * bz-ver to devel version - * bz-devel to "INCLUDE" For a devel release, simple bump bz-ver and bz-date --> -<!ENTITY bz-ver "2.17.5"> -<!ENTITY bz-nextver "2.18"> -<!ENTITY bz-date "2003-10-31"> -<!ENTITY % bz-devel "INCLUDE"> +<!ENTITY bz-ver "2.21"> +<!ENTITY bz-nextver "2.22"> +<!ENTITY bz-date "2005-07-07"> +<!ENTITY current-year "2005"> +<!ENTITY landfillbase "http://landfill.bugzilla.org/bugzilla-tip/"> <!ENTITY bz "http://www.bugzilla.org/"> -<!ENTITY bzg-auth "The Bugzilla Team"> <!ENTITY bzg-bugs "<ulink url='http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation'>Bugzilla Documentation</ulink>"> <!ENTITY mysql "http://www.mysql.com/"> -<!ENTITY newest-perl-ver "5.8"> <!-- For minimum versions --> <!ENTITY min-mysql-ver "3.23.41"> -<!ENTITY min-perl-ver "5.6"> +<!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"> <!ENTITY min-file-temp-ver "any"> <!ENTITY min-appconfig-ver "1.52"> <!ENTITY min-text-wrap-ver "2001.0131"> <!ENTITY min-file-spec-ver "0.82"> <!ENTITY min-data-dumper-ver "any"> -<!ENTITY min-dbd-mysql-ver "2.1010"> -<!ENTITY min-dbi-ver "1.32"> +<!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.88"> +<!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"> <!ENTITY min-gd-text-align-ver "any"> -<!ENTITY min-chart-base-ver "0.99c"> +<!ENTITY min-chart-base-ver "1.0"> <!ENTITY min-xml-parser-ver "any"> <!ENTITY min-mime-parser-ver "any"> -<!ENTITY min-patchreader-ver "0.9.1"> +<!ENTITY min-patchreader-ver "0.9.4"> ]> <!-- Coding standards for this document -* Other than the GFDL, please use the "section" tag instead of "sect1", "sect2", etc. +* Other than the GFDL, please use the "section" tag instead of "sect1", + "sect2", etc. * Use Entities to include files for new chapters in Bugzilla-Guide.xml. * Try to use Entities for frequently-used passages of text as well. * Ensure all documents compile cleanly to HTML after modification. -The warning, "DTDDECL catalog types not supported" is normal. + The warning, "DTDDECL catalog types not supported" is normal. * Try to index important terms wherever possible. * Use "glossterm" whenever you introduce a new term. * Follow coding standards at http://www.tldp.org, and -check out the KDE guidelines (they are nice, too) -http://i18n.kde.org/doc/markup.html + check out the KDE guidelines (they are nice, too) + http://i18n.kde.org/doc/markup.html * All tags should be lowercase. * Please use sensible spacing. The comments at the very end of each -file define reasonable defaults for PSGML mode in EMACS. -Double-indent tags, use double spacing whenever possible, and -try to avoid clutter and feel free to waste space in the code to make it more readable. + file define reasonable defaults for PSGML mode in EMACS. +* Double-indent tags, use double spacing whenever possible, and + try to avoid clutter and feel free to waste space in the code to make it + more readable. --> @@ -93,18 +98,11 @@ try to avoid clutter and feel free to waste space in the code to make it more re <!-- Header --> <bookinfo> - <title>The Bugzilla Guide - &bz-ver; <![%bz-devel;[Development ]]>Release</title> + <title>The Bugzilla Guide - &bz-ver; + <!-- BZ-DEVEL -->Development <!-- /BZ-DEVEL --> + Release</title> <authorgroup> - <author> - <firstname>Matthew</firstname> - <othername>P.</othername> - <surname>Barnson</surname> - </author> - <author> - <firstname>Jacob</firstname> - <surname>Steenhagen</surname> - </author> <corpauthor>The Bugzilla Team</corpauthor> </authorgroup> @@ -112,24 +110,19 @@ try to avoid clutter and feel free to waste space in the code to make it more re <abstract> <para> - 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. </para> - <para> - This documentation is maintained in DocBook 4.1.2 XML format. - Changes are best submitted as plain text or XML diffs, attached - to a bug filed in the &bzg-bugs; component. + <para> + The most current version of this document can always be found on the + <ulink url="http://www.bugzilla.org/documentation.html">Bugzilla + Documentation Page</ulink>. </para> - <![%bz-devel;[ - <para>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). - </para> - ]]> + </abstract> <keywordset> @@ -148,29 +141,32 @@ try to avoid clutter and feel free to waste space in the code to make it more re <!-- About This Guide --> &about; -<!-- Introduction --> -&introduction; - -<!-- Using Bugzilla --> -&using; - <!-- Installing Bugzilla --> &installation; <!-- Administering Bugzilla --> &administration; +<!-- Securing Bugzilla --> +&security; + +<!-- Customizing Bugzilla --> +&customization; + +<!-- Using Bugzilla --> +&using; + <!-- Appendix: The Frequently Asked Questions --> &faq; -<!-- Appendix: The Database Schema --> -&database; +<!-- Appendix: Troubleshooting --> +&troubleshooting; <!-- Appendix: Custom Patches --> &patches; -<!-- Appendix: Major Bugzilla Variants --> -&variants; +<!-- Appendix: Manually Installing Perl Modules --> +&modules; <!-- Appendix: GNU Free Documentation License --> &gfdl; @@ -204,3 +200,4 @@ 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 0866062df..1b711ed39 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.98 2008/04/04 06:47:28 mozilla%colinogilvie.co.uk Exp $ --> +<!-- $Id: installation.xml,v 1.99 2008/04/04 06:47:29 mozilla%colinogilvie.co.uk Exp $ --> <chapter id="installing-bugzilla"> <title>Installing Bugzilla</title> @@ -96,7 +96,7 @@ visit <ulink url="http://www.perl.com"/>. Although Bugzilla runs with Perl &min-perl-ver;, it's a good idea to be using the latest stable version. - As of this writing, that is Perl &newest-perl-ver;.</para> + </para> </section> <section id="install-database"> |