зеркало из https://github.com/mozilla/gecko-dev.git
Recompile the docs from the XML source in anticipation of the 2.17.4 release.
This commit is contained in:
Родитель
6535561639
Коммит
1b1454bb41
Разница между файлами не показана из-за своего большого размера
Загрузить разницу
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -138,12 +138,24 @@ HREF="faq.html#faq-general-mysql"
|
|||
><DT
|
||||
>A.1.9. <A
|
||||
HREF="faq.html#faq-general-bonsaitools"
|
||||
> 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
|
||||
>?
|
||||
</A
|
||||
></DT
|
||||
><DT
|
||||
>A.1.10. <A
|
||||
HREF="faq.html#faq-general-perlpath"
|
||||
> 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"
|
||||
> 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
|
||||
> 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"
|
||||
> 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
|
||||
> 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"
|
||||
> 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
|
||||
> 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"
|
||||
> Bugzilla Project Page</A
|
||||
> for details on how to
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -144,7 +144,7 @@ HREF="gfdl-howto.html"
|
|||
><P
|
||||
>Version 1.1, March 2000</P
|
||||
><A
|
||||
NAME="AEN2214"
|
||||
NAME="AEN2206"
|
||||
></A
|
||||
><BLOCKQUOTE
|
||||
CLASS="BLOCKQUOTE"
|
||||
|
|
|
@ -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
|
||||
><P
|
||||
><DIV
|
||||
CLASS="variablelist"
|
||||
><DL
|
||||
><DT
|
||||
><A
|
||||
HREF="http://www.mysql.com/doc/P/r/Privilege_system.html"
|
||||
HREF="http://www.mysql.com/doc/en/Backup.html"
|
||||
TARGET="_top"
|
||||
>MySQL
|
||||
Privilege System</A
|
||||
> - Much more detailed information about
|
||||
the suggestions in <A
|
||||
>Backup</A
|
||||
></DT
|
||||
><DD
|
||||
><P
|
||||
>Methods for backing up your Bugzilla database.
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
><A
|
||||
HREF="http://www.mysql.com/doc/en/Option_files.html"
|
||||
TARGET="_top"
|
||||
>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"
|
||||
> </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"
|
||||
> </TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
COLSPAN="2"
|
||||
ALIGN="RIGHT"
|
||||
VALIGN="TOP"
|
||||
>--<SPAN
|
||||
CLASS="attribution"
|
||||
>Terry Weissman</SPAN
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
> </TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DD
|
||||
></DL
|
||||
></DIV
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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"
|
||||
> 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"
|
||||
> 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"
|
||||
> <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"
|
||||
|
|
|
@ -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
|
||||
> <TT
|
||||
CLASS="prompt"
|
||||
>bash#</TT
|
||||
>
|
||||
|
||||
<B
|
||||
CLASS="command"
|
||||
>urpmi perl-mysql</B
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
> <TT
|
||||
CLASS="prompt"
|
||||
>bash#</TT
|
||||
>
|
||||
|
||||
<B
|
||||
CLASS="command"
|
||||
>urpmi perl-chart</B
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
> <TT
|
||||
CLASS="prompt"
|
||||
>bash#</TT
|
||||
>
|
||||
|
||||
<B
|
||||
CLASS="command"
|
||||
>urpmi perl-gd</B
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
> <TT
|
||||
CLASS="prompt"
|
||||
>bash#</TT
|
||||
>
|
||||
|
||||
<B
|
||||
CLASS="command"
|
||||
>urpmi perl-MailTools</B
|
||||
>
|
||||
|
||||
(for Bugzilla email integration)</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
> <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"
|
||||
> 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
|
||||
|
|
|
@ -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"
|
||||
> 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"
|
||||
> --- 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 = &$func();
|
||||
1;
|
||||
};
|
||||
@@ -226,6 +227,7 @@
|
||||
# eg CGI::Carp
|
||||
local $SIG{__DIE__} = sub {};
|
||||
local $SIG{__WARN__} = sub {};
|
||||
+ local *CORE::GLOBAL::die = sub {};
|
||||
$bit = &$func();
|
||||
1;
|
||||
};
|
||||
</PRE
|
||||
></FONT
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
|
|
|
@ -7,7 +7,7 @@ Jacob Steenhagen
|
|||
|
||||
The Bugzilla Team
|
||||
|
||||
2003-02-16
|
||||
2003-04-23
|
||||
|
||||
This is the documentation for Bugzilla, the mozilla.org bug-tracking
|
||||
system. Bugzilla is an enterprise-class piece of software that powers
|
||||
|
@ -15,8 +15,8 @@ The Bugzilla Team
|
|||
tracking millions of bugs.
|
||||
|
||||
This documentation is maintained in DocBook 4.1.2 XML format. Changes
|
||||
are best submitted as plain text or SGML diffs, attached to a bug
|
||||
filed in the Bugzilla Documentation compontent.
|
||||
are best submitted as plain text or XML diffs, attached to a bug filed
|
||||
in the Bugzilla Documentation compontent.
|
||||
|
||||
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
|
||||
|
@ -101,6 +101,10 @@ The Bugzilla Team
|
|||
|
||||
Glossary
|
||||
|
||||
List of Figures
|
||||
4-1. Other File::Temp error messages
|
||||
4-2. Patch for File::Temp in Perl 5.6.0
|
||||
|
||||
List of Examples
|
||||
4-1. .htaccess files for Apache
|
||||
5-1. Upgrading using CVS
|
||||
|
@ -702,7 +706,7 @@ Chapter 4. Installation
|
|||
f. Data::Dumper (any)
|
||||
g. DBD::mysql (2.1010)
|
||||
h. DBI (1.32)
|
||||
i. Date::Parse (any)
|
||||
i. Date::Parse (2.21)
|
||||
j. CGI (2.88)
|
||||
and, optionally:
|
||||
a. GD (1.20) for bug charting
|
||||
|
@ -721,20 +725,6 @@ Chapter 4. Installation
|
|||
Many installation steps require an active Internet connection to
|
||||
complete, but you must take care to ensure that at no point is your
|
||||
machine vulnerable to an attack.
|
||||
|
||||
Note
|
||||
|
||||
Linux-Mandrake 8.0 includes every required and optional library for
|
||||
Bugzilla. The easiest way to install them is by using the urpmi
|
||||
utility. If you follow these commands, you should have everything you
|
||||
need for Bugzilla, and checksetup.pl should not complain about any
|
||||
missing libraries. You may already have some of these installed.
|
||||
|
||||
bash# urpmi perl-mysql
|
||||
bash# urpmi perl-chart
|
||||
bash# urpmi perl-gd
|
||||
bash# urpmi perl-MailTools (for Bugzilla email integration)
|
||||
bash# urpmi apache-modules
|
||||
_________________________________________________________________
|
||||
|
||||
4.1.3. MySQL
|
||||
|
@ -938,31 +928,6 @@ Chapter 4. Installation
|
|||
directory writable by your webserver's user. This is a temporary step
|
||||
until you run the post-install checksetup.pl script, which locks down
|
||||
your installation.
|
||||
|
||||
Lastly, you'll need to set up a symbolic link to
|
||||
/usr/bonsaitools/bin/perl for the correct location of your Perl
|
||||
executable (probably /usr/bin/perl). 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.
|
||||
|
||||
Note
|
||||
|
||||
"Bonsaitools" 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, /usr/bonsaitools to house his specific versions of perl and
|
||||
other utilities. This usage is still current at bugzilla.mozilla.org,
|
||||
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
|
||||
/usr/bonsaitools and /usr/bonsaitools/bin directory, placing a symlink
|
||||
to perl on your system inside /usr/bonsaitools/bin
|
||||
|
||||
perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm
|
||||
syncshadowdb
|
||||
|
||||
Change /usr/bin/perl to match the location of Perl on your machine.
|
||||
_________________________________________________________________
|
||||
|
||||
4.1.8. Setting Up the MySQL Database
|
||||
|
@ -1001,6 +966,11 @@ syncshadowdb
|
|||
ALTER,CREATE,DROP,REFERENCES ON bugs.* TO bugs@localhost IDENTIFIED BY
|
||||
'<bugs_password>';
|
||||
mysql> FLUSH PRIVILEGES;
|
||||
|
||||
Note
|
||||
|
||||
If you are using MySQL 4, the bugs user also needs to be granted the
|
||||
LOCK TABLES and CREATE TEMPORARY TABLES permissions.
|
||||
_________________________________________________________________
|
||||
|
||||
4.1.9. checksetup.pl
|
||||
|
@ -1307,32 +1277,6 @@ my $webservergid = getgrnam($my_webservergroup)
|
|||
my $webservergid = '8'
|
||||
_________________________________________________________________
|
||||
|
||||
4.3.1.3.2. System Calls
|
||||
|
||||
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 system calls. You will need to search all of Bugzilla's code for
|
||||
system calls. To tell perl your interpreter, it needs to be the first
|
||||
argument to the system call. For example, you'll need to change:
|
||||
system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
|
||||
|
||||
with
|
||||
system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filen
|
||||
ame");
|
||||
|
||||
Tip
|
||||
|
||||
The grep command is very helpful in finding these system calls,
|
||||
assuming you have the cygwin utilities.
|
||||
|
||||
Note
|
||||
|
||||
It appears that the only system call remaining in the Bugzilla
|
||||
codebase is in showdependencygraph.cgi. Not changing this file will
|
||||
only cause dependency graphs to not function if the webdotbase
|
||||
paramater points to a local installation of GraphViz.
|
||||
_________________________________________________________________
|
||||
|
||||
4.3.1.4. Serving the web pages
|
||||
|
||||
As is the case on Unix based systems, any web server should be able to
|
||||
|
@ -1346,7 +1290,7 @@ ame");
|
|||
If using Apache on windows, you can set the ScriptInterpreterSource
|
||||
directive in your Apache config, if you don't do this, you'll have to
|
||||
modify the first line of every script to contain your path to perl
|
||||
instead of /usr/bonsaitools/bin/perl.
|
||||
instead of /usr/bin/perl.
|
||||
_________________________________________________________________
|
||||
|
||||
4.3.2. Mac OS X
|
||||
|
@ -1390,6 +1334,23 @@ ame");
|
|||
And don't forget to run exit to get back to CPAN.
|
||||
_________________________________________________________________
|
||||
|
||||
4.3.3. Linux-Mandrake 8.0
|
||||
|
||||
Linux-Mandrake 8.0 includes every required and optional library for
|
||||
Bugzilla. The easiest way to install them is by using the urpmi
|
||||
utility. If you follow these commands, you should have everything you
|
||||
need for Bugzilla, and ./checksetup.pl should not complain about any
|
||||
missing libraries. You may already have some of these installed.
|
||||
bash# urpmi perl-mysql
|
||||
bash# urpmi perl-chart
|
||||
bash# urpmi perl-gd
|
||||
bash# urpmi perl-MailTools (1)
|
||||
bash# urpmi apache-modules
|
||||
|
||||
(1)
|
||||
for Bugzilla e-mail integration
|
||||
_________________________________________________________________
|
||||
|
||||
4.4. HTTP Server Configuration
|
||||
|
||||
The Bugzilla Team recommends Apache when using Bugzilla, however, any
|
||||
|
@ -1602,6 +1563,47 @@ proc filter_deny { why } {
|
|||
problem.
|
||||
_________________________________________________________________
|
||||
|
||||
4.5.4. Your vendor has not defined Fcntl macro O_NOINHERIT
|
||||
|
||||
This is caused by a bug in the version of File::Temp that is
|
||||
distributed with perl 5.6.0. Many minor variations of this error have
|
||||
been reported. Examples can be found in Figure 4-1.
|
||||
|
||||
Figure 4-1. Other File::Temp error messages
|
||||
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.
|
||||
|
||||
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 Figure 4-2. The patch is also available as a patch file.
|
||||
|
||||
Figure 4-2. Patch for File::Temp in Perl 5.6.0
|
||||
--- 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 = &$func();
|
||||
1;
|
||||
};
|
||||
@@ -226,6 +227,7 @@
|
||||
# eg CGI::Carp
|
||||
local $SIG{__DIE__} = sub {};
|
||||
local $SIG{__WARN__} = sub {};
|
||||
+ local *CORE::GLOBAL::die = sub {};
|
||||
$bit = &$func();
|
||||
1;
|
||||
};
|
||||
_________________________________________________________________
|
||||
|
||||
Chapter 5. Administering Bugzilla
|
||||
|
||||
5.1. Bugzilla Configuration
|
||||
|
@ -2662,10 +2664,11 @@ Appendix A. The Bugzilla FAQ
|
|||
A.1.8. Why MySQL? I'm interested in seeing Bugzilla run on
|
||||
Oracle/Sybase/Msql/PostgreSQL/MSSQL.
|
||||
|
||||
A.1.9. Why do the scripts say "/usr/bonsaitools/bin/perl" instead
|
||||
of "/usr/bin/perl" or something else?
|
||||
A.1.9. What is /usr/bonsaitools/bin/perl?
|
||||
A.1.10. My perl is not located at /usr/bin/perl, is there an easy
|
||||
way to change it everywhere it needs to be changed?
|
||||
|
||||
A.1.10. Is there an easy way to change the Bugzilla cookie name?
|
||||
A.1.11. Is there an easy way to change the Bugzilla cookie name?
|
||||
|
||||
2. Managerial Questions
|
||||
|
||||
|
@ -2926,18 +2929,27 @@ Appendix A. The Bugzilla FAQ
|
|||
Once both of these are done, adding support for additional database
|
||||
servers should be trivial.
|
||||
|
||||
A.1.9. Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
|
||||
"/usr/bin/perl" or something else?
|
||||
A.1.9. What is /usr/bonsaitools/bin/perl?
|
||||
|
||||
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.
|
||||
Bugzilla used to have the path to perl on the shebang line set to
|
||||
/usr/bonsaitools/bin/perl 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 /usr/bin/perl. 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).
|
||||
|
||||
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.
|
||||
A.1.10. My perl is not located at /usr/bin/perl, is there an easy way
|
||||
to change it everywhere it needs to be changed?
|
||||
|
||||
A.1.10. Is there an easy way to change the Bugzilla cookie name?
|
||||
Yes, the following bit of perl magic will change all the shebang
|
||||
lines. Be sure to change /usr/local/bin/perl to your path to the perl
|
||||
binary.
|
||||
perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl
|
||||
|
||||
A.1.11. Is there an easy way to change the Bugzilla cookie name?
|
||||
|
||||
At present, no.
|
||||
|
||||
|
@ -3048,8 +3060,8 @@ Appendix A. The Bugzilla FAQ
|
|||
|
||||
Currently the only script included with Bugzilla that can import data
|
||||
is importxml.pl which is intended to be used for importing the data
|
||||
generated by xml.cgi in association with bug moving. Any other use is
|
||||
left as an exercise for the user.
|
||||
generated by the XML ctype of show_bug.cgi in association with bug
|
||||
moving. Any other use is left as an exercise for the user.
|
||||
|
||||
There are also scripts included in the contrib/ directory for using
|
||||
e-mail to import information into Bugzilla, but these scripts are not
|
||||
|
@ -3059,10 +3071,10 @@ Appendix A. The Bugzilla FAQ
|
|||
in other countries? Is it localizable?
|
||||
|
||||
Yes. For more information including available translated templates,
|
||||
see http://www.bugzilla.org/download.html. The admin interfaces are
|
||||
still not included in these translated templates and is therefore
|
||||
still English only. Also, there may be issues with the charset not
|
||||
being declared. See bug 126226 for more information.
|
||||
see http://www.bugzilla.org/download.html#localizations. The admin
|
||||
interfaces are still not included in these translated templates and is
|
||||
therefore still English only. Also, there may be issues with the
|
||||
charset not being declared. See bug 126226 for more information.
|
||||
|
||||
A.2.13. Can a user create and save reports? Can they do this in Word
|
||||
format? Excel format?
|
||||
|
@ -4337,6 +4349,8 @@ B
|
|||
Bugzilla is the world-leading free software bug tracking
|
||||
system.
|
||||
|
||||
C
|
||||
|
||||
Common Gateway Interface (CGI)
|
||||
CGI is an acronym for Common Gateway Interface. This is a
|
||||
standard for interfacing an external application with a web
|
||||
|
@ -4391,8 +4405,15 @@ M
|
|||
familiarize yourself with all of the documentation, some high
|
||||
points are:
|
||||
|
||||
+ MySQL Privilege System - Much more detailed information about
|
||||
the suggestions in Section 5.6.2.
|
||||
Backup
|
||||
Methods for backing up your Bugzilla database.
|
||||
|
||||
Option Files
|
||||
Information about how to configure MySQL using my.cnf.
|
||||
|
||||
Privilege System
|
||||
Much more detailed information about the suggestions in
|
||||
Section 5.6.2.
|
||||
|
||||
P
|
||||
|
||||
|
@ -4459,6 +4480,22 @@ T
|
|||
Z
|
||||
|
||||
Zarro Boogs Found
|
||||
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".
|
||||
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:
|
||||
|
||||
|
||||
|
||||
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.
|
||||
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...
|
||||
|
||||
--Terry Weissman
|
||||
|
|
Загрузка…
Ссылка в новой задаче