diff options
| author | jake%bugzilla.org <> | 2003-01-13 11:38:51 +0100 |
|---|---|---|
| committer | jake%bugzilla.org <> | 2003-01-13 11:38:51 +0100 |
| commit | 9af33116a6e1d7a193504d48376d883f159fb5f7 (patch) | |
| tree | 266705a528ea26d0dc4b7ab858ad8b0694be1f4d /docs | |
| parent | 804416d9489832cf6687067d471d81f62de67dcc (diff) | |
| download | bugzilla-9af33116a6e1d7a193504d48376d883f159fb5f7.tar.gz bugzilla-9af33116a6e1d7a193504d48376d883f159fb5f7.tar.xz | |
Recompile the docs to pick up recent changes for the website.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/html/Bugzilla-Guide.html | 904 | ||||
| -rw-r--r-- | docs/html/administration.html | 8 | ||||
| -rw-r--r-- | docs/html/conventions.html | 2 | ||||
| -rw-r--r-- | docs/html/copyright.html | 6 | ||||
| -rw-r--r-- | docs/html/cust-templates.html | 8 | ||||
| -rw-r--r-- | docs/html/dbdoc.html | 4 | ||||
| -rw-r--r-- | docs/html/extraconfig.html | 6 | ||||
| -rw-r--r-- | docs/html/faq.html | 236 | ||||
| -rw-r--r-- | docs/html/glossary.html | 2 | ||||
| -rw-r--r-- | docs/html/hintsandtips.html | 4 | ||||
| -rw-r--r-- | docs/html/index.html | 31 | ||||
| -rw-r--r-- | docs/html/installation.html | 26 | ||||
| -rw-r--r-- | docs/html/newversions.html | 44 | ||||
| -rw-r--r-- | docs/html/stepbystep.html | 34 | ||||
| -rw-r--r-- | docs/html/troubleshooting.html | 4 | ||||
| -rw-r--r-- | docs/html/upgrading.html | 517 | ||||
| -rw-r--r-- | docs/html/using.html | 4 | ||||
| -rw-r--r-- | docs/html/win32.html | 8 | ||||
| -rw-r--r-- | docs/txt/Bugzilla-Guide.txt | 193 |
19 files changed, 1555 insertions, 486 deletions
diff --git a/docs/html/Bugzilla-Guide.html b/docs/html/Bugzilla-Guide.html index 2e33a3c17..73987b694 100644 --- a/docs/html/Bugzilla-Guide.html +++ b/docs/html/Bugzilla-Guide.html @@ -56,11 +56,14 @@ CLASS="author" NAME="AEN9" ></A >The Bugzilla Team</H3 +><P +CLASS="pubdate" +>2003-01-02<BR></P ><DIV ><DIV CLASS="abstract" ><A -NAME="AEN13" +NAME="AEN14" ></A ><P ></P @@ -83,6 +86,11 @@ TARGET="_top" >. </P ><P +>This is a development version of this guide. Information in it + is subject to change before the 2.18 release of this guide + (which will correspond with the 2.18 release of Bugzilla). + </P +><P ></P ></DIV ></DIV @@ -369,22 +377,37 @@ CLASS="LOT" ></DT ><DT >4-1. <A -HREF="#AEN1035" +HREF="#AEN1032" >Installing ActivePerl ppd Modules on Microsoft Windows</A ></DT ><DT >4-2. <A -HREF="#AEN1048" +HREF="#AEN1045" >Installing OpenInteract ppd Modules manually on Microsoft Windows</A ></DT ><DT >4-3. <A -HREF="#AEN1214" +HREF="#AEN1211" >Removing encrypt() for Windows NT Bugzilla version 2.12 or earlier</A ></DT +><DT +>5-1. <A +HREF="#upgrade-cvs" +>Upgrading using CVS</A +></DT +><DT +>5-2. <A +HREF="#upgrade-tarball" +>Upgrading using the tarball</A +></DT +><DT +>5-3. <A +HREF="#upgrade-patches" +>Upgrading using patches</A +></DT ></DL ></DIV ><DIV @@ -403,7 +426,7 @@ NAME="copyright" ></A >1.1. Copyright Information</H1 ><A -NAME="AEN31" +NAME="AEN33" ></A ><TABLE BORDER="0" @@ -463,7 +486,7 @@ NAME="gfdl" ><P >Version 1.1, March 2000</P ><A -NAME="AEN38" +NAME="AEN40" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -928,7 +951,7 @@ NAME="gfdl-howto" of the License in the document and put the following copyright and license notices just after the title page:</P ><A -NAME="AEN128" +NAME="AEN130" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -1013,40 +1036,34 @@ NAME="newversions" ></A >1.3. New Versions</H1 ><P -> This is the 2.16 version of The Bugzilla Guide. It is so named - to match the current version of Bugzilla. If you are +> This is the 2.17.3 version of The Bugzilla Guide. It is so named + to match the current version of Bugzilla. + + This version of the guide, like its associated Bugzilla version is a + development version. Information is subject to change between now and + when 2.18 is released. + + If you are reading this from any source other than those below, please check one of these mirrors to make sure you are reading an up-to-date version of the Guide. </P ><P -> This document can be found in the following places: - </P -><P -> <P -></P -><UL -><LI -><P -> <A -HREF="http://www.bugzilla.org/" +> The newest version of this guide can always be found at <A +HREF="http://www.bugzilla.org" TARGET="_top" >bugzilla.org</A -> - </P -></LI -><LI +>; including + documentation for past releases and the current development version. + </P ><P -> <A -HREF="http://www.linuxdoc.org/" +> The documentation for the most recent stable release of Bugzilla can also + be found at + <A +HREF="http://www.tldp.org" TARGET="_top" ->The Linux - Documentation Project</A -> - </P -></LI -></UL -> +>The Linux Documentation Project</A +>. </P ><P > The latest version of this document can always be checked out via CVS. @@ -1162,7 +1179,7 @@ NAME="conventions" ><DIV CLASS="informaltable" ><A -NAME="AEN178" +NAME="AEN175" ></A ><P ></P @@ -2212,7 +2229,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN434" +NAME="AEN431" ></A >3.2.1. Autolinkification</H2 ><P @@ -2360,7 +2377,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN463" +NAME="AEN460" ></A >3.2.5. Filing Bugs</H2 ><P @@ -2517,7 +2534,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN492" +NAME="AEN489" ></A >4.1.1. Introduction</H2 ><P @@ -2537,7 +2554,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN496" +NAME="AEN493" ></A >4.1.2. Package List</H2 ><DIV @@ -2588,7 +2605,7 @@ HREF="http://www.mysql.com/" TARGET="_top" >MySQL database server</A > - (3.23.6 or greater) + (3.23.41 or greater) </P ></LI ><LI @@ -2734,7 +2751,7 @@ TARGET="_top" ></LI ><LI ><P -> GD::Chart +> GD::Graph (any) for bug charting </P ></LI @@ -3299,7 +3316,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN650" +NAME="AEN647" ></A >4.1.5.1. DBI</H3 ><P @@ -3314,7 +3331,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN653" +NAME="AEN650" ></A >4.1.5.2. Data::Dumper</H3 ><P @@ -3328,7 +3345,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN656" +NAME="AEN653" ></A >4.1.5.3. MySQL-related modules</H3 ><P @@ -3354,7 +3371,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN661" +NAME="AEN658" ></A >4.1.5.4. TimeDate modules</H3 ><P @@ -3370,7 +3387,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN664" +NAME="AEN661" ></A >4.1.5.5. GD (optional)</H3 ><P @@ -3425,7 +3442,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN671" +NAME="AEN668" ></A >4.1.5.6. Chart::Base (optional)</H3 ><P @@ -3440,7 +3457,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN674" +NAME="AEN671" ></A >4.1.5.7. Template Toolkit</H3 ><P @@ -3456,7 +3473,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN677" +NAME="AEN674" ></A >4.1.6. HTTP Server</H2 ><P @@ -3634,7 +3651,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN696" +NAME="AEN693" ></A >4.1.7. Bugzilla</H2 ><P @@ -3804,7 +3821,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN721" +NAME="AEN718" ></A >4.1.8. Setting Up the MySQL Database</H2 ><P @@ -3977,7 +3994,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN757" +NAME="AEN754" ></A >4.1.9. <TT CLASS="filename" @@ -4130,7 +4147,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN789" +NAME="AEN786" ></A >4.1.10. Securing MySQL</H2 ><P @@ -4408,7 +4425,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN855" +NAME="AEN852" ></A >4.1.11. Configuring Bugzilla</H2 ><P @@ -4434,7 +4451,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN861" +NAME="AEN858" ></A >4.2.1. Dependency Charts</H2 ><P @@ -4498,7 +4515,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN876" +NAME="AEN873" ></A >4.2.2. Bug Graphs</H2 ><P @@ -4557,7 +4574,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN889" +NAME="AEN886" ></A >4.2.3. The Whining Cron</H2 ><P @@ -5478,7 +5495,7 @@ CLASS="command" ><DIV CLASS="example" ><A -NAME="AEN1035" +NAME="AEN1032" ></A ><P ><B @@ -5538,7 +5555,7 @@ TARGET="_top" <DIV CLASS="example" ><A -NAME="AEN1048" +NAME="AEN1045" ></A ><P ><B @@ -6564,7 +6581,7 @@ VALIGN="TOP" ><P >From Andrew Pearson: <A -NAME="AEN1202" +NAME="AEN1199" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -6649,7 +6666,7 @@ VALIGN="TOP" <DIV CLASS="example" ><A -NAME="AEN1214" +NAME="AEN1211" ></A ><P ><B @@ -6847,7 +6864,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1248" +NAME="AEN1245" ></A >4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2 ><P @@ -6872,7 +6889,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1253" +NAME="AEN1250" ></A >4.5.2. DBD::Sponge::db prepare failed</H2 ><P @@ -8730,7 +8747,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1613" +NAME="AEN1610" ></A >5.7.1. What to Edit</H2 ><P @@ -8845,7 +8862,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1632" +NAME="AEN1629" ></A >5.7.2. How To Edit Templates</H2 ><P @@ -8927,7 +8944,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1642" +NAME="AEN1639" ></A >5.7.3. Template Formats</H2 ><P @@ -8989,7 +9006,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1655" +NAME="AEN1652" ></A >5.7.4. Particular Templates</H2 ><P @@ -9354,41 +9371,496 @@ NAME="upgrading" ></A >5.9. Upgrading to New Releases</H1 ><P ->A plain Bugzilla is fairly easy to upgrade from one version to a - newer one. Always read the release notes to see if there are any issues - that you might need to take note of. It is recommended that you take a - backup of your database and your entire Bugzilla installation before attempting an - upgrade. You can upgrade a 'clean' installation by untarring a new - tarball over the old installation. If you are upgrading from 2.12 or - later, and have cvs installed, you can type <TT -CLASS="filename" ->cvs -z3 update</TT ->, - and resolve conflicts if there are any. +>Upgrading Bugzilla is something we all want to do from time to time, + be it to get new features or pick up the latest security fix. How easy + it is to update depends on a few factors. + </P +><P +></P +><UL +><LI +><P +>If the new version is a revision or a new point release</P +></LI +><LI +><P +>How many, if any, local changes have been made</P +></LI +></UL +><P +>There are also three different methods to upgrade your installation. + </P +><P +></P +><OL +TYPE="1" +><LI +><P +>Using CVS (<A +HREF="#upgrade-cvs" +>Example 5-1</A +>)</P +></LI +><LI +><P +>Downloading a new tarball (<A +HREF="#upgrade-tarball" +>Example 5-2</A +>)</P +></LI +><LI +><P +>Applying the relevant patches (<A +HREF="#upgrade-patches" +>Example 5-3</A +>)</P +></LI +></OL +><P +>Which options are available to you may depend on how large a jump + you are making and/or your network configuration. + </P +><P +>Revisions are normally released to fix security vulnerabilities + and are distinguished by an increase in the third number. For example, + when 2.16.2 was released, it was a revision to 2.16.1. + </P +><P +>Point releases are normally released when the Bugzilla team feels + that there has been a significant amount of progress made between the + last point release and the current time. These are often proceeded by a + stabilization period and release candidates, however the use of + development versions or release candidates is beyond the scope of this + document. Point releases can be distinguished by an increase in the + second number, or minor version. For example, 2.16.2 is a newer point + release than 2.14.5. + </P +><P +>The examples in this section are written as if you were updating + to version 2.16.2. The procedures are the same regardless if you are + updating to a new point release or a new revision. However, the chance + of running into trouble increases when upgrading to a new point release, + escpecially if you've made local changes. </P ><P ->However, things get a bit more complicated if you've made - changes to Bugzilla's code. In this case, you may have to re-make or - reapply those changes. One good method is to take a diff of your customized - version against the original, so you can survey all that you've changed. - Hopefully, templatization will reduce the need for - this in the future.</P -><P ->From version 2.8 onward, Bugzilla databases can be automatically - carried forward during an upgrade. However, because the developers of - Bugzilla are constantly adding new - tables, columns and fields, you'll probably get SQL errors if you just - update the code and attempt to use Bugzilla. Always run the +>These examples also assume that your Bugzilla installation is at <TT CLASS="filename" ->checksetup.pl</TT -> - script whenever you upgrade your installation.</P +>/var/www/html/bugzilla</TT +>. If that is not the case, + simply substitute the proper paths where appropriate. + </P +><DIV +CLASS="example" +><A +NAME="upgrade-cvs" +></A ><P ->If you are running Bugzilla version 2.8 or lower, and wish to - upgrade to the latest version, please consult the file, - "UPGRADING-pre-2.8" in the Bugzilla root directory after untarring the - archive.</P +><B +>Example 5-1. Upgrading using CVS</B +></P +><P +>Every release of Bugzilla, whether it is a revision or a point + release, is tagged in CVS. Also, every tarball we have distributed + since version 2.12 has been primed for using CVS. This does, however, + require that you are able to access cvs-mirror.mozilla.org on port + 2401. + + <DIV +CLASS="tip" +><P +></P +><TABLE +CLASS="tip" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/tip.gif" +HSPACE="5" +ALT="Tip"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>If you can do this, updating using CVS is probably the most + painless method, especially if you have a lot of local changes. + </P +></TD +></TR +></TABLE +></DIV +> + </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> bash$ <B +CLASS="command" +>cd /var/www/html/bugzilla</B +> +bash$ <B +CLASS="command" +>cvs login</B +> +Logging in to :pserver:anonymous@cvs-mirror.mozilla.org:2401/cvsroot +CVS password: <B +CLASS="command" +>anonymous</B +> +bash$ <B +CLASS="command" +>cvs -q update -r BUGZILLA-2_16_2 -dP</B +> +P checksetup.pl +P collectstats.pl +P globals.pl +P docs/rel_notes.txt +P template/en/default/list/quips.html.tmpl + </PRE +></FONT +></TD +></TR +></TABLE +><P +> <DIV +CLASS="caution" +><P +></P +><TABLE +CLASS="caution" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/caution.gif" +HSPACE="5" +ALT="Caution"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>If a line in the output from <B +CLASS="command" +>cvs update</B +> + begins with a <TT +CLASS="computeroutput" +>C</TT +> that represents a + file with local changes that CVS was unable to properly merge. You + need to resolve these conflicts manually before Bugzilla (or at + least the portion using that file) will be usable. + </P +></TD +></TR +></TABLE +></DIV +> + + <DIV +CLASS="note" +><P +></P +><TABLE +CLASS="note" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/note.gif" +HSPACE="5" +ALT="Note"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>You also need to run <B +CLASS="command" +>./checksetup.pl</B +> + before your Bugzilla upgrade will be complete. + </P +></TD +></TR +></TABLE +></DIV +> + </P +></DIV +><DIV +CLASS="example" +><A +NAME="upgrade-tarball" +></A +><P +><B +>Example 5-2. Upgrading using the tarball</B +></P +><P +>If you are unable or unwilling to use CVS, another option that's + always available is to download the latest tarball. This is the most + difficult option to use, especially if you have local changes. + </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> bash$ <B +CLASS="command" +>cd /var/www/html</B +> +bash$ <B +CLASS="command" +>wget ftp://ftp.mozilla.org/pub/webtools/bugzilla-2.16.2.tar.gz</B +> +<EM +>Output omitted</EM +> +bash$ <B +CLASS="command" +>tar xzvf bugzilla-2.16.2.tar.gz</B +> +bugzilla-2.16.2/ +bugzilla-2.16.2/.cvsignore +bugzilla-2.16.2/1x1.gif +<EM +>Output truncated</EM +> +bash$ <B +CLASS="command" +>cd bugzilla-2.16.2</B +> +bash$ <B +CLASS="command" +>cp ../bugzilla/localconfig* .</B +> +bash$ <B +CLASS="command" +>cp -r ../bugzilla/data .</B +> +bash$ <B +CLASS="command" +>cd ..</B +> +bash$ <B +CLASS="command" +>mv bugzilla bugzilla.old</B +> +bash$ <B +CLASS="command" +>mv bugzilla-2.16.2 bugzilla</B +> +bash$ <B +CLASS="command" +>cd bugzilla</B +> +bash$ <B +CLASS="command" +>./checksetup.pl</B +> +<EM +>Output omitted</EM +> + </PRE +></FONT +></TD +></TR +></TABLE +><P +> <DIV +CLASS="warning" +><P +></P +><TABLE +CLASS="warning" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/warning.gif" +HSPACE="5" +ALT="Warning"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>The <B +CLASS="command" +>cp</B +> commands both end with periods which + is a very important detail, it tells the shell that the destination + directory is the current working directory. Also, the period at the + beginning of the <B +CLASS="command" +>./checksetup.pl</B +> is important and + can not be omitted. + </P +></TD +></TR +></TABLE +></DIV +> + + <DIV +CLASS="note" +><P +></P +><TABLE +CLASS="note" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/note.gif" +HSPACE="5" +ALT="Note"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>You will now have to reapply any changes you have made to your + local installation manually. + </P +></TD +></TR +></TABLE +></DIV +> + </P +></DIV +><DIV +CLASS="example" +><A +NAME="upgrade-patches" +></A +><P +><B +>Example 5-3. Upgrading using patches</B +></P +><P +>The Bugzilla team will normally make a patch file available for + revisions to go from the most recent revision to the new one. You could + also read the release notes and grab the patches attached to the + mentioned bug, but it is safer to use the released patch file as + sometimes patches get changed before they get checked in (for minor + spelling fixes and the like). It is also theorectically possible to + scour the fixed bug list and pick and choose which patches to apply + from a point release, but this is not recommended either as what you'll + end up with is a hodge podge Bugzilla that isn't really any version. + This would also make it more difficult to upgrade in the future. + </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> bash$ <B +CLASS="command" +>cd /var/www/html/bugzilla</B +> +bash$ <B +CLASS="command" +>wget ftp://ftp.mozilla.org/pub/webtools/bugzilla-2.16.1-to-2.16.2.diff.gz</B +> +<EM +>Output omitted</EM +> +bash$ <B +CLASS="command" +>gunzip bugzilla-2.16.1-to-2.16.2.diff.gz</B +> +bash$ <B +CLASS="command" +>patch -p1 < bugzilla-2.16.1-to-2.16.2.diff</B +> +patching file checksetup.pl +patching file collectstats.pl +patching file globals.pl + </PRE +></FONT +></TD +></TR +></TABLE +><P +> <DIV +CLASS="caution" +><P +></P +><TABLE +CLASS="caution" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/caution.gif" +HSPACE="5" +ALT="Caution"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>If you do this, beware that this doesn't change the entires in + your <TT +CLASS="filename" +>CVS</TT +> directory so it may make + updates using CVS (<A +HREF="#upgrade-cvs" +>Example 5-1</A +>) more difficult in the + future. + </P +></TD +></TR +></TABLE +></DIV +> + </P +></DIV ></DIV ><DIV CLASS="section" @@ -9532,64 +10004,64 @@ HREF="#faq-general" ><DL ><DT >A.1.1. <A -HREF="#AEN1742" +HREF="#AEN1813" > Where can I find information about Bugzilla?</A ></DT ><DT >A.1.2. <A -HREF="#AEN1748" +HREF="#AEN1819" > What license is Bugzilla distributed under? </A ></DT ><DT >A.1.3. <A -HREF="#AEN1754" +HREF="#AEN1825" > How do I get commercial support for Bugzilla? </A ></DT ><DT >A.1.4. <A -HREF="#AEN1763" +HREF="#AEN1834" > What major companies or projects are currently using Bugzilla for bug-tracking? </A ></DT ><DT >A.1.5. <A -HREF="#AEN1787" +HREF="#AEN1858" > Who maintains Bugzilla? </A ></DT ><DT >A.1.6. <A -HREF="#AEN1793" +HREF="#AEN1864" > How does Bugzilla stack up against other bug-tracking databases? </A ></DT ><DT >A.1.7. <A -HREF="#AEN1799" +HREF="#AEN1870" > Why doesn't Bugzilla offer this or that feature or compatibility with this other tracking software? </A ></DT ><DT >A.1.8. <A -HREF="#AEN1806" +HREF="#AEN1877" > Why MySQL? I'm interested in seeing Bugzilla run on Oracle/Sybase/Msql/PostgreSQL/MSSQL. </A ></DT ><DT >A.1.9. <A -HREF="#AEN1815" +HREF="#AEN1886" > Why do the scripts say "/usr/bonsaitools/bin/perl" instead of "/usr/bin/perl" or something else? </A ></DT ><DT >A.1.10. <A -HREF="#AEN1821" +HREF="#AEN1892" > Is there an easy way to change the Bugzilla cookie name? </A ></DT @@ -9604,41 +10076,41 @@ HREF="#faq-phb" ><DL ><DT >A.2.1. <A -HREF="#AEN1831" +HREF="#AEN1902" > Is Bugzilla web-based, or do you have to have specific software or a specific operating system on your machine? </A ></DT ><DT >A.2.2. <A -HREF="#AEN1836" +HREF="#AEN1907" > Can Bugzilla integrate with Perforce (SCM software)? </A ></DT ><DT >A.2.3. <A -HREF="#AEN1841" +HREF="#AEN1912" > Does Bugzilla allow the user to track multiple projects? </A ></DT ><DT >A.2.4. <A -HREF="#AEN1846" +HREF="#AEN1917" > If I am on many projects, and search for all bugs assigned to me, will Bugzilla list them for me and allow me to sort by project, severity etc? </A ></DT ><DT >A.2.5. <A -HREF="#AEN1851" +HREF="#AEN1922" > Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes, are there any that are NOT allowed? </A ></DT ><DT >A.2.6. <A -HREF="#AEN1856" +HREF="#AEN1927" > Does Bugzilla allow us to define our own priorities and levels? Do we have complete freedom to change the labels of fields and format of them, and the choice of acceptable values? @@ -9646,35 +10118,35 @@ HREF="#AEN1856" ></DT ><DT >A.2.7. <A -HREF="#AEN1863" +HREF="#AEN1934" > Does Bugzilla provide any reporting features, metrics, graphs, etc? You know, the type of stuff that management likes to see. :) </A ></DT ><DT >A.2.8. <A -HREF="#AEN1870" +HREF="#AEN1941" > Is there email notification and if so, what do you see when you get an email? </A ></DT ><DT >A.2.9. <A -HREF="#AEN1875" +HREF="#AEN1946" > Can email notification be set up to send to multiple people, some on the To List, CC List, BCC List etc? </A ></DT ><DT >A.2.10. <A -HREF="#AEN1880" +HREF="#AEN1951" > Do users have to have any particular type of email application? </A ></DT ><DT >A.2.11. <A -HREF="#AEN1887" +HREF="#AEN1958" > Does Bugzilla allow data to be imported and exported? If I had outsiders write up a bug report using a MS Word bug template, could that template be imported into "matching" fields? If I wanted to take the results of a query @@ -9683,28 +10155,28 @@ HREF="#AEN1887" ></DT ><DT >A.2.12. <A -HREF="#AEN1899" +HREF="#AEN1970" > Has anyone converted Bugzilla to another language to be used in other countries? Is it localizable? </A ></DT ><DT >A.2.13. <A -HREF="#AEN1906" +HREF="#AEN1977" > Can a user create and save reports? Can they do this in Word format? Excel format? </A ></DT ><DT >A.2.14. <A -HREF="#AEN1911" +HREF="#AEN1982" > Does Bugzilla have the ability to search by word, phrase, compound search? </A ></DT ><DT >A.2.15. <A -HREF="#AEN1916" +HREF="#AEN1987" > Does Bugzilla provide record locking when there is simultaneous access to the same bug? Does the second person get a notice that the bug is in use or how are they notified? @@ -9712,19 +10184,19 @@ HREF="#AEN1916" ></DT ><DT >A.2.16. <A -HREF="#AEN1921" +HREF="#AEN1992" > Are there any backup features provided? </A ></DT ><DT >A.2.17. <A -HREF="#AEN1927" +HREF="#AEN1998" > Can users be on the system while a backup is in progress? </A ></DT ><DT >A.2.18. <A -HREF="#AEN1932" +HREF="#AEN2003" > What type of human resources are needed to be on staff to install and maintain Bugzilla? Specifically, what type of skills does the person need to have? I need to find out if we were to go with Bugzilla, what types of @@ -9734,7 +10206,7 @@ HREF="#AEN1932" ></DT ><DT >A.2.19. <A -HREF="#AEN1938" +HREF="#AEN2009" > What time frame are we looking at if we decide to hire people to install and maintain the Bugzilla? Is this something that takes hours or weeks to install and a couple of hours per week to maintain and customize or is this @@ -9744,7 +10216,7 @@ HREF="#AEN1938" ></DT ><DT >A.2.20. <A -HREF="#AEN1943" +HREF="#AEN2014" > Is there any licensing fee or other fees for using Bugzilla? Any out-of-pocket cost other than the bodies needed as identified above? </A @@ -9760,20 +10232,20 @@ HREF="#faq-security" ><DL ><DT >A.3.1. <A -HREF="#AEN1950" +HREF="#AEN2021" > How do I completely disable MySQL security if it's giving me problems (I've followed the instructions in the installation section of this guide)? </A ></DT ><DT >A.3.2. <A -HREF="#AEN1956" +HREF="#AEN2027" > Are there any security problems with Bugzilla? </A ></DT ><DT >A.3.3. <A -HREF="#AEN1961" +HREF="#AEN2032" > I've implemented the security fixes mentioned in Chris Yeh's security advisory of 5/10/2000 advising not to run MySQL as root, and am running into problems with MySQL no longer working correctly. @@ -9790,48 +10262,48 @@ HREF="#faq-email" ><DL ><DT >A.4.1. <A -HREF="#AEN1968" +HREF="#AEN2039" > I have a user who doesn't want to receive any more email from Bugzilla. How do I stop it entirely for this user? </A ></DT ><DT >A.4.2. <A -HREF="#AEN1974" +HREF="#AEN2045" > I'm evaluating/testing Bugzilla, and don't want it to send email to anyone but me. How do I do it? </A ></DT ><DT >A.4.3. <A -HREF="#AEN1979" +HREF="#AEN2050" > I want whineatnews.pl to whine at something more, or other than, only new bugs. How do I do it? </A ></DT ><DT >A.4.4. <A -HREF="#AEN1985" +HREF="#AEN2056" > I don't like/want to use Procmail to hand mail off to bug_email.pl. What alternatives do I have? </A ></DT ><DT >A.4.5. <A -HREF="#AEN1992" +HREF="#AEN2063" > How do I set up the email interface to submit/change bugs via email? </A ></DT ><DT >A.4.6. <A -HREF="#AEN1997" +HREF="#AEN2068" > Email takes FOREVER to reach me from Bugzilla -- it's extremely slow. What gives? </A ></DT ><DT >A.4.7. <A -HREF="#AEN2004" +HREF="#AEN2075" > How come email from Bugzilla changes never reaches me? </A ></DT @@ -9846,33 +10318,33 @@ HREF="#faq-db" ><DL ><DT >A.5.1. <A -HREF="#AEN2012" +HREF="#AEN2083" > I've heard Bugzilla can be used with Oracle? </A ></DT ><DT >A.5.2. <A -HREF="#AEN2017" +HREF="#AEN2088" > I think my database might be corrupted, or contain invalid entries. What do I do? </A ></DT ><DT >A.5.3. <A -HREF="#AEN2025" +HREF="#AEN2096" > I want to manually edit some entries in my database. How? </A ></DT ><DT >A.5.4. <A -HREF="#AEN2033" +HREF="#AEN2104" > I think I've set up MySQL permissions correctly, but Bugzilla still can't connect. </A ></DT ><DT >A.5.5. <A -HREF="#AEN2041" +HREF="#AEN2112" > How do I synchronize bug information among multiple different Bugzilla databases? </A @@ -9888,26 +10360,26 @@ HREF="#faq-nt" ><DL ><DT >A.6.1. <A -HREF="#AEN2050" +HREF="#AEN2121" > What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)? </A ></DT ><DT >A.6.2. <A -HREF="#AEN2055" +HREF="#AEN2126" > Is there a "Bundle::Bugzilla" equivalent for Win32? </A ></DT ><DT >A.6.3. <A -HREF="#AEN2060" +HREF="#AEN2131" > CGI's are failing with a "something.cgi is not a valid Windows NT application" error. Why? </A ></DT ><DT >A.6.4. <A -HREF="#AEN2068" +HREF="#AEN2139" > I'm having trouble with the perl modules for NT not being able to talk to to the database. </A @@ -9923,33 +10395,33 @@ HREF="#faq-use" ><DL ><DT >A.7.1. <A -HREF="#AEN2089" +HREF="#AEN2160" > How do I change my user name (email address) in Bugzilla? </A ></DT ><DT >A.7.2. <A -HREF="#AEN2094" +HREF="#AEN2165" > The query page is very confusing. Isn't there a simpler way to query? </A ></DT ><DT >A.7.3. <A -HREF="#AEN2099" +HREF="#AEN2170" > I'm confused by the behavior of the "accept" button in the Show Bug form. Why doesn't it assign the bug to me when I accept it? </A ></DT ><DT >A.7.4. <A -HREF="#AEN2109" +HREF="#AEN2180" > I can't upload anything into the database via the "Create Attachment" link. What am I doing wrong? </A ></DT ><DT >A.7.5. <A -HREF="#AEN2114" +HREF="#AEN2185" > How do I change a keyword in Bugzilla, once some bugs are using it? </A ></DT @@ -9964,26 +10436,26 @@ HREF="#faq-hacking" ><DL ><DT >A.8.1. <A -HREF="#AEN2121" +HREF="#AEN2192" > What kind of style should I use for templatization? </A ></DT ><DT >A.8.2. <A -HREF="#AEN2129" +HREF="#AEN2200" > What bugs are in Bugzilla right now? </A ></DT ><DT >A.8.3. <A -HREF="#AEN2138" +HREF="#AEN2209" > How can I change the default priority to a null value? For instance, have the default priority be "---" instead of "P2"? </A ></DT ><DT >A.8.4. <A -HREF="#AEN2144" +HREF="#AEN2215" > What's the best way to submit patches? What guidelines should I follow? </A ></DT @@ -10003,7 +10475,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1742" +NAME="AEN1813" ></A ><B >A.1.1. </B @@ -10031,7 +10503,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1748" +NAME="AEN1819" ></A ><B >A.1.2. </B @@ -10060,7 +10532,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1754" +NAME="AEN1825" ></A ><B >A.1.3. </B @@ -10106,7 +10578,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1763" +NAME="AEN1834" ></A ><B >A.1.4. </B @@ -10212,7 +10684,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1787" +NAME="AEN1858" ></A ><B >A.1.5. </B @@ -10242,7 +10714,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1793" +NAME="AEN1864" ></A ><B >A.1.6. </B @@ -10280,7 +10752,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1799" +NAME="AEN1870" ></A ><B >A.1.7. </B @@ -10320,7 +10792,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1806" +NAME="AEN1877" ></A ><B >A.1.8. </B @@ -10365,7 +10837,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1815" +NAME="AEN1886" ></A ><B >A.1.9. </B @@ -10398,7 +10870,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1821" +NAME="AEN1892" ></A ><B >A.1.10. </B @@ -10460,7 +10932,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1831" +NAME="AEN1902" ></A ><B >A.2.1. </B @@ -10486,7 +10958,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1836" +NAME="AEN1907" ></A ><B >A.2.2. </B @@ -10512,7 +10984,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1841" +NAME="AEN1912" ></A ><B >A.2.3. </B @@ -10537,7 +11009,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1846" +NAME="AEN1917" ></A ><B >A.2.4. </B @@ -10562,7 +11034,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1851" +NAME="AEN1922" ></A ><B >A.2.5. </B @@ -10591,7 +11063,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1856" +NAME="AEN1927" ></A ><B >A.2.6. </B @@ -10628,7 +11100,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1863" +NAME="AEN1934" ></A ><B >A.2.7. </B @@ -10666,7 +11138,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1870" +NAME="AEN1941" ></A ><B >A.2.8. </B @@ -10693,7 +11165,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1875" +NAME="AEN1946" ></A ><B >A.2.9. </B @@ -10718,7 +11190,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1880" +NAME="AEN1951" ></A ><B >A.2.10. </B @@ -10777,7 +11249,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1887" +NAME="AEN1958" ></A ><B >A.2.11. </B @@ -10839,7 +11311,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1899" +NAME="AEN1970" ></A ><B >A.2.12. </B @@ -10877,7 +11349,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1906" +NAME="AEN1977" ></A ><B >A.2.13. </B @@ -10902,7 +11374,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1911" +NAME="AEN1982" ></A ><B >A.2.14. </B @@ -10928,7 +11400,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1916" +NAME="AEN1987" ></A ><B >A.2.15. </B @@ -10955,7 +11427,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1921" +NAME="AEN1992" ></A ><B >A.2.16. </B @@ -10985,7 +11457,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1927" +NAME="AEN1998" ></A ><B >A.2.17. </B @@ -11011,7 +11483,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1932" +NAME="AEN2003" ></A ><B >A.2.18. </B @@ -11046,7 +11518,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1938" +NAME="AEN2009" ></A ><B >A.2.19. </B @@ -11079,7 +11551,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1943" +NAME="AEN2014" ></A ><B >A.2.20. </B @@ -11113,7 +11585,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1950" +NAME="AEN2021" ></A ><B >A.3.1. </B @@ -11142,7 +11614,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1956" +NAME="AEN2027" ></A ><B >A.3.2. </B @@ -11170,7 +11642,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1961" +NAME="AEN2032" ></A ><B >A.3.3. </B @@ -11206,7 +11678,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1968" +NAME="AEN2039" ></A ><B >A.4.1. </B @@ -11236,7 +11708,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1974" +NAME="AEN2045" ></A ><B >A.4.2. </B @@ -11262,7 +11734,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1979" +NAME="AEN2050" ></A ><B >A.4.3. </B @@ -11294,7 +11766,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1985" +NAME="AEN2056" ></A ><B >A.4.4. </B @@ -11312,7 +11784,7 @@ CLASS="answer" You can call bug_email.pl directly from your aliases file, with an entry like this: <A -NAME="AEN1989" +NAME="AEN2060" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -11333,7 +11805,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1992" +NAME="AEN2063" ></A ><B >A.4.5. </B @@ -11358,7 +11830,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1997" +NAME="AEN2068" ></A ><B >A.4.6. </B @@ -11393,7 +11865,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2004" +NAME="AEN2075" ></A ><B >A.4.7. </B @@ -11433,7 +11905,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2012" +NAME="AEN2083" ></A ><B >A.5.1. </B @@ -11461,7 +11933,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2017" +NAME="AEN2088" ></A ><B >A.5.2. </B @@ -11508,7 +11980,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2025" +NAME="AEN2096" ></A ><B >A.5.3. </B @@ -11549,7 +12021,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2033" +NAME="AEN2104" ></A ><B >A.5.4. </B @@ -11610,7 +12082,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2041" +NAME="AEN2112" ></A ><B >A.5.5. </B @@ -11656,7 +12128,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2050" +NAME="AEN2121" ></A ><B >A.6.1. </B @@ -11681,7 +12153,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2055" +NAME="AEN2126" ></A ><B >A.6.2. </B @@ -11707,7 +12179,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2060" +NAME="AEN2131" ></A ><B >A.6.3. </B @@ -11730,7 +12202,7 @@ CLASS="answer" ><P > Microsoft has some advice on this matter, as well: <A -NAME="AEN2065" +NAME="AEN2136" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -11755,7 +12227,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2068" +NAME="AEN2139" ></A ><B >A.6.4. </B @@ -11832,7 +12304,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2089" +NAME="AEN2160" ></A ><B >A.7.1. </B @@ -11857,7 +12329,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2094" +NAME="AEN2165" ></A ><B >A.7.2. </B @@ -11883,7 +12355,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2099" +NAME="AEN2170" ></A ><B >A.7.3. </B @@ -11938,7 +12410,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2109" +NAME="AEN2180" ></A ><B >A.7.4. </B @@ -11965,7 +12437,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2114" +NAME="AEN2185" ></A ><B >A.7.5. </B @@ -11999,7 +12471,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2121" +NAME="AEN2192" ></A ><B >A.8.1. </B @@ -12058,7 +12530,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2129" +NAME="AEN2200" ></A ><B >A.8.2. </B @@ -12104,7 +12576,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2138" +NAME="AEN2209" ></A ><B >A.8.3. </B @@ -12136,7 +12608,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2144" +NAME="AEN2215" ></A ><B >A.8.4. </B @@ -12360,7 +12832,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN2187" +NAME="AEN2258" ></A >B.2.1. Bugzilla Database Basics</H2 ><P @@ -12476,7 +12948,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN2214" +NAME="AEN2285" ></A >B.2.1.1. Bugzilla Database Tables</H3 ><P @@ -13046,7 +13518,7 @@ CLASS="glossdiv" ><H1 CLASS="glossdiv" ><A -NAME="AEN2300" +NAME="AEN2371" ></A >0-9, high ascii</H1 ><DL diff --git a/docs/html/administration.html b/docs/html/administration.html index d47d5e737..58bf99ef2 100644 --- a/docs/html/administration.html +++ b/docs/html/administration.html @@ -156,22 +156,22 @@ HREF="cust-templates.html" ><DL ><DT >5.7.1. <A -HREF="cust-templates.html#AEN1613" +HREF="cust-templates.html#AEN1610" >What to Edit</A ></DT ><DT >5.7.2. <A -HREF="cust-templates.html#AEN1632" +HREF="cust-templates.html#AEN1629" >How To Edit Templates</A ></DT ><DT >5.7.3. <A -HREF="cust-templates.html#AEN1642" +HREF="cust-templates.html#AEN1639" >Template Formats</A ></DT ><DT >5.7.4. <A -HREF="cust-templates.html#AEN1655" +HREF="cust-templates.html#AEN1652" >Particular Templates</A ></DT ></DL diff --git a/docs/html/conventions.html b/docs/html/conventions.html index 2bcaa2949..a25642333 100644 --- a/docs/html/conventions.html +++ b/docs/html/conventions.html @@ -81,7 +81,7 @@ NAME="conventions" ><DIV CLASS="informaltable" ><A -NAME="AEN178" +NAME="AEN175" ></A ><P ></P diff --git a/docs/html/copyright.html b/docs/html/copyright.html index ee7f86558..8135d13b0 100644 --- a/docs/html/copyright.html +++ b/docs/html/copyright.html @@ -77,7 +77,7 @@ NAME="copyright" ></A >1.1. Copyright Information</H1 ><A -NAME="AEN31" +NAME="AEN33" ></A ><TABLE BORDER="0" @@ -137,7 +137,7 @@ NAME="gfdl" ><P >Version 1.1, March 2000</P ><A -NAME="AEN38" +NAME="AEN40" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -602,7 +602,7 @@ NAME="gfdl-howto" of the License in the document and put the following copyright and license notices just after the title page:</P ><A -NAME="AEN128" +NAME="AEN130" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" diff --git a/docs/html/cust-templates.html b/docs/html/cust-templates.html index e0bfa2181..993bc0eb9 100644 --- a/docs/html/cust-templates.html +++ b/docs/html/cust-templates.html @@ -99,7 +99,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1613" +NAME="AEN1610" ></A >5.7.1. What to Edit</H2 ><P @@ -214,7 +214,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1632" +NAME="AEN1629" ></A >5.7.2. How To Edit Templates</H2 ><P @@ -296,7 +296,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1642" +NAME="AEN1639" ></A >5.7.3. Template Formats</H2 ><P @@ -358,7 +358,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1655" +NAME="AEN1652" ></A >5.7.4. Particular Templates</H2 ><P diff --git a/docs/html/dbdoc.html b/docs/html/dbdoc.html index 034c8369a..85ea7b735 100644 --- a/docs/html/dbdoc.html +++ b/docs/html/dbdoc.html @@ -135,7 +135,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN2187" +NAME="AEN2258" ></A >B.2.1. Bugzilla Database Basics</H2 ><P @@ -251,7 +251,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN2214" +NAME="AEN2285" ></A >B.2.1.1. Bugzilla Database Tables</H3 ><P diff --git a/docs/html/extraconfig.html b/docs/html/extraconfig.html index 24603c2a4..8a6cdd4b7 100644 --- a/docs/html/extraconfig.html +++ b/docs/html/extraconfig.html @@ -81,7 +81,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN861" +NAME="AEN858" ></A >4.2.1. Dependency Charts</H2 ><P @@ -145,7 +145,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN876" +NAME="AEN873" ></A >4.2.2. Bug Graphs</H2 ><P @@ -204,7 +204,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN889" +NAME="AEN886" ></A >4.2.3. The Whining Cron</H2 ><P diff --git a/docs/html/faq.html b/docs/html/faq.html index 78c10523c..f038311c6 100644 --- a/docs/html/faq.html +++ b/docs/html/faq.html @@ -87,64 +87,64 @@ HREF="faq.html#faq-general" ><DL ><DT >A.1.1. <A -HREF="faq.html#AEN1742" +HREF="faq.html#AEN1813" > Where can I find information about Bugzilla?</A ></DT ><DT >A.1.2. <A -HREF="faq.html#AEN1748" +HREF="faq.html#AEN1819" > What license is Bugzilla distributed under? </A ></DT ><DT >A.1.3. <A -HREF="faq.html#AEN1754" +HREF="faq.html#AEN1825" > How do I get commercial support for Bugzilla? </A ></DT ><DT >A.1.4. <A -HREF="faq.html#AEN1763" +HREF="faq.html#AEN1834" > What major companies or projects are currently using Bugzilla for bug-tracking? </A ></DT ><DT >A.1.5. <A -HREF="faq.html#AEN1787" +HREF="faq.html#AEN1858" > Who maintains Bugzilla? </A ></DT ><DT >A.1.6. <A -HREF="faq.html#AEN1793" +HREF="faq.html#AEN1864" > How does Bugzilla stack up against other bug-tracking databases? </A ></DT ><DT >A.1.7. <A -HREF="faq.html#AEN1799" +HREF="faq.html#AEN1870" > Why doesn't Bugzilla offer this or that feature or compatibility with this other tracking software? </A ></DT ><DT >A.1.8. <A -HREF="faq.html#AEN1806" +HREF="faq.html#AEN1877" > Why MySQL? I'm interested in seeing Bugzilla run on Oracle/Sybase/Msql/PostgreSQL/MSSQL. </A ></DT ><DT >A.1.9. <A -HREF="faq.html#AEN1815" +HREF="faq.html#AEN1886" > Why do the scripts say "/usr/bonsaitools/bin/perl" instead of "/usr/bin/perl" or something else? </A ></DT ><DT >A.1.10. <A -HREF="faq.html#AEN1821" +HREF="faq.html#AEN1892" > Is there an easy way to change the Bugzilla cookie name? </A ></DT @@ -159,41 +159,41 @@ HREF="faq.html#faq-phb" ><DL ><DT >A.2.1. <A -HREF="faq.html#AEN1831" +HREF="faq.html#AEN1902" > Is Bugzilla web-based, or do you have to have specific software or a specific operating system on your machine? </A ></DT ><DT >A.2.2. <A -HREF="faq.html#AEN1836" +HREF="faq.html#AEN1907" > Can Bugzilla integrate with Perforce (SCM software)? </A ></DT ><DT >A.2.3. <A -HREF="faq.html#AEN1841" +HREF="faq.html#AEN1912" > Does Bugzilla allow the user to track multiple projects? </A ></DT ><DT >A.2.4. <A -HREF="faq.html#AEN1846" +HREF="faq.html#AEN1917" > If I am on many projects, and search for all bugs assigned to me, will Bugzilla list them for me and allow me to sort by project, severity etc? </A ></DT ><DT >A.2.5. <A -HREF="faq.html#AEN1851" +HREF="faq.html#AEN1922" > Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes, are there any that are NOT allowed? </A ></DT ><DT >A.2.6. <A -HREF="faq.html#AEN1856" +HREF="faq.html#AEN1927" > Does Bugzilla allow us to define our own priorities and levels? Do we have complete freedom to change the labels of fields and format of them, and the choice of acceptable values? @@ -201,35 +201,35 @@ HREF="faq.html#AEN1856" ></DT ><DT >A.2.7. <A -HREF="faq.html#AEN1863" +HREF="faq.html#AEN1934" > Does Bugzilla provide any reporting features, metrics, graphs, etc? You know, the type of stuff that management likes to see. :) </A ></DT ><DT >A.2.8. <A -HREF="faq.html#AEN1870" +HREF="faq.html#AEN1941" > Is there email notification and if so, what do you see when you get an email? </A ></DT ><DT >A.2.9. <A -HREF="faq.html#AEN1875" +HREF="faq.html#AEN1946" > Can email notification be set up to send to multiple people, some on the To List, CC List, BCC List etc? </A ></DT ><DT >A.2.10. <A -HREF="faq.html#AEN1880" +HREF="faq.html#AEN1951" > Do users have to have any particular type of email application? </A ></DT ><DT >A.2.11. <A -HREF="faq.html#AEN1887" +HREF="faq.html#AEN1958" > Does Bugzilla allow data to be imported and exported? If I had outsiders write up a bug report using a MS Word bug template, could that template be imported into "matching" fields? If I wanted to take the results of a query @@ -238,28 +238,28 @@ HREF="faq.html#AEN1887" ></DT ><DT >A.2.12. <A -HREF="faq.html#AEN1899" +HREF="faq.html#AEN1970" > Has anyone converted Bugzilla to another language to be used in other countries? Is it localizable? </A ></DT ><DT >A.2.13. <A -HREF="faq.html#AEN1906" +HREF="faq.html#AEN1977" > Can a user create and save reports? Can they do this in Word format? Excel format? </A ></DT ><DT >A.2.14. <A -HREF="faq.html#AEN1911" +HREF="faq.html#AEN1982" > Does Bugzilla have the ability to search by word, phrase, compound search? </A ></DT ><DT >A.2.15. <A -HREF="faq.html#AEN1916" +HREF="faq.html#AEN1987" > Does Bugzilla provide record locking when there is simultaneous access to the same bug? Does the second person get a notice that the bug is in use or how are they notified? @@ -267,19 +267,19 @@ HREF="faq.html#AEN1916" ></DT ><DT >A.2.16. <A -HREF="faq.html#AEN1921" +HREF="faq.html#AEN1992" > Are there any backup features provided? </A ></DT ><DT >A.2.17. <A -HREF="faq.html#AEN1927" +HREF="faq.html#AEN1998" > Can users be on the system while a backup is in progress? </A ></DT ><DT >A.2.18. <A -HREF="faq.html#AEN1932" +HREF="faq.html#AEN2003" > What type of human resources are needed to be on staff to install and maintain Bugzilla? Specifically, what type of skills does the person need to have? I need to find out if we were to go with Bugzilla, what types of @@ -289,7 +289,7 @@ HREF="faq.html#AEN1932" ></DT ><DT >A.2.19. <A -HREF="faq.html#AEN1938" +HREF="faq.html#AEN2009" > What time frame are we looking at if we decide to hire people to install and maintain the Bugzilla? Is this something that takes hours or weeks to install and a couple of hours per week to maintain and customize or is this @@ -299,7 +299,7 @@ HREF="faq.html#AEN1938" ></DT ><DT >A.2.20. <A -HREF="faq.html#AEN1943" +HREF="faq.html#AEN2014" > Is there any licensing fee or other fees for using Bugzilla? Any out-of-pocket cost other than the bodies needed as identified above? </A @@ -315,20 +315,20 @@ HREF="faq.html#faq-security" ><DL ><DT >A.3.1. <A -HREF="faq.html#AEN1950" +HREF="faq.html#AEN2021" > How do I completely disable MySQL security if it's giving me problems (I've followed the instructions in the installation section of this guide)? </A ></DT ><DT >A.3.2. <A -HREF="faq.html#AEN1956" +HREF="faq.html#AEN2027" > Are there any security problems with Bugzilla? </A ></DT ><DT >A.3.3. <A -HREF="faq.html#AEN1961" +HREF="faq.html#AEN2032" > I've implemented the security fixes mentioned in Chris Yeh's security advisory of 5/10/2000 advising not to run MySQL as root, and am running into problems with MySQL no longer working correctly. @@ -345,48 +345,48 @@ HREF="faq.html#faq-email" ><DL ><DT >A.4.1. <A -HREF="faq.html#AEN1968" +HREF="faq.html#AEN2039" > I have a user who doesn't want to receive any more email from Bugzilla. How do I stop it entirely for this user? </A ></DT ><DT >A.4.2. <A -HREF="faq.html#AEN1974" +HREF="faq.html#AEN2045" > I'm evaluating/testing Bugzilla, and don't want it to send email to anyone but me. How do I do it? </A ></DT ><DT >A.4.3. <A -HREF="faq.html#AEN1979" +HREF="faq.html#AEN2050" > I want whineatnews.pl to whine at something more, or other than, only new bugs. How do I do it? </A ></DT ><DT >A.4.4. <A -HREF="faq.html#AEN1985" +HREF="faq.html#AEN2056" > I don't like/want to use Procmail to hand mail off to bug_email.pl. What alternatives do I have? </A ></DT ><DT >A.4.5. <A -HREF="faq.html#AEN1992" +HREF="faq.html#AEN2063" > How do I set up the email interface to submit/change bugs via email? </A ></DT ><DT >A.4.6. <A -HREF="faq.html#AEN1997" +HREF="faq.html#AEN2068" > Email takes FOREVER to reach me from Bugzilla -- it's extremely slow. What gives? </A ></DT ><DT >A.4.7. <A -HREF="faq.html#AEN2004" +HREF="faq.html#AEN2075" > How come email from Bugzilla changes never reaches me? </A ></DT @@ -401,33 +401,33 @@ HREF="faq.html#faq-db" ><DL ><DT >A.5.1. <A -HREF="faq.html#AEN2012" +HREF="faq.html#AEN2083" > I've heard Bugzilla can be used with Oracle? </A ></DT ><DT >A.5.2. <A -HREF="faq.html#AEN2017" +HREF="faq.html#AEN2088" > I think my database might be corrupted, or contain invalid entries. What do I do? </A ></DT ><DT >A.5.3. <A -HREF="faq.html#AEN2025" +HREF="faq.html#AEN2096" > I want to manually edit some entries in my database. How? </A ></DT ><DT >A.5.4. <A -HREF="faq.html#AEN2033" +HREF="faq.html#AEN2104" > I think I've set up MySQL permissions correctly, but Bugzilla still can't connect. </A ></DT ><DT >A.5.5. <A -HREF="faq.html#AEN2041" +HREF="faq.html#AEN2112" > How do I synchronize bug information among multiple different Bugzilla databases? </A @@ -443,26 +443,26 @@ HREF="faq.html#faq-nt" ><DL ><DT >A.6.1. <A -HREF="faq.html#AEN2050" +HREF="faq.html#AEN2121" > What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)? </A ></DT ><DT >A.6.2. <A -HREF="faq.html#AEN2055" +HREF="faq.html#AEN2126" > Is there a "Bundle::Bugzilla" equivalent for Win32? </A ></DT ><DT >A.6.3. <A -HREF="faq.html#AEN2060" +HREF="faq.html#AEN2131" > CGI's are failing with a "something.cgi is not a valid Windows NT application" error. Why? </A ></DT ><DT >A.6.4. <A -HREF="faq.html#AEN2068" +HREF="faq.html#AEN2139" > I'm having trouble with the perl modules for NT not being able to talk to to the database. </A @@ -478,33 +478,33 @@ HREF="faq.html#faq-use" ><DL ><DT >A.7.1. <A -HREF="faq.html#AEN2089" +HREF="faq.html#AEN2160" > How do I change my user name (email address) in Bugzilla? </A ></DT ><DT >A.7.2. <A -HREF="faq.html#AEN2094" +HREF="faq.html#AEN2165" > The query page is very confusing. Isn't there a simpler way to query? </A ></DT ><DT >A.7.3. <A -HREF="faq.html#AEN2099" +HREF="faq.html#AEN2170" > I'm confused by the behavior of the "accept" button in the Show Bug form. Why doesn't it assign the bug to me when I accept it? </A ></DT ><DT >A.7.4. <A -HREF="faq.html#AEN2109" +HREF="faq.html#AEN2180" > I can't upload anything into the database via the "Create Attachment" link. What am I doing wrong? </A ></DT ><DT >A.7.5. <A -HREF="faq.html#AEN2114" +HREF="faq.html#AEN2185" > How do I change a keyword in Bugzilla, once some bugs are using it? </A ></DT @@ -519,26 +519,26 @@ HREF="faq.html#faq-hacking" ><DL ><DT >A.8.1. <A -HREF="faq.html#AEN2121" +HREF="faq.html#AEN2192" > What kind of style should I use for templatization? </A ></DT ><DT >A.8.2. <A -HREF="faq.html#AEN2129" +HREF="faq.html#AEN2200" > What bugs are in Bugzilla right now? </A ></DT ><DT >A.8.3. <A -HREF="faq.html#AEN2138" +HREF="faq.html#AEN2209" > How can I change the default priority to a null value? For instance, have the default priority be "---" instead of "P2"? </A ></DT ><DT >A.8.4. <A -HREF="faq.html#AEN2144" +HREF="faq.html#AEN2215" > What's the best way to submit patches? What guidelines should I follow? </A ></DT @@ -558,7 +558,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1742" +NAME="AEN1813" ></A ><B >A.1.1. </B @@ -586,7 +586,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1748" +NAME="AEN1819" ></A ><B >A.1.2. </B @@ -615,7 +615,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1754" +NAME="AEN1825" ></A ><B >A.1.3. </B @@ -661,7 +661,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1763" +NAME="AEN1834" ></A ><B >A.1.4. </B @@ -767,7 +767,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1787" +NAME="AEN1858" ></A ><B >A.1.5. </B @@ -797,7 +797,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1793" +NAME="AEN1864" ></A ><B >A.1.6. </B @@ -835,7 +835,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1799" +NAME="AEN1870" ></A ><B >A.1.7. </B @@ -875,7 +875,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1806" +NAME="AEN1877" ></A ><B >A.1.8. </B @@ -920,7 +920,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1815" +NAME="AEN1886" ></A ><B >A.1.9. </B @@ -953,7 +953,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1821" +NAME="AEN1892" ></A ><B >A.1.10. </B @@ -1015,7 +1015,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1831" +NAME="AEN1902" ></A ><B >A.2.1. </B @@ -1041,7 +1041,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1836" +NAME="AEN1907" ></A ><B >A.2.2. </B @@ -1067,7 +1067,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1841" +NAME="AEN1912" ></A ><B >A.2.3. </B @@ -1092,7 +1092,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1846" +NAME="AEN1917" ></A ><B >A.2.4. </B @@ -1117,7 +1117,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1851" +NAME="AEN1922" ></A ><B >A.2.5. </B @@ -1146,7 +1146,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1856" +NAME="AEN1927" ></A ><B >A.2.6. </B @@ -1183,7 +1183,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1863" +NAME="AEN1934" ></A ><B >A.2.7. </B @@ -1221,7 +1221,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1870" +NAME="AEN1941" ></A ><B >A.2.8. </B @@ -1248,7 +1248,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1875" +NAME="AEN1946" ></A ><B >A.2.9. </B @@ -1273,7 +1273,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1880" +NAME="AEN1951" ></A ><B >A.2.10. </B @@ -1332,7 +1332,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1887" +NAME="AEN1958" ></A ><B >A.2.11. </B @@ -1394,7 +1394,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1899" +NAME="AEN1970" ></A ><B >A.2.12. </B @@ -1432,7 +1432,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1906" +NAME="AEN1977" ></A ><B >A.2.13. </B @@ -1457,7 +1457,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1911" +NAME="AEN1982" ></A ><B >A.2.14. </B @@ -1483,7 +1483,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1916" +NAME="AEN1987" ></A ><B >A.2.15. </B @@ -1510,7 +1510,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1921" +NAME="AEN1992" ></A ><B >A.2.16. </B @@ -1540,7 +1540,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1927" +NAME="AEN1998" ></A ><B >A.2.17. </B @@ -1566,7 +1566,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1932" +NAME="AEN2003" ></A ><B >A.2.18. </B @@ -1601,7 +1601,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1938" +NAME="AEN2009" ></A ><B >A.2.19. </B @@ -1634,7 +1634,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1943" +NAME="AEN2014" ></A ><B >A.2.20. </B @@ -1668,7 +1668,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1950" +NAME="AEN2021" ></A ><B >A.3.1. </B @@ -1697,7 +1697,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1956" +NAME="AEN2027" ></A ><B >A.3.2. </B @@ -1725,7 +1725,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1961" +NAME="AEN2032" ></A ><B >A.3.3. </B @@ -1761,7 +1761,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1968" +NAME="AEN2039" ></A ><B >A.4.1. </B @@ -1791,7 +1791,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1974" +NAME="AEN2045" ></A ><B >A.4.2. </B @@ -1817,7 +1817,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1979" +NAME="AEN2050" ></A ><B >A.4.3. </B @@ -1849,7 +1849,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1985" +NAME="AEN2056" ></A ><B >A.4.4. </B @@ -1867,7 +1867,7 @@ CLASS="answer" You can call bug_email.pl directly from your aliases file, with an entry like this: <A -NAME="AEN1989" +NAME="AEN2060" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -1888,7 +1888,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1992" +NAME="AEN2063" ></A ><B >A.4.5. </B @@ -1913,7 +1913,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN1997" +NAME="AEN2068" ></A ><B >A.4.6. </B @@ -1948,7 +1948,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2004" +NAME="AEN2075" ></A ><B >A.4.7. </B @@ -1988,7 +1988,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2012" +NAME="AEN2083" ></A ><B >A.5.1. </B @@ -2016,7 +2016,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2017" +NAME="AEN2088" ></A ><B >A.5.2. </B @@ -2063,7 +2063,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2025" +NAME="AEN2096" ></A ><B >A.5.3. </B @@ -2104,7 +2104,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2033" +NAME="AEN2104" ></A ><B >A.5.4. </B @@ -2165,7 +2165,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2041" +NAME="AEN2112" ></A ><B >A.5.5. </B @@ -2211,7 +2211,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2050" +NAME="AEN2121" ></A ><B >A.6.1. </B @@ -2236,7 +2236,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2055" +NAME="AEN2126" ></A ><B >A.6.2. </B @@ -2262,7 +2262,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2060" +NAME="AEN2131" ></A ><B >A.6.3. </B @@ -2285,7 +2285,7 @@ CLASS="answer" ><P > Microsoft has some advice on this matter, as well: <A -NAME="AEN2065" +NAME="AEN2136" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -2310,7 +2310,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2068" +NAME="AEN2139" ></A ><B >A.6.4. </B @@ -2387,7 +2387,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2089" +NAME="AEN2160" ></A ><B >A.7.1. </B @@ -2412,7 +2412,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2094" +NAME="AEN2165" ></A ><B >A.7.2. </B @@ -2438,7 +2438,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2099" +NAME="AEN2170" ></A ><B >A.7.3. </B @@ -2493,7 +2493,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2109" +NAME="AEN2180" ></A ><B >A.7.4. </B @@ -2520,7 +2520,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2114" +NAME="AEN2185" ></A ><B >A.7.5. </B @@ -2554,7 +2554,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2121" +NAME="AEN2192" ></A ><B >A.8.1. </B @@ -2613,7 +2613,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2129" +NAME="AEN2200" ></A ><B >A.8.2. </B @@ -2659,7 +2659,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2138" +NAME="AEN2209" ></A ><B >A.8.3. </B @@ -2691,7 +2691,7 @@ CLASS="qandaentry" CLASS="question" ><P ><A -NAME="AEN2144" +NAME="AEN2215" ></A ><B >A.8.4. </B diff --git a/docs/html/glossary.html b/docs/html/glossary.html index 3e73b56ae..ccf315815 100644 --- a/docs/html/glossary.html +++ b/docs/html/glossary.html @@ -70,7 +70,7 @@ CLASS="glossdiv" ><H1 CLASS="glossdiv" ><A -NAME="AEN2300" +NAME="AEN2371" ></A >0-9, high ascii</H1 ><DL diff --git a/docs/html/hintsandtips.html b/docs/html/hintsandtips.html index 8638a3167..2256e47ea 100644 --- a/docs/html/hintsandtips.html +++ b/docs/html/hintsandtips.html @@ -84,7 +84,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN434" +NAME="AEN431" ></A >3.2.1. Autolinkification</H2 ><P @@ -232,7 +232,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN463" +NAME="AEN460" ></A >3.2.5. Filing Bugs</H2 ><P diff --git a/docs/html/index.html b/docs/html/index.html index 36eafcf62..57c05dbf2 100644 --- a/docs/html/index.html +++ b/docs/html/index.html @@ -59,11 +59,14 @@ CLASS="author" NAME="AEN9" ></A >The Bugzilla Team</H3 +><P +CLASS="pubdate" +>2003-01-02<BR></P ><DIV ><DIV CLASS="abstract" ><A -NAME="AEN13" +NAME="AEN14" ></A ><P ></P @@ -86,6 +89,11 @@ TARGET="_top" >. </P ><P +>This is a development version of this guide. Information in it + is subject to change before the 2.18 release of this guide + (which will correspond with the 2.18 release of Bugzilla). + </P +><P ></P ></DIV ></DIV @@ -372,22 +380,37 @@ CLASS="LOT" ></DT ><DT >4-1. <A -HREF="win32.html#AEN1035" +HREF="win32.html#AEN1032" >Installing ActivePerl ppd Modules on Microsoft Windows</A ></DT ><DT >4-2. <A -HREF="win32.html#AEN1048" +HREF="win32.html#AEN1045" >Installing OpenInteract ppd Modules manually on Microsoft Windows</A ></DT ><DT >4-3. <A -HREF="win32.html#AEN1214" +HREF="win32.html#AEN1211" >Removing encrypt() for Windows NT Bugzilla version 2.12 or earlier</A ></DT +><DT +>5-1. <A +HREF="upgrading.html#upgrade-cvs" +>Upgrading using CVS</A +></DT +><DT +>5-2. <A +HREF="upgrading.html#upgrade-tarball" +>Upgrading using the tarball</A +></DT +><DT +>5-3. <A +HREF="upgrading.html#upgrade-patches" +>Upgrading using patches</A +></DT ></DL ></DIV ></DIV diff --git a/docs/html/installation.html b/docs/html/installation.html index 26abff6b5..558ae920b 100644 --- a/docs/html/installation.html +++ b/docs/html/installation.html @@ -88,12 +88,12 @@ HREF="stepbystep.html" ><DL ><DT >4.1.1. <A -HREF="stepbystep.html#AEN492" +HREF="stepbystep.html#AEN489" >Introduction</A ></DT ><DT >4.1.2. <A -HREF="stepbystep.html#AEN496" +HREF="stepbystep.html#AEN493" >Package List</A ></DT ><DT @@ -113,22 +113,22 @@ HREF="stepbystep.html#perl-modules" ></DT ><DT >4.1.6. <A -HREF="stepbystep.html#AEN677" +HREF="stepbystep.html#AEN674" >HTTP Server</A ></DT ><DT >4.1.7. <A -HREF="stepbystep.html#AEN696" +HREF="stepbystep.html#AEN693" >Bugzilla</A ></DT ><DT >4.1.8. <A -HREF="stepbystep.html#AEN721" +HREF="stepbystep.html#AEN718" >Setting Up the MySQL Database</A ></DT ><DT >4.1.9. <A -HREF="stepbystep.html#AEN757" +HREF="stepbystep.html#AEN754" ><TT CLASS="filename" >checksetup.pl</TT @@ -136,12 +136,12 @@ CLASS="filename" ></DT ><DT >4.1.10. <A -HREF="stepbystep.html#AEN789" +HREF="stepbystep.html#AEN786" >Securing MySQL</A ></DT ><DT >4.1.11. <A -HREF="stepbystep.html#AEN855" +HREF="stepbystep.html#AEN852" >Configuring Bugzilla</A ></DT ></DL @@ -155,17 +155,17 @@ HREF="extraconfig.html" ><DL ><DT >4.2.1. <A -HREF="extraconfig.html#AEN861" +HREF="extraconfig.html#AEN858" >Dependency Charts</A ></DT ><DT >4.2.2. <A -HREF="extraconfig.html#AEN876" +HREF="extraconfig.html#AEN873" >Bug Graphs</A ></DT ><DT >4.2.3. <A -HREF="extraconfig.html#AEN889" +HREF="extraconfig.html#AEN886" >The Whining Cron</A ></DT ><DT @@ -249,12 +249,12 @@ HREF="troubleshooting.html" ><DL ><DT >4.5.1. <A -HREF="troubleshooting.html#AEN1248" +HREF="troubleshooting.html#AEN1245" >Bundle::Bugzilla makes me upgrade to Perl 5.6.1</A ></DT ><DT >4.5.2. <A -HREF="troubleshooting.html#AEN1253" +HREF="troubleshooting.html#AEN1250" >DBD::Sponge::db prepare failed</A ></DT ><DT diff --git a/docs/html/newversions.html b/docs/html/newversions.html index ddecb859c..37ccb9755 100644 --- a/docs/html/newversions.html +++ b/docs/html/newversions.html @@ -77,40 +77,34 @@ NAME="newversions" ></A >1.3. New Versions</H1 ><P -> This is the 2.16 version of The Bugzilla Guide. It is so named - to match the current version of Bugzilla. If you are +> This is the 2.17.3 version of The Bugzilla Guide. It is so named + to match the current version of Bugzilla. + + This version of the guide, like its associated Bugzilla version is a + development version. Information is subject to change between now and + when 2.18 is released. + + If you are reading this from any source other than those below, please check one of these mirrors to make sure you are reading an up-to-date version of the Guide. </P ><P -> This document can be found in the following places: - </P -><P -> <P -></P -><UL -><LI -><P -> <A -HREF="http://www.bugzilla.org/" +> The newest version of this guide can always be found at <A +HREF="http://www.bugzilla.org" TARGET="_top" >bugzilla.org</A -> - </P -></LI -><LI +>; including + documentation for past releases and the current development version. + </P ><P -> <A -HREF="http://www.linuxdoc.org/" +> The documentation for the most recent stable release of Bugzilla can also + be found at + <A +HREF="http://www.tldp.org" TARGET="_top" ->The Linux - Documentation Project</A -> - </P -></LI -></UL -> +>The Linux Documentation Project</A +>. </P ><P > The latest version of this document can always be checked out via CVS. diff --git a/docs/html/stepbystep.html b/docs/html/stepbystep.html index 09dea6ccf..27870e9ae 100644 --- a/docs/html/stepbystep.html +++ b/docs/html/stepbystep.html @@ -81,7 +81,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN492" +NAME="AEN489" ></A >4.1.1. Introduction</H2 ><P @@ -101,7 +101,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN496" +NAME="AEN493" ></A >4.1.2. Package List</H2 ><DIV @@ -152,7 +152,7 @@ HREF="http://www.mysql.com/" TARGET="_top" >MySQL database server</A > - (3.23.6 or greater) + (3.23.41 or greater) </P ></LI ><LI @@ -298,7 +298,7 @@ TARGET="_top" ></LI ><LI ><P -> GD::Chart +> GD::Graph (any) for bug charting </P ></LI @@ -863,7 +863,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN650" +NAME="AEN647" ></A >4.1.5.1. DBI</H3 ><P @@ -878,7 +878,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN653" +NAME="AEN650" ></A >4.1.5.2. Data::Dumper</H3 ><P @@ -892,7 +892,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN656" +NAME="AEN653" ></A >4.1.5.3. MySQL-related modules</H3 ><P @@ -918,7 +918,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN661" +NAME="AEN658" ></A >4.1.5.4. TimeDate modules</H3 ><P @@ -934,7 +934,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN664" +NAME="AEN661" ></A >4.1.5.5. GD (optional)</H3 ><P @@ -989,7 +989,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN671" +NAME="AEN668" ></A >4.1.5.6. Chart::Base (optional)</H3 ><P @@ -1004,7 +1004,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN674" +NAME="AEN671" ></A >4.1.5.7. Template Toolkit</H3 ><P @@ -1020,7 +1020,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN677" +NAME="AEN674" ></A >4.1.6. HTTP Server</H2 ><P @@ -1198,7 +1198,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN696" +NAME="AEN693" ></A >4.1.7. Bugzilla</H2 ><P @@ -1368,7 +1368,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN721" +NAME="AEN718" ></A >4.1.8. Setting Up the MySQL Database</H2 ><P @@ -1541,7 +1541,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN757" +NAME="AEN754" ></A >4.1.9. <TT CLASS="filename" @@ -1694,7 +1694,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN789" +NAME="AEN786" ></A >4.1.10. Securing MySQL</H2 ><P @@ -1972,7 +1972,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN855" +NAME="AEN852" ></A >4.1.11. Configuring Bugzilla</H2 ><P diff --git a/docs/html/troubleshooting.html b/docs/html/troubleshooting.html index 11d3ae689..d899953c3 100644 --- a/docs/html/troubleshooting.html +++ b/docs/html/troubleshooting.html @@ -85,7 +85,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1248" +NAME="AEN1245" ></A >4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2 ><P @@ -110,7 +110,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1253" +NAME="AEN1250" ></A >4.5.2. DBD::Sponge::db prepare failed</H2 ><P diff --git a/docs/html/upgrading.html b/docs/html/upgrading.html index 8371afa31..2f58b007b 100644 --- a/docs/html/upgrading.html +++ b/docs/html/upgrading.html @@ -77,41 +77,496 @@ NAME="upgrading" ></A >5.9. Upgrading to New Releases</H1 ><P ->A plain Bugzilla is fairly easy to upgrade from one version to a - newer one. Always read the release notes to see if there are any issues - that you might need to take note of. It is recommended that you take a - backup of your database and your entire Bugzilla installation before attempting an - upgrade. You can upgrade a 'clean' installation by untarring a new - tarball over the old installation. If you are upgrading from 2.12 or - later, and have cvs installed, you can type <TT -CLASS="filename" ->cvs -z3 update</TT ->, - and resolve conflicts if there are any. +>Upgrading Bugzilla is something we all want to do from time to time, + be it to get new features or pick up the latest security fix. How easy + it is to update depends on a few factors. + </P +><P +></P +><UL +><LI +><P +>If the new version is a revision or a new point release</P +></LI +><LI +><P +>How many, if any, local changes have been made</P +></LI +></UL +><P +>There are also three different methods to upgrade your installation. + </P +><P +></P +><OL +TYPE="1" +><LI +><P +>Using CVS (<A +HREF="upgrading.html#upgrade-cvs" +>Example 5-1</A +>)</P +></LI +><LI +><P +>Downloading a new tarball (<A +HREF="upgrading.html#upgrade-tarball" +>Example 5-2</A +>)</P +></LI +><LI +><P +>Applying the relevant patches (<A +HREF="upgrading.html#upgrade-patches" +>Example 5-3</A +>)</P +></LI +></OL +><P +>Which options are available to you may depend on how large a jump + you are making and/or your network configuration. + </P +><P +>Revisions are normally released to fix security vulnerabilities + and are distinguished by an increase in the third number. For example, + when 2.16.2 was released, it was a revision to 2.16.1. + </P +><P +>Point releases are normally released when the Bugzilla team feels + that there has been a significant amount of progress made between the + last point release and the current time. These are often proceeded by a + stabilization period and release candidates, however the use of + development versions or release candidates is beyond the scope of this + document. Point releases can be distinguished by an increase in the + second number, or minor version. For example, 2.16.2 is a newer point + release than 2.14.5. + </P +><P +>The examples in this section are written as if you were updating + to version 2.16.2. The procedures are the same regardless if you are + updating to a new point release or a new revision. However, the chance + of running into trouble increases when upgrading to a new point release, + escpecially if you've made local changes. </P ><P ->However, things get a bit more complicated if you've made - changes to Bugzilla's code. In this case, you may have to re-make or - reapply those changes. One good method is to take a diff of your customized - version against the original, so you can survey all that you've changed. - Hopefully, templatization will reduce the need for - this in the future.</P -><P ->From version 2.8 onward, Bugzilla databases can be automatically - carried forward during an upgrade. However, because the developers of - Bugzilla are constantly adding new - tables, columns and fields, you'll probably get SQL errors if you just - update the code and attempt to use Bugzilla. Always run the +>These examples also assume that your Bugzilla installation is at <TT CLASS="filename" ->checksetup.pl</TT -> - script whenever you upgrade your installation.</P -><P ->If you are running Bugzilla version 2.8 or lower, and wish to - upgrade to the latest version, please consult the file, - "UPGRADING-pre-2.8" in the Bugzilla root directory after untarring the - archive.</P +>/var/www/html/bugzilla</TT +>. If that is not the case, + simply substitute the proper paths where appropriate. + </P +><DIV +CLASS="example" +><A +NAME="upgrade-cvs" +></A +><P +><B +>Example 5-1. Upgrading using CVS</B +></P +><P +>Every release of Bugzilla, whether it is a revision or a point + release, is tagged in CVS. Also, every tarball we have distributed + since version 2.12 has been primed for using CVS. This does, however, + require that you are able to access cvs-mirror.mozilla.org on port + 2401. + + <DIV +CLASS="tip" +><P +></P +><TABLE +CLASS="tip" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/tip.gif" +HSPACE="5" +ALT="Tip"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>If you can do this, updating using CVS is probably the most + painless method, especially if you have a lot of local changes. + </P +></TD +></TR +></TABLE +></DIV +> + </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> bash$ <B +CLASS="command" +>cd /var/www/html/bugzilla</B +> +bash$ <B +CLASS="command" +>cvs login</B +> +Logging in to :pserver:anonymous@cvs-mirror.mozilla.org:2401/cvsroot +CVS password: <B +CLASS="command" +>anonymous</B +> +bash$ <B +CLASS="command" +>cvs -q update -r BUGZILLA-2_16_2 -dP</B +> +P checksetup.pl +P collectstats.pl +P globals.pl +P docs/rel_notes.txt +P template/en/default/list/quips.html.tmpl + </PRE +></FONT +></TD +></TR +></TABLE +><P +> <DIV +CLASS="caution" +><P +></P +><TABLE +CLASS="caution" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/caution.gif" +HSPACE="5" +ALT="Caution"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>If a line in the output from <B +CLASS="command" +>cvs update</B +> + begins with a <TT +CLASS="computeroutput" +>C</TT +> that represents a + file with local changes that CVS was unable to properly merge. You + need to resolve these conflicts manually before Bugzilla (or at + least the portion using that file) will be usable. + </P +></TD +></TR +></TABLE +></DIV +> + + <DIV +CLASS="note" +><P +></P +><TABLE +CLASS="note" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/note.gif" +HSPACE="5" +ALT="Note"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>You also need to run <B +CLASS="command" +>./checksetup.pl</B +> + before your Bugzilla upgrade will be complete. + </P +></TD +></TR +></TABLE +></DIV +> + </P +></DIV +><DIV +CLASS="example" +><A +NAME="upgrade-tarball" +></A +><P +><B +>Example 5-2. Upgrading using the tarball</B +></P +><P +>If you are unable or unwilling to use CVS, another option that's + always available is to download the latest tarball. This is the most + difficult option to use, especially if you have local changes. + </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> bash$ <B +CLASS="command" +>cd /var/www/html</B +> +bash$ <B +CLASS="command" +>wget ftp://ftp.mozilla.org/pub/webtools/bugzilla-2.16.2.tar.gz</B +> +<EM +>Output omitted</EM +> +bash$ <B +CLASS="command" +>tar xzvf bugzilla-2.16.2.tar.gz</B +> +bugzilla-2.16.2/ +bugzilla-2.16.2/.cvsignore +bugzilla-2.16.2/1x1.gif +<EM +>Output truncated</EM +> +bash$ <B +CLASS="command" +>cd bugzilla-2.16.2</B +> +bash$ <B +CLASS="command" +>cp ../bugzilla/localconfig* .</B +> +bash$ <B +CLASS="command" +>cp -r ../bugzilla/data .</B +> +bash$ <B +CLASS="command" +>cd ..</B +> +bash$ <B +CLASS="command" +>mv bugzilla bugzilla.old</B +> +bash$ <B +CLASS="command" +>mv bugzilla-2.16.2 bugzilla</B +> +bash$ <B +CLASS="command" +>cd bugzilla</B +> +bash$ <B +CLASS="command" +>./checksetup.pl</B +> +<EM +>Output omitted</EM +> + </PRE +></FONT +></TD +></TR +></TABLE +><P +> <DIV +CLASS="warning" +><P +></P +><TABLE +CLASS="warning" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/warning.gif" +HSPACE="5" +ALT="Warning"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>The <B +CLASS="command" +>cp</B +> commands both end with periods which + is a very important detail, it tells the shell that the destination + directory is the current working directory. Also, the period at the + beginning of the <B +CLASS="command" +>./checksetup.pl</B +> is important and + can not be omitted. + </P +></TD +></TR +></TABLE +></DIV +> + + <DIV +CLASS="note" +><P +></P +><TABLE +CLASS="note" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/note.gif" +HSPACE="5" +ALT="Note"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>You will now have to reapply any changes you have made to your + local installation manually. + </P +></TD +></TR +></TABLE +></DIV +> + </P +></DIV +><DIV +CLASS="example" +><A +NAME="upgrade-patches" +></A +><P +><B +>Example 5-3. Upgrading using patches</B +></P +><P +>The Bugzilla team will normally make a patch file available for + revisions to go from the most recent revision to the new one. You could + also read the release notes and grab the patches attached to the + mentioned bug, but it is safer to use the released patch file as + sometimes patches get changed before they get checked in (for minor + spelling fixes and the like). It is also theorectically possible to + scour the fixed bug list and pick and choose which patches to apply + from a point release, but this is not recommended either as what you'll + end up with is a hodge podge Bugzilla that isn't really any version. + This would also make it more difficult to upgrade in the future. + </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> bash$ <B +CLASS="command" +>cd /var/www/html/bugzilla</B +> +bash$ <B +CLASS="command" +>wget ftp://ftp.mozilla.org/pub/webtools/bugzilla-2.16.1-to-2.16.2.diff.gz</B +> +<EM +>Output omitted</EM +> +bash$ <B +CLASS="command" +>gunzip bugzilla-2.16.1-to-2.16.2.diff.gz</B +> +bash$ <B +CLASS="command" +>patch -p1 < bugzilla-2.16.1-to-2.16.2.diff</B +> +patching file checksetup.pl +patching file collectstats.pl +patching file globals.pl + </PRE +></FONT +></TD +></TR +></TABLE +><P +> <DIV +CLASS="caution" +><P +></P +><TABLE +CLASS="caution" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="../images/caution.gif" +HSPACE="5" +ALT="Caution"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" +><P +>If you do this, beware that this doesn't change the entires in + your <TT +CLASS="filename" +>CVS</TT +> directory so it may make + updates using CVS (<A +HREF="upgrading.html#upgrade-cvs" +>Example 5-1</A +>) more difficult in the + future. + </P +></TD +></TR +></TABLE +></DIV +> + </P +></DIV ></DIV ><DIV CLASS="NAVFOOTER" diff --git a/docs/html/using.html b/docs/html/using.html index efbd2dba5..6056e87fc 100644 --- a/docs/html/using.html +++ b/docs/html/using.html @@ -122,7 +122,7 @@ HREF="hintsandtips.html" ><DL ><DT >3.2.1. <A -HREF="hintsandtips.html#AEN434" +HREF="hintsandtips.html#AEN431" >Autolinkification</A ></DT ><DT @@ -142,7 +142,7 @@ HREF="hintsandtips.html#attachments" ></DT ><DT >3.2.5. <A -HREF="hintsandtips.html#AEN463" +HREF="hintsandtips.html#AEN460" >Filing Bugs</A ></DT ></DL diff --git a/docs/html/win32.html b/docs/html/win32.html index 6d5edd9dd..c7e1eb88a 100644 --- a/docs/html/win32.html +++ b/docs/html/win32.html @@ -389,7 +389,7 @@ CLASS="command" ><DIV CLASS="example" ><A -NAME="AEN1035" +NAME="AEN1032" ></A ><P ><B @@ -449,7 +449,7 @@ TARGET="_top" <DIV CLASS="example" ><A -NAME="AEN1048" +NAME="AEN1045" ></A ><P ><B @@ -1475,7 +1475,7 @@ VALIGN="TOP" ><P >From Andrew Pearson: <A -NAME="AEN1202" +NAME="AEN1199" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -1560,7 +1560,7 @@ VALIGN="TOP" <DIV CLASS="example" ><A -NAME="AEN1214" +NAME="AEN1211" ></A ><P ><B diff --git a/docs/txt/Bugzilla-Guide.txt b/docs/txt/Bugzilla-Guide.txt index 166ee98a8..90a993e1f 100644 --- a/docs/txt/Bugzilla-Guide.txt +++ b/docs/txt/Bugzilla-Guide.txt @@ -5,6 +5,8 @@ Matthew P. Barnson The Bugzilla Team + 2003-01-02 + This is the documentation for Bugzilla, the mozilla.org bug-tracking system. Bugzilla is an enterprise-class piece of software that powers issue-tracking for hundreds of organizations around the world, @@ -13,6 +15,10 @@ The Bugzilla Team 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 mozilla.org's Bugzilla. + + This is a development version of this guide. Information in it is + subject to change before the 2.18 release of this guide (which will + correspond with the 2.18 release of Bugzilla). _________________________________________________________________ Table of Contents @@ -83,6 +89,10 @@ The Bugzilla Team 4-2. Installing OpenInteract ppd Modules manually on Microsoft Windows 4-3. Removing encrypt() for Windows NT Bugzilla version 2.12 or earlier + + 5-1. Upgrading using CVS + 5-2. Upgrading using the tarball + 5-3. Upgrading using patches _________________________________________________________________ Chapter 1. About This Guide @@ -506,15 +516,20 @@ How to use this License for your documents 1.3. New Versions - This is the 2.16 version of The Bugzilla Guide. It is so named to - match the current version of Bugzilla. If you are reading this from - any source other than those below, please check one of these mirrors - to make sure you are reading an up-to-date version of the Guide. + This is the 2.17.3 version of The Bugzilla Guide. It is so named to + match the current version of Bugzilla. This version of the guide, like + its associated Bugzilla version is a development version. Information + is subject to change between now and when 2.18 is released. If you are + reading this from any source other than those below, please check one + of these mirrors to make sure you are reading an up-to-date version of + the Guide. - This document can be found in the following places: + The newest version of this guide can always be found at bugzilla.org; + including documentation for past releases and the current development + version. - * bugzilla.org - * The Linux Documentation Project + The documentation for the most recent stable release of Bugzilla can + also be found at The Linux Documentation Project. The latest version of this document can always be checked out via CVS. Please follow the instructions available at the Mozilla CVS page, and @@ -1015,7 +1030,7 @@ Chapter 4. Installation The software packages necessary for the proper running of Bugzilla (with download links) are: - 1. MySQL database server (3.23.6 or greater) + 1. MySQL database server (3.23.41 or greater) 2. Perl (5.6, 5.6.1 is recommended if you wish to use Bundle::Bugzilla) 3. Perl Modules (minimum version): @@ -1031,7 +1046,7 @@ Chapter 4. Installation j. CGI (2.88) and, optionally: a. GD (1.20) for bug charting - b. GD::Chart (any) for bug charting + b. GD::Graph (any) for bug charting c. GD::Text::Align (any) for bug charting d. Chart::Base (0.99c) for bug charting e. XML::Parser (any) for the XML interface @@ -2978,32 +2993,142 @@ deny from all 5.9. Upgrading to New Releases - A plain Bugzilla is fairly easy to upgrade from one version to a newer - one. Always read the release notes to see if there are any issues that - you might need to take note of. It is recommended that you take a - backup of your database and your entire Bugzilla installation before - attempting an upgrade. You can upgrade a 'clean' installation by - untarring a new tarball over the old installation. If you are - upgrading from 2.12 or later, and have cvs installed, you can type cvs - -z3 update, and resolve conflicts if there are any. - - However, things get a bit more complicated if you've made changes to - Bugzilla's code. In this case, you may have to re-make or reapply - those changes. One good method is to take a diff of your customized - version against the original, so you can survey all that you've - changed. Hopefully, templatization will reduce the need for this in - the future. - - From version 2.8 onward, Bugzilla databases can be automatically - carried forward during an upgrade. However, because the developers of - Bugzilla are constantly adding new tables, columns and fields, you'll - probably get SQL errors if you just update the code and attempt to use - Bugzilla. Always run the checksetup.pl script whenever you upgrade - your installation. + Upgrading Bugzilla is something we all want to do from time to time, + be it to get new features or pick up the latest security fix. How easy + it is to update depends on a few factors. + + * If the new version is a revision or a new point release + * How many, if any, local changes have been made + + There are also three different methods to upgrade your installation. + + 1. Using CVS (Example 5-1) + 2. Downloading a new tarball (Example 5-2) + 3. Applying the relevant patches (Example 5-3) + + Which options are available to you may depend on how large a jump you + are making and/or your network configuration. + + Revisions are normally released to fix security vulnerabilities and + are distinguished by an increase in the third number. For example, + when 2.16.2 was released, it was a revision to 2.16.1. + + Point releases are normally released when the Bugzilla team feels that + there has been a significant amount of progress made between the last + point release and the current time. These are often proceeded by a + stabilization period and release candidates, however the use of + development versions or release candidates is beyond the scope of this + document. Point releases can be distinguished by an increase in the + second number, or minor version. For example, 2.16.2 is a newer point + release than 2.14.5. + + The examples in this section are written as if you were updating to + version 2.16.2. The procedures are the same regardless if you are + updating to a new point release or a new revision. However, the chance + of running into trouble increases when upgrading to a new point + release, escpecially if you've made local changes. + + These examples also assume that your Bugzilla installation is at + /var/www/html/bugzilla. If that is not the case, simply substitute the + proper paths where appropriate. + + Example 5-1. Upgrading using CVS + + Every release of Bugzilla, whether it is a revision or a point + release, is tagged in CVS. Also, every tarball we have distributed + since version 2.12 has been primed for using CVS. This does, however, + require that you are able to access cvs-mirror.mozilla.org on port + 2401. + + Tip + + If you can do this, updating using CVS is probably the most painless + method, especially if you have a lot of local changes. +bash$ cd /var/www/html/bugzilla +bash$ cvs login +Logging in to :pserver:anonymous@cvs-mirror.mozilla.org:2401/cvsroot +CVS password: anonymous +bash$ cvs -q update -r BUGZILLA-2_16_2 -dP +P checksetup.pl +P collectstats.pl +P globals.pl +P docs/rel_notes.txt +P template/en/default/list/quips.html.tmpl + + Caution + + If a line in the output from cvs update begins with a C that + represents a file with local changes that CVS was unable to properly + merge. You need to resolve these conflicts manually before Bugzilla + (or at least the portion using that file) will be usable. + + Note + + You also need to run ./checksetup.pl before your Bugzilla upgrade will + be complete. + + Example 5-2. Upgrading using the tarball + + If you are unable or unwilling to use CVS, another option that's + always available is to download the latest tarball. This is the most + difficult option to use, especially if you have local changes. +bash$ cd /var/www/html +bash$ wget ftp://ftp.mozilla.org/pub/webtools/bugzilla-2.16.2.tar.gz +Output omitted +bash$ tar xzvf bugzilla-2.16.2.tar.gz +bugzilla-2.16.2/ +bugzilla-2.16.2/.cvsignore +bugzilla-2.16.2/1x1.gif +Output truncated +bash$ cd bugzilla-2.16.2 +bash$ cp ../bugzilla/localconfig* . +bash$ cp -r ../bugzilla/data . +bash$ cd .. +bash$ mv bugzilla bugzilla.old +bash$ mv bugzilla-2.16.2 bugzilla +bash$ cd bugzilla +bash$ ./checksetup.pl +Output omitted + + Warning + + The cp commands both end with periods which is a very important + detail, it tells the shell that the destination directory is the + current working directory. Also, the period at the beginning of the + ./checksetup.pl is important and can not be omitted. + + Note + + You will now have to reapply any changes you have made to your local + installation manually. + + Example 5-3. Upgrading using patches + + The Bugzilla team will normally make a patch file available for + revisions to go from the most recent revision to the new one. You + could also read the release notes and grab the patches attached to the + mentioned bug, but it is safer to use the released patch file as + sometimes patches get changed before they get checked in (for minor + spelling fixes and the like). It is also theorectically possible to + scour the fixed bug list and pick and choose which patches to apply + from a point release, but this is not recommended either as what + you'll end up with is a hodge podge Bugzilla that isn't really any + version. This would also make it more difficult to upgrade in the + future. +bash$ cd /var/www/html/bugzilla +bash$ wget ftp://ftp.mozilla.org/pub/webtools/bugzilla-2.16.1-to-2.16.2.diff.gz +Output omitted +bash$ gunzip bugzilla-2.16.1-to-2.16.2.diff.gz +bash$ patch -p1 < bugzilla-2.16.1-to-2.16.2.diff +patching file checksetup.pl +patching file collectstats.pl +patching file globals.pl + + Caution - If you are running Bugzilla version 2.8 or lower, and wish to upgrade - to the latest version, please consult the file, "UPGRADING-pre-2.8" in - the Bugzilla root directory after untarring the archive. + If you do this, beware that this doesn't change the entires in your + CVS directory so it may make updates using CVS (Example 5-1) more + difficult in the future. _________________________________________________________________ 5.10. Integrating Bugzilla with Third-Party Tools |