Rebuilding documentation for the 2.17.5 release; the docbook system on landfill proved to be broken.

1 files changed, 214 insertions, 73 deletions

diff --git a/docs/html/faq.html b/docs/html/faq.html
index 9971ec1cc..9ec11cd40 100644
--- a/docs/html/faq.html
+++ b/docs/html/faq.html
@@ -4,8 +4,7 @@
 >The Bugzilla FAQ</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
 REL="HOME"
 TITLE="The Bugzilla Guide - 2.17.5 Development Release"
 HREF="index.html"><LINK
@@ -69,7 +68,9 @@ WIDTH="100%"></DIV
 CLASS="appendix"
 ><H1
 ><A
-NAME="faq">Appendix A. The Bugzilla FAQ</H1
+NAME="faq"
+></A
+>Appendix A. The Bugzilla FAQ</H1
 ><P
 >&#13;    This FAQ includes questions not covered elsewhere in the Guide.
   </P
@@ -565,14 +566,18 @@ HREF="faq.html#faq-hacking-patches"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-general">1. General Questions</H3
+NAME="faq-general"
+></A
+>1. General Questions</H3
 ><DIV
 CLASS="qandaentry"
 ><DIV
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-information"><B
+NAME="faq-general-information"
+></A
+><B
 >A.1.1. </B
 >
 	    Where can I find information about Bugzilla?</P
@@ -598,7 +603,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-license"><B
+NAME="faq-general-license"
+></A
+><B
 >A.1.2. </B
 >
 	    What license is Bugzilla distributed under?
@@ -625,7 +632,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-support"><B
+NAME="faq-general-support"
+></A
+><B
 >A.1.3. </B
 >
 	    How do I get commercial support for Bugzilla?
@@ -669,7 +678,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-companies"><B
+NAME="faq-general-companies"
+></A
+><B
 >A.1.4. </B
 >
 	    What major companies or projects are currently using Bugzilla
@@ -714,7 +725,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-maintainers"><B
+NAME="faq-general-maintainers"
+></A
+><B
 >A.1.5. </B
 >
 	    Who maintains Bugzilla?
@@ -742,7 +755,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-compare"><B
+NAME="faq-general-compare"
+></A
+><B
 >A.1.6. </B
 >
 	    How does Bugzilla stack up against other bug-tracking databases?
@@ -778,7 +793,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-bzmissing"><B
+NAME="faq-general-bzmissing"
+></A
+><B
 >A.1.7. </B
 >
 	    Why doesn't Bugzilla offer this or that feature or compatibility
@@ -816,7 +833,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-mysql"><B
+NAME="faq-general-mysql"
+></A
+><B
 >A.1.8. </B
 >
 	    Why MySQL?  I'm interested in seeing Bugzilla run on
@@ -859,7 +878,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-bonsaitools"><B
+NAME="faq-general-bonsaitools"
+></A
+><B
 >A.1.9. </B
 >
 	    What is <TT
@@ -899,7 +920,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-perlpath"><B
+NAME="faq-general-perlpath"
+></A
+><B
 >A.1.10. </B
 >
             My perl is not located at <TT
@@ -946,7 +969,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-general-cookie"><B
+NAME="faq-general-cookie"
+></A
+><B
 >A.1.11. </B
 >
 	    Is there an easy way to change the Bugzilla cookie name?
@@ -967,7 +992,9 @@ CLASS="answer"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-phb">2. Managerial Questions</H3
+NAME="faq-phb"
+></A
+>2. Managerial Questions</H3
 ><P
 >&#13;	<DIV
 CLASS="note"
@@ -1004,7 +1031,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-client"><B
+NAME="faq-phb-client"
+></A
+><B
 >A.2.1. </B
 >
 	    Is Bugzilla web-based, or do you have to have specific software or
@@ -1028,7 +1057,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-integration"><B
+NAME="faq-phb-integration"
+></A
+><B
 >A.2.2. </B
 >
 	    Can Bugzilla integrate with
@@ -1052,7 +1083,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-projects"><B
+NAME="faq-phb-projects"
+></A
+><B
 >A.2.3. </B
 >
 	    Does Bugzilla allow the user to track multiple projects?
@@ -1075,7 +1108,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-sorting"><B
+NAME="faq-phb-sorting"
+></A
+><B
 >A.2.4. </B
 >
 	    If I am on many projects, and search for all bugs assigned to me, will
@@ -1098,7 +1133,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-attachments"><B
+NAME="faq-phb-attachments"
+></A
+><B
 >A.2.5. </B
 >
 	    Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes,
@@ -1125,7 +1162,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-priorities"><B
+NAME="faq-phb-priorities"
+></A
+><B
 >A.2.6. </B
 >
 	    Does Bugzilla allow us to define our own priorities and levels? Do we
@@ -1160,7 +1199,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-reporting"><B
+NAME="faq-phb-reporting"
+></A
+><B
 >A.2.7. </B
 >
 	    Does Bugzilla provide any reporting features, metrics, graphs, etc? You
@@ -1196,7 +1237,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-email"><B
+NAME="faq-phb-email"
+></A
+><B
 >A.2.8. </B
 >
 	    Is there email notification and if so, what do you see when you get an
@@ -1221,7 +1264,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-cclist"><B
+NAME="faq-phb-cclist"
+></A
+><B
 >A.2.9. </B
 >
 	    Can email notification be set up to send to multiple
@@ -1244,7 +1289,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-emailapp"><B
+NAME="faq-phb-emailapp"
+></A
+><B
 >A.2.10. </B
 >
 	    Do users have to have any particular
@@ -1301,7 +1348,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-data"><B
+NAME="faq-phb-data"
+></A
+><B
 >A.2.11. </B
 >
 	    Does Bugzilla allow data to be imported and exported? If I had outsiders
@@ -1361,7 +1410,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-l10n"><B
+NAME="faq-phb-l10n"
+></A
+><B
 >A.2.12. </B
 >
 	    Has anyone converted Bugzilla to another language to be used in other
@@ -1397,7 +1448,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-reports"><B
+NAME="faq-phb-reports"
+></A
+><B
 >A.2.13. </B
 >
 	    Can a user create and save reports? Can they do this in Word format?
@@ -1420,7 +1473,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-searching"><B
+NAME="faq-phb-searching"
+></A
+><B
 >A.2.14. </B
 >
 	    Does Bugzilla have the ability to search by word, phrase, compound
@@ -1444,7 +1499,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-midair"><B
+NAME="faq-phb-midair"
+></A
+><B
 >A.2.15. </B
 >
 	     Does Bugzilla provide record locking when there is simultaneous access
@@ -1469,7 +1526,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-backup"><B
+NAME="faq-phb-backup"
+></A
+><B
 >A.2.16. </B
 >
 	    Are there any backup features provided?
@@ -1497,7 +1556,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-livebackup"><B
+NAME="faq-phb-livebackup"
+></A
+><B
 >A.2.17. </B
 >
 	    Can users be on the system while a backup is in progress?
@@ -1521,7 +1582,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-maintenance"><B
+NAME="faq-phb-maintenance"
+></A
+><B
 >A.2.18. </B
 >
 	    What type of human resources are needed to be on staff to install and
@@ -1554,7 +1617,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-installtime"><B
+NAME="faq-phb-installtime"
+></A
+><B
 >A.2.19. </B
 >
 	    What time frame are we looking at if we decide to hire people to install
@@ -1585,7 +1650,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-phb-cost"><B
+NAME="faq-phb-cost"
+></A
+><B
 >A.2.20. </B
 >
 	    Is there any licensing fee or other fees for using Bugzilla? Any
@@ -1608,14 +1675,18 @@ CLASS="answer"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-security">3. Bugzilla Security</H3
+NAME="faq-security"
+></A
+>3. Bugzilla Security</H3
 ><DIV
 CLASS="qandaentry"
 ><DIV
 CLASS="question"
 ><P
 ><A
-NAME="faq-security-mysql"><B
+NAME="faq-security-mysql"
+></A
+><B
 >A.3.1. </B
 >
 	    How do I completely disable MySQL security if it's giving me problems
@@ -1642,7 +1713,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-security-knownproblems"><B
+NAME="faq-security-knownproblems"
+></A
+><B
 >A.3.2. </B
 >
 	    Are there any security problems with Bugzilla?
@@ -1668,7 +1741,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-security-mysqluser"><B
+NAME="faq-security-mysqluser"
+></A
+><B
 >A.3.3. </B
 >
 	    I've implemented the security fixes mentioned in Chris Yeh's security
@@ -1693,14 +1768,18 @@ CLASS="answer"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-email">4. Bugzilla Email</H3
+NAME="faq-email"
+></A
+>4. Bugzilla Email</H3
 ><DIV
 CLASS="qandaentry"
 ><DIV
 CLASS="question"
 ><P
 ><A
-NAME="faq-email-nomail"><B
+NAME="faq-email-nomail"
+></A
+><B
 >A.4.1. </B
 >
 	    I have a user who doesn't want to receive any more email from Bugzilla.
@@ -1728,7 +1807,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-email-testing"><B
+NAME="faq-email-testing"
+></A
+><B
 >A.4.2. </B
 >
 	    I'm evaluating/testing Bugzilla, and don't want it to send email to
@@ -1752,7 +1833,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-email-whine"><B
+NAME="faq-email-whine"
+></A
+><B
 >A.4.3. </B
 >
 	    I want whineatnews.pl to whine at something more, or other than, only new
@@ -1783,7 +1866,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-email-procmail"><B
+NAME="faq-email-procmail"
+></A
+><B
 >A.4.4. </B
 >
 	    I don't like/want to use Procmail to hand mail off to bug_email.pl.
@@ -1799,7 +1884,9 @@ CLASS="answer"
 	    You can call bug_email.pl directly from your aliases file, with
 	    an entry like this:
 	    <A
-NAME="AEN2067"><BLOCKQUOTE
+NAME="AEN2067"
+></A
+><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ><P
 >&#13;		bugzilla-daemon: "|/usr/local/bin/bugzilla/contrib/bug_email.pl"
@@ -1818,7 +1905,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-email-mailif"><B
+NAME="faq-email-mailif"
+></A
+><B
 >A.4.5. </B
 >
 	    How do I set up the email interface to submit/change bugs via email?
@@ -1841,7 +1930,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-email-sendmailnow"><B
+NAME="faq-email-sendmailnow"
+></A
+><B
 >A.4.6. </B
 >
 	    Email takes FOREVER to reach me from Bugzilla -- it's extremely slow.
@@ -1900,7 +1991,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-email-nonreceived"><B
+NAME="faq-email-nonreceived"
+></A
+><B
 >A.4.7. </B
 >
 	     How come email from Bugzilla changes never reaches me?
@@ -1929,14 +2022,18 @@ CLASS="answer"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-db">5. Bugzilla Database</H3
+NAME="faq-db"
+></A
+>5. Bugzilla Database</H3
 ><DIV
 CLASS="qandaentry"
 ><DIV
 CLASS="question"
 ><P
 ><A
-NAME="faq-db-oracle"><B
+NAME="faq-db-oracle"
+></A
+><B
 >A.5.1. </B
 >
 	    I've heard Bugzilla can be used with Oracle?
@@ -1962,7 +2059,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-db-corrupted"><B
+NAME="faq-db-corrupted"
+></A
+><B
 >A.5.2. </B
 >
 	    I think my database might be corrupted, or contain invalid entries. What
@@ -2007,7 +2106,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-db-manualedit"><B
+NAME="faq-db-manualedit"
+></A
+><B
 >A.5.3. </B
 >
 	    I want to manually edit some entries in my database. How?
@@ -2046,7 +2147,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-db-permissions"><B
+NAME="faq-db-permissions"
+></A
+><B
 >A.5.4. </B
 >
 	    I think I've set up MySQL permissions correctly, but Bugzilla still can't
@@ -2105,7 +2208,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-db-synchronize"><B
+NAME="faq-db-synchronize"
+></A
+><B
 >A.5.5. </B
 >
 	    How do I synchronize bug information among multiple different Bugzilla
@@ -2140,14 +2245,18 @@ CLASS="answer"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-nt">6. Bugzilla and Win32</H3
+NAME="faq-nt"
+></A
+>6. Bugzilla and Win32</H3
 ><DIV
 CLASS="qandaentry"
 ><DIV
 CLASS="question"
 ><P
 ><A
-NAME="faq-nt-easiest"><B
+NAME="faq-nt-easiest"
+></A
+><B
 >A.6.1. </B
 >
 	    What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
@@ -2170,7 +2279,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-nt-bundle"><B
+NAME="faq-nt-bundle"
+></A
+><B
 >A.6.2. </B
 >
 	    Is there a "Bundle::Bugzilla" equivalent for Win32?
@@ -2194,7 +2305,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-nt-mappings"><B
+NAME="faq-nt-mappings"
+></A
+><B
 >A.6.3. </B
 >
 	    CGI's are failing with a "something.cgi is not a valid Windows NT
@@ -2215,7 +2328,9 @@ CLASS="answer"
 ><P
 >&#13;	    Microsoft has some advice on this matter, as well:
 	    <A
-NAME="AEN2150"><BLOCKQUOTE
+NAME="AEN2150"
+></A
+><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
 ><P
 >&#13;		"Set application mappings. In the ISM, map the extension for the script
@@ -2238,7 +2353,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-nt-dbi"><B
+NAME="faq-nt-dbi"
+></A
+><B
 >A.6.4. </B
 >
 	    I'm having trouble with the perl modules for NT not being able to talk to
@@ -2304,14 +2421,18 @@ TARGET="_top"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-use">7. Bugzilla Usage</H3
+NAME="faq-use"
+></A
+>7. Bugzilla Usage</H3
 ><DIV
 CLASS="qandaentry"
 ><DIV
 CLASS="question"
 ><P
 ><A
-NAME="faq-use-changeaddress"><B
+NAME="faq-use-changeaddress"
+></A
+><B
 >A.7.1. </B
 >
 	    How do I change my user name (email address) in Bugzilla?
@@ -2334,7 +2455,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-use-query"><B
+NAME="faq-use-query"
+></A
+><B
 >A.7.2. </B
 >
 	    The query page is very confusing. Isn't there a simpler way to query?
@@ -2358,7 +2481,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-use-accept"><B
+NAME="faq-use-accept"
+></A
+><B
 >A.7.3. </B
 >
 	    I'm confused by the behavior of the "accept" button in the Show Bug form.
@@ -2410,7 +2535,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-use-attachment"><B
+NAME="faq-use-attachment"
+></A
+><B
 >A.7.4. </B
 >
 	    I can't upload anything into the database via the "Create Attachment"
@@ -2435,7 +2562,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-use-keyword"><B
+NAME="faq-use-keyword"
+></A
+><B
 >A.7.5. </B
 >
 	    How do I change a keyword in Bugzilla, once some bugs are using it?
@@ -2459,7 +2588,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-use-close"><B
+NAME="faq-use-close"
+></A
+><B
 >A.7.6. </B
 >
         Why can't I close bugs from the "Change Several Bugs at Once" page?
@@ -2493,14 +2624,18 @@ CLASS="answer"
 CLASS="qandadiv"
 ><H3
 ><A
-NAME="faq-hacking">8. Bugzilla Hacking</H3
+NAME="faq-hacking"
+></A
+>8. Bugzilla Hacking</H3
 ><DIV
 CLASS="qandaentry"
 ><DIV
 CLASS="question"
 ><P
 ><A
-NAME="faq-hacking-templatestyle"><B
+NAME="faq-hacking-templatestyle"
+></A
+><B
 >A.8.1. </B
 >
 	    What kind of style should I use for templatization?
@@ -2557,7 +2692,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-hacking-bugzillabugs"><B
+NAME="faq-hacking-bugzillabugs"
+></A
+><B
 >A.8.2. </B
 >
 	    What bugs are in Bugzilla right now?
@@ -2601,7 +2738,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-hacking-priority"><B
+NAME="faq-hacking-priority"
+></A
+><B
 >A.8.3. </B
 >
 	    How can I change the default priority to a null value?  For instance, have the default
@@ -2630,7 +2769,9 @@ CLASS="qandaentry"
 CLASS="question"
 ><P
 ><A
-NAME="faq-hacking-patches"><B
+NAME="faq-hacking-patches"
+></A
+><B
 >A.8.4. </B
 >
 	    What's the best way to submit patches?  What guidelines should I follow?