Fresh docs compile (first one w/a PDF version).

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"
+>&#13;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"
+>&#13;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-&#62;new($smtp_server) ||
+  die 'Cannot connect to server \'$smtp_server\'';
+
+$smtp-&#62;mail('bugzilla-daemon@mycompany.com');  # change this
+$smtp-&#62;to($person);
+$smtp-&#62;data();
+$smtp-&#62;datasend($msg);
+$smtp-&#62;dataend();
+$smtp-&#62;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-&#62;user-&#62;groups("quality_assurance")) {
             return 1;
         } 
         else {
@@ -8457,7 +8537,7 @@ COLOR="#000000"
 ><PRE
 CLASS="programlisting"
 >    if (($field eq "priority") &#38;&#38;
-        ($vars-&#62;{'user'}{'login'} =~ /.*\@example\.com$/))
+        (Bugzilla-&#62;user-&#62;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
->&#13;	    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"
+>&#60;<A
+HREF="mailto:gerv@mozilla.org"
+>gerv@mozilla.org</A
+>&#62;</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
 >&#13;	    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"

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

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-&#62;user-&#62;groups("quality_assurance")) {
             return 1;
         } 
         else {
@@ -208,7 +208,7 @@ COLOR="#000000"
 ><PRE
 CLASS="programlisting"
 >    if (($field eq "priority") &#38;&#38;
-        ($vars-&#62;{'user'}{'login'} =~ /.*\@example\.com$/))
+        (Bugzilla-&#62;user-&#62;email =~ /.*\@example\.com$/))
     {
         if ($oldvalue eq "P1") {
             return 1;

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

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

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
->&#13;	    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"
+>&#60;<A
+HREF="mailto:gerv@mozilla.org"
+>gerv@mozilla.org</A
+>&#62;</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
 >&#13;	    Microsoft has some advice on this matter, as well:
 	    <A
-NAME="AEN2068"
+NAME="AEN2063"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"

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"

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"

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"

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

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"
+>&#13;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"
+>&#13;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-&#62;new($smtp_server) ||
+  die 'Cannot connect to server \'$smtp_server\'';
+
+$smtp-&#62;mail('bugzilla-daemon@mycompany.com');  # change this
+$smtp-&#62;to($person);
+$smtp-&#62;data();
+$smtp-&#62;datasend($msg);
+$smtp-&#62;dataend();
+$smtp-&#62;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"

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

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?