From 1b2aa767929784a37212b9e3dc01f9e119c4a9d6 Mon Sep 17 00:00:00 2001 From: "gerv%gerv.net" <> Date: Sun, 22 Dec 2002 00:33:39 +0000 Subject: Rebuild HTML and text versions of documentation for 2.17.2 release. --- docs/html/Bugzilla-Guide.html | 1858 ++++++++++++++++++++++++------------ docs/html/about.html | 4 +- docs/html/administration.html | 27 +- docs/html/cmdline.html | 4 +- docs/html/conventions.html | 8 +- docs/html/copyright.html | 68 +- docs/html/credits.html | 4 +- docs/html/cust-templates.html | 45 +- docs/html/database.html | 18 +- docs/html/dbdoc.html | 27 +- docs/html/disclaimer.html | 4 +- docs/html/extraconfig.html | 135 ++- docs/html/faq.html | 471 ++++++--- docs/html/glossary.html | 68 +- docs/html/groups.html | 81 +- docs/html/hintsandtips.html | 24 +- docs/html/how.html | 24 +- docs/html/index.html | 37 +- docs/html/installation.html | 42 +- docs/html/integration.html | 20 +- docs/html/introduction.html | 4 +- docs/html/newversions.html | 4 +- docs/html/osx.html | 4 +- docs/html/parameters.html | 78 +- docs/html/patches.html | 4 +- docs/html/programadmin.html | 20 +- docs/html/rewrite.html | 4 +- docs/html/rhbugzilla.html | 4 +- docs/html/security.html | 4 +- docs/html/stepbystep.html | 180 +++- docs/html/troubleshooting.html | 16 +- docs/html/upgrading.html | 14 +- docs/html/useradmin.html | 77 +- docs/html/userpreferences.html | 20 +- docs/html/using.html | 4 +- docs/html/variant-fenris.html | 4 +- docs/html/variant-issuezilla.html | 4 +- docs/html/variant-perforce.html | 4 +- docs/html/variant-scarab.html | 4 +- docs/html/variant-sourceforge.html | 4 +- docs/html/variants.html | 4 +- docs/html/voting.html | 4 +- docs/html/whatis.html | 4 +- docs/html/why.html | 4 +- docs/html/win32.html | 144 +-- 45 files changed, 2374 insertions(+), 1212 deletions(-) (limited to 'docs/html') diff --git a/docs/html/Bugzilla-Guide.html b/docs/html/Bugzilla-Guide.html index 66bb333ec..bc8f148cd 100644 --- a/docs/html/Bugzilla-Guide.html +++ b/docs/html/Bugzilla-Guide.html @@ -34,25 +34,35 @@ ALINK="#0000FF" >
This is the documentation for Bugzilla, the mozilla.org @@ -239,11 +249,16 @@ HREF="#cust-templates" >
Users of older versions of Apache may find the above lines - in the srm.conf and access.conf files, respecitvely.
You should untar the Bugzilla files into a directory that you're willing to make writable by the default web server user (probably @@ -3550,6 +3698,64 @@ CLASS="filename" for Perl. This can be done using the following Perl one-liner, but I suggest using the symlink approach to avoid upgrade hassles.
"Bonsaitools" is the name Terry Weissman, the + original author of Bugzilla, created + for his suite of webtools at the time he created Bugzilla and several + other tools in use at mozilla.org. He created a directory, + /usr/bonsaitools to house his specific versions + of perl and other utilities. This usage is still current at + bugzilla.mozilla.org, + but in general most other places do not use it. You can either edit + the paths at the start of each perl file to the correct location of + perl on your system, or simply bow to history and create a + /usr/bonsaitools and /usr/bonsaitools/bin + directory, placing a symlink to perl on your system + inside /usr/bonsaitools/bin + |
-binmode(STDIN); -binmode(STDOUT); - - |
According to - bug 62000 - - , the perl documentation says that you should always use - binmode() - - when dealing with binary files, but never when dealing with text - files. That seems to suggest that rather than arbitrarily putting - - binmode() - - at the beginning of the attachment files, there should be logic - to determine if - binmode() - - is needed or not. |
4.3.2. Additional Windows Tips4.3.2. Additional Windows Tips
|
mysql> - use bugs; - |
mysql> - - update profiles set groupset=0x7ffffffffffffff where login_name = - "(user's login name)"; - - |
Yes, that is - fourteen - - "f" - - 's. A whole lot of f-ing going on if you want to create a new - administator.
Your users can create their own user accounts by clicking the "New Account" link at the bottom of each page (assuming they @@ -7216,7 +7397,9 @@ CLASS="section" >
To see a specific user, search for their login name in the box provided on the "Edit Users" page. To see all users, @@ -7445,13 +7628,17 @@ CLASS="section" >
5.3.2. Components
5.3.2. Components
Components are subsections of a Product. E.g. the computer game you are designing may have a "UI" @@ -7558,7 +7747,9 @@ CLASS="section" >
Versions are the revisions of the product, such as "Flinders 3.1", "Flinders 95", and "Flinders 2000". Version is not a multi-select @@ -7592,7 +7783,9 @@ CLASS="section" >
Milestones are "targets" that you plan to get a bug fixed by. For example, you have a bug that you plan to fix for your 3.0 release, it @@ -7693,7 +7886,9 @@ CLASS="section" >
Voting allows users to be given a pot of votes which they can allocate to bugs, to indicate that they'd like them fixed. @@ -7753,7 +7948,9 @@ CLASS="section" >
Groups allow the administrator to isolate bugs or products that should only be seen by certain people. @@ -7792,22 +7989,10 @@ TYPE="1" >
Fill out the "New Name", "New Description", and - "New User RegExp" fields. "New User RegExp" allows you to automatically +>Fill out the "Group", "Description", and + "User RegExp" fields. "New User RegExp" allows you to automatically place all users who fulfill the Regular Expression into the new group. When you have finished, click "Add".
To use Product-Based Groups:
Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit - Parameters" screen.
XXX is this still true? - "usebuggroupsentry" has the capacity to prevent the - administrative user from directly altering bugs because of - conflicting group permissions. If you plan on using - "usebuggroupsentry", you should plan on restricting - administrative account usage to administrative duties only. In - other words, manage bugs with an unpriveleged user account, and - manage users, groups, Products, etc. with the administrative - account.
The User Regexp is a perl regexp and, if not anchored, will match + any part of an address. So, if you do not want to grant access + into 'mycompany.com' to 'badperson@mycompany.com.hacker.net', use + '@mycompany\.com$' as the regexp.After you add your new group, edit the new group. On the + edit page, you can specify other groups that should be included + in this group and which groups should be permitted to add and delete + users from this group.
To use Product-Based Groups:
Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit + Parameters" screen.
In future, when you create a Product, a matching group will be automatically created. If you need to add a Product Group to a Product which was created before you turned on usebuggroups, @@ -7852,35 +8051,6 @@ VALIGN="TOP" same name as the Product.
Bugzilla currently has a limit of 64 groups per installation. If - you have more than about 50 products, you should consider - running multiple Bugzillas. Ask in the newsgroup for other - suggestions for working around this restriction. |
Note that group permissions are such that you need to be a member
of
One of the large changes for 2.16 was the templatisation of the
entire user-facing UI, using the
@@ -8201,7 +8375,9 @@ CLASS="section"
>
There are two different ways of editing of Bugzilla's templates,
and which you use depends mainly on how you upgrade Bugzilla. The
@@ -8314,7 +8490,9 @@ CLASS="section"
>
The syntax of the Template Toolkit language is beyond the scope of
this guide. It's reasonably easy to pick up by looking at the current
@@ -8394,7 +8572,9 @@ CLASS="section"
>
Some CGIs have the ability to use more than one template. For
example, buglist.cgi can output bug lists as RDF or two
@@ -8454,7 +8634,9 @@ CLASS="section"
>
There are a few templates you may be particularly interested in
customising for your installation.
@@ -8510,6 +8692,21 @@ CLASS="command"
>
bug/process/midair.html.tmpl:
+ This is the page used if two people submit simultaneous changes to the
+ same bug. The second person to submit their changes will get this page
+ to tell them what the first person did, and ask if they wish to
+ overwrite those changes or go back and revisit the bug. The default
+ title and header on this page read "Mid-air collision detected!" If
+ you work in the aviation industry, or other environment where this
+ might be found offensive (yes, we have true stories of this happening)
+ you'll want to change this to something more appropriate for your
+ environment.
+
bug/create/create.html.tmpl and
This feature should be considered experimental; the Bugzilla code you
+ will be changing is not stable, and could change or move between
+ versions. Be aware that if you make modifications to it, you may have
+ to re-make them or port them if Bugzilla changes internally between
+ versions.
+
Companies often have rules about which employees, or classes of employees,
+ are allowed to change certain things in the bug system. For example,
+ only the bug's designated QA Contact may be allowed to VERIFY the bug.
+ Bugzilla has been
+ designed to make it easy for you to write your own custom rules to define
+ who is allowed to make what sorts of value transition.
+
For maximum flexibility, customising this means editing Bugzilla's Perl
+ code. This gives the administrator complete control over exactly who is
+ allowed to do what. The relevant function is called
+ CheckCanChangeField(),
+ and is found in process_bug.cgi in your
+ Bugzilla directory. If you open that file and grep for
+ "sub CheckCanChangeField", you'll find it.
+
This function has been carefully commented to allow you to see exactly
+ how it works, and give you an idea of how to make changes to it. Certain
+ marked sections should not be changed - these are the "plumbing" which
+ makes the rest of the function work. In between those sections, you'll
+ find snippets of code like:
+
So, how does one go about changing this function? Well, simple changes
+ can be made just be removing pieces - for example, if you wanted to
+ prevent any user adding a comment to a bug, just remove the lines marked
+ "Allow anyone to change comments." And if you want the reporter to have
+ no special rights on bugs they have filed, just remove the entire section
+ which refers to him.
+
More complex customisations are not much harder. Basically, you add
+ a check in the right place in the function, i.e. after all the variables
+ you are using have been set up. So, don't look at $ownerid before
+ $ownerid has been obtained from the database. You can either add a
+ positive check, which returns 1 (allow) if certain conditions are true,
+ or a negative check, which returns 0 (deny.) E.g.:
+
For a list of possible field names, look in
+ data/versioncache for the list called
+ @::log_columns. If you need help writing custom
+ rules for your organisation, ask in the newsgroup.
+ A plain Bugzilla is fairly easy to upgrade from one version to a
newer one. Always read the release notes to see if there are any issues
@@ -8670,13 +9040,17 @@ CLASS="section"
> Bonsai is a web-based tool for managing
CVS integration is best accomplished, at this point, using the
Bugzilla Email Gateway. You can find the project page for Bugzilla and Teamtrack Perforce
integration (p4dti) at:
@@ -8769,7 +9147,9 @@ CLASS="section"
> We need Tinderbox integration information.
This FAQ includes questions not covered elsewhere in the Guide.
A.1.1.
Where can I find information about Bugzilla? A.1.2.
What license is Bugzilla distributed under?
@@ -9324,7 +9718,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.3.
How do I get commercial support for Bugzilla?
@@ -9359,7 +9755,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.4.
What major companies or projects are currently using Bugzilla
@@ -9467,7 +9865,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.5.
Who maintains Bugzilla?
@@ -9495,7 +9895,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.6.
How does Bugzilla stack up against other bug-tracking databases?
@@ -9531,7 +9933,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.7.
Why doesn't Bugzilla offer this or that feature or compatability
@@ -9569,7 +9973,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.8.
Why MySQL? I'm interested in seeing Bugzilla run on
@@ -9593,7 +9999,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.9.
Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
@@ -9624,7 +10032,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.10.
Is there an easy way to change the Bugzilla cookie name?
@@ -9645,7 +10055,9 @@ CLASS="answer"
CLASS="qandadiv"
>
A.2.1.
Is Bugzilla web-based, or do you have to have specific software or
@@ -9706,7 +10120,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.2.
Can Bugzilla integrate with
@@ -9730,7 +10146,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.3.
Does Bugzilla allow the user to track multiple projects?
@@ -9755,7 +10173,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.4.
If I am on many projects, and search for all bugs assigned to me, will
@@ -9778,7 +10198,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.5.
Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes,
@@ -9805,7 +10227,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.6.
Does Bugzilla allow us to define our own priorities and levels? Do we
@@ -9840,7 +10264,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.7.
Does Bugzilla provide any reporting features, metrics, graphs, etc? You
@@ -9876,7 +10302,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.8.
Is there email notification and if so, what do you see when you get an
@@ -9901,7 +10329,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.9.
Can email notification be set up to send to multiple
@@ -9924,7 +10354,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.10.
Do users have to have any particular
@@ -9981,7 +10413,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.11.
Does Bugzilla allow data to be imported and exported? If I had outsiders
@@ -10026,7 +10460,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.12.
Has anyone converted Bugzilla to another language to be used in other
@@ -10052,7 +10488,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.13.
Can a user create and save reports? Can they do this in Word format?
@@ -10075,7 +10513,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.14.
Does Bugzilla have the ability to search by word, phrase, compound
@@ -10099,7 +10539,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.15.
Does Bugzilla provide record locking when there is simultaneous access
@@ -10124,7 +10566,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.16.
Are there any backup features provided?
@@ -10152,7 +10596,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.17.
Can users be on the system while a backup is in progress?
@@ -10176,7 +10622,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.18.
What type of human resources are needed to be on staff to install and
@@ -10209,7 +10657,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.19.
What time frame are we looking at if we decide to hire people to install
@@ -10240,7 +10690,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.20.
Is there any licensing fee or other fees for using Bugzilla? Any
@@ -10263,14 +10715,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.3.1.
How do I completely disable MySQL security if it's giving me problems
@@ -10297,7 +10753,9 @@ CLASS="qandaentry"
CLASS="question"
> A.3.2.
Are there any security problems with Bugzilla?
@@ -10323,7 +10781,9 @@ CLASS="qandaentry"
CLASS="question"
> A.3.3.
I've implemented the security fixes mentioned in Chris Yeh's security
@@ -10348,14 +10808,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.4.1.
I have a user who doesn't want to receive any more email from Bugzilla.
@@ -10379,7 +10843,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.2.
I'm evaluating/testing Bugzilla, and don't want it to send email to
@@ -10403,7 +10869,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.3.
I want whineatnews.pl to whine at something more, or other than, only new
@@ -10433,7 +10901,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.4.
I don't like/want to use Procmail to hand mail off to bug_email.pl.
@@ -10449,7 +10919,9 @@ CLASS="answer"
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"
@@ -10468,7 +10940,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.5.
How do I set up the email interface to submit/change bugs via email?
@@ -10491,7 +10965,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.6.
Email takes FOREVER to reach me from Bugzilla -- it's extremely slow.
@@ -10524,7 +11000,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.7.
How come email from Bugzilla changes never reaches me?
@@ -10553,14 +11031,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.5.1.
I've heard Bugzilla can be used with Oracle?
@@ -10585,7 +11067,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.2.
I think my database might be corrupted, or contain invalid entries. What
@@ -10630,7 +11114,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.3.
I want to manually edit some entries in my database. How?
@@ -10657,7 +11143,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.4.
I try to add myself as a user, but Bugzilla always tells me my password is wrong.
@@ -10681,7 +11169,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.5.
I think I've set up MySQL permissions correctly, but Bugzilla still can't
@@ -10708,7 +11198,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.6.
How do I synchronize bug information among multiple different Bugzilla
@@ -10743,14 +11235,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.6.1.
What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
@@ -10773,7 +11269,9 @@ CLASS="qandaentry"
CLASS="question"
> A.6.2.
Is there a "Bundle::Bugzilla" equivalent for Win32?
@@ -10797,7 +11295,9 @@ CLASS="qandaentry"
CLASS="question"
> A.6.3.
CGI's are failing with a "something.cgi is not a valid Windows NT
@@ -10818,7 +11318,9 @@ CLASS="answer"
>
Microsoft has some advice on this matter, as well:
"Set application mappings. In the ISM, map the extension for the script
@@ -10841,7 +11343,9 @@ CLASS="qandaentry"
CLASS="question"
> A.6.4.
I'm having trouble with the perl modules for NT not being able to talk to
@@ -10907,14 +11411,18 @@ TARGET="_top"
CLASS="qandadiv"
> A.7.1.
How do I change my user name (email address) in Bugzilla?
@@ -10937,7 +11445,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.2.
The query page is very confusing. Isn't there a simpler way to query?
@@ -10961,7 +11471,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.3.
I'm confused by the behavior of the "accept" button in the Show Bug form.
@@ -11014,7 +11526,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.4.
I can't upload anything into the database via the "Create Attachment"
@@ -11039,7 +11553,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.5.
Email submissions to Bugzilla that have attachments end up asking me to
@@ -11064,7 +11580,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.6.
How do I change a keyword in Bugzilla, once some bugs are using it?
@@ -11087,15 +11605,78 @@ CLASS="answer"
CLASS="qandadiv"
>
+ Gerv and Myk suggest a 2-space endent, with embedded code sections on
+ their own line, in line with outer tags. Like this: Myk also recommends you turn on PRE_CHOMP in the template
+ initialization to prevent bloating of HTML with unnecessary whitespace.
+ Please note that many have differing opinions on this subject,
+ and the existing templates in Bugzilla espouse both this and a 4-space
+ style. Either is acceptable; the above is preferred. A.8.2.
What bugs are in Bugzilla right now?
A.8.2. A.8.3.
How can I change the default priority to a null value? For instance, have the default
priority be "---" instead of "P2"?
@@ -11168,8 +11751,10 @@ CLASS="qandaentry"
CLASS="question"
> A.8.3. A.8.4.
What's the best way to submit patches? What guidelines should I follow?
Bugzilla database relationships chart versioncache
+ gets automatically regenerated whenever it's more than
+ an hour old, so Bugzilla will eventually notice your changes by itself,
+ but generally you want it to notice right away, so that you can test
+ things. This information comes straight from my life. I was forced to learn
how Bugzilla organizes database because of nitpicky requests from users
@@ -11358,7 +11975,9 @@ CLASS="section"
> If you were like me, at this point you're totally clueless about
the internals of MySQL, and if it weren't for this executive order from
@@ -11472,7 +12091,9 @@ CLASS="section"
> Imagine your MySQL database as a series of spreadsheets, and
you won't be too far off. If you use this command: Are you looking for a way to put your Bugzilla into overdrive? Catch
some of the niftiest tricks here in this section. There are a suite of Unix utilities for querying Bugzilla from the
command line. They live in the
@@ -11870,7 +12492,9 @@ CLASS="command"
CLASS="appendix"
> I created this section to answer questions about Bugzilla competitors
and variants, then found a wonderful site which covers an awful lot of what
@@ -11887,7 +12511,9 @@ CLASS="section"
> Red Hat Bugzilla is a fork of Bugzilla 2.8.
One of its major benefits is the ability
@@ -11909,7 +12535,9 @@ CLASS="section"
> Fenris was a fork from Bugzilla made by Loki Games; when
Loki went into receivership, it died. While Loki's other code lives on,
@@ -11921,7 +12549,9 @@ CLASS="section"
> Issuezilla was another fork from Bugzilla, made by collab.net and
hosted at tigris.org. It is also dead; the primary focus of bug-tracking
@@ -11936,7 +12566,9 @@ CLASS="section"
> Scarab is a new open source bug-tracking system built using Java
Serlet technology. It is currently at version 1.0 beta 8. Although Perforce isn't really a bug tracker, it can be used as
such through the SourceForge is a way of coordinating geographically
distributed free software and open source projects over the Internet.
@@ -11996,13 +12632,17 @@ TARGET="_top"
CLASS="GLOSSARY"
> There are a suite of Unix utilities for querying Bugzilla from the
command line. They live in the
diff --git a/docs/html/conventions.html b/docs/html/conventions.html
index 40ce3f8c4..2bcaa2949 100644
--- a/docs/html/conventions.html
+++ b/docs/html/conventions.html
@@ -73,13 +73,17 @@ CLASS="section"
> This document uses the following conventions: Version 1.1, March 2000 Copyright (C) 2000 Free Software Foundation, Inc. 59 Temple Place,
@@ -144,7 +152,9 @@ CLASS="section"
> The purpose of this License is to make a manual, textbook, or other
written document "free" in the sense of freedom: to assure everyone the
@@ -172,7 +182,9 @@ CLASS="section"
> This License applies to any manual or other work that contains a
notice placed by the copyright holder saying it can be distributed under
@@ -235,7 +247,9 @@ CLASS="section"
> You may copy and distribute the Document in any medium, either
commercially or noncommercially, provided that this License, the
@@ -255,7 +269,9 @@ CLASS="section"
> If you publish printed copies of the Document numbering more than
100, and the Document's license notice requires Cover Texts, you must
@@ -297,7 +313,9 @@ CLASS="section"
> You may copy and distribute a Modified Version of the Document
under the conditions of sections 2 and 3 above, provided that you release
@@ -433,7 +451,9 @@ CLASS="section"
> You may combine the Document with other documents released under
this License, under the terms defined in section 4 above for modified
@@ -462,7 +482,9 @@ CLASS="section"
> You may make a collection consisting of the Document and other
documents released under this License, and replace the individual copies
@@ -481,7 +503,9 @@ CLASS="section"
> A compilation of the Document or its derivatives with other
separate and independent documents or works, in or on a volume of a
@@ -503,7 +527,9 @@ CLASS="section"
> Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section 4.
@@ -521,7 +547,9 @@ CLASS="section"
> You may not copy, modify, sublicense, or distribute the Document
except as expressly provided for under this License. Any other attempt to
@@ -536,7 +564,9 @@ CLASS="section"
> The Free Software Foundation may publish new, revised versions of
the GNU Free Documentation License from time to time. Such new versions
@@ -564,13 +594,17 @@ CLASS="section"
> To use this License in a document you have written, include a copy
of the License in the document and put the following copyright and
license notices just after the title page: Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
diff --git a/docs/html/credits.html b/docs/html/credits.html
index a15f56fb7..b609c9c7d 100644
--- a/docs/html/credits.html
+++ b/docs/html/credits.html
@@ -73,7 +73,9 @@ CLASS="section"
>
The people listed below have made enormous contributions to the
creation of this Guide, through their writing, dedicated hacking efforts,
diff --git a/docs/html/cust-templates.html b/docs/html/cust-templates.html
index 7987f2aba..7c8f17cc1 100644
--- a/docs/html/cust-templates.html
+++ b/docs/html/cust-templates.html
@@ -16,8 +16,8 @@ REL="PREVIOUS"
TITLE="Bugzilla Security"
HREF="security.html">
One of the large changes for 2.16 was the templatisation of the
entire user-facing UI, using the
@@ -97,7 +99,9 @@ CLASS="section"
>
There are two different ways of editing of Bugzilla's templates,
and which you use depends mainly on how you upgrade Bugzilla. The
@@ -210,7 +214,9 @@ CLASS="section"
>
The syntax of the Template Toolkit language is beyond the scope of
this guide. It's reasonably easy to pick up by looking at the current
@@ -290,7 +296,9 @@ CLASS="section"
>
Some CGIs have the ability to use more than one template. For
example, buglist.cgi can output bug lists as RDF or two
@@ -350,7 +358,9 @@ CLASS="section"
>
There are a few templates you may be particularly interested in
customising for your installation.
@@ -406,6 +416,21 @@ CLASS="command"
>
bug/process/midair.html.tmpl:
+ This is the page used if two people submit simultaneous changes to the
+ same bug. The second person to submit their changes will get this page
+ to tell them what the first person did, and ask if they wish to
+ overwrite those changes or go back and revisit the bug. The default
+ title and header on this page read "Mid-air collision detected!" If
+ you work in the aviation industry, or other environment where this
+ might be found offensive (yes, we have true stories of this happening)
+ you'll want to change this to something more appropriate for your
+ environment.
+
bug/create/create.html.tmpl and
NextUpgrading to New ReleasesChange Permission Customisation This information comes straight from my life. I was forced to learn
how Bugzilla organizes database because of nitpicky requests from users
@@ -133,7 +135,9 @@ CLASS="section"
> If you were like me, at this point you're totally clueless about
the internals of MySQL, and if it weren't for this executive order from
@@ -247,7 +251,9 @@ CLASS="section"
> Imagine your MySQL database as a series of spreadsheets, and
you won't be too far off. If you use this command:
No liability for the contents of this document can be accepted.
Use the concepts, examples, and other content at your own risk.
diff --git a/docs/html/extraconfig.html b/docs/html/extraconfig.html
index fb8ceb445..064f1382f 100644
--- a/docs/html/extraconfig.html
+++ b/docs/html/extraconfig.html
@@ -73,13 +73,17 @@ CLASS="section"
> As well as the text-based dependency graphs, Bugzilla also
supports dependency graphing, using a package called 'dot'.
@@ -141,7 +145,9 @@ CLASS="section"
> As long as you installed the GD and Graph::Base Perl modules you
might as well turn on the nifty Bugzilla bug reporting graphs. By now you have a fully functional Bugzilla, but what good are
bugs if they're not annoying? To help make those bugs more annoying you
@@ -267,7 +275,8 @@ WIDTH="100%"
COLOR="#000000"
>
You can also try using
OpenLDAP with Bugzilla, using any of a number of administration
+ tools. You should apply the patch attached this bug:
+
http://bugzilla.mozilla.org/show_bug.cgi?id=158630, then set
+ the following object classes for your users:
+
+ objectClass: person objectClass: organizationalPerson objectClass: inetOrgPerson objectClass: top objectClass: posixAccount objectClass: shadowAccount It is possible for a Bugzilla to execute malicious Javascript
@@ -403,7 +468,7 @@ WIDTH="100%"
COLOR="#000000"
> You should modify the <DirectoryIndex> parameter for
+ the Apache virtual host running your Bugzilla installation to
+ allow index.cgi as the index page for a
+ directory, as well as the usual index.html,
+ index.htm, and so forth. Bugzilla is unsupported under mod_perl. Effort is underway
+ to make it work cleanly in a mod_perl environment, but it is
+ slow going.
+
This FAQ includes questions not covered elsewhere in the Guide.
A.1.1.
Where can I find information about Bugzilla? A.1.2.
What license is Bugzilla distributed under?
@@ -614,7 +628,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.3.
How do I get commercial support for Bugzilla?
@@ -649,7 +665,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.4.
What major companies or projects are currently using Bugzilla
@@ -757,7 +775,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.5.
Who maintains Bugzilla?
@@ -785,7 +805,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.6.
How does Bugzilla stack up against other bug-tracking databases?
@@ -821,7 +843,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.7.
Why doesn't Bugzilla offer this or that feature or compatability
@@ -859,7 +883,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.8.
Why MySQL? I'm interested in seeing Bugzilla run on
@@ -883,7 +909,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.9.
Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
@@ -914,7 +942,9 @@ CLASS="qandaentry"
CLASS="question"
> A.1.10.
Is there an easy way to change the Bugzilla cookie name?
@@ -935,7 +965,9 @@ CLASS="answer"
CLASS="qandadiv"
>
A.2.1.
Is Bugzilla web-based, or do you have to have specific software or
@@ -996,7 +1030,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.2.
Can Bugzilla integrate with
@@ -1020,7 +1056,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.3.
Does Bugzilla allow the user to track multiple projects?
@@ -1045,7 +1083,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.4.
If I am on many projects, and search for all bugs assigned to me, will
@@ -1068,7 +1108,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.5.
Does Bugzilla allow attachments (text, screenshots, URLs etc)? If yes,
@@ -1095,7 +1137,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.6.
Does Bugzilla allow us to define our own priorities and levels? Do we
@@ -1130,7 +1174,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.7.
Does Bugzilla provide any reporting features, metrics, graphs, etc? You
@@ -1166,7 +1212,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.8.
Is there email notification and if so, what do you see when you get an
@@ -1191,7 +1239,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.9.
Can email notification be set up to send to multiple
@@ -1214,7 +1264,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.10.
Do users have to have any particular
@@ -1271,7 +1323,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.11.
Does Bugzilla allow data to be imported and exported? If I had outsiders
@@ -1316,7 +1370,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.12.
Has anyone converted Bugzilla to another language to be used in other
@@ -1342,7 +1398,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.13.
Can a user create and save reports? Can they do this in Word format?
@@ -1365,7 +1423,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.14.
Does Bugzilla have the ability to search by word, phrase, compound
@@ -1389,7 +1449,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.15.
Does Bugzilla provide record locking when there is simultaneous access
@@ -1414,7 +1476,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.16.
Are there any backup features provided?
@@ -1442,7 +1506,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.17.
Can users be on the system while a backup is in progress?
@@ -1466,7 +1532,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.18.
What type of human resources are needed to be on staff to install and
@@ -1499,7 +1567,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.19.
What time frame are we looking at if we decide to hire people to install
@@ -1530,7 +1600,9 @@ CLASS="qandaentry"
CLASS="question"
> A.2.20.
Is there any licensing fee or other fees for using Bugzilla? Any
@@ -1553,14 +1625,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.3.1.
How do I completely disable MySQL security if it's giving me problems
@@ -1587,7 +1663,9 @@ CLASS="qandaentry"
CLASS="question"
> A.3.2.
Are there any security problems with Bugzilla?
@@ -1613,7 +1691,9 @@ CLASS="qandaentry"
CLASS="question"
> A.3.3.
I've implemented the security fixes mentioned in Chris Yeh's security
@@ -1638,14 +1718,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.4.1.
I have a user who doesn't want to receive any more email from Bugzilla.
@@ -1669,7 +1753,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.2.
I'm evaluating/testing Bugzilla, and don't want it to send email to
@@ -1693,7 +1779,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.3.
I want whineatnews.pl to whine at something more, or other than, only new
@@ -1723,7 +1811,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.4.
I don't like/want to use Procmail to hand mail off to bug_email.pl.
@@ -1739,7 +1829,9 @@ CLASS="answer"
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"
@@ -1758,7 +1850,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.5.
How do I set up the email interface to submit/change bugs via email?
@@ -1781,7 +1875,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.6.
Email takes FOREVER to reach me from Bugzilla -- it's extremely slow.
@@ -1814,7 +1910,9 @@ CLASS="qandaentry"
CLASS="question"
> A.4.7.
How come email from Bugzilla changes never reaches me?
@@ -1843,14 +1941,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.5.1.
I've heard Bugzilla can be used with Oracle?
@@ -1875,7 +1977,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.2.
I think my database might be corrupted, or contain invalid entries. What
@@ -1920,7 +2024,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.3.
I want to manually edit some entries in my database. How?
@@ -1947,7 +2053,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.4.
I try to add myself as a user, but Bugzilla always tells me my password is wrong.
@@ -1971,7 +2079,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.5.
I think I've set up MySQL permissions correctly, but Bugzilla still can't
@@ -1998,7 +2108,9 @@ CLASS="qandaentry"
CLASS="question"
> A.5.6.
How do I synchronize bug information among multiple different Bugzilla
@@ -2033,14 +2145,18 @@ CLASS="answer"
CLASS="qandadiv"
> A.6.1.
What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
@@ -2063,7 +2179,9 @@ CLASS="qandaentry"
CLASS="question"
> A.6.2.
Is there a "Bundle::Bugzilla" equivalent for Win32?
@@ -2087,7 +2205,9 @@ CLASS="qandaentry"
CLASS="question"
> A.6.3.
CGI's are failing with a "something.cgi is not a valid Windows NT
@@ -2108,7 +2228,9 @@ CLASS="answer"
>
Microsoft has some advice on this matter, as well:
"Set application mappings. In the ISM, map the extension for the script
@@ -2131,7 +2253,9 @@ CLASS="qandaentry"
CLASS="question"
> A.6.4.
I'm having trouble with the perl modules for NT not being able to talk to
@@ -2197,14 +2321,18 @@ TARGET="_top"
CLASS="qandadiv"
> A.7.1.
How do I change my user name (email address) in Bugzilla?
@@ -2227,7 +2355,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.2.
The query page is very confusing. Isn't there a simpler way to query?
@@ -2251,7 +2381,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.3.
I'm confused by the behavior of the "accept" button in the Show Bug form.
@@ -2304,7 +2436,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.4.
I can't upload anything into the database via the "Create Attachment"
@@ -2329,7 +2463,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.5.
Email submissions to Bugzilla that have attachments end up asking me to
@@ -2354,7 +2490,9 @@ CLASS="qandaentry"
CLASS="question"
> A.7.6.
How do I change a keyword in Bugzilla, once some bugs are using it?
@@ -2377,15 +2515,78 @@ CLASS="answer"
CLASS="qandadiv"
>
+ Gerv and Myk suggest a 2-space endent, with embedded code sections on
+ their own line, in line with outer tags. Like this: Myk also recommends you turn on PRE_CHOMP in the template
+ initialization to prevent bloating of HTML with unnecessary whitespace.
+ Please note that many have differing opinions on this subject,
+ and the existing templates in Bugzilla espouse both this and a 4-space
+ style. Either is acceptable; the above is preferred. A.8.2.
What bugs are in Bugzilla right now?
A.8.2. A.8.3.
How can I change the default priority to a null value? For instance, have the default
priority be "---" instead of "P2"?
@@ -2458,8 +2661,10 @@ CLASS="qandaentry"
CLASS="question"
> A.8.3. A.8.4.
What's the best way to submit patches? What guidelines should I follow?
Groups allow the administrator
to isolate bugs or products that should only be seen by certain people.
@@ -112,22 +114,10 @@ TYPE="1"
> Fill out the "New Name", "New Description", and
- "New User RegExp" fields. "New User RegExp" allows you to automatically
+>Fill out the "Group", "Description", and
+ "User RegExp" fields. "New User RegExp" allows you to automatically
place all users who fulfill the Regular Expression into the new group.
When you have finished, click "Add". To use Product-Based Groups: Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit
- Parameters" screen. XXX is this still true?
- "usebuggroupsentry" has the capacity to prevent the
- administrative user from directly altering bugs because of
- conflicting group permissions. If you plan on using
- "usebuggroupsentry", you should plan on restricting
- administrative account usage to administrative duties only. In
- other words, manage bugs with an unpriveleged user account, and
- manage users, groups, Products, etc. with the administrative
- account. After you add your new group, edit the new group. On the
+ edit page, you can specify other groups that should be included
+ in this group and which groups should be permitted to add and delete
+ users from this group. To use Product-Based Groups: Turn on "usebuggroups" and "usebuggroupsentry" in the "Edit
+ Parameters" screen. In future, when you create a Product, a matching group will be
automatically created. If you need to add a Product Group to
a Product which was created before you turned on usebuggroups,
@@ -172,35 +176,6 @@ VALIGN="TOP"
same name as the Product. Bugzilla currently has a limit of 64 groups per installation. If
- you have more than about 50 products, you should consider
- running multiple Bugzillas. Ask in the newsgroup for other
- suggestions for working around this restriction.
Note that group permissions are such that you need to be a member
of This section distills some Bugzilla tips and best practices
that have been developed. Bugzilla comments are plain text - so posting HTML will result
in literal HTML tags rather than being interpreted by a browser.
@@ -145,7 +149,9 @@ CLASS="section"
> Quicksearch is a single-text-box query tool which uses
metacharacters to indicate what is to be searched. For example, typing
@@ -176,7 +182,9 @@ CLASS="section"
> If you are changing the fields on a bug, only comment if
either you have something pertinent to say, or Bugzilla requires it.
@@ -198,7 +206,9 @@ CLASS="section"
>
Use attachments, rather than comments, for large chunks of ASCII data,
such as trace, debugging output files, or log files. That way, it doesn't
@@ -222,7 +232,9 @@ CLASS="section"
> Try to make sure that everything said in the summary is also
said in the first comment. Summaries are often updated and this will
diff --git a/docs/html/how.html b/docs/html/how.html
index 6d7018a0c..f4bfbcba3 100644
--- a/docs/html/how.html
+++ b/docs/html/how.html
@@ -73,7 +73,9 @@ CLASS="section"
> This section contains information for end-users of Bugzilla.
There is a Bugzilla test installation, called
@@ -92,7 +94,9 @@ CLASS="section"
> If you want to use Bugzilla, first you need to create an account.
Consult with the administrator responsible for your installation of
@@ -160,7 +164,9 @@ CLASS="section"
> The core of Bugzilla is the screen which displays a particular
bug. It's a good place to explain some Bugzilla concepts.
@@ -425,7 +431,9 @@ CLASS="section"
> The Bugzilla Search page is is the interface where you can find
any bug report, comment, or patch currently in the Bugzilla system. You
@@ -458,7 +466,9 @@ CLASS="section"
> If you run a search, a list of matching bugs will be returned.
The default search is to return all open bugs on the system - don't try
@@ -530,7 +540,9 @@ CLASS="section"
> Years of bug writing experience has been distilled for your
reading pleasure into the
diff --git a/docs/html/index.html b/docs/html/index.html
index 51024b628..a874ac33a 100644
--- a/docs/html/index.html
+++ b/docs/html/index.html
@@ -37,25 +37,35 @@ ALINK="#0000FF"
>
This is the documentation for Bugzilla, the mozilla.org
@@ -242,11 +252,16 @@ HREF="cust-templates.html"
> Bonsai is a web-based tool for managing
CVS integration is best accomplished, at this point, using the
Bugzilla Email Gateway. You can find the project page for Bugzilla and Teamtrack Perforce
integration (p4dti) at:
@@ -172,7 +180,9 @@ CLASS="section"
> We need Tinderbox integration information.
This is the 2.16 version of The Bugzilla Guide. It is so named
to match the current version of Bugzilla. If you are
diff --git a/docs/html/osx.html b/docs/html/osx.html
index 147cf3b6c..664dea1da 100644
--- a/docs/html/osx.html
+++ b/docs/html/osx.html
@@ -73,7 +73,9 @@ CLASS="section"
> There are a lot of common libraries and utilities out there that
Apple did not include with Mac OS X, but which run perfectly well on it.
diff --git a/docs/html/parameters.html b/docs/html/parameters.html
index 59455a082..aad3dd86b 100644
--- a/docs/html/parameters.html
+++ b/docs/html/parameters.html
@@ -73,7 +73,9 @@ CLASS="section"
> Bugzilla is configured by changing various parameters, accessed
from the "Edit parameters" link in the page footer. Here are
@@ -165,8 +167,14 @@ CLASS="command"
write locking. What this means is that if someone needs to make a
change to a bug, they will lock the entire table until the operation
is complete. Locking for write also blocks reads until the write is
- complete. The
- The "shadowdb"
@@ -186,49 +194,10 @@ CLASS="QUOTE"
Bugzilla bug changes and comments per day. The value of the parameter defines the name of the
- shadow bug database.
- Set "shadowdb" to e.g. "bug_shadowdb" if you will be running a
- *very* large installation of Bugzilla.
- Enabling "shadowdb" can adversely affect the stability of
- your installation of Bugzilla. You should regularly check that your
- database is in sync. It is often advisable to force a shadow
- database sync nightly via
- "cron".
- If you use the "shadowdb" option, it is only natural that you
- should turn the "queryagainstshadowdb" option on as well. Otherwise
- you are replicating data into a shadow database for no reason!
movebugs:
+
+ This option is an undocumented feature to allow moving bugs
+ between separate Bugzilla installations. You will need to understand
+ the source code in order to use this feature. Please consult
+ movebugs.pl in your Bugzilla source tree for
+ further documentation, such as it is.
+
useqacontact
Components are subsections of a Product. E.g. the computer game
you are designing may have a "UI"
@@ -186,7 +192,9 @@ CLASS="section"
> Versions are the revisions of the product, such as "Flinders
3.1", "Flinders 95", and "Flinders 2000". Version is not a multi-select
@@ -220,7 +228,9 @@ CLASS="section"
> Milestones are "targets" that you plan to get a bug fixed by. For
example, you have a bug that you plan to fix for your 3.0 release, it
diff --git a/docs/html/rewrite.html b/docs/html/rewrite.html
index a64240d98..007f998e6 100644
--- a/docs/html/rewrite.html
+++ b/docs/html/rewrite.html
@@ -76,7 +76,9 @@ CLASS="section"
> Red Hat Bugzilla is a fork of Bugzilla 2.8.
One of its major benefits is the ability
diff --git a/docs/html/security.html b/docs/html/security.html
index a7433f67c..096a771aa 100644
--- a/docs/html/security.html
+++ b/docs/html/security.html
@@ -73,7 +73,9 @@ CLASS="section"
> Bugzilla has been successfully installed under Solaris, Linux,
and Win32. Win32 is not yet officially supported, but many people
@@ -97,7 +101,9 @@ CLASS="section"
>
File::Temp (v1.804) (Prerequisite for Template)
+
AppConfig
@@ -475,7 +490,9 @@ CLASS="section"
> Visit the MySQL homepage at
Any machine that doesn't have Perl on it is a sad machine indeed.
Perl can be got in source form from
@@ -594,7 +613,9 @@ TARGET="_top"
>
All Perl modules can be found on the
@@ -822,7 +845,9 @@ CLASS="section"
> The DBI module is a generic Perl module used the
MySQL-related modules. As long as your Perl installation was done
@@ -835,7 +860,9 @@ CLASS="section"
> The Data::Dumper module provides data structure persistence for
Perl (similar to Java's serialization). It comes with later
@@ -847,7 +874,9 @@ CLASS="section"
> The Perl/MySQL interface requires a few mutually-dependent Perl
modules. These modules are grouped together into the the
@@ -871,7 +900,9 @@ CLASS="section"
> Many of the more common date/time/calendar related Perl modules
have been grouped into a bundle similar to the MySQL modules bundle.
@@ -885,7 +916,9 @@ CLASS="section"
> The GD library was written by Thomas Boutell a long while ago to
programatically generate images in C. Since then it's become the
@@ -938,7 +971,9 @@ CLASS="section"
> The Chart module provides Bugzilla with on-the-fly charting
abilities. It can be installed in the usual fashion after it has been
@@ -951,7 +986,9 @@ CLASS="section"
> When you install Template Toolkit, you'll get asked various
questions about features to enable. The defaults are fine, except
@@ -967,7 +1004,9 @@ CLASS="section"
> You have a freedom of choice here - Apache, Netscape or any other
server on UNIX would do. You can run the web server on a
@@ -1009,8 +1048,12 @@ VALIGN="TOP"
>
You'll want to make sure that your web server will run any file
- with the .cgi extension as a CGI and not just display it. If you're
+>You'll want to make sure that your web server will run
+ any file
+ with the .cgi extension as a CGI program and not simply display the source
+ code. If you're
using Apache that means uncommenting the following line in the httpd.conf
file:
With Apache you'll also want to make sure that within the
- httpd.conf file the line:
+ httpd.conf file these lines:
Users of older versions of Apache may find the above lines
- in the srm.conf and access.conf files, respecitvely. You should untar the Bugzilla files into a directory that you're
willing to make writable by the default web server user (probably
@@ -1219,6 +1262,64 @@ CLASS="filename"
for Perl. This can be done using the following Perl one-liner, but
I suggest using the symlink approach to avoid upgrade hassles.
"Bonsaitools" is the name Terry Weissman, the
+ original author of Bugzilla, created
+ for his suite of webtools at the time he created Bugzilla and several
+ other tools in use at mozilla.org. He created a directory,
+ /usr/bonsaitools to house his specific versions
+ of perl and other utilities. This usage is still current at
+ bugzilla.mozilla.org,
+ but in general most other places do not use it. You can either edit
+ the paths at the start of each perl file to the correct location of
+ perl on your system, or simply bow to history and create a
+ /usr/bonsaitools and /usr/bonsaitools/bin
+ directory, placing a symlink to perl on your system
+ inside /usr/bonsaitools/bin
+
After you've gotten all the software installed and working you're
ready to start preparing the database for its life as the back end to
@@ -1423,7 +1525,9 @@ CLASS="section"
> If you followed the installation instructions for setting up your
"bugs" and "root" user in MySQL, much of this should not apply to you.
@@ -1850,7 +1956,9 @@ CLASS="section"
>
You should run through the parameters on the Edit Parameters page
(link in the footer) and set them all to appropriate values.
diff --git a/docs/html/troubleshooting.html b/docs/html/troubleshooting.html
index 7a4a32d7d..59087ba94 100644
--- a/docs/html/troubleshooting.html
+++ b/docs/html/troubleshooting.html
@@ -73,7 +73,9 @@ CLASS="section"
> This section gives solutions to common Bugzilla installation
problems.
@@ -83,7 +85,9 @@ CLASS="section"
>
Try executing
The following error message may appear due to a bug in DBD::mysql
(over which the Bugzilla team have no control):
@@ -190,7 +196,9 @@ CLASS="section"
> If you are installing Bugzilla on SuSE Linux, or some other
distributions with
diff --git a/docs/html/upgrading.html b/docs/html/upgrading.html
index 445154030..7919fa2f1 100644
--- a/docs/html/upgrading.html
+++ b/docs/html/upgrading.html
@@ -13,8 +13,8 @@ REL="UP"
TITLE="Administering Bugzilla"
HREF="administration.html">Prev A plain Bugzilla is fairly easy to upgrade from one version to a
newer one. Always read the release notes to see if there are any issues
@@ -127,7 +129,7 @@ WIDTH="33%"
ALIGN="left"
VALIGN="top"
>PrevTemplate CustomisationChange Permission Customisation When you first run checksetup.pl after installing Bugzilla, it
will prompt you for the administrative username (email address) and
@@ -107,60 +111,11 @@ ALT="Tip"> If you wish to add more administrative users, you must use the
- MySQL interface. Run "mysql" from the command line, and use these
- commands:
- Yes, that is
- fourteen
-
- "f"
-
- 's. A whole lot of f-ing going on if you want to create a new
- administator. Your users can create their own user accounts by clicking the
"New Account" link at the bottom of each page (assuming they
@@ -248,7 +207,9 @@ CLASS="section"
> To see a specific user, search for their login name
in the box provided on the "Edit Users" page. To see all users,
diff --git a/docs/html/userpreferences.html b/docs/html/userpreferences.html
index a782877f3..a59b52e9c 100644
--- a/docs/html/userpreferences.html
+++ b/docs/html/userpreferences.html
@@ -73,7 +73,9 @@ CLASS="section"
> Once you have logged in, you can customise various aspects of
Bugzilla via the "Edit prefs" link in the page footer.
@@ -83,7 +85,9 @@ CLASS="section"
> On this tab, you can change your basic account information,
including your password, email address and real name. For security
@@ -106,7 +110,9 @@ CLASS="section"
> On this tab you can reduce or increase the amount of email sent
you from Bugzilla, opting in our out depending on your relationship to
@@ -153,7 +159,9 @@ CLASS="section"
> On the Search page, you can store queries in Bugzilla, so if you
regularly run a particular query it is just a drop-down menu away.
@@ -165,7 +173,9 @@ CLASS="section"
> This is a purely informative page which outlines your current
permissions on this installation of Bugzilla - what product groups you
diff --git a/docs/html/using.html b/docs/html/using.html
index 0d1231589..efbd2dba5 100644
--- a/docs/html/using.html
+++ b/docs/html/using.html
@@ -69,7 +69,9 @@ WIDTH="100%"> Fenris was a fork from Bugzilla made by Loki Games; when
Loki went into receivership, it died. While Loki's other code lives on,
diff --git a/docs/html/variant-issuezilla.html b/docs/html/variant-issuezilla.html
index e14cc0794..912e22847 100644
--- a/docs/html/variant-issuezilla.html
+++ b/docs/html/variant-issuezilla.html
@@ -73,7 +73,9 @@ CLASS="section"
> Issuezilla was another fork from Bugzilla, made by collab.net and
hosted at tigris.org. It is also dead; the primary focus of bug-tracking
diff --git a/docs/html/variant-perforce.html b/docs/html/variant-perforce.html
index 6bcfc5eed..29f5e95dc 100644
--- a/docs/html/variant-perforce.html
+++ b/docs/html/variant-perforce.html
@@ -73,7 +73,9 @@ CLASS="section"
> Although Perforce isn't really a bug tracker, it can be used as
such through the Scarab is a new open source bug-tracking system built using Java
Serlet technology. It is currently at version 1.0 beta 8. SourceForge is a way of coordinating geographically
distributed free software and open source projects over the Internet.
diff --git a/docs/html/variants.html b/docs/html/variants.html
index f5bd22fde..712a6125f 100644
--- a/docs/html/variants.html
+++ b/docs/html/variants.html
@@ -69,7 +69,9 @@ WIDTH="100%"> Voting allows users to be given a pot of votes which they can allocate
to bugs, to indicate that they'd like them fixed.
diff --git a/docs/html/whatis.html b/docs/html/whatis.html
index 85ec72202..7c57399a3 100644
--- a/docs/html/whatis.html
+++ b/docs/html/whatis.html
@@ -73,7 +73,9 @@ CLASS="section"
>
Bugzilla is a bug- or issue-tracking system. Bug-tracking
systems allow individual or groups of developers effectively to keep track
diff --git a/docs/html/why.html b/docs/html/why.html
index 1baa4042e..35daf683b 100644
--- a/docs/html/why.html
+++ b/docs/html/why.html
@@ -73,7 +73,9 @@ CLASS="section"
> For many years, defect-tracking software has remained principally
the domain of large software development houses. Even then, most shops
diff --git a/docs/html/win32.html b/docs/html/win32.html
index 575bf8f4b..2e9383b15 100644
--- a/docs/html/win32.html
+++ b/docs/html/win32.html
@@ -73,7 +73,9 @@ CLASS="section"
> This section covers installation on Microsoft Windows.
Bugzilla has been made to work on Win32 platforms, but the Bugzilla team
@@ -150,7 +152,9 @@ CLASS="section"
> Example 4-1. Installing ActivePerl ppd Modules on Microsoft
Windows Example 4-2. Installing OpenInteract ppd Modules manually on Microsoft
Windows
Add
- binmode()
-
- calls so attachments will work (
- bug
- 62000
-
- ). Because Microsoft Windows based systems handle binary files
- different than Unix based systems, you need to add the following
- lines to
- createattachment.cgi
-
- and
- showattachment.cgi
-
- before the
- require 'CGI.pl';
-
- line.
According to
-
bug 62000
-
- , the perl documentation says that you should always use
- binmode()
-
- when dealing with binary files, but never when dealing with text
- files. That seems to suggest that rather than arbitrarily putting
-
- binmode()
-
- at the beginning of the attachment files, there should be logic
- to determine if
- binmode()
-
- is needed or not.5.6. Bugzilla Security
5.6. Bugzilla Security5.7. Template Customisation
5.7. Template Customisation5.7.1. What to Edit
5.7.1. What to Edit5.7.2. How To Edit Templates
5.7.2. How To Edit Templates5.7.3. Template Formats
5.7.3. Template Formats5.7.4. Particular Templates
5.7.4. Particular Templates5.8. Upgrading to New Releases
5.8. Change Permission Customisation
+ It's fairly obvious what this piece of code does.
+ # Allow the owner to change anything.
+ if ($ownerid eq $whoid) {
+ return 1;
+ }
+ 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 "qacontact") {
+ if (UserInGroup("quality_assurance")) {
+ return 1;
+ }
+ else {
+ return 0;
+ }
+ }
+ This says that if the user is trying to change the priority field,
+ and their email address is @example.com, they can only do so if the
+ old value of the field was "P1". Not very useful, but illustrative.
+ if (($field eq "priority") &&
+ ($vars->{'user'}{'login'} =~ /.*\@example\.com$/))
+ {
+ if ($oldvalue eq "P1") {
+ return 1;
+ }
+ else {
+ return 0;
+ }
+ }
5.9. Upgrading to New Releases
5.9. Integrating Bugzilla with Third-Party Tools
5.10. Integrating Bugzilla with Third-Party Tools5.9.1. Bonsai
5.10.1. Bonsai5.9.2. CVS
5.10.2. CVS5.9.3. Perforce SCM
5.10.3. Perforce SCM5.9.4. Tinderbox/Tinderbox2
5.10.4. Tinderbox/Tinderbox2Appendix A. The Bugzilla FAQ
Appendix A. The Bugzilla FAQ
1. General Questions1. General Questions
2. Managerial Questions
2. Managerial Questions3. Bugzilla Security
3. Bugzilla Security4. Bugzilla Email
4. Bugzilla Email5. Bugzilla Database
5. Bugzilla Database6. Bugzilla and Win32
6. Bugzilla and Win327. Bugzilla Usage
7. Bugzilla Usage8. Bugzilla Hacking
8. Bugzilla Hacking
<fred>
+[% IF foo %]
+ <bar>
+ [% FOREACH x = barney %]
+ <tr>
+ <td>
+ [% x %]
+ </td>
+ <tr>
+ [% END %]
+[% END %]
+</fred>
+
Appendix B. The Bugzilla Database
Appendix B. The Bugzilla DatabaseB.1. Database Schema Chart
B.2. MySQL Bugzilla Database Introduction
B.2. MySQL Bugzilla Database IntroductionB.2.1. Bugzilla Database Basics
B.2.1. Bugzilla Database BasicsB.2.1.1. Bugzilla Database Tables
B.2.1.1. Bugzilla Database Tables
tell you, it's a pretty complete history.
-shadowlog: I could be mistaken here, but I believe this table tells you when
-your shadow database is updated and what commands were used to update it. We
-don't use a shadow database at our site yet, so it's pretty empty for us.
-
versions: Version information for every product
votes: Who voted for what when
@@ -11712,7 +12328,9 @@ this. But you need to know this stuff&n
CLASS="appendix"
>Appendix C. Useful Patches and Utilities for Bugzilla
Appendix C. Useful Patches and Utilities for BugzillaC.1. Apache
+NAME="rewrite"
+>C.1. Apache
mod_rewrite
C.2. Command-line Bugzilla Queries
C.2. Command-line Bugzilla QueriesAppendix D. Bugzilla Variants and Competitors
Appendix D. Bugzilla Variants and CompetitorsD.1. Red Hat Bugzilla
D.1. Red Hat BugzillaD.2. Loki Bugzilla (Fenris)
D.2. Loki Bugzilla (Fenris)D.3. Issuezilla
D.3. IssuezillaD.4. Scarab
D.4. ScarabD.5. Perforce SCM
D.5. Perforce SCMD.6. SourceForge
D.6. SourceForgeGlossary
GlossaryChapter 1. About This Guide
Chapter 1. About This GuideChapter 5. Administering Bugzilla
Chapter 5. Administering BugzillaC.2. Command-line Bugzilla Queries
C.2. Command-line Bugzilla Queries1.5. Document Conventions
1.5. Document Conventions1.1. Copyright Information
1.1. Copyright Information
Prev
Next1.1.1. GNU Free Documentation License
1.1.1. GNU Free Documentation License0. PREAMBLE
0. PREAMBLE1. APPLICABILITY AND DEFINITIONS
1. APPLICABILITY AND DEFINITIONS2. VERBATIM COPYING
2. VERBATIM COPYING3. COPYING IN QUANTITY
3. COPYING IN QUANTITY4. MODIFICATIONS
4. MODIFICATIONS5. COMBINING DOCUMENTS
5. COMBINING DOCUMENTS6. COLLECTIONS OF DOCUMENTS
6. COLLECTIONS OF DOCUMENTS7. AGGREGATION WITH INDEPENDENT WORKS
7. AGGREGATION WITH INDEPENDENT WORKS8. TRANSLATION
8. TRANSLATION9. TERMINATION
9. TERMINATION10. FUTURE REVISIONS OF THIS LICENSE
10. FUTURE REVISIONS OF THIS LICENSEHow to use this License for your documents
How to use this License for your documents1.4. Credits
1.4. Credits5.7. Template Customisation
5.7. Template Customisation5.7.1. What to Edit
5.7.1. What to Edit5.7.2. How To Edit Templates
5.7.2. How To Edit Templates5.7.3. Template Formats
5.7.3. Template Formats5.7.4. Particular Templates
5.7.4. Particular TemplatesAppendix B. The Bugzilla Database
Appendix B. The Bugzilla DatabaseB.2. MySQL Bugzilla Database Introduction
B.2. MySQL Bugzilla Database IntroductionB.2.1. Bugzilla Database Basics
B.2.1. Bugzilla Database BasicsB.2.1.1. Bugzilla Database Tables
B.2.1.1. Bugzilla Database Tables
tell you, it's a pretty complete history.
-shadowlog: I could be mistaken here, but I believe this table tells you when
-your shadow database is updated and what commands were used to update it. We
-don't use a shadow database at our site yet, so it's pretty empty for us.
-
versions: Version information for every product
votes: Who voted for what when
@@ -498,7 +499,7 @@ WIDTH="33%"
ALIGN="left"
VALIGN="top"
>PrevDatabase Schema ChartModifying Your Running System1.2. Disclaimer
1.2. Disclaimer4.2. Optional Additional Configuration
4.2. Optional Additional Configuration4.2.1. Dependency Charts
4.2.1. Dependency Charts4.2.2. Bug Graphs
4.2.2. Bug Graphs4.2.3. The Whining Cron
4.2.3. The Whining Cronman 5 crontab
man 5 crontab
+ 4.2.4. LDAP Authentication
4.2.4. LDAP Authentication
+
+ Please note that this patch has not yet been
+ accepted by the Bugzilla team, and so you may need to do some
+ manual tweaking. That said, it looks like Net::LDAP is probably
+ the way to go in the future.
+ 4.2.5. Preventing untrusted Bugzilla content from executing malicious
+NAME="content-type"
+>4.2.5. Preventing untrusted Bugzilla content from executing malicious
Javascript code
bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl
+>
bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl
4.2.6. 4.2.6. .htaccess
@@ -551,7 +618,7 @@ WIDTH="100%"
COLOR="#000000"
>
<Directory /usr/local/bugzilla/>
+>
<Directory /usr/local/bugzilla/>
Options +FollowSymLinks +Indexes +Includes +ExecCGI
AllowOverride All
</Directory>
@@ -615,7 +682,53 @@ CLASS="section"
>
4.2.7. 4.2.7. directoryindex for the Bugzilla default page.
4.2.8. Bugzilla and mod_perl
4.2.9. mod_throttle
diff --git a/docs/html/faq.html b/docs/html/faq.html
index 0b0dfcca5..552e18bc4 100644
--- a/docs/html/faq.html
+++ b/docs/html/faq.html
@@ -69,7 +69,9 @@ WIDTH="100%">
Appendix A. The Bugzilla FAQ
Appendix A. The Bugzilla FAQ
1. General Questions1. General Questions
2. Managerial Questions
2. Managerial Questions3. Bugzilla Security
3. Bugzilla Security4. Bugzilla Email
4. Bugzilla Email5. Bugzilla Database
5. Bugzilla Database6. Bugzilla and Win32
6. Bugzilla and Win327. Bugzilla Usage
7. Bugzilla Usage8. Bugzilla Hacking
8. Bugzilla Hacking
<fred>
+[% IF foo %]
+ <bar>
+ [% FOREACH x = barney %]
+ <tr>
+ <td>
+ [% x %]
+ </td>
+ <tr>
+ [% END %]
+[% END %]
+</fred>
+
Glossary
Glossary0-9, high ascii
0-9, high asciiA
AB
BD
DM
MP
PQ
QS
ST
TZ
Z5.5. Groups and Group Security
5.5. Groups and Group Security3.2. Hints and Tips
3.2. Hints and Tips3.2.1. Autolinkification
3.2.1. Autolinkification3.2.2. Quicksearch
3.2.2. Quicksearch3.2.3. Comments
3.2.3. Comments3.2.4. Attachments
3.2.4. Attachments3.2.5. Filing Bugs
3.2.5. Filing Bugs3.1. How do I use Bugzilla?
3.1. How do I use Bugzilla?3.1.1. Create a Bugzilla Account
3.1.1. Create a Bugzilla Account3.1.2. Anatomy of a Bug
3.1.2. Anatomy of a Bug3.1.3. Searching for Bugs
3.1.3. Searching for Bugs3.1.4. Bug Lists
3.1.4. Bug Lists3.1.5. Filing Bugs
3.1.5. Filing BugsThe Bugzilla Guide
The Bugzilla GuideMatthew P. Barnson
Matthew P. BarnsonThe Bugzilla Team
The Bugzilla TeamChapter 4. Installation
Chapter 4. Installation5.9.1. Bonsai
5.10.1. Bonsai5.9.2. CVS
5.10.2. CVS5.9.3. Perforce SCM
5.10.3. Perforce SCM5.9.4. Tinderbox/Tinderbox2
5.10.4. Tinderbox/Tinderbox2Chapter 2. Introduction
Chapter 2. Introduction1.3. New Versions
1.3. New Versions4.4. Mac OS X Installation Notes
4.4. Mac OS X Installation Notes5.1. Bugzilla Configuration
5.1. Bugzilla ConfigurationAppendix C. Useful Patches and Utilities for Bugzilla
Appendix C. Useful Patches and Utilities for Bugzilla5.3. Product, Component, Milestone, and Version Administration
5.3. Product, Component, Milestone, and Version Administration5.3.1. Products
5.3.1. Products5.3.2. Components
5.3.2. Components5.3.3. Versions
5.3.3. Versions5.3.4. Milestones
5.3.4. MilestonesC.1. Apache
+NAME="rewrite"
+>C.1. Apache
mod_rewrite
D.1. Red Hat Bugzilla
D.1. Red Hat Bugzilla5.6. Bugzilla Security
5.6. Bugzilla Security4.1. Step-by-step Install
4.1. Step-by-step Install4.1.1. Introduction
4.1.1. Introduction4.1.2. Package List
4.1.2. Package List4.1.3. MySQL
4.1.3. MySQL4.1.4. Perl
4.1.4. Perl4.1.5. Perl Modules
4.1.5. Perl Modules4.1.5.1. DBI
4.1.5.1. DBI4.1.5.2. Data::Dumper
4.1.5.2. Data::Dumper4.1.5.3. MySQL-related modules
4.1.5.3. MySQL-related modules4.1.5.4. TimeDate modules
4.1.5.4. TimeDate modules4.1.5.5. GD (optional)
4.1.5.5. GD (optional)4.1.5.6. Chart::Base (optional)
4.1.5.6. Chart::Base (optional)4.1.5.7. Template Toolkit
4.1.5.7. Template Toolkit4.1.6. HTTP Server
4.1.6. HTTP Server
"data"
- and
- "shadow"
- directories and the
+ directory and the
"localconfig"AddHandler cgi-script .cgi
AddHandler cgi-script .cgi
+
- is in the stanza that covers the directories into which you intend to
+ are in the stanza that covers the directories into which you intend to
put the bugzilla .html and .cgi files.
Options ExecCGI AllowOverride Limit
Options +ExecCGI
+AllowOverride Limit
+4.1.7. Bugzilla
4.1.7. Bugzillaperl -pi -e
- 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm
- processmail syncshadowdb
perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb
+ 4.1.8. Setting Up the MySQL Database
4.1.8. Setting Up the MySQL Database4.1.9. 4.1.9. checksetup.pl
4.1.10. Securing MySQL
4.1.10. Securing MySQL4.1.11. Configuring Bugzilla
4.1.11. Configuring Bugzilla4.5. Troubleshooting
4.5. Troubleshooting4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.1
4.5.1. Bundle::Bugzilla makes me upgrade to Perl 5.6.14.5.2. DBD::Sponge::db prepare failed
4.5.2. DBD::Sponge::db prepare failed4.5.3. cannot chdir(/var/spool/mqueue)
4.5.3. cannot chdir(/var/spool/mqueue)5.8. Upgrading to New Releases
5.9. Upgrading to New Releases5.2. User Administration
5.2. User Administration5.2.1. Creating the Default User
5.2.1. Creating the Default User
+>If you wish to add more administrative users, add them to
+ the "admin" group and, optionally, add edit the tweakparams, editusers,
+ creategroups, editcomponents, and editkeywords groups to add the
+ entire admin group to those groups.
mysql>
- use bugs;
-
mysql>
-
-
update profiles set groupset=0x7ffffffffffffff where login_name =
- "(user's login name)";
-
- 5.2.2. Managing Other Users
5.2.2. Managing Other Users5.2.2.1. Creating new users
5.2.2.1. Creating new users5.2.2.2. Modifying Users
5.2.2.2. Modifying Users3.3. User Preferences
3.3. User Preferences3.3.1. Account Settings
3.3.1. Account Settings3.3.2. Email Settings
3.3.2. Email Settings3.3.3. Page Footer
3.3.3. Page Footer3.3.4. Permissions
3.3.4. PermissionsChapter 3. Using Bugzilla
Chapter 3. Using BugzillaD.2. Loki Bugzilla (Fenris)
D.2. Loki Bugzilla (Fenris)D.3. Issuezilla
D.3. IssuezillaD.5. Perforce SCM
D.5. Perforce SCMD.4. Scarab
D.4. ScarabD.6. SourceForge
D.6. SourceForgeAppendix D. Bugzilla Variants and Competitors
Appendix D. Bugzilla Variants and Competitors5.4. Voting
5.4. Voting2.1. What is Bugzilla?
2.1. What is Bugzilla?2.2. Why Should We Use Bugzilla?
2.2. Why Should We Use Bugzilla?4.3. Win32 Installation Notes
4.3. Win32 Installation Notes4.3.1. Win32 Installation: Step-by-step
4.3.1. Win32 Installation: Step-by-step
-
-binmode(STDIN);
-binmode(STDOUT);
-
-
4.3.2. Additional Windows Tips
4.3.2. Additional Windows Tips