Skip to content

bugzilla
bugzilla
Commit d09b99cd authored by jake%bugzilla.org's avatar jake%bugzilla.org
Browse files
Options

Recompile the docs from the XML source in anticipation of the 2.17.4 release.

parent 25047db4
Expand all Hide whitespace changes
Inline Side-by-side
Showing with 507 additions and 446 deletions
docs/html/administration.html
View file @ d09b99cd
......@@ -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
......
docs/html/cust-templates.html
View file @ d09b99cd
......@@ -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
......
docs/html/dbdoc.html
View file @ d09b99cd
......@@ -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
......
docs/html/extraconfig.html
View file @ d09b99cd
......@@ -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
......
docs/html/faq.html
View file @ d09b99cd
......@@ -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
......
docs/html/gfdl-howto.html
View file @ d09b99cd
......@@ -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"
......
docs/html/gfdl.html
View file @ d09b99cd
......@@ -144,7 +144,7 @@ HREF="gfdl-howto.html"
><P
>Version 1.1, March 2000</P
><A
NAME="AEN2214"
NAME="AEN2206"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
......
docs/html/glossary.html
View file @ d09b99cd
......@@ -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
......
docs/html/index.html
View file @ d09b99cd
......@@ -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
......
docs/html/installation.html
View file @ d09b99cd
......@@ -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
......
docs/html/os-specific.html
View file @ d09b99cd
......@@ -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"
......
docs/html/stepbystep.html
View file @ d09b99cd
......@@ -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
......
docs/html/troubleshooting.html
View file @ d09b99cd
......@@ -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"
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment