summaryrefslogtreecommitdiffstats
path: root/docs/html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/html')
-rw-r--r--docs/html/Bugzilla-Guide.html917
-rw-r--r--docs/html/administration.html8
-rw-r--r--docs/html/cust-templates.html8
-rw-r--r--docs/html/dbdoc.html4
-rw-r--r--docs/html/extraconfig.html6
-rw-r--r--docs/html/faq.html125
-rw-r--r--docs/html/gfdl-howto.html2
-rw-r--r--docs/html/gfdl.html2
-rw-r--r--docs/html/glossary.html116
-rw-r--r--docs/html/index.html24
-rw-r--r--docs/html/installation.html28
-rw-r--r--docs/html/os-specific.html247
-rw-r--r--docs/html/stepbystep.html269
-rw-r--r--docs/html/troubleshooting.html114
14 files changed, 991 insertions, 879 deletions
diff --git a/docs/html/Bugzilla-Guide.html b/docs/html/Bugzilla-Guide.html
index 4c91b1051..694648c26 100644
--- a/docs/html/Bugzilla-Guide.html
+++ b/docs/html/Bugzilla-Guide.html
@@ -61,7 +61,7 @@ CLASS="corpauthor"
>The Bugzilla Team</H3
><P
CLASS="pubdate"
->2003-02-16<BR></P
+>2003-04-23<BR></P
><DIV
><DIV
CLASS="abstract"
@@ -80,7 +80,7 @@ NAME="AEN14"
><P
>
This documentation is maintained in DocBook 4.1.2 XML format.
- Changes are best submitted as plain text or SGML diffs, attached
+ Changes are best submitted as plain text or XML diffs, attached
to a bug filed in the <A
HREF="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation"
TARGET="_top"
@@ -444,6 +444,26 @@ CLASS="LOT"
CLASS="LOT"
><DT
><B
+>List of Figures</B
+></DT
+><DT
+>4-1. <A
+HREF="#trouble-filetemp-errors"
+>Other File::Temp error messages</A
+></DT
+><DT
+>4-2. <A
+HREF="#trouble-filetemp-patch"
+>Patch for File::Temp in Perl 5.6.0</A
+></DT
+></DL
+></DIV
+><DIV
+CLASS="LOT"
+><DL
+CLASS="LOT"
+><DT
+><B
>List of Examples</B
></DT
><DT
@@ -2347,7 +2367,7 @@ TARGET="_top"
>Date::Parse
</A
>
- (any)
+ (2.21)
</P
></LI
><LI
@@ -2465,124 +2485,6 @@ VALIGN="TOP"
></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
->Linux-Mandrake 8.0 includes every
- required and optional library for Bugzilla. The easiest way to
- install them is by using the
- <TT
-CLASS="filename"
->urpmi</TT
->
-
- utility. If you follow these commands, you should have everything you
- need for Bugzilla, and
- <TT
-CLASS="filename"
->checksetup.pl</TT
->
-
- should not complain about any missing libraries. You may already have
- some of these installed.</P
-><P
-></P
-><TABLE
-BORDER="0"
-><TBODY
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-mysql</B
->
- </TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-chart</B
->
- </TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-gd</B
->
- </TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-MailTools</B
->
-
- (for Bugzilla email integration)</TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi apache-modules</B
->
- </TD
-></TR
-></TBODY
-></TABLE
-><P
-></P
-></TD
-></TR
-></TABLE
-></DIV
->
</P
></DIV
><DIV
@@ -2945,7 +2847,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN586"
+NAME="AEN566"
></A
>4.1.5.1. DBI</H3
><P
@@ -2960,7 +2862,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN589"
+NAME="AEN569"
></A
>4.1.5.2. Data::Dumper</H3
><P
@@ -2974,7 +2876,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN592"
+NAME="AEN572"
></A
>4.1.5.3. MySQL-related modules</H3
><P
@@ -3000,7 +2902,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN597"
+NAME="AEN577"
></A
>4.1.5.4. TimeDate modules</H3
><P
@@ -3016,7 +2918,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN600"
+NAME="AEN580"
></A
>4.1.5.5. GD (optional)</H3
><P
@@ -3071,7 +2973,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN607"
+NAME="AEN587"
></A
>4.1.5.6. Chart::Base (optional)</H3
><P
@@ -3086,7 +2988,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN610"
+NAME="AEN590"
></A
>4.1.5.7. Template Toolkit</H3
><P
@@ -3155,7 +3057,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN620"
+NAME="AEN600"
></A
>4.1.7. Bugzilla</H2
><P
@@ -3220,112 +3122,13 @@ CLASS="filename"
>checksetup.pl</TT
>
script, which locks down your installation.</P
-><P
->Lastly, you'll need to set up a symbolic link to
- <TT
-CLASS="filename"
->/usr/bonsaitools/bin/perl</TT
->
- for the correct location of your Perl executable (probably
- <TT
-CLASS="filename"
->/usr/bin/perl</TT
->).
- Otherwise you must hack all the .cgi files to change where they look
- for Perl. This can be done using the following Perl one-liner, but
- I suggest using the symlink approach to avoid upgrade hassles.
- </P
-><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
-><SPAN
-CLASS="QUOTE"
->"Bonsaitools"</SPAN
-> is the name Terry Weissman, the
- original author of Bugzilla, created
- for his suite of webtools at the time he created Bugzilla and several
- other tools in use at mozilla.org. He created a directory,
- <TT
-CLASS="filename"
->/usr/bonsaitools</TT
-> to house his specific versions
- of perl and other utilities. This usage is still current at
- <A
-HREF="http://bugzilla.mozilla.org/"
-TARGET="_top"
->bugzilla.mozilla.org</A
->,
- but in general most other places do not use it. You can either edit
- the paths at the start of each perl file to the correct location of
- perl on your system, or simply bow to history and create a
- <TT
-CLASS="filename"
->/usr/bonsaitools</TT
-> and <TT
-CLASS="filename"
->/usr/bonsaitools/bin
- </TT
-> directory, placing a symlink to perl on your system
- inside <TT
-CLASS="filename"
->/usr/bonsaitools/bin</TT
->
- </P
-></TD
-></TR
-></TABLE
-></DIV
-><P
->
- <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><FONT
-COLOR="#000000"
-><PRE
-CLASS="programlisting"
->&#13;perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb
- </PRE
-></FONT
-></TD
-></TR
-></TABLE
->
-
- Change <TT
-CLASS="filename"
->/usr/bin/perl</TT
-> to match the location
- of Perl on your machine.
- </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN645"
+NAME="AEN611"
></A
>4.1.8. Setting Up the MySQL Database</H2
><P
@@ -3492,13 +3295,41 @@ CLASS="command"
></P
>
</P
+><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
+>If you are using MySQL 4, the bugs user also needs to be granted
+ the LOCK TABLES and CREATE TEMPORARY TABLES permissions.
+ </P
+></TD
+></TR
+></TABLE
+></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN681"
+NAME="AEN649"
></A
>4.1.9. <TT
CLASS="filename"
@@ -3651,7 +3482,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN713"
+NAME="AEN681"
></A
>4.1.10. Configuring Bugzilla</H2
><P
@@ -3677,7 +3508,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN719"
+NAME="AEN687"
></A
>4.2.1. Dependency Charts</H2
><P
@@ -3741,7 +3572,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN734"
+NAME="AEN702"
></A
>4.2.2. Bug Graphs</H2
><P
@@ -3800,7 +3631,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN747"
+NAME="AEN715"
></A
>4.2.3. The Whining Cron</H2
><P
@@ -4513,150 +4344,6 @@ CLASS="programlisting"
></TR
></TABLE
></DIV
-><DIV
-CLASS="section"
-><HR><H4
-CLASS="section"
-><A
-NAME="AEN863"
-></A
->4.3.1.3.2. System Calls</H4
-><P
->In order to get system calls to work on win32's perl, you need
- to tell the windows shell what interpreter to use. This is done by
- changing the <TT
-CLASS="function"
->system</TT
-> calls. You will need to
- search all of Bugzilla's code for <TT
-CLASS="function"
->system</TT
-> calls.
- To tell perl your interpreter, it needs to be the first argument to
- the <TT
-CLASS="function"
->system</TT
-> call. For example, you'll need to
- change:
- </P
-><TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><FONT
-COLOR="#000000"
-><PRE
-CLASS="programlisting"
->&#13;system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
- </PRE
-></FONT
-></TD
-></TR
-></TABLE
-><P
->with</P
-><TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><FONT
-COLOR="#000000"
-><PRE
-CLASS="programlisting"
->&#13;system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
- </PRE
-></FONT
-></TD
-></TR
-></TABLE
-><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
->The <B
-CLASS="command"
->grep</B
-> command is very helpful in finding
- these <TT
-CLASS="function"
->system</TT
-> calls, assuming you have the
- <SPAN
-CLASS="productname"
->cygwin</SPAN
-> utilities.
- </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
->It appears that the only <TT
-CLASS="function"
->system</TT
-> call
- remaining in the Bugzilla codebase is in
- <TT
-CLASS="filename"
->showdependencygraph.cgi</TT
->. Not changing this
- file will only cause dependency graphs to not function if the
- <TT
-CLASS="option"
->webdotbase</TT
-> paramater points to a local
- installation of <A
-HREF="http://www.graphviz.org"
-TARGET="_top"
->GraphViz</A
->.
- </P
-></TD
-></TR
-></TABLE
-></DIV
-></DIV
></DIV
><DIV
CLASS="section"
@@ -4710,7 +4397,7 @@ TARGET="_top"
to modify the first line of every script to contain your path to
perl instead of <TT
CLASS="filename"
->/usr/bonsaitools/bin/perl</TT
+>/usr/bin/perl</TT
>.
</P
></TD
@@ -4783,7 +4470,7 @@ CLASS="command"
This should go through the motions of downloading the latest version of
the GD module, then it will open a shell and drop you into the build
directory. Apply <A
-HREF="../sgml/gd-makefile.patch"
+HREF="../xml/gd-makefile.patch"
TARGET="_top"
>this patch</A
>
@@ -4851,6 +4538,105 @@ CLASS="command"
>
</P
></DIV
+><DIV
+CLASS="section"
+><HR><H2
+CLASS="section"
+><A
+NAME="os-mandrake"
+></A
+>4.3.3. Linux-Mandrake 8.0</H2
+><P
+>Linux-Mandrake 8.0 includes every required and optional library
+ for Bugzilla. The easiest way to install them is by using the
+ <B
+CLASS="command"
+>urpmi</B
+> utility. If you follow these commands, you
+ should have everything you need for Bugzilla, and
+ <B
+CLASS="command"
+>./checksetup.pl</B
+> should not complain about any
+ missing libraries. You may already have some of these installed.
+ </P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="screen"
+>&#13;<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-mysql</B
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-chart</B
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-gd</B
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-MailTools</B
+> <A
+NAME="test-mailtools"
+><IMG
+SRC="../images/callouts/1.gif"
+HSPACE="0"
+VSPACE="0"
+BORDER="0"
+ALT="(1)"></A
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi apache-modules</B
+>
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
+><DIV
+CLASS="calloutlist"
+><DL
+COMPACT="COMPACT"
+><DT
+><A
+HREF="#test-mailtools"
+><IMG
+SRC="../images/callouts/1.gif"
+HSPACE="0"
+VSPACE="0"
+BORDER="0"
+ALT="(1)"></A
+></DT
+><DD
+>for Bugzilla e-mail integration</DD
+></DL
+></DIV
+></DIV
></DIV
><DIV
CLASS="section"
@@ -5433,7 +5219,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN1009"
+NAME="AEN977"
></A
>4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2
><P
@@ -5458,7 +5244,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN1014"
+NAME="AEN982"
></A
>4.5.2. DBD::Sponge::db prepare failed</H2
><P
@@ -5597,6 +5383,116 @@ CLASS="filename"
as root to fix this problem.
</P
></DIV
+><DIV
+CLASS="section"
+><HR><H2
+CLASS="section"
+><A
+NAME="trouble-filetemp"
+></A
+>4.5.4. Your vendor has not defined Fcntl macro O_NOINHERIT</H2
+><P
+>This is caused by a bug in the version of
+ <SPAN
+CLASS="productname"
+>File::Temp</SPAN
+> that is distributed with perl
+ 5.6.0. Many minor variations of this error have been reported. Examples
+ can be found in <A
+HREF="#trouble-filetemp-errors"
+>Figure 4-1</A
+>.
+ </P
+><DIV
+CLASS="figure"
+><A
+NAME="trouble-filetemp-errors"
+></A
+><P
+><B
+>Figure 4-1. Other File::Temp error messages</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="programlisting"
+>&#13;Your vendor has not defined Fcntl macro O_NOINHERIT, used
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 208.
+
+Your vendor has not defined Fcntl macro O_EXLOCK, used
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 210.
+
+Your vendor has not defined Fcntl macro O_TEMPORARY, used
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Numerous people have reported that upgrading to version 5.6.1
+ or higher solved the problem for them. A less involved fix is to apply
+ the patch in <A
+HREF="#trouble-filetemp-patch"
+>Figure 4-2</A
+>. The patch is also
+ available as a <A
+HREF="../xml/filetemp.patch"
+TARGET="_top"
+>patch file</A
+>.
+ </P
+><DIV
+CLASS="figure"
+><A
+NAME="trouble-filetemp-patch"
+></A
+><P
+><B
+>Figure 4-2. Patch for File::Temp in Perl 5.6.0</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="programlisting"
+>&#13;--- File/Temp.pm.orig Thu Feb 6 16:26:00 2003
++++ File/Temp.pm Thu Feb 6 16:26:23 2003
+@@ -205,6 +205,7 @@
+ # eg CGI::Carp
+ local $SIG{__DIE__} = sub {};
+ local $SIG{__WARN__} = sub {};
++ local *CORE::GLOBAL::die = sub {};
+ $bit = &#38;$func();
+ 1;
+ };
+@@ -226,6 +227,7 @@
+ # eg CGI::Carp
+ local $SIG{__DIE__} = sub {};
+ local $SIG{__WARN__} = sub {};
++ local *CORE::GLOBAL::die = sub {};
+ $bit = &#38;$func();
+ 1;
+ };
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
+></DIV
+></DIV
></DIV
></DIV
><DIV
@@ -7435,7 +7331,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN1443"
+NAME="AEN1425"
></A
>5.7.1. What to Edit</H2
><P
@@ -7550,7 +7446,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN1462"
+NAME="AEN1444"
></A
>5.7.2. How To Edit Templates</H2
><P
@@ -7632,7 +7528,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN1472"
+NAME="AEN1454"
></A
>5.7.3. Template Formats</H2
><P
@@ -7694,7 +7590,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN1485"
+NAME="AEN1467"
></A
>5.7.4. Particular Templates</H2
><P
@@ -8747,12 +8643,24 @@ HREF="#faq-general-mysql"
><DT
>A.1.9. <A
HREF="#faq-general-bonsaitools"
->&#13; Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
- "/usr/bin/perl" or something else?
+>&#13; What is <TT
+CLASS="filename"
+>/usr/bonsaitools/bin/perl</TT
+>?
</A
></DT
><DT
>A.1.10. <A
+HREF="#faq-general-perlpath"
+>&#13; My perl is not located at <TT
+CLASS="filename"
+>/usr/bin/perl</TT
+>, is
+ there an easy way to change it everywhere it needs to be changed?
+ </A
+></DT
+><DT
+>A.1.11. <A
HREF="#faq-general-cookie"
>&#13; Is there an easy way to change the Bugzilla cookie name?
</A
@@ -9534,8 +9442,10 @@ NAME="faq-general-bonsaitools"
><B
>A.1.9. </B
>
- Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
- "/usr/bin/perl" or something else?
+ What is <TT
+CLASS="filename"
+>/usr/bonsaitools/bin/perl</TT
+>?
</P
></DIV
><DIV
@@ -9544,16 +9454,72 @@ CLASS="answer"
><B
> </B
>
- Mozilla.org uses /usr/bonsaitools/bin/perl, because originally
- Terry wanted a place to put a version of Perl and other tools
- that was strictly under his control.
- </P
+ Bugzilla used to have the path to perl on the shebang line set to
+ <TT
+CLASS="filename"
+>/usr/bonsaitools/bin/perl</TT
+> because when
+ Terry first started writing the code for mozilla.org he needed a
+ version of Perl and other tools that were completely under his
+ control. This location was abandoned for the 2.18 release in favor
+ of the more sensible <TT
+CLASS="filename"
+>/usr/bin/perl</TT
+>. If you
+ installed an older verion of Bugzilla and created the symlink we
+ suggested, you can remove it now (provided that you don't have
+ anything else, such as Bonsai, using it and you don't intend to
+ reinstall an older version of Bugzilla).
+ </P
+></DIV
+></DIV
+><DIV
+CLASS="qandaentry"
+><DIV
+CLASS="question"
><P
->&#13; We always recommend that, if possible, you keep the path
- as /usr/bonsaitools/bin/perl, and simply add symlink.
- This will make upgrading
- your Bugzilla much easier in the future.
- </P
+><A
+NAME="faq-general-perlpath"
+></A
+><B
+>A.1.10. </B
+>
+ My perl is not located at <TT
+CLASS="filename"
+>/usr/bin/perl</TT
+>, is
+ there an easy way to change it everywhere it needs to be changed?
+ </P
+></DIV
+><DIV
+CLASS="answer"
+><P
+><B
+> </B
+>
+ Yes, the following bit of perl magic will change all the shebang
+ lines. Be sure to change <TT
+CLASS="filename"
+>/usr/local/bin/perl</TT
+>
+ to your path to the perl binary.
+ </P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="programlisting"
+>&#13;perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
></DIV
></DIV
><DIV
@@ -9565,7 +9531,7 @@ CLASS="question"
NAME="faq-general-cookie"
></A
><B
->A.1.10. </B
+>A.1.11. </B
>
Is there an easy way to change the Bugzilla cookie name?
</P
@@ -9979,12 +9945,12 @@ CLASS="computeroutput"
CLASS="filename"
>importxml.pl</TT
> which is intended to be
- used for importing the data generated by <TT
+ used for importing the data generated by the XML ctype of
+ <TT
CLASS="filename"
->xml.cgi</TT
->
- in association with bug moving. Any other use is left as an
- exercise for the user.
+>show_bug.cgi</TT
+> in association with bug moving.
+ Any other use is left as an exercise for the user.
</P
><P
>&#13; There are also scripts included in the <TT
@@ -10020,9 +9986,9 @@ CLASS="answer"
>
Yes. For more information including available translated templates,
see <A
-HREF="http://www.bugzilla.org/download.html"
+HREF="http://www.bugzilla.org/download.html#localizations"
TARGET="_top"
->http://www.bugzilla.org/download.html</A
+>http://www.bugzilla.org/download.html#localizations</A
>.
The admin interfaces are still not included in these translated
templates and is therefore still English only. Also, there may be
@@ -10442,13 +10408,14 @@ CLASS="answer"
> </B
>
Try Klaas Freitag's excellent patch for "whineatassigned" functionality.
- You can find it at<A
-HREF=" http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
+ You can find it at <A
+HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
TARGET="_top"
->&#13; http://bugzilla.mozilla.org/show_bug.cgi?id=6679</A
+>http://bugzilla.mozilla.org/show_bug.cgi?id=6679</A
>. This
patch is against an older version of Bugzilla, so you must apply
the diffs manually.
+
</P
></DIV
></DIV
@@ -10476,7 +10443,7 @@ CLASS="answer"
You can call bug_email.pl directly from your aliases file, with
an entry like this:
<A
-NAME="AEN1894"
+NAME="AEN1886"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -10920,7 +10887,7 @@ CLASS="answer"
><P
>&#13; Microsoft has some advice on this matter, as well:
<A
-NAME="AEN1977"
+NAME="AEN1969"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -11279,7 +11246,7 @@ TARGET="_top"
This list includes bugs for the 2.18 release that have already
been fixed and checked into CVS. Please consult the
<A
-HREF="http://www.mozilla.org/projects/bugzilla/"
+HREF="http://www.bugzilla.org/"
TARGET="_top"
>&#13; Bugzilla Project Page</A
> for details on how to
@@ -11550,7 +11517,7 @@ CLASS="section"
><HR><H2
CLASS="section"
><A
-NAME="AEN2099"
+NAME="AEN2091"
></A
>B.2.1. Bugzilla Database Basics</H2
><P
@@ -11666,7 +11633,7 @@ CLASS="section"
><HR><H3
CLASS="section"
><A
-NAME="AEN2126"
+NAME="AEN2118"
></A
>B.2.1.1. Bugzilla Database Tables</H3
><P
@@ -12234,7 +12201,7 @@ NAME="gfdl"
><P
>Version 1.1, March 2000</P
><A
-NAME="AEN2214"
+NAME="AEN2206"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -12699,7 +12666,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="AEN2304"
+NAME="AEN2296"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -12736,7 +12703,7 @@ CLASS="glossdiv"
><H1
CLASS="glossdiv"
><A
-NAME="AEN2309"
+NAME="AEN2301"
></A
>0-9, high ascii</H1
><DL
@@ -12978,7 +12945,7 @@ CLASS="glossdiv"
><A
NAME="gloss-c"
></A
-></H1
+>C</H1
><DL
><DT
><A
@@ -13207,22 +13174,52 @@ TARGET="_top"
</P
><P
></P
-><UL
-><LI
+><DIV
+CLASS="variablelist"
+><DL
+><DT
+><A
+HREF="http://www.mysql.com/doc/en/Backup.html"
+TARGET="_top"
+>Backup</A
+></DT
+><DD
><P
+>Methods for backing up your Bugzilla database.
+ </P
+></DD
+><DT
><A
-HREF="http://www.mysql.com/doc/P/r/Privilege_system.html"
+HREF="http://www.mysql.com/doc/en/Option_files.html"
TARGET="_top"
->MySQL
- Privilege System</A
-> - Much more detailed information about
- the suggestions in <A
+>Option Files</A
+></DT
+><DD
+><P
+>Information about how to configure MySQL using
+ <TT
+CLASS="filename"
+>my.cnf</TT
+>.
+ </P
+></DD
+><DT
+><A
+HREF="http://www.mysql.com/doc/en/Privilege_system.html"
+TARGET="_top"
+>Privilege System</A
+></DT
+><DD
+><P
+>Much more detailed information about the suggestions in
+ <A
HREF="#security-mysql"
>Section 5.6.2</A
>.
- </P
-></LI
-></UL
+ </P
+></DD
+></DL
+></DIV
></DD
></DL
></DIV
@@ -13473,16 +13470,70 @@ NAME="gloss-z"
><DL
><DT
><A
-NAME="zarro-boogs-found"
+NAME="gloss-zarro"
></A
><B
>Zarro Boogs Found</B
></DT
><DD
><P
->This is the cryptic response sent by Bugzilla when a query
- returned no results. It is just a goofy way of saying "Zero Bugs
- Found".</P
+>This is just a goofy way of saying that there were no bugs
+ found matching your query. When asked to explain this message,
+ Terry had the following to say:
+ </P
+><A
+NAME="AEN2515"
+></A
+><TABLE
+BORDER="0"
+WIDTH="100%"
+CELLSPACING="0"
+CELLPADDING="0"
+CLASS="BLOCKQUOTE"
+><TR
+><TD
+WIDTH="10%"
+VALIGN="TOP"
+>&nbsp;</TD
+><TD
+WIDTH="80%"
+VALIGN="TOP"
+><P
+>I've been asked to explain this ... way back when, when
+ Netscape released version 4.0 of its browser, we had a release
+ party. Naturally, there had been a big push to try and fix every
+ known bug before the release. Naturally, that hadn't actually
+ happened. (This is not unique to Netscape or to 4.0; the same thing
+ has happened with every software project I've ever seen.) Anyway,
+ at the release party, T-shirts were handed out that said something
+ like "Netscape 4.0: Zarro Boogs". Just like the software, the
+ T-shirt had no known bugs. Uh-huh.
+ </P
+><P
+>So, when you query for a list of bugs, and it gets no results,
+ you can think of this as a friendly reminder. Of *course* there are
+ bugs matching your query, they just aren't in the bugsystem yet...
+ </P
+></TD
+><TD
+WIDTH="10%"
+VALIGN="TOP"
+>&nbsp;</TD
+></TR
+><TR
+><TD
+COLSPAN="2"
+ALIGN="RIGHT"
+VALIGN="TOP"
+>--<SPAN
+CLASS="attribution"
+>Terry Weissman</SPAN
+></TD
+><TD
+WIDTH="10%"
+>&nbsp;</TD
+></TR
+></TABLE
></DD
></DL
></DIV
diff --git a/docs/html/administration.html b/docs/html/administration.html
index c505edaeb..f8a111328 100644
--- a/docs/html/administration.html
+++ b/docs/html/administration.html
@@ -180,22 +180,22 @@ HREF="cust-templates.html"
><DL
><DT
>5.7.1. <A
-HREF="cust-templates.html#AEN1443"
+HREF="cust-templates.html#AEN1425"
>What to Edit</A
></DT
><DT
>5.7.2. <A
-HREF="cust-templates.html#AEN1462"
+HREF="cust-templates.html#AEN1444"
>How To Edit Templates</A
></DT
><DT
>5.7.3. <A
-HREF="cust-templates.html#AEN1472"
+HREF="cust-templates.html#AEN1454"
>Template Formats</A
></DT
><DT
>5.7.4. <A
-HREF="cust-templates.html#AEN1485"
+HREF="cust-templates.html#AEN1467"
>Particular Templates</A
></DT
></DL
diff --git a/docs/html/cust-templates.html b/docs/html/cust-templates.html
index a7e333030..e34e1815a 100644
--- a/docs/html/cust-templates.html
+++ b/docs/html/cust-templates.html
@@ -99,7 +99,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN1443"
+NAME="AEN1425"
></A
>5.7.1. What to Edit</H2
><P
@@ -214,7 +214,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN1462"
+NAME="AEN1444"
></A
>5.7.2. How To Edit Templates</H2
><P
@@ -296,7 +296,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN1472"
+NAME="AEN1454"
></A
>5.7.3. Template Formats</H2
><P
@@ -358,7 +358,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN1485"
+NAME="AEN1467"
></A
>5.7.4. Particular Templates</H2
><P
diff --git a/docs/html/dbdoc.html b/docs/html/dbdoc.html
index 830bb0ee2..8e0109d0d 100644
--- a/docs/html/dbdoc.html
+++ b/docs/html/dbdoc.html
@@ -135,7 +135,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN2099"
+NAME="AEN2091"
></A
>B.2.1. Bugzilla Database Basics</H2
><P
@@ -251,7 +251,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN2126"
+NAME="AEN2118"
></A
>B.2.1.1. Bugzilla Database Tables</H3
><P
diff --git a/docs/html/extraconfig.html b/docs/html/extraconfig.html
index 6699ba2cd..0bd60486a 100644
--- a/docs/html/extraconfig.html
+++ b/docs/html/extraconfig.html
@@ -81,7 +81,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN719"
+NAME="AEN687"
></A
>4.2.1. Dependency Charts</H2
><P
@@ -145,7 +145,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN734"
+NAME="AEN702"
></A
>4.2.2. Bug Graphs</H2
><P
@@ -204,7 +204,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN747"
+NAME="AEN715"
></A
>4.2.3. The Whining Cron</H2
><P
diff --git a/docs/html/faq.html b/docs/html/faq.html
index 606519724..a45b7b7e3 100644
--- a/docs/html/faq.html
+++ b/docs/html/faq.html
@@ -138,12 +138,24 @@ HREF="faq.html#faq-general-mysql"
><DT
>A.1.9. <A
HREF="faq.html#faq-general-bonsaitools"
->&#13; Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
- "/usr/bin/perl" or something else?
+>&#13; What is <TT
+CLASS="filename"
+>/usr/bonsaitools/bin/perl</TT
+>?
</A
></DT
><DT
>A.1.10. <A
+HREF="faq.html#faq-general-perlpath"
+>&#13; My perl is not located at <TT
+CLASS="filename"
+>/usr/bin/perl</TT
+>, is
+ there an easy way to change it everywhere it needs to be changed?
+ </A
+></DT
+><DT
+>A.1.11. <A
HREF="faq.html#faq-general-cookie"
>&#13; Is there an easy way to change the Bugzilla cookie name?
</A
@@ -925,8 +937,10 @@ NAME="faq-general-bonsaitools"
><B
>A.1.9. </B
>
- Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
- "/usr/bin/perl" or something else?
+ What is <TT
+CLASS="filename"
+>/usr/bonsaitools/bin/perl</TT
+>?
</P
></DIV
><DIV
@@ -935,16 +949,72 @@ CLASS="answer"
><B
> </B
>
- Mozilla.org uses /usr/bonsaitools/bin/perl, because originally
- Terry wanted a place to put a version of Perl and other tools
- that was strictly under his control.
- </P
+ Bugzilla used to have the path to perl on the shebang line set to
+ <TT
+CLASS="filename"
+>/usr/bonsaitools/bin/perl</TT
+> because when
+ Terry first started writing the code for mozilla.org he needed a
+ version of Perl and other tools that were completely under his
+ control. This location was abandoned for the 2.18 release in favor
+ of the more sensible <TT
+CLASS="filename"
+>/usr/bin/perl</TT
+>. If you
+ installed an older verion of Bugzilla and created the symlink we
+ suggested, you can remove it now (provided that you don't have
+ anything else, such as Bonsai, using it and you don't intend to
+ reinstall an older version of Bugzilla).
+ </P
+></DIV
+></DIV
+><DIV
+CLASS="qandaentry"
+><DIV
+CLASS="question"
><P
->&#13; We always recommend that, if possible, you keep the path
- as /usr/bonsaitools/bin/perl, and simply add symlink.
- This will make upgrading
- your Bugzilla much easier in the future.
- </P
+><A
+NAME="faq-general-perlpath"
+></A
+><B
+>A.1.10. </B
+>
+ My perl is not located at <TT
+CLASS="filename"
+>/usr/bin/perl</TT
+>, is
+ there an easy way to change it everywhere it needs to be changed?
+ </P
+></DIV
+><DIV
+CLASS="answer"
+><P
+><B
+> </B
+>
+ Yes, the following bit of perl magic will change all the shebang
+ lines. Be sure to change <TT
+CLASS="filename"
+>/usr/local/bin/perl</TT
+>
+ to your path to the perl binary.
+ </P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="programlisting"
+>&#13;perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
></DIV
></DIV
><DIV
@@ -956,7 +1026,7 @@ CLASS="question"
NAME="faq-general-cookie"
></A
><B
->A.1.10. </B
+>A.1.11. </B
>
Is there an easy way to change the Bugzilla cookie name?
</P
@@ -1370,12 +1440,12 @@ CLASS="computeroutput"
CLASS="filename"
>importxml.pl</TT
> which is intended to be
- used for importing the data generated by <TT
+ used for importing the data generated by the XML ctype of
+ <TT
CLASS="filename"
->xml.cgi</TT
->
- in association with bug moving. Any other use is left as an
- exercise for the user.
+>show_bug.cgi</TT
+> in association with bug moving.
+ Any other use is left as an exercise for the user.
</P
><P
>&#13; There are also scripts included in the <TT
@@ -1411,9 +1481,9 @@ CLASS="answer"
>
Yes. For more information including available translated templates,
see <A
-HREF="http://www.bugzilla.org/download.html"
+HREF="http://www.bugzilla.org/download.html#localizations"
TARGET="_top"
->http://www.bugzilla.org/download.html</A
+>http://www.bugzilla.org/download.html#localizations</A
>.
The admin interfaces are still not included in these translated
templates and is therefore still English only. Also, there may be
@@ -1833,13 +1903,14 @@ CLASS="answer"
> </B
>
Try Klaas Freitag's excellent patch for "whineatassigned" functionality.
- You can find it at<A
-HREF=" http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
+ You can find it at <A
+HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=6679"
TARGET="_top"
->&#13; http://bugzilla.mozilla.org/show_bug.cgi?id=6679</A
+>http://bugzilla.mozilla.org/show_bug.cgi?id=6679</A
>. This
patch is against an older version of Bugzilla, so you must apply
the diffs manually.
+
</P
></DIV
></DIV
@@ -1867,7 +1938,7 @@ CLASS="answer"
You can call bug_email.pl directly from your aliases file, with
an entry like this:
<A
-NAME="AEN1894"
+NAME="AEN1886"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -2311,7 +2382,7 @@ CLASS="answer"
><P
>&#13; Microsoft has some advice on this matter, as well:
<A
-NAME="AEN1977"
+NAME="AEN1969"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -2670,7 +2741,7 @@ TARGET="_top"
This list includes bugs for the 2.18 release that have already
been fixed and checked into CVS. Please consult the
<A
-HREF="http://www.mozilla.org/projects/bugzilla/"
+HREF="http://www.bugzilla.org/"
TARGET="_top"
>&#13; Bugzilla Project Page</A
> for details on how to
diff --git a/docs/html/gfdl-howto.html b/docs/html/gfdl-howto.html
index 931236fc5..5ba320953 100644
--- a/docs/html/gfdl-howto.html
+++ b/docs/html/gfdl-howto.html
@@ -81,7 +81,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="AEN2304"
+NAME="AEN2296"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
diff --git a/docs/html/gfdl.html b/docs/html/gfdl.html
index e998ee966..367e5c33a 100644
--- a/docs/html/gfdl.html
+++ b/docs/html/gfdl.html
@@ -144,7 +144,7 @@ HREF="gfdl-howto.html"
><P
>Version 1.1, March 2000</P
><A
-NAME="AEN2214"
+NAME="AEN2206"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
diff --git a/docs/html/glossary.html b/docs/html/glossary.html
index 44e264d45..3894e8a9b 100644
--- a/docs/html/glossary.html
+++ b/docs/html/glossary.html
@@ -70,7 +70,7 @@ CLASS="glossdiv"
><H1
CLASS="glossdiv"
><A
-NAME="AEN2309"
+NAME="AEN2301"
></A
>0-9, high ascii</H1
><DL
@@ -312,7 +312,7 @@ CLASS="glossdiv"
><A
NAME="gloss-c"
></A
-></H1
+>C</H1
><DL
><DT
><A
@@ -541,22 +541,52 @@ TARGET="_top"
</P
><P
></P
-><UL
-><LI
+><DIV
+CLASS="variablelist"
+><DL
+><DT
+><A
+HREF="http://www.mysql.com/doc/en/Backup.html"
+TARGET="_top"
+>Backup</A
+></DT
+><DD
><P
+>Methods for backing up your Bugzilla database.
+ </P
+></DD
+><DT
><A
-HREF="http://www.mysql.com/doc/P/r/Privilege_system.html"
+HREF="http://www.mysql.com/doc/en/Option_files.html"
TARGET="_top"
->MySQL
- Privilege System</A
-> - Much more detailed information about
- the suggestions in <A
+>Option Files</A
+></DT
+><DD
+><P
+>Information about how to configure MySQL using
+ <TT
+CLASS="filename"
+>my.cnf</TT
+>.
+ </P
+></DD
+><DT
+><A
+HREF="http://www.mysql.com/doc/en/Privilege_system.html"
+TARGET="_top"
+>Privilege System</A
+></DT
+><DD
+><P
+>Much more detailed information about the suggestions in
+ <A
HREF="security.html#security-mysql"
>Section 5.6.2</A
>.
- </P
-></LI
-></UL
+ </P
+></DD
+></DL
+></DIV
></DD
></DL
></DIV
@@ -807,16 +837,70 @@ NAME="gloss-z"
><DL
><DT
><A
-NAME="zarro-boogs-found"
+NAME="gloss-zarro"
></A
><B
>Zarro Boogs Found</B
></DT
><DD
><P
->This is the cryptic response sent by Bugzilla when a query
- returned no results. It is just a goofy way of saying "Zero Bugs
- Found".</P
+>This is just a goofy way of saying that there were no bugs
+ found matching your query. When asked to explain this message,
+ Terry had the following to say:
+ </P
+><A
+NAME="AEN2515"
+></A
+><TABLE
+BORDER="0"
+WIDTH="100%"
+CELLSPACING="0"
+CELLPADDING="0"
+CLASS="BLOCKQUOTE"
+><TR
+><TD
+WIDTH="10%"
+VALIGN="TOP"
+>&nbsp;</TD
+><TD
+WIDTH="80%"
+VALIGN="TOP"
+><P
+>I've been asked to explain this ... way back when, when
+ Netscape released version 4.0 of its browser, we had a release
+ party. Naturally, there had been a big push to try and fix every
+ known bug before the release. Naturally, that hadn't actually
+ happened. (This is not unique to Netscape or to 4.0; the same thing
+ has happened with every software project I've ever seen.) Anyway,
+ at the release party, T-shirts were handed out that said something
+ like "Netscape 4.0: Zarro Boogs". Just like the software, the
+ T-shirt had no known bugs. Uh-huh.
+ </P
+><P
+>So, when you query for a list of bugs, and it gets no results,
+ you can think of this as a friendly reminder. Of *course* there are
+ bugs matching your query, they just aren't in the bugsystem yet...
+ </P
+></TD
+><TD
+WIDTH="10%"
+VALIGN="TOP"
+>&nbsp;</TD
+></TR
+><TR
+><TD
+COLSPAN="2"
+ALIGN="RIGHT"
+VALIGN="TOP"
+>--<SPAN
+CLASS="attribution"
+>Terry Weissman</SPAN
+></TD
+><TD
+WIDTH="10%"
+>&nbsp;</TD
+></TR
+></TABLE
></DD
></DL
></DIV
diff --git a/docs/html/index.html b/docs/html/index.html
index 66f407108..3cabc43e5 100644
--- a/docs/html/index.html
+++ b/docs/html/index.html
@@ -64,7 +64,7 @@ CLASS="corpauthor"
>The Bugzilla Team</H3
><P
CLASS="pubdate"
->2003-02-16<BR></P
+>2003-04-23<BR></P
><DIV
><DIV
CLASS="abstract"
@@ -83,7 +83,7 @@ NAME="AEN14"
><P
>
This documentation is maintained in DocBook 4.1.2 XML format.
- Changes are best submitted as plain text or SGML diffs, attached
+ Changes are best submitted as plain text or XML diffs, attached
to a bug filed in the <A
HREF="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation"
TARGET="_top"
@@ -447,6 +447,26 @@ CLASS="LOT"
CLASS="LOT"
><DT
><B
+>List of Figures</B
+></DT
+><DT
+>4-1. <A
+HREF="troubleshooting.html#trouble-filetemp-errors"
+>Other File::Temp error messages</A
+></DT
+><DT
+>4-2. <A
+HREF="troubleshooting.html#trouble-filetemp-patch"
+>Patch for File::Temp in Perl 5.6.0</A
+></DT
+></DL
+></DIV
+><DIV
+CLASS="LOT"
+><DL
+CLASS="LOT"
+><DT
+><B
>List of Examples</B
></DT
><DT
diff --git a/docs/html/installation.html b/docs/html/installation.html
index 36cc6efd6..f3cf6892e 100644
--- a/docs/html/installation.html
+++ b/docs/html/installation.html
@@ -118,17 +118,17 @@ HREF="stepbystep.html#sbs-http"
></DT
><DT
>4.1.7. <A
-HREF="stepbystep.html#AEN620"
+HREF="stepbystep.html#AEN600"
>Bugzilla</A
></DT
><DT
>4.1.8. <A
-HREF="stepbystep.html#AEN645"
+HREF="stepbystep.html#AEN611"
>Setting Up the MySQL Database</A
></DT
><DT
>4.1.9. <A
-HREF="stepbystep.html#AEN681"
+HREF="stepbystep.html#AEN649"
><TT
CLASS="filename"
>checksetup.pl</TT
@@ -136,7 +136,7 @@ CLASS="filename"
></DT
><DT
>4.1.10. <A
-HREF="stepbystep.html#AEN713"
+HREF="stepbystep.html#AEN681"
>Configuring Bugzilla</A
></DT
></DL
@@ -150,17 +150,17 @@ HREF="extraconfig.html"
><DL
><DT
>4.2.1. <A
-HREF="extraconfig.html#AEN719"
+HREF="extraconfig.html#AEN687"
>Dependency Charts</A
></DT
><DT
>4.2.2. <A
-HREF="extraconfig.html#AEN734"
+HREF="extraconfig.html#AEN702"
>Bug Graphs</A
></DT
><DT
>4.2.3. <A
-HREF="extraconfig.html#AEN747"
+HREF="extraconfig.html#AEN715"
>The Whining Cron</A
></DT
><DT
@@ -222,6 +222,11 @@ CLASS="productname"
>Mac OS X</SPAN
></A
></DT
+><DT
+>4.3.3. <A
+HREF="os-specific.html#os-mandrake"
+>Linux-Mandrake 8.0</A
+></DT
></DL
></DD
><DT
@@ -263,12 +268,12 @@ HREF="troubleshooting.html"
><DL
><DT
>4.5.1. <A
-HREF="troubleshooting.html#AEN1009"
+HREF="troubleshooting.html#AEN977"
>Bundle::Bugzilla makes me upgrade to Perl 5.6.1</A
></DT
><DT
>4.5.2. <A
-HREF="troubleshooting.html#AEN1014"
+HREF="troubleshooting.html#AEN982"
>DBD::Sponge::db prepare failed</A
></DT
><DT
@@ -276,6 +281,11 @@ HREF="troubleshooting.html#AEN1014"
HREF="troubleshooting.html#paranoid-security"
>cannot chdir(/var/spool/mqueue)</A
></DT
+><DT
+>4.5.4. <A
+HREF="troubleshooting.html#trouble-filetemp"
+>Your vendor has not defined Fcntl macro O_NOINHERIT</A
+></DT
></DL
></DD
></DL
diff --git a/docs/html/os-specific.html b/docs/html/os-specific.html
index ef29d5a22..cdafc2b45 100644
--- a/docs/html/os-specific.html
+++ b/docs/html/os-specific.html
@@ -353,150 +353,6 @@ CLASS="programlisting"
></TR
></TABLE
></DIV
-><DIV
-CLASS="section"
-><H4
-CLASS="section"
-><A
-NAME="AEN863"
-></A
->4.3.1.3.2. System Calls</H4
-><P
->In order to get system calls to work on win32's perl, you need
- to tell the windows shell what interpreter to use. This is done by
- changing the <TT
-CLASS="function"
->system</TT
-> calls. You will need to
- search all of Bugzilla's code for <TT
-CLASS="function"
->system</TT
-> calls.
- To tell perl your interpreter, it needs to be the first argument to
- the <TT
-CLASS="function"
->system</TT
-> call. For example, you'll need to
- change:
- </P
-><TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><FONT
-COLOR="#000000"
-><PRE
-CLASS="programlisting"
->&#13;system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
- </PRE
-></FONT
-></TD
-></TR
-></TABLE
-><P
->with</P
-><TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><FONT
-COLOR="#000000"
-><PRE
-CLASS="programlisting"
->&#13;system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
- </PRE
-></FONT
-></TD
-></TR
-></TABLE
-><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
->The <B
-CLASS="command"
->grep</B
-> command is very helpful in finding
- these <TT
-CLASS="function"
->system</TT
-> calls, assuming you have the
- <SPAN
-CLASS="productname"
->cygwin</SPAN
-> utilities.
- </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
->It appears that the only <TT
-CLASS="function"
->system</TT
-> call
- remaining in the Bugzilla codebase is in
- <TT
-CLASS="filename"
->showdependencygraph.cgi</TT
->. Not changing this
- file will only cause dependency graphs to not function if the
- <TT
-CLASS="option"
->webdotbase</TT
-> paramater points to a local
- installation of <A
-HREF="http://www.graphviz.org"
-TARGET="_top"
->GraphViz</A
->.
- </P
-></TD
-></TR
-></TABLE
-></DIV
-></DIV
></DIV
><DIV
CLASS="section"
@@ -550,7 +406,7 @@ TARGET="_top"
to modify the first line of every script to contain your path to
perl instead of <TT
CLASS="filename"
->/usr/bonsaitools/bin/perl</TT
+>/usr/bin/perl</TT
>.
</P
></TD
@@ -623,7 +479,7 @@ CLASS="command"
This should go through the motions of downloading the latest version of
the GD module, then it will open a shell and drop you into the build
directory. Apply <A
-HREF="../sgml/gd-makefile.patch"
+HREF="../xml/gd-makefile.patch"
TARGET="_top"
>this patch</A
>
@@ -691,6 +547,105 @@ CLASS="command"
>
</P
></DIV
+><DIV
+CLASS="section"
+><H2
+CLASS="section"
+><A
+NAME="os-mandrake"
+></A
+>4.3.3. Linux-Mandrake 8.0</H2
+><P
+>Linux-Mandrake 8.0 includes every required and optional library
+ for Bugzilla. The easiest way to install them is by using the
+ <B
+CLASS="command"
+>urpmi</B
+> utility. If you follow these commands, you
+ should have everything you need for Bugzilla, and
+ <B
+CLASS="command"
+>./checksetup.pl</B
+> should not complain about any
+ missing libraries. You may already have some of these installed.
+ </P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="screen"
+>&#13;<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-mysql</B
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-chart</B
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-gd</B
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi perl-MailTools</B
+> <A
+NAME="test-mailtools"
+><IMG
+SRC="../images/callouts/1.gif"
+HSPACE="0"
+VSPACE="0"
+BORDER="0"
+ALT="(1)"></A
+>
+<TT
+CLASS="prompt"
+>bash#</TT
+> <B
+CLASS="command"
+>urpmi apache-modules</B
+>
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
+><DIV
+CLASS="calloutlist"
+><DL
+COMPACT="COMPACT"
+><DT
+><A
+HREF="os-specific.html#test-mailtools"
+><IMG
+SRC="../images/callouts/1.gif"
+HSPACE="0"
+VSPACE="0"
+BORDER="0"
+ALT="(1)"></A
+></DT
+><DD
+>for Bugzilla e-mail integration</DD
+></DL
+></DIV
+></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
diff --git a/docs/html/stepbystep.html b/docs/html/stepbystep.html
index 8de6806b1..33244655f 100644
--- a/docs/html/stepbystep.html
+++ b/docs/html/stepbystep.html
@@ -265,7 +265,7 @@ TARGET="_top"
>Date::Parse
</A
>
- (any)
+ (2.21)
</P
></LI
><LI
@@ -383,124 +383,6 @@ VALIGN="TOP"
></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
->Linux-Mandrake 8.0 includes every
- required and optional library for Bugzilla. The easiest way to
- install them is by using the
- <TT
-CLASS="filename"
->urpmi</TT
->
-
- utility. If you follow these commands, you should have everything you
- need for Bugzilla, and
- <TT
-CLASS="filename"
->checksetup.pl</TT
->
-
- should not complain about any missing libraries. You may already have
- some of these installed.</P
-><P
-></P
-><TABLE
-BORDER="0"
-><TBODY
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-mysql</B
->
- </TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-chart</B
->
- </TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-gd</B
->
- </TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi perl-MailTools</B
->
-
- (for Bugzilla email integration)</TD
-></TR
-><TR
-><TD
->&#13; <TT
-CLASS="prompt"
->bash#</TT
->
-
- <B
-CLASS="command"
->urpmi apache-modules</B
->
- </TD
-></TR
-></TBODY
-></TABLE
-><P
-></P
-></TD
-></TR
-></TABLE
-></DIV
->
</P
></DIV
><DIV
@@ -863,7 +745,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN586"
+NAME="AEN566"
></A
>4.1.5.1. DBI</H3
><P
@@ -878,7 +760,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN589"
+NAME="AEN569"
></A
>4.1.5.2. Data::Dumper</H3
><P
@@ -892,7 +774,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN592"
+NAME="AEN572"
></A
>4.1.5.3. MySQL-related modules</H3
><P
@@ -918,7 +800,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN597"
+NAME="AEN577"
></A
>4.1.5.4. TimeDate modules</H3
><P
@@ -934,7 +816,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN600"
+NAME="AEN580"
></A
>4.1.5.5. GD (optional)</H3
><P
@@ -989,7 +871,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN607"
+NAME="AEN587"
></A
>4.1.5.6. Chart::Base (optional)</H3
><P
@@ -1004,7 +886,7 @@ CLASS="section"
><H3
CLASS="section"
><A
-NAME="AEN610"
+NAME="AEN590"
></A
>4.1.5.7. Template Toolkit</H3
><P
@@ -1073,7 +955,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN620"
+NAME="AEN600"
></A
>4.1.7. Bugzilla</H2
><P
@@ -1138,112 +1020,13 @@ CLASS="filename"
>checksetup.pl</TT
>
script, which locks down your installation.</P
-><P
->Lastly, you'll need to set up a symbolic link to
- <TT
-CLASS="filename"
->/usr/bonsaitools/bin/perl</TT
->
- for the correct location of your Perl executable (probably
- <TT
-CLASS="filename"
->/usr/bin/perl</TT
->).
- Otherwise you must hack all the .cgi files to change where they look
- for Perl. This can be done using the following Perl one-liner, but
- I suggest using the symlink approach to avoid upgrade hassles.
- </P
-><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
-><SPAN
-CLASS="QUOTE"
->"Bonsaitools"</SPAN
-> is the name Terry Weissman, the
- original author of Bugzilla, created
- for his suite of webtools at the time he created Bugzilla and several
- other tools in use at mozilla.org. He created a directory,
- <TT
-CLASS="filename"
->/usr/bonsaitools</TT
-> to house his specific versions
- of perl and other utilities. This usage is still current at
- <A
-HREF="http://bugzilla.mozilla.org/"
-TARGET="_top"
->bugzilla.mozilla.org</A
->,
- but in general most other places do not use it. You can either edit
- the paths at the start of each perl file to the correct location of
- perl on your system, or simply bow to history and create a
- <TT
-CLASS="filename"
->/usr/bonsaitools</TT
-> and <TT
-CLASS="filename"
->/usr/bonsaitools/bin
- </TT
-> directory, placing a symlink to perl on your system
- inside <TT
-CLASS="filename"
->/usr/bonsaitools/bin</TT
->
- </P
-></TD
-></TR
-></TABLE
-></DIV
-><P
->
- <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><FONT
-COLOR="#000000"
-><PRE
-CLASS="programlisting"
->&#13;perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb
- </PRE
-></FONT
-></TD
-></TR
-></TABLE
->
-
- Change <TT
-CLASS="filename"
->/usr/bin/perl</TT
-> to match the location
- of Perl on your machine.
- </P
></DIV
><DIV
CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN645"
+NAME="AEN611"
></A
>4.1.8. Setting Up the MySQL Database</H2
><P
@@ -1410,13 +1193,41 @@ CLASS="command"
></P
>
</P
+><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
+>If you are using MySQL 4, the bugs user also needs to be granted
+ the LOCK TABLES and CREATE TEMPORARY TABLES permissions.
+ </P
+></TD
+></TR
+></TABLE
+></DIV
></DIV
><DIV
CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN681"
+NAME="AEN649"
></A
>4.1.9. <TT
CLASS="filename"
@@ -1569,7 +1380,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN713"
+NAME="AEN681"
></A
>4.1.10. Configuring Bugzilla</H2
><P
diff --git a/docs/html/troubleshooting.html b/docs/html/troubleshooting.html
index 9b4a2c2cd..5dd2d1714 100644
--- a/docs/html/troubleshooting.html
+++ b/docs/html/troubleshooting.html
@@ -85,7 +85,7 @@ CLASS="section"
><H2
CLASS="section"
><A
-NAME="AEN1009"
+NAME="AEN977"
></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="AEN1014"
+NAME="AEN982"
></A
>4.5.2. DBD::Sponge::db prepare failed</H2
><P
@@ -249,6 +249,116 @@ CLASS="filename"
as root to fix this problem.
</P
></DIV
+><DIV
+CLASS="section"
+><H2
+CLASS="section"
+><A
+NAME="trouble-filetemp"
+></A
+>4.5.4. Your vendor has not defined Fcntl macro O_NOINHERIT</H2
+><P
+>This is caused by a bug in the version of
+ <SPAN
+CLASS="productname"
+>File::Temp</SPAN
+> that is distributed with perl
+ 5.6.0. Many minor variations of this error have been reported. Examples
+ can be found in <A
+HREF="troubleshooting.html#trouble-filetemp-errors"
+>Figure 4-1</A
+>.
+ </P
+><DIV
+CLASS="figure"
+><A
+NAME="trouble-filetemp-errors"
+></A
+><P
+><B
+>Figure 4-1. Other File::Temp error messages</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="programlisting"
+>&#13;Your vendor has not defined Fcntl macro O_NOINHERIT, used
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 208.
+
+Your vendor has not defined Fcntl macro O_EXLOCK, used
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 210.
+
+Your vendor has not defined Fcntl macro O_TEMPORARY, used
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Numerous people have reported that upgrading to version 5.6.1
+ or higher solved the problem for them. A less involved fix is to apply
+ the patch in <A
+HREF="troubleshooting.html#trouble-filetemp-patch"
+>Figure 4-2</A
+>. The patch is also
+ available as a <A
+HREF="../xml/filetemp.patch"
+TARGET="_top"
+>patch file</A
+>.
+ </P
+><DIV
+CLASS="figure"
+><A
+NAME="trouble-filetemp-patch"
+></A
+><P
+><B
+>Figure 4-2. Patch for File::Temp in Perl 5.6.0</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><FONT
+COLOR="#000000"
+><PRE
+CLASS="programlisting"
+>&#13;--- File/Temp.pm.orig Thu Feb 6 16:26:00 2003
++++ File/Temp.pm Thu Feb 6 16:26:23 2003
+@@ -205,6 +205,7 @@
+ # eg CGI::Carp
+ local $SIG{__DIE__} = sub {};
+ local $SIG{__WARN__} = sub {};
++ local *CORE::GLOBAL::die = sub {};
+ $bit = &#38;$func();
+ 1;
+ };
+@@ -226,6 +227,7 @@
+ # eg CGI::Carp
+ local $SIG{__DIE__} = sub {};
+ local $SIG{__WARN__} = sub {};
++ local *CORE::GLOBAL::die = sub {};
+ $bit = &#38;$func();
+ 1;
+ };
+ </PRE
+></FONT
+></TD
+></TR
+></TABLE
+></DIV
+></DIV
></DIV
><DIV
CLASS="NAVFOOTER"