summaryrefslogtreecommitdiffstats
path: root/docs/sgml/faq.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/sgml/faq.sgml')
-rw-r--r--docs/sgml/faq.sgml263
1 files changed, 71 insertions, 192 deletions
diff --git a/docs/sgml/faq.sgml b/docs/sgml/faq.sgml
index f7fafd3e8..91380863f 100644
--- a/docs/sgml/faq.sgml
+++ b/docs/sgml/faq.sgml
@@ -3,6 +3,10 @@
<appendix id="faq">
<title>The Bugzilla FAQ</title>
+ <para>
+ This FAQ includes questions not covered elsewhere in the Guide.
+ </para>
+
<qandaset>
@@ -121,9 +125,9 @@
</question>
<answer>
<para>
- A year has gone by, and I <emphasis>still</emphasis> can't
- find any head-to-head comparisons of Bugzilla against
- other defect-tracking software. However, from my personal
+ We can't find any head-to-head comparisons of Bugzilla against
+ other defect-tracking software. If you know of one, please
+ get in touch. However, from the author's personal
experience with other bug-trackers, Bugzilla offers
superior performance on commodity hardware, better price
(free!), more developer- friendly features (such as stored
@@ -133,24 +137,9 @@
</para>
<para>
If you happen to be a commercial bug-tracker vendor, please
- step forward with a rebuttal so I can include it in the
- FAQ. We're not in pursuit of Bugzilla ueber alles; we
- simply love having a powerful, open-source tool to get our
- jobs done.
- </para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>
- How do I change my user name (email address) in Bugzilla?
- </para>
- </question>
- <answer>
- <para>
- New in 2.16 - go to the Account section of the Preferences. You will
- be emailed at both addresses for confirmation.
+ step forward with a list of advantages your product has over
+ Bugzilla. We'd be happy to include it in the "Competitors"
+ section.
</para>
</answer>
</qandaentry>
@@ -184,7 +173,7 @@
<question>
<para>
Why MySQL? I'm interested in seeing Bugzilla run on
- Oracle/Sybase/Msql/PostgreSQL/MSSQL?
+ Oracle/Sybase/Msql/PostgreSQL/MSSQL.
</para>
</question>
<answer>
@@ -204,42 +193,41 @@
</question>
<answer>
<para>
- Mozilla.org uses /usr/bonsaitools/bin/perl. The prime rule in making
- submissions is "don't break bugzilla.mozilla.org". If it breaks it, your
- patch will be reverted faster than you can do a diff.
- </para>
- <para>
- Here's Terry Weissman's comment, for some historical context:
- <blockquote>
- <para>
- [This was] purely my own convention. I wanted a place to put a version of
- Perl and other tools that was strictly under my control for the
- various webtools, and not subject to anyone else. Edit it to point
- to whatever you like.
- </para>
- <note>
+ Mozilla.org uses /usr/bonsaitools/bin/perl, because originally
+ Terry wanted a place to put a version of Perl and other tools
+ that was strictly under his control.
+ </para>
<para>
We always recommend that, if possible, you keep the path
- as /usr/bonsaitools/bin/perl, and simply add a /usr/bonsaitools
- and /usr/bonsaitools/bin directory, then symlink your version
- of perl to /usr/bonsaitools/bin/perl. This will make upgrading
+ as /usr/bonsaitools/bin/perl, and simply add symlink.
+ This will make upgrading
your Bugzilla much easier in the future.
</para>
- </note>
- </blockquote>
- </para>
</answer>
</qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
+ Is there an easy way to change the Bugzilla cookie name?
+ </para>
+ </question>
+ <answer>
+ <para>
+ At present, no.
+ </para>
+ </answer>
+ </qandaentry>
+
</qandadiv>
<qandadiv id="faq-phb">
- <title>Pointy-Haired-Boss Questions</title>
+ <title>Managerial Questions</title>
<para>
<note>
<para>
- The title of this section doesn't mean you're a PHB -- it just means
- you probably HAVE a PHB who wants to know this :)
+ Questions likely to be asked by managers. :-)
</para>
</note>
</para>
@@ -247,8 +235,8 @@
<qandaentry>
<question>
<para>
- Is Bugzilla web-based or do you have to have specific software or
- specific operating system on your machine?
+ Is Bugzilla web-based, or do you have to have specific software or
+ a specific operating system on your machine?
</para>
</question>
<answer>
@@ -262,7 +250,7 @@
<qandaentry>
<question>
<para>
- Has anyone you know of already done any Bugzilla integration with
+ Can Bugzilla integrate with
Perforce (SCM software)?
</para>
</question>
@@ -282,11 +270,10 @@
</question>
<answer>
<para>
- Absolutely! You can track up to a "soft-limit" of around
- 64 individual "Products", that can each be composed of as
- many "Components" as you want. Check the Administration
- section of the Bugzilla Guide for more information regarding
- setting up Products and Components.
+ Absolutely! You can track any number of Products (although you
+ are limited to about 55 or so if
+ you are using Product-Based Groups), that can each be composed of any
+ number of Components.
</para>
</answer>
</qandaentry>
@@ -308,7 +295,7 @@
<qandaentry>
<question>
<para>
- Does Bugzilla allow attachments (text, screenshots, urls etc)? If yes,
+ Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes,
are there any that are NOT allowed?
</para>
</question>
@@ -346,19 +333,6 @@
</answer>
</qandaentry>
-
- <qandaentry>
- <question>
- <para>
- The index.html page doesn't show the footer. It's really annoying to have
- to go to the querypage just to check my "my bugs" link.
- </para>
- </question>
- <answer>
- <para>If you upgrade to 2.16, the index page has a footer.
- </para>
- </answer>
- </qandaentry>
<qandaentry>
<question>
<para>
@@ -370,7 +344,7 @@
<para>
Yes. Look at <ulink url="http://bugzilla.mozilla.org/reports.cgi">
http://bugzilla.mozilla.org/reports.cgi</ulink> for basic reporting
- facilities.
+ and graphing facilities.
</para>
<para>
For more advanced reporting, I recommend hooking up a professional
@@ -387,7 +361,7 @@
<question>
<para>
Is there email notification and if so, what do you see when you get an
- email? Do you see bug number and title or is it only the number?
+ email?
</para>
</question>
<answer>
@@ -416,7 +390,7 @@
<qandaentry>
<question>
<para>
- If there is email notification, do users have to have any particular
+ Do users have to have any particular
type of email application?
</para>
</question>
@@ -441,24 +415,6 @@
<qandaentry>
<question>
<para>
- If I just wanted to track certain bugs, as they go through life, can I
- set it up to alert me via email whenever that bug changes, whether it be
- owner, status or description etc.?
- </para>
- </question>
- <answer>
- <para>
- Yes. Place yourself in the "cc" field of the bug you wish to monitor.
- Then change your "Notify me of changes to" field in the Email Settings
- tab of the User Preferences screen in Bugzilla to the "Only those
- bugs which I am listed on the CC line" option.
- </para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>
Does Bugzilla allow data to be imported and exported? If I had outsiders
write up a bug report using a MS Word bug template, could that template be
imported into "matching" fields? If I wanted to take the results of a query
@@ -523,33 +479,6 @@
<qandaentry>
<question>
<para>
- Can a user re-run a report with a new project, same query?
- </para>
- </question>
- <answer>
- <para>
- Yes.
- </para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>
- Can a user modify an existing report and then save it into another name?
- </para>
- </question>
- <answer>
- <para>
- You can save an unlimited number of queries in Bugzilla. You are free
- to modify them and rename them to your heart's desire.
- </para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>
Does Bugzilla have the ability to search by word, phrase, compound
search?
</para>
@@ -565,20 +494,6 @@
<qandaentry>
<question>
<para>
- Can the admin person establish separate group and individual user
- privileges?
- </para>
- </question>
- <answer>
- <para>
- Yes.
- </para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>
Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use
or how are they notified?
@@ -635,9 +550,8 @@
</question>
<answer>
<para>
- If Bugzilla is set up correctly from the start, continuing maintenance needs
- are minimal and can be completed by unskilled labor. Things like rotate
- backup tapes and check log files for the word "error".
+ If Bugzilla is set up correctly from the start, continuing maintenance
+ needs are minimal and can be done easily using the web interface.
</para>
<para>
Commercial Bug-tracking software typically costs somewhere upwards
@@ -686,52 +600,6 @@
</qandaentry>
</qandadiv>
- <qandadiv id="faq-install">
- <title>Bugzilla Installation</title>
- <qandaentry>
- <question>
- <para>
- How do I download and install Bugzilla?
- </para>
- </question>
- <answer>
- <para>
- Check <ulink url="http://www.bugzilla.org/">
- http://www.bugzilla.org/</ulink> for details.
- Read the other parts of this Guide for installation instructions.
- </para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>
- How do I install Bugzilla on Windows NT?
- </para>
- </question>
- <answer>
- <para>
- Installation on Windows NT has its own section in
- this document.
- </para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>
- Is there an easy way to change the Bugzilla cookie name?
- </para>
- </question>
- <answer>
- <para>
- At present, no.
- </para>
- </answer>
- </qandaentry>
-
- </qandadiv>
-
<qandadiv id="faq-security">
<title>Bugzilla Security</title>
@@ -739,15 +607,14 @@
<question>
<para>
How do I completely disable MySQL security if it's giving me problems
- (I've followed the instructions in the installation section of this guide!)?
+ (I've followed the instructions in the installation section of this guide)?
</para>
</question>
<answer>
<para>
Run MySQL like this: "mysqld --skip-grant-tables". Please remember <emphasis>this
makes MySQL as secure as taping a $100 to the floor of a football stadium
- bathroom for safekeeping.</emphasis> Please read the Security section of the
- Administration chapter of "The Bugzilla Guide" before proceeding.
+ bathroom for safekeeping.</emphasis>
</para>
</answer>
</qandaentry>
@@ -815,8 +682,8 @@
</question>
<answer>
<para>
- Edit the "changedmail" param. Replace "To:" with "X-Real-To:",
- replace "Cc:" with "X-Real-CC:", and add a "To: (myemailaddress)".
+ Edit the "changedmail" Param. Replace "To:" with "X-Real-To:",
+ replace "Cc:" with "X-Real-CC:", and add a "To: &lt;youremailaddress&gt;".
</para>
</answer>
</qandaentry>
@@ -1002,7 +869,7 @@
<qandaentry>
<question>
<para>
- I think I've set up MySQL permissions correctly, but bugzilla still can't
+ I think I've set up MySQL permissions correctly, but Bugzilla still can't
connect.
</para>
</question>
@@ -1162,6 +1029,20 @@
<qandaentry>
<question>
<para>
+ How do I change my user name (email address) in Bugzilla?
+ </para>
+ </question>
+ <answer>
+ <para>
+ New in 2.16 - go to the Account section of the Preferences. You will
+ be emailed at both addresses for confirmation.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
The query page is very confusing. Isn't there a simpler way to query?
</para>
</question>
@@ -1184,7 +1065,7 @@
<answer>
<para>
The current behavior is acceptable to bugzilla.mozilla.org and most
- users. I personally don't like it. You have your choice of patches
+ users. You have your choice of patches
to change this behavior, however.
<simplelist>
<member><ulink url="http://bugzilla.mozilla.org/showattachment.cgi?attach_id=8029">
@@ -1192,8 +1073,8 @@
<member><ulink url="http://bugzilla.mozilla.org/showattachment.cgi?attach_id=8153">
"Accept" button automatically assigns to you</ulink></member>
</simplelist>
- Note that these patches are somewhat dated. You will need to do the find
- and replace manually to apply them. They are very small, though. It is easy.
+ Note that these patches are somewhat dated. You will need to apply
+ them manually.
</para>
</answer>
</qandaentry>
@@ -1224,7 +1105,7 @@
<answer>
<para>
Yup. Just rename it once you download it, or save it under a different
- filename. This will not be fixed anytime too soon, because it would
+ filename. This will not be fixed anytime soon, because it would
cripple some other functionality.
</para>
</answer>
@@ -1288,9 +1169,7 @@
http://bugzilla.mozilla.org/show_bug.cgi?id=49862</ulink>. Ultimately, it's as easy
as adding the "---" priority field to your localconfig file in the appropriate area,
re-running checksetup.pl, and then changing the default priority in your browser using
- "editparams.cgi". Hmm, now that I think about it, that is kind of a klunky way to handle
- it, but for now it's what we have! Although the bug has been closed "RESOLVED WONTFIX",
- there may be a better way to handle this...
+ "editparams.cgi".
</para>
</answer>
</qandaentry>
@@ -1325,7 +1204,7 @@
<listitem>
<para>
Announce your patch and the associated URL
- (http://bugzilla.mozilla.org/show_bug.cgi?id=XXXX) for discussion in
+ (http://bugzilla.mozilla.org/show_bug.cgi?id=XXXXXX) for discussion in
the newsgroup (netscape.public.mozilla.webtools). You'll get a really
good, fairly immediate reaction to the implications of your patch,
which will also give us an idea how well-received the change would