From 4bbb07e8048ef859cfc29c6b9d221840f2c6aed1 Mon Sep 17 00:00:00 2001 From: "gerv%gerv.net" <> Date: Fri, 16 Jan 2004 06:34:12 +0000 Subject: Phase 1 of a big documentation update before 2.17.6. --- docs/xml/faq.xml | 199 ++++++------------------------------------------------- 1 file changed, 20 insertions(+), 179 deletions(-) (limited to 'docs/xml/faq.xml') diff --git a/docs/xml/faq.xml b/docs/xml/faq.xml index e2cebd647..d00a8e8f3 100644 --- a/docs/xml/faq.xml +++ b/docs/xml/faq.xml @@ -13,19 +13,6 @@ General Questions - - - - Where can I find information about Bugzilla? - - - - You can stay up-to-date with the latest Bugzilla - information at . - - - - @@ -52,12 +39,6 @@ is a list of people and companies who have asked us to list them as consultants for Bugzilla. - - offers - Bugzilla as part of their standard offering to large projects. - They do have some minimum fees that are pretty hefty, and generally - aren't interested in small projects. - There are several experienced Bugzilla hackers on the mailing list/newsgroup who are willing @@ -79,11 +60,10 @@ There are dozens of major companies with public Bugzilla sites to track bugs in their products. We have a fairly complete list available on our website at - . If you + . 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 ;). + Gerv gerv@mozilla.org. @@ -241,13 +221,6 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl Managerial Questions - - - - Questions likely to be asked by managers. :-) - - - @@ -258,69 +231,7 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl - It is web and e-mail based. You can edit bugs by sending specially - formatted email to a properly configured Bugzilla, or control via the web. - - - - - - - - Can Bugzilla integrate with - Perforce (SCM software)? - - - - - Yes! You can find more information elsewhere in "The Bugzilla - Guide" in the "Integration with Third-Party Products" section. - - - - - - - - Does Bugzilla allow the user to track multiple projects? - - - - - Absolutely! You can track any number of Products that can each be - composed of any number of Components. - - - - - - - - If I am on many projects, and search for all bugs assigned to me, will - Bugzilla list them for me and allow me to sort by project, severity etc? - - - - - Yes. - - - - - - - - Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes, - are there any that are NOT allowed? - - - - - Yes - any sort of attachment is allowed, although administrators can - configure a maximum size. - Bugzilla gives the user the option of either using the MIME-type - supplied by the browser, choosing from a pre-defined list or - manually typing any arbitrary MIME-type. + It is web and e-mail based. @@ -380,26 +291,12 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl Email notification is user-configurable. By default, the bug id and - Summary of the bug report accompany each email notification, along with + summary of the bug report accompany each email notification, along with a list of the changes made. - - - - Can email notification be set up to send to multiple - people, some on the To List, CC List, BCC List etc? - - - - - Yes. - - - - @@ -439,13 +336,13 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl Bugzilla can output buglists as HTML (the default), CSV or RDF. The link for CSV can be found at the bottom of the buglist in HTML format. This CSV format can easily be imported into MS Excel or - other spread-sheet applications. + other spreadsheet applications. To use the RDF format of the buglist it is necessary to append a &ctype=rdf to the URL. RDF is meant to be machine readable and thus it is assumed that the - URL would be generated progmatically so there is no user visible + URL would be generated programatically so there is no user visible link to this format. @@ -499,21 +396,6 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl - - - - Does Bugzilla have the ability to search by word, phrase, compound - search? - - - - - You have no idea. Bugzilla's query interface, particularly with the - advanced Boolean operators, is incredibly versatile. - - - - @@ -567,7 +449,7 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl maintain Bugzilla? Specifically, what type of skills does the person need to have? I need to find out if we were to go with Bugzilla, what types of individuals would we need to hire and how much would that cost vs buying an - "Out-of-the-Box" solution. + "out-of-the-box" solution? @@ -657,24 +539,6 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl - - - - - - I've implemented the security fixes mentioned in Chris Yeh's security - advisory of 5/10/2000 advising not to run MySQL as root, and am running into - problems with MySQL no longer working correctly. - - - - - This is a common problem, related to running out of file descriptors. - Simply add "ulimit -n unlimited" to the script which starts - mysqld. - - - @@ -714,7 +578,7 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl - I want whineatnews.pl to whine at something more, or other than, only new + I want whineatnews.pl to whine at something different to only new bugs. How do I do it? @@ -730,29 +594,6 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl - - - - I don't like/want to use Procmail to hand mail off to bug_email.pl. - What alternatives do I have? - - - - - You can call bug_email.pl directly from your aliases file, with - an entry like this: -
- - bugzilla-daemon: "|/usr/local/bin/bugzilla/contrib/bug_email.pl" - -
- However, this is fairly nasty and subject to problems; you also - need to set up your smrsh (sendmail restricted shell) to allow - it. In a pinch, though, it can work. -
-
-
- @@ -775,6 +616,11 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl + + If you are using sendmail, try enabling + in editparams.cgi. + + If you are using an alternate MTA, make sure the options given in Bugzilla/BugMail.pm @@ -782,11 +628,6 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl are correct for your MTA. You should also ensure that the param is set to on. - - If you are using sendmail, try enabling - in editparams.cgi. - - @@ -804,7 +645,7 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl button after entering your email address. - If you never receive mail from Bugzilla, chances you do not have + If you never receive mail from Bugzilla, chances are you do not have sendmail in "/usr/lib/sendmail". Ensure sendmail lives in, or is symlinked to, "/usr/lib/sendmail". @@ -823,11 +664,12 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl - Red Hat's old version of Bugzilla (based on 2.8) worked on Oracle. + Red Hat's old version of Bugzilla (based on 2.8) worked on Oracle, + but it is now so old as to be obsolete, and is totally unsupported. Red Hat's newer version (based on 2.17.1 and soon to be merged into the main distribution) runs on PostgreSQL. At this time we know of - no recent ports of Bugzilla to Oracle but do intend to support it - in the future (possibly the 2.20 time-frame). + no recent ports of Bugzilla to Oracle; to be honest, Bugzilla + doesn't need what Oracle offers. @@ -842,9 +684,8 @@ perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl Run the sanity check utility - (./sanitycheck.cgi in the - Bugzilla_home directory) from your web browser to see! If - it finishes without errors, you're + (sanitycheck.cgi) from your web browser to see! + If it finishes without errors, you're probably OK. If it doesn't come back OK (i.e. any red letters), there are certain things Bugzilla can recover from and certain things it can't. If -- cgit v1.2.3-24-g4f1b