diff options
author | jake%bugzilla.org <> | 2003-06-14 01:41:21 +0200 |
---|---|---|
committer | jake%bugzilla.org <> | 2003-06-14 01:41:21 +0200 |
commit | 7bd0d001e89b4c27865c1756c7bc4829867d6e58 (patch) | |
tree | 3d99acdbf36a5516c4c4ad6844f3393a353cb369 | |
parent | 6bab73fe02dc15f3a68dc29ac2e7ba1814fdfa1a (diff) | |
download | bugzilla-7bd0d001e89b4c27865c1756c7bc4829867d6e58.tar.gz bugzilla-7bd0d001e89b4c27865c1756c7bc4829867d6e58.tar.xz |
Fresh docs compile (first one w/a PDF version).
-rw-r--r-- | docs/html/Bugzilla-Guide.html | 211 | ||||
-rw-r--r-- | docs/html/administration.html | 8 | ||||
-rw-r--r-- | docs/html/cust-change-permissions.html | 4 | ||||
-rw-r--r-- | docs/html/cust-templates.html | 8 | ||||
-rw-r--r-- | docs/html/dbdoc.html | 4 | ||||
-rw-r--r-- | docs/html/faq.html | 103 | ||||
-rw-r--r-- | docs/html/gfdl-howto.html | 2 | ||||
-rw-r--r-- | docs/html/gfdl.html | 2 | ||||
-rw-r--r-- | docs/html/glossary.html | 4 | ||||
-rw-r--r-- | docs/html/installation.html | 4 | ||||
-rw-r--r-- | docs/html/os-specific.html | 80 | ||||
-rw-r--r-- | docs/html/troubleshooting.html | 4 | ||||
-rw-r--r-- | docs/pdf/Bugzilla-Guide.pdf | bin | 0 -> 340369 bytes | |||
-rw-r--r-- | docs/txt/Bugzilla-Guide.txt | 62 |
14 files changed, 277 insertions, 219 deletions
diff --git a/docs/html/Bugzilla-Guide.html b/docs/html/Bugzilla-Guide.html index fe8ecffdc..d8d9f7779 100644 --- a/docs/html/Bugzilla-Guide.html +++ b/docs/html/Bugzilla-Guide.html @@ -4888,6 +4888,86 @@ CLASS="programlisting" ></TR ></TABLE ></DIV +><DIV +CLASS="section" +><HR><H4 +CLASS="section" +><A +NAME="win32-code-bugmail" +></A +>4.3.1.3.2. Changes to <TT +CLASS="filename" +>BugMail.pm</TT +></H4 +><P +>To make bug e-mail work on Win32 (until + <A +HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=84876" +TARGET="_top" +>bug + 84876</A +> lands), the + simplest way is to have Net::SMTP installed and change this (in + <TT +CLASS="filename" +>Bugzilla/BugMail.pm</TT +>):</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> open(SENDMAIL, "|/usr/lib/sendmail $sendmailparam -t -i") || + die "Can't open sendmail"; + +print SENDMAIL trim($msg) . "\n"; +close SENDMAIL; + </PRE +></FONT +></TD +></TR +></TABLE +><P +>to</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> use Net::SMTP; +$smtp_server = 'smtp.mycompany.com'; # change this + +# Use die on error, so that the mail will be in the 'unsent mails' and +# can be sent from the sanity check page. +my $smtp = Net::SMTP->new($smtp_server) || + die 'Cannot connect to server \'$smtp_server\''; + +$smtp->mail('bugzilla-daemon@mycompany.com'); # change this +$smtp->to($person); +$smtp->data(); +$smtp->datasend($msg); +$smtp->dataend(); +$smtp->quit; + </PRE +></FONT +></TD +></TR +></TABLE +><P +>Don't forget to change the name of your SMTP server and the + domain of the sending e-mail address (after the '@') in the above + lines of code.</P +></DIV ></DIV ><DIV CLASS="section" @@ -5762,7 +5842,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1076" +NAME="AEN1086" ></A >4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1</H2 ><P @@ -5787,7 +5867,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1081" +NAME="AEN1091" ></A >4.5.2. DBD::Sponge::db prepare failed</H2 ><P @@ -7873,7 +7953,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1524" +NAME="AEN1534" ></A >5.7.1. What to Edit</H2 ><P @@ -7988,7 +8068,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1543" +NAME="AEN1553" ></A >5.7.2. How To Edit Templates</H2 ><P @@ -8070,7 +8150,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1553" +NAME="AEN1563" ></A >5.7.3. Template Formats</H2 ><P @@ -8132,7 +8212,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN1566" +NAME="AEN1576" ></A >5.7.4. Particular Templates</H2 ><P @@ -8432,7 +8512,7 @@ COLOR="#000000" ><PRE CLASS="programlisting" > if ($field eq "qacontact") { - if (UserInGroup("quality_assurance")) { + if (Bugzilla->user->groups("quality_assurance")) { return 1; } else { @@ -8457,7 +8537,7 @@ COLOR="#000000" ><PRE CLASS="programlisting" > if (($field eq "priority") && - ($vars->{'user'}{'login'} =~ /.*\@example\.com$/)) + (Bugzilla->user->email =~ /.*\@example\.com$/)) { if ($oldvalue eq "P1") { return 1; @@ -9737,85 +9817,26 @@ CLASS="answer" There are <EM >dozens</EM > of major companies with public - Bugzilla sites to track bugs in their products. A few include: - <P -></P -><TABLE -BORDER="0" -><TBODY -><TR -><TD ->Netscape/AOL</TD -></TR -><TR -><TD ->Mozilla.org</TD -></TR -><TR -><TD ->NASA</TD -></TR -><TR -><TD ->Red Hat Software</TD -></TR -><TR -><TD ->SuSe Corp</TD -></TR -><TR -><TD ->The Horde Project</TD -></TR -><TR -><TD ->AbiSource</TD -></TR -><TR -><TD ->Real Time Enterprises, Inc</TD -></TR -><TR -><TD ->Eggheads.org</TD -></TR -><TR -><TD ->Strata Software</TD -></TR -><TR -><TD ->RockLinux</TD -></TR -><TR -><TD ->Creative Labs (makers of SoundBlaster)</TD -></TR -><TR -><TD ->The Apache Foundation</TD -></TR -><TR -><TD ->The Gnome Foundation</TD -></TR -><TR -><TD ->Ximian</TD -></TR -><TR -><TD ->Linux-Mandrake</TD -></TR -></TBODY -></TABLE -><P -></P -> - </P -><P -> Suffice to say, there are more than enough huge projects using Bugzilla - that we can safely say it's extremely popular. + Bugzilla sites to track bugs in their products. We have a fairly + complete list available on our website at + <A +HREF="http://bugzilla.org/installation_list.html" +TARGET="_top" +>http://bugzilla.org/installation_list.html</A +>. If you + have an installation of Bugzilla and would like to be added to the + list, whether it's a public install or not, simply e-mail + Gerv <TT +CLASS="email" +><<A +HREF="mailto:gerv@mozilla.org" +>gerv@mozilla.org</A +>></TT +>. Keep in mind that it's kinda + difficult to get onto the <SPAN +CLASS="QUOTE" +>"high-profile"</SPAN +> list ;). </P ></DIV ></DIV @@ -10984,7 +11005,7 @@ CLASS="answer" You can call bug_email.pl directly from your aliases file, with an entry like this: <A -NAME="AEN1985" +NAME="AEN1980" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -11428,7 +11449,7 @@ CLASS="answer" ><P > Microsoft has some advice on this matter, as well: <A -NAME="AEN2068" +NAME="AEN2063" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -12056,7 +12077,7 @@ CLASS="section" ><HR><H2 CLASS="section" ><A -NAME="AEN2190" +NAME="AEN2185" ></A >B.2.1. Bugzilla Database Basics</H2 ><P @@ -12170,7 +12191,7 @@ CLASS="section" ><HR><H3 CLASS="section" ><A -NAME="AEN2217" +NAME="AEN2212" ></A >B.2.1.1. Bugzilla Database Tables</H3 ><P @@ -12733,7 +12754,7 @@ NAME="gfdl" ><P >Version 1.1, March 2000</P ><A -NAME="AEN2305" +NAME="AEN2300" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -13196,7 +13217,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="AEN2395" +NAME="AEN2390" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -13233,7 +13254,7 @@ CLASS="glossdiv" ><H1 CLASS="glossdiv" ><A -NAME="AEN2400" +NAME="AEN2395" ></A >0-9, high ascii</H1 ><DL @@ -14041,7 +14062,7 @@ NAME="gloss-zarro" Terry had the following to say: </P ><A -NAME="AEN2626" +NAME="AEN2621" ></A ><TABLE BORDER="0" diff --git a/docs/html/administration.html b/docs/html/administration.html index 609e9049e..be490dce7 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#AEN1524" +HREF="cust-templates.html#AEN1534" >What to Edit</A ></DT ><DT >5.7.2. <A -HREF="cust-templates.html#AEN1543" +HREF="cust-templates.html#AEN1553" >How To Edit Templates</A ></DT ><DT >5.7.3. <A -HREF="cust-templates.html#AEN1553" +HREF="cust-templates.html#AEN1563" >Template Formats</A ></DT ><DT >5.7.4. <A -HREF="cust-templates.html#AEN1566" +HREF="cust-templates.html#AEN1576" >Particular Templates</A ></DT ></DL diff --git a/docs/html/cust-change-permissions.html b/docs/html/cust-change-permissions.html index 465896d0b..3d240bc40 100644 --- a/docs/html/cust-change-permissions.html +++ b/docs/html/cust-change-permissions.html @@ -183,7 +183,7 @@ COLOR="#000000" ><PRE CLASS="programlisting" > if ($field eq "qacontact") { - if (UserInGroup("quality_assurance")) { + if (Bugzilla->user->groups("quality_assurance")) { return 1; } else { @@ -208,7 +208,7 @@ COLOR="#000000" ><PRE CLASS="programlisting" > if (($field eq "priority") && - ($vars->{'user'}{'login'} =~ /.*\@example\.com$/)) + (Bugzilla->user->email =~ /.*\@example\.com$/)) { if ($oldvalue eq "P1") { return 1; diff --git a/docs/html/cust-templates.html b/docs/html/cust-templates.html index fc7f972a9..e096d17b0 100644 --- a/docs/html/cust-templates.html +++ b/docs/html/cust-templates.html @@ -99,7 +99,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1524" +NAME="AEN1534" ></A >5.7.1. What to Edit</H2 ><P @@ -214,7 +214,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1543" +NAME="AEN1553" ></A >5.7.2. How To Edit Templates</H2 ><P @@ -296,7 +296,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1553" +NAME="AEN1563" ></A >5.7.3. Template Formats</H2 ><P @@ -358,7 +358,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1566" +NAME="AEN1576" ></A >5.7.4. Particular Templates</H2 ><P diff --git a/docs/html/dbdoc.html b/docs/html/dbdoc.html index 82548422b..8a4960ae2 100644 --- a/docs/html/dbdoc.html +++ b/docs/html/dbdoc.html @@ -135,7 +135,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN2190" +NAME="AEN2185" ></A >B.2.1. Bugzilla Database Basics</H2 ><P @@ -249,7 +249,7 @@ CLASS="section" ><H3 CLASS="section" ><A -NAME="AEN2217" +NAME="AEN2212" ></A >B.2.1.1. Bugzilla Database Tables</H3 ><P diff --git a/docs/html/faq.html b/docs/html/faq.html index 7c8ba0cea..bf1dd21fe 100644 --- a/docs/html/faq.html +++ b/docs/html/faq.html @@ -691,85 +691,26 @@ CLASS="answer" There are <EM >dozens</EM > of major companies with public - Bugzilla sites to track bugs in their products. A few include: - <P -></P -><TABLE -BORDER="0" -><TBODY -><TR -><TD ->Netscape/AOL</TD -></TR -><TR -><TD ->Mozilla.org</TD -></TR -><TR -><TD ->NASA</TD -></TR -><TR -><TD ->Red Hat Software</TD -></TR -><TR -><TD ->SuSe Corp</TD -></TR -><TR -><TD ->The Horde Project</TD -></TR -><TR -><TD ->AbiSource</TD -></TR -><TR -><TD ->Real Time Enterprises, Inc</TD -></TR -><TR -><TD ->Eggheads.org</TD -></TR -><TR -><TD ->Strata Software</TD -></TR -><TR -><TD ->RockLinux</TD -></TR -><TR -><TD ->Creative Labs (makers of SoundBlaster)</TD -></TR -><TR -><TD ->The Apache Foundation</TD -></TR -><TR -><TD ->The Gnome Foundation</TD -></TR -><TR -><TD ->Ximian</TD -></TR -><TR -><TD ->Linux-Mandrake</TD -></TR -></TBODY -></TABLE -><P -></P -> - </P -><P -> Suffice to say, there are more than enough huge projects using Bugzilla - that we can safely say it's extremely popular. + Bugzilla sites to track bugs in their products. We have a fairly + complete list available on our website at + <A +HREF="http://bugzilla.org/installation_list.html" +TARGET="_top" +>http://bugzilla.org/installation_list.html</A +>. If you + have an installation of Bugzilla and would like to be added to the + list, whether it's a public install or not, simply e-mail + Gerv <TT +CLASS="email" +><<A +HREF="mailto:gerv@mozilla.org" +>gerv@mozilla.org</A +>></TT +>. Keep in mind that it's kinda + difficult to get onto the <SPAN +CLASS="QUOTE" +>"high-profile"</SPAN +> list ;). </P ></DIV ></DIV @@ -1938,7 +1879,7 @@ CLASS="answer" You can call bug_email.pl directly from your aliases file, with an entry like this: <A -NAME="AEN1985" +NAME="AEN1980" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" @@ -2382,7 +2323,7 @@ CLASS="answer" ><P > Microsoft has some advice on this matter, as well: <A -NAME="AEN2068" +NAME="AEN2063" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" diff --git a/docs/html/gfdl-howto.html b/docs/html/gfdl-howto.html index 8359dcaee..7adca55fc 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="AEN2395" +NAME="AEN2390" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" diff --git a/docs/html/gfdl.html b/docs/html/gfdl.html index 1f8490229..d146ae59f 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="AEN2305" +NAME="AEN2300" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" diff --git a/docs/html/glossary.html b/docs/html/glossary.html index 23242ef90..26434117b 100644 --- a/docs/html/glossary.html +++ b/docs/html/glossary.html @@ -70,7 +70,7 @@ CLASS="glossdiv" ><H1 CLASS="glossdiv" ><A -NAME="AEN2400" +NAME="AEN2395" ></A >0-9, high ascii</H1 ><DL @@ -878,7 +878,7 @@ NAME="gloss-zarro" Terry had the following to say: </P ><A -NAME="AEN2626" +NAME="AEN2621" ></A ><TABLE BORDER="0" diff --git a/docs/html/installation.html b/docs/html/installation.html index fc87848f9..18a00cff5 100644 --- a/docs/html/installation.html +++ b/docs/html/installation.html @@ -258,12 +258,12 @@ HREF="troubleshooting.html" ><DL ><DT >4.5.1. <A -HREF="troubleshooting.html#AEN1076" +HREF="troubleshooting.html#AEN1086" >Bundle::Bugzilla makes me upgrade to Perl 5.6.1</A ></DT ><DT >4.5.2. <A -HREF="troubleshooting.html#AEN1081" +HREF="troubleshooting.html#AEN1091" >DBD::Sponge::db prepare failed</A ></DT ><DT diff --git a/docs/html/os-specific.html b/docs/html/os-specific.html index 43edb1d23..f130bbf8a 100644 --- a/docs/html/os-specific.html +++ b/docs/html/os-specific.html @@ -357,6 +357,86 @@ CLASS="programlisting" ></TR ></TABLE ></DIV +><DIV +CLASS="section" +><H4 +CLASS="section" +><A +NAME="win32-code-bugmail" +></A +>4.3.1.3.2. Changes to <TT +CLASS="filename" +>BugMail.pm</TT +></H4 +><P +>To make bug e-mail work on Win32 (until + <A +HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=84876" +TARGET="_top" +>bug + 84876</A +> lands), the + simplest way is to have Net::SMTP installed and change this (in + <TT +CLASS="filename" +>Bugzilla/BugMail.pm</TT +>):</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> open(SENDMAIL, "|/usr/lib/sendmail $sendmailparam -t -i") || + die "Can't open sendmail"; + +print SENDMAIL trim($msg) . "\n"; +close SENDMAIL; + </PRE +></FONT +></TD +></TR +></TABLE +><P +>to</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><FONT +COLOR="#000000" +><PRE +CLASS="programlisting" +> use Net::SMTP; +$smtp_server = 'smtp.mycompany.com'; # change this + +# Use die on error, so that the mail will be in the 'unsent mails' and +# can be sent from the sanity check page. +my $smtp = Net::SMTP->new($smtp_server) || + die 'Cannot connect to server \'$smtp_server\''; + +$smtp->mail('bugzilla-daemon@mycompany.com'); # change this +$smtp->to($person); +$smtp->data(); +$smtp->datasend($msg); +$smtp->dataend(); +$smtp->quit; + </PRE +></FONT +></TD +></TR +></TABLE +><P +>Don't forget to change the name of your SMTP server and the + domain of the sending e-mail address (after the '@') in the above + lines of code.</P +></DIV ></DIV ><DIV CLASS="section" diff --git a/docs/html/troubleshooting.html b/docs/html/troubleshooting.html index 7d9789274..3b2bd86a7 100644 --- a/docs/html/troubleshooting.html +++ b/docs/html/troubleshooting.html @@ -85,7 +85,7 @@ CLASS="section" ><H2 CLASS="section" ><A -NAME="AEN1076" +NAME="AEN1086" ></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="AEN1081" +NAME="AEN1091" ></A >4.5.2. DBD::Sponge::db prepare failed</H2 ><P diff --git a/docs/pdf/Bugzilla-Guide.pdf b/docs/pdf/Bugzilla-Guide.pdf Binary files differnew file mode 100644 index 000000000..6eb5287b3 --- /dev/null +++ b/docs/pdf/Bugzilla-Guide.pdf diff --git a/docs/txt/Bugzilla-Guide.txt b/docs/txt/Bugzilla-Guide.txt index f35b28b8b..d683d47ac 100644 --- a/docs/txt/Bugzilla-Guide.txt +++ b/docs/txt/Bugzilla-Guide.txt @@ -1451,6 +1451,37 @@ my $webservergid = getgrnam($my_webservergroup) my $webservergid = '8' _________________________________________________________________ +4.3.1.3.2. Changes to BugMail.pm + + To make bug e-mail work on Win32 (until bug 84876 lands), the simplest + way is to have Net::SMTP installed and change this (in + Bugzilla/BugMail.pm): +open(SENDMAIL, "|/usr/lib/sendmail $sendmailparam -t -i") || + die "Can't open sendmail"; + +print SENDMAIL trim($msg) . "\n"; +close SENDMAIL; + + to +use Net::SMTP; +$smtp_server = 'smtp.mycompany.com'; # change this + +# Use die on error, so that the mail will be in the 'unsent mails' and +# can be sent from the sanity check page. +my $smtp = Net::SMTP->new($smtp_server) || + die 'Cannot connect to server \'$smtp_server\''; + +$smtp->mail('bugzilla-daemon@mycompany.com'); # change this +$smtp->to($person); +$smtp->data(); +$smtp->datasend($msg); +$smtp->dataend(); +$smtp->quit; + + Don't forget to change the name of your SMTP server and the domain of + the sending e-mail address (after the '@') in the above lines of code. + _________________________________________________________________ + 4.3.1.4. Serving the web pages As is the case on Unix based systems, any web server should be able to @@ -2596,7 +2627,7 @@ skip-networking positive check, which returns 1 (allow) if certain conditions are true, or a negative check, which returns 0 (deny.) E.g.: if ($field eq "qacontact") { - if (UserInGroup("quality_assurance")) { + if (Bugzilla->user->groups("quality_assurance")) { return 1; } else { @@ -2607,7 +2638,7 @@ skip-networking This says that only users in the group "quality_assurance" can change the QA Contact field of a bug. Getting more weird: if (($field eq "priority") && - ($vars->{'user'}{'login'} =~ /.*\@example\.com$/)) + (Bugzilla->user->email =~ /.*\@example\.com$/)) { if ($oldvalue eq "P1") { return 1; @@ -3033,27 +3064,12 @@ Appendix A. The Bugzilla FAQ for bug-tracking? There are dozens of major companies with public Bugzilla sites to - track bugs in their products. A few include: - - Netscape/AOL - Mozilla.org - NASA - Red Hat Software - SuSe Corp - The Horde Project - AbiSource - Real Time Enterprises, Inc - Eggheads.org - Strata Software - RockLinux - Creative Labs (makers of SoundBlaster) - The Apache Foundation - The Gnome Foundation - Ximian - Linux-Mandrake - - Suffice to say, there are more than enough huge projects using - Bugzilla that we can safely say it's extremely popular. + track bugs in their products. We have a fairly complete list available + on our website at http://bugzilla.org/installation_list.html. If you + have an installation of Bugzilla and would like to be added to the + list, whether it's a public install or not, simply e-mail Gerv + <gerv@mozilla.org>. Keep in mind that it's kinda difficult to get onto + the "high-profile" list ;). A.1.5. Who maintains Bugzilla? |