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

12 files changed, 238 insertions, 196 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"
+>&#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"
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-&#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;
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
->&#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"
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"
+>&#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"
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