From 7bd0d001e89b4c27865c1756c7bc4829867d6e58 Mon Sep 17 00:00:00 2001 From: "jake%bugzilla.org" <> Date: Fri, 13 Jun 2003 23:41:21 +0000 Subject: Fresh docs compile (first one w/a PDF version). --- docs/html/Bugzilla-Guide.html | 211 ++++++++++++++++++--------------- docs/html/administration.html | 8 +- docs/html/cust-change-permissions.html | 4 +- docs/html/cust-templates.html | 8 +- docs/html/dbdoc.html | 4 +- docs/html/faq.html | 103 ++++------------ docs/html/gfdl-howto.html | 2 +- docs/html/gfdl.html | 2 +- docs/html/glossary.html | 4 +- docs/html/installation.html | 4 +- docs/html/os-specific.html | 80 +++++++++++++ docs/html/troubleshooting.html | 4 +- docs/pdf/Bugzilla-Guide.pdf | Bin 0 -> 340369 bytes docs/txt/Bugzilla-Guide.txt | 62 ++++++---- 14 files changed, 277 insertions(+), 219 deletions(-) create mode 100644 docs/pdf/Bugzilla-Guide.pdf 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" >

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.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1

4.5.2. DBD::Sponge::db prepare failed

5.7.1. What to Edit

5.7.2. How To Edit Templates

5.7.3. Template Formats

5.7.4. Particular Templates

    if ($field eq "qacontact") {
-        if (UserInGroup("quality_assurance")) {
+        if (Bugzilla->user->groups("quality_assurance")) {
             return 1;
         } 
         else {
@@ -8457,7 +8537,7 @@ COLOR="#000000"
 >
    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 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.
+	    Bugzilla sites to 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 ;).

Microsoft has some advice on this matter, as well:

B.2.1. Bugzilla Database Basics

B.2.1.1. Bugzilla Database Tables

Version 1.1, March 2000

0-9, high ascii

5.7.1. What to Edit
5.7.2. How To Edit Templates
5.7.3. Template Formats
5.7.4. Particular Templates
    if ($field eq "qacontact") {
-        if (UserInGroup("quality_assurance")) {
+        if (Bugzilla->user->groups("quality_assurance")) {
             return 1;
         } 
         else {
@@ -208,7 +208,7 @@ COLOR="#000000"
 >
    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"
 >
5.7.1. What to Edit
5.7.2. How To Edit Templates
5.7.3. Template Formats
5.7.4. Particular Templates
B.2.1. Bugzilla Database Basics
B.2.1.1. Bugzilla Database Tables
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. + Bugzilla sites to 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 ;).

Microsoft has some advice on this matter, as well:

Version 1.1, March 2000

0-9, high ascii

4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1
4.5.2. DBD::Sponge::db prepare failed

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.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1

4.5.2. DBD::Sponge::db prepare failed

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 + . Keep in mind that it's kinda difficult to get onto + the "high-profile" list ;). A.1.5. Who maintains Bugzilla? -- cgit v1.2.3-24-g4f1b