Buncha' release updates. Moved all images to
./images so we don't have multiple copies of the same image, fixed these doc bugs (in no particular order): 94949 97070 97071 97114 96498 95970 96677 94953 96501 96679 97068 97191 97192 git-svn-id: svn://10.0.0.236/trunk@101950 18797224-902f-48f8-a5cc-f745e15eee43
This commit is contained in:
barnboy%trilobyte.net
File diff suppressed because it is too large
Load Diff
@@ -131,8 +131,8 @@ TARGET="_top"
|
||||
<TT
|
||||
CLASS="EMAIL"
|
||||
><<A
|
||||
HREF="mailto:barnboy@NOSPAM.trilobyte.net"
|
||||
>barnboy@NOSPAM.trilobyte.net</A
|
||||
HREF="mailto:barnboy@trilobyte.net"
|
||||
>barnboy@trilobyte.net</A
|
||||
>></TT
|
||||
> to correct them.
|
||||
</P
|
||||
|
||||
231
mozilla/webtools/bugzilla/docs/html/bzhacking.html
Normal file
231
mozilla/webtools/bugzilla/docs/html/bzhacking.html
Normal file
@@ -0,0 +1,231 @@
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Hacking Bugzilla</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
|
||||
"><LINK
|
||||
REL="HOME"
|
||||
TITLE="The Bugzilla Guide"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="Useful Patches and Utilities for Bugzilla"
|
||||
HREF="patches.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="The Quicksearch Utility"
|
||||
HREF="quicksearch.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="GNU Free Documentation License"
|
||||
HREF="gfdl.html"></HEAD
|
||||
><BODY
|
||||
CLASS="SECTION"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>The Bugzilla Guide</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="quicksearch.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Appendix D. Useful Patches and Utilities for Bugzilla</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="gfdl.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="SECTION"
|
||||
><H1
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="BZHACKING"
|
||||
>D.5. Hacking Bugzilla</A
|
||||
></H1
|
||||
><P
|
||||
> What follows are some general guidelines for changing Bugzilla, and adhering to good coding practice while doing so. We've had some checkins in the past which ruined Bugzilla installations because of disregard for these conventions. Sorry for the lack of formatting; I got this info into the Guide on the day of 2.14 release and haven't formatted it yet.
|
||||
</P
|
||||
><P
|
||||
CLASS="LITERALLAYOUT"
|
||||
><br>
|
||||
The following is a guide for reviewers when checking code into Bugzilla's<br>
|
||||
CVS repostory at mozilla.org. If you wish to submit patches to Bugzilla,<br>
|
||||
you should follow the rules and style conventions below. Any code that<br>
|
||||
does not adhere to these basic rules will not be added to Bugzilla's<br>
|
||||
codebase.<br>
|
||||
<br>
|
||||
1. Usage of variables in Regular Expressions<br>
|
||||
<br>
|
||||
It is very important that you don't use a variable in a regular<br>
|
||||
expression unless that variable is supposed to contain an expression.<br>
|
||||
This especially applies when using grep. You should use:<br>
|
||||
<br>
|
||||
grep ($_ eq $value, @array);<br>
|
||||
<br>
|
||||
- NOT -<br>
|
||||
<br>
|
||||
grep (/$value/, @array);<br>
|
||||
<br>
|
||||
If you need to use a non-expression variable inside of an expression, be<br>
|
||||
sure to quote it properly (using \Q..\E).<br>
|
||||
<br>
|
||||
Coding Style for Bugzilla<br>
|
||||
-------------------------<br>
|
||||
<br>
|
||||
While it's true that not all of the code currently in Bugzilla adheres to<br>
|
||||
this styleguide, it is something that is being worked toward. Therefore,<br>
|
||||
we ask that all new code (submitted patches and new files) follow this guide<br>
|
||||
as closely as possible (if you're only changing 1 or 2 lines, you don't have<br>
|
||||
to reformat the entire file :).<br>
|
||||
<br>
|
||||
1. Whitespace<br>
|
||||
<br>
|
||||
Bugzilla's prefered indentation is 4 spaces (no tabs, please).<br>
|
||||
<br>
|
||||
2. Curly braces.<br>
|
||||
<br>
|
||||
The opening brace of a block should be on the same line as the statement<br>
|
||||
that is causing the block and the closing brace should be at the same<br>
|
||||
indentation level as that statement, for example:<br>
|
||||
<br>
|
||||
if ($var) {<br>
|
||||
print "The variable is true";<br>
|
||||
} else {<br>
|
||||
print "Try again";<br>
|
||||
}<br>
|
||||
<br>
|
||||
- NOT -<br>
|
||||
<br>
|
||||
if ($var)<br>
|
||||
{<br>
|
||||
print "The variable is true";<br>
|
||||
}<br>
|
||||
else<br>
|
||||
{<br>
|
||||
print "Try again";<br>
|
||||
}<br>
|
||||
<br>
|
||||
3. File Names<br>
|
||||
<br>
|
||||
File names for bugzilla code and support documention should be legal across<br>
|
||||
multiple platforms. \ / : * ? " < > and | are all illegal characters for<br>
|
||||
filenames on various platforms. Also, file names should not have spaces in<br>
|
||||
them as they can cause confusion in CVS and other mozilla.org utilities.<br>
|
||||
<br>
|
||||
4. Variable Names<br>
|
||||
<br>
|
||||
If a variable is scoped globally ($::variable) its name should be descriptive<br>
|
||||
of what it contains. Local variables can be named a bit looser, provided the<br>
|
||||
context makes their content obvious. For example, $ret could be used as a<br>
|
||||
staging variable for a routine's return value as the line |return $ret;| will<br>
|
||||
make it blatently obvious what the variable holds and most likely be shown<br>
|
||||
on the same screen as |my $ret = "";|.<br>
|
||||
<br>
|
||||
5. Cross Database Compatability<br>
|
||||
<br>
|
||||
Bugzilla was originally written to work with MySQL and therefore took advantage<br>
|
||||
of some of its features that aren't contained in other RDBMS software. These<br>
|
||||
should be avoided in all new code. Examples of these features are enums and<br>
|
||||
encrypt().<br>
|
||||
<br>
|
||||
6. Cross Platform Compatability<br>
|
||||
<br>
|
||||
While Bugzilla was written to be used on Unix based systems (and Unix/Linux is<br>
|
||||
still the only officially supported platform) there are many who desire/need to<br>
|
||||
run Bugzilla on Microsoft Windows boxes. Whenever possible, we should strive<br>
|
||||
not to make the lives of these people any more complicated and avoid doing things<br>
|
||||
that break Bugzilla's ability to run on multiple operating systems.<br>
|
||||
<br>
|
||||
</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="quicksearch.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="gfdl.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>The Quicksearch Utility</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="patches.html"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>GNU Free Documentation License</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
||||
@@ -78,7 +78,8 @@ NAME="CONTRIBUTORS"
|
||||
documentation (in no particular order):
|
||||
</P
|
||||
><P
|
||||
> Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron Teitelbaum
|
||||
> Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron
|
||||
Teitelbaum, Jacob Steenhagen, Joe Robins
|
||||
</P
|
||||
></DIV
|
||||
><DIV
|
||||
|
||||
@@ -122,8 +122,7 @@ WIDTH="10%"
|
||||
><P
|
||||
> If you have any questions regarding this document, its
|
||||
copyright, or publishing this document in non-electronic form,
|
||||
please contact Matthew P. Barnson. Remove "NOSPAM" from email address
|
||||
to send.
|
||||
please contact Matthew P. Barnson.
|
||||
</P
|
||||
></DIV
|
||||
><DIV
|
||||
|
||||
@@ -85,8 +85,8 @@ HREF="mailto://terry@mozilla.org"
|
||||
TARGET="_top"
|
||||
>Terry Weissman</A
|
||||
>
|
||||
for initially converting Bugzilla from BugSplat! and writing the
|
||||
README upon which this documentation is largely based.
|
||||
for initially writing Bugzilla and creating the
|
||||
README upon which the UNIX installation documentation is largely based.
|
||||
</P
|
||||
><P
|
||||
> <A
|
||||
|
||||
@@ -91,6 +91,20 @@ CLASS="QUOTE"
|
||||
an @resolution field, you can even change the Bugzilla bug
|
||||
state.
|
||||
</P
|
||||
><P
|
||||
> There is also a project, based upon somewhat dated Bugzilla
|
||||
code, to integrate CVS and Bugzilla through CVS' ability to
|
||||
email. Check it out at:
|
||||
<A
|
||||
HREF="http://homepages.kcbbs.gen.nz/~tonyg/"
|
||||
TARGET="_top"
|
||||
> http://homepages.kcbbs.gen.nz/~tonyg/</A
|
||||
>, under the
|
||||
<SPAN
|
||||
CLASS="QUOTE"
|
||||
>"cvszilla"</SPAN
|
||||
> link.
|
||||
</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
|
||||
@@ -137,7 +137,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN2217"
|
||||
NAME="AEN2331"
|
||||
>C.2.1. Bugzilla Database Basics</A
|
||||
></H2
|
||||
><P
|
||||
@@ -260,7 +260,7 @@ CLASS="SECTION"
|
||||
><H3
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN2246"
|
||||
NAME="AEN2360"
|
||||
>C.2.1.1. Bugzilla Database Tables</A
|
||||
></H3
|
||||
><P
|
||||
|
||||
@@ -78,7 +78,7 @@ NAME="DBSCHEMA"
|
||||
CLASS="MEDIAOBJECT"
|
||||
><P
|
||||
><IMG
|
||||
SRC="dbschema.jpg"
|
||||
SRC="../images/dbschema.jpg"
|
||||
ALT="Database Relationships"
|
||||
></IMG
|
||||
><DIV
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -13,8 +13,8 @@ REL="PREVIOUS"
|
||||
TITLE="Tinderbox/Tinderbox2"
|
||||
HREF="tinderbox.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="The Bugzilla FAQ"
|
||||
HREF="faq.html"></HEAD
|
||||
TITLE="Bugzilla Variants and Competitors"
|
||||
HREF="variants.html"></HEAD
|
||||
><BODY
|
||||
CLASS="CHAPTER"
|
||||
BGCOLOR="#FFFFFF"
|
||||
@@ -54,7 +54,7 @@ WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="faq.html"
|
||||
HREF="variants.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -85,11 +85,600 @@ CLASS="SYNOPSIS"
|
||||
></TR
|
||||
></TABLE
|
||||
><P
|
||||
> The future of Bugzilla is Bugzilla 3.0. Unfortunately, I do
|
||||
not have more information about it right now, and most of what
|
||||
went into the "future" section is now present. That stuff was
|
||||
blue-sky a year ago; MattyT should have me a new document
|
||||
sometime...
|
||||
> Bugzilla's future is a constantly-changing thing, as various developers
|
||||
<SPAN
|
||||
CLASS="QUOTE"
|
||||
>"scratch an itch"</SPAN
|
||||
> when it comes to functionality.
|
||||
Thus this section is very malleable, subject to change without notice, etc.
|
||||
You'll probably also notice the lack of formatting. I apologize that it's
|
||||
not quite as readable as the rest of the Guide.
|
||||
</P
|
||||
><P
|
||||
> <P
|
||||
CLASS="LITERALLAYOUT"
|
||||
> Bugzilla Blue Sky<br>
|
||||
<br>
|
||||
Customisability<br>
|
||||
<br>
|
||||
One of the major stumbling blocks of Bugzilla has been that it is too<br>
|
||||
rigid and does not adapt itself well enough to the needs of an<br>
|
||||
organisation. This has led to organisations making changes to the<br>
|
||||
Bugzilla code that need to be redone each new version of Bugzilla.<br>
|
||||
Bugzilla should attempt to move away from this to a world where this<br>
|
||||
doesn't need to occur.<br>
|
||||
<br>
|
||||
Most of the subsections in this section are currently explicit design<br>
|
||||
goals for the "Bugzilla 3" rewrite. This does not necessarily mean<br>
|
||||
that they will not occur before them in Bugzilla 2, but most are<br>
|
||||
significant undertakings.<br>
|
||||
<br>
|
||||
Field Customisation<br>
|
||||
<br>
|
||||
Many installations wish to customise the fields that appear on bug<br>
|
||||
reports. Current versions of Bugzilla offer limited<br>
|
||||
customisability. In particular, some fields can be turned off.<br>
|
||||
<br>
|
||||
However, many administrators wish to add their own fields, and rename<br>
|
||||
or otherwise modify existing fields. An architecture that supports<br>
|
||||
this would be extraordinarily useful.<br>
|
||||
<br>
|
||||
Indeed, many fields work similarly and could be abstracted into "field<br>
|
||||
types", so that an administrator need write little or no code to<br>
|
||||
support the new fields they desire.<br>
|
||||
<br>
|
||||
Possible field types include text (eg status whiteboard), numbers,<br>
|
||||
dates (eg report time), accounts (eg reporter, qa, cc), inter-bug<br>
|
||||
relationships (dependencies, duplicates), option groups (platform, os,<br>
|
||||
severity, priority, target milestone, version) etc.<br>
|
||||
<br>
|
||||
Ideally an administrator could configure their fields through a<br>
|
||||
Bugzilla interface that requires no code to be added. However, it is<br>
|
||||
highly unlikely this ideal will never be met, and in a similar way<br>
|
||||
that office applications have scripting languages, Bugzilla should<br>
|
||||
allow new field types to be written.<br>
|
||||
<br>
|
||||
Similarly, a common desire is for resolutions to be added or removed.<br>
|
||||
<br>
|
||||
Allocations<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Option Groups<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Relations<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Database Integrity<br>
|
||||
<br>
|
||||
Furthermore, it is desirable for administrators to be able to specify<br>
|
||||
rules that must or should apply between the fields on a bug report.<br>
|
||||
<br>
|
||||
For example, you might wish to specify that a bug with status ASSIGNED<br>
|
||||
must have a target milestone field that that is not untargetted. Or<br>
|
||||
that a bug with a certain number of votes should get ASSIGNED. Or<br>
|
||||
that the QA contact must be different from the assignee.<br>
|
||||
<br>
|
||||
"Must" relationships could be implemented by refusing to make changes<br>
|
||||
that violate the relationships, or alternatively, automatically<br>
|
||||
updating certain fields in order to satisfy the criteria. Which<br>
|
||||
occurs should be up to the administrator.<br>
|
||||
<br>
|
||||
"Should" relationships could be implemented by a combination of<br>
|
||||
emitting warnings on the process bug page, the same on notification<br>
|
||||
mails, or emitting periodic whine mails about the situation. Again,<br>
|
||||
which occurs should be up to the administrator.<br>
|
||||
<br>
|
||||
It should also be possible for whine mails to be emitted for "must"<br>
|
||||
relationships, as they might become violated through direct database<br>
|
||||
access, Bugzilla bugs, or because they were there before the<br>
|
||||
relationship was enforced.<br>
|
||||
<br>
|
||||
As well as implementing intra-bug constraints, it would be useful to<br>
|
||||
create inter-bug constraints. For example, a bug that is dependent on<br>
|
||||
another bug should not have an earlier milestone or greater priority<br>
|
||||
than that bug.<br>
|
||||
<br>
|
||||
Database Adaptability<br>
|
||||
<br>
|
||||
Often an administrator desires that fields adapt to the values of<br>
|
||||
other fields. For example, the value of a field might determine the<br>
|
||||
possible values of another field or even whether it appears (whether<br>
|
||||
it is "applicable").<br>
|
||||
<br>
|
||||
Limited adaptability is present in Bugzilla 2, and only on the<br>
|
||||
"Product" field:<br>
|
||||
* The possible values of the target milestone, version and component<br>
|
||||
fields depend on the product.<br>
|
||||
* UNCONFIRMED can be turned off for specific products.<br>
|
||||
* Voting can be configured differently or turned off for different<br>
|
||||
products, and there is a separate user vote limits for each<br>
|
||||
product.<br>
|
||||
<br>
|
||||
It would be good if more adaptability was present, both in terms of<br>
|
||||
all fields relying on the product, as well as the ability to adapt<br>
|
||||
based on the value of all fields.<br>
|
||||
<br>
|
||||
Example ???<br>
|
||||
<br>
|
||||
General adaptability raises the issue of circular references between<br>
|
||||
fields causing problems. One possible solution to this is to place<br>
|
||||
the fields in a total ordering and require a field refer only to the<br>
|
||||
previous fields.<br>
|
||||
<br>
|
||||
In Bugzilla 2, changing the product of a bug meant a second page would<br>
|
||||
appear that allowed you to choose a new milestone, component and<br>
|
||||
version, as those fields adapted themselves to the new product. This<br>
|
||||
page could be generalised to support all instances where:<br>
|
||||
* a field value must or might be changed because the possible values<br>
|
||||
have changed<br>
|
||||
* is going to drop off because it it is no longer applicable, and<br>
|
||||
this should be confirmed<br>
|
||||
* must be specified because it is suddenly applicable, and the<br>
|
||||
default value, if one exists, might not be acceptable<br>
|
||||
<br>
|
||||
Database Independence<br>
|
||||
<br>
|
||||
Currently Bugzilla only runs on the MySQL database. It would be<br>
|
||||
desirable for Bugzilla to run on other databases, because:<br>
|
||||
* Organisations may have existing database products they use and<br>
|
||||
would prefer to run a homogenous environment.<br>
|
||||
* Databases each have their own shortcomings, including MySQL. An<br>
|
||||
administrator might choose a database that would work better with<br>
|
||||
their Bugzilla.<br>
|
||||
<br>
|
||||
This raises the possibility that we could use features that are only<br>
|
||||
present in some databases, by appropriately falling back. For<br>
|
||||
example, in the MySQL world, we live without:<br>
|
||||
* record-level locking, instead we use table-level locking<br>
|
||||
* referential and record constraints, instead we checking code<br>
|
||||
* subselects, instead we use multiple queries and redundant "caches"<br>
|
||||
<br>
|
||||
Multiple Front Ends<br>
|
||||
<br>
|
||||
Currently Bugzilla is manipulated via the Web, and notifies via<br>
|
||||
E-Mail. It would be desirable for Bugzilla to easily support various<br>
|
||||
front ends.<br>
|
||||
<br>
|
||||
There is no reason that Bugzilla could not be controlled via a whole<br>
|
||||
range of front ends, including Web, E-Mail, IRC, ICQ, etc, and<br>
|
||||
similarly for how it notifies. It's also possible that we could<br>
|
||||
introduce a special Bugzilla client that uses its own protocol, for<br>
|
||||
maximum user productivity.<br>
|
||||
<br>
|
||||
Indeed a request reply might be returned via a totally different<br>
|
||||
transport method than was use to submit the request.<br>
|
||||
<br>
|
||||
Internationalisation<br>
|
||||
<br>
|
||||
Bugzilla currently supports only English. All of the field names,<br>
|
||||
user instructions, etc are written in English. It would be desirable<br>
|
||||
to allow "language packs" so Bugzilla can be easily used in<br>
|
||||
non-English speaking locales.<br>
|
||||
<br>
|
||||
To a degree field customisation supports this, because administrators<br>
|
||||
could specify their own fields names anyway. However, there will<br>
|
||||
always be some basic facilities not covered by this, and it is<br>
|
||||
desirable that the administrator's interface also is<br>
|
||||
internationalisable.<br>
|
||||
<br>
|
||||
Better Searching<br>
|
||||
<br>
|
||||
General Summary Reports<br>
|
||||
<br>
|
||||
Sometimes, the normal querying page leaves a lot to be desired. There<br>
|
||||
are other facilities already in place or which people have asked for:<br>
|
||||
<br>
|
||||
Most Doomed Reports - All Bugs or All Bugs In A Product, Categorised<br>
|
||||
On Assignee, Shows and Counts Number of Bugs For Each Assignee<br>
|
||||
Most Voted For Bugs - All Bugs, Categorised On Product, Shows Top Ten<br>
|
||||
Bugs Voters Most Want Fixed<br>
|
||||
Number of Open Bugs For An Assignee - Bug List, Categorised On<br>
|
||||
Developers, Counts Number of Bugs In Category<br>
|
||||
<br>
|
||||
The important thing to realise is that people want categorised reports<br>
|
||||
on all sorts of things - a general summary report.<br>
|
||||
<br>
|
||||
In a categorised report, you choose the subset of bugs you wish to<br>
|
||||
operate on (similar to how you would specify a query), and then<br>
|
||||
categorise them on one or more fields.<br>
|
||||
<br>
|
||||
For each category you display the count of the number of things in<br>
|
||||
that category. You can optionally display the bugs themselves, or<br>
|
||||
leave them out, just showing the counts. And you can optionally limit<br>
|
||||
the number of things (bugs or subcategories) that display in each<br>
|
||||
category.<br>
|
||||
<br>
|
||||
Such a mechanism would let you do all of the above and more.<br>
|
||||
Applications of this mechanism would only be recognised once it was<br>
|
||||
implemented.<br>
|
||||
<br>
|
||||
Related Bugs<br>
|
||||
<br>
|
||||
It would be nice to have a field where you could enter other bugs<br>
|
||||
related to the current bug. It would be handy for navigation and<br>
|
||||
possibly even finding duplicates.<br>
|
||||
<br>
|
||||
Column Specification Support<br>
|
||||
<br>
|
||||
Currently bug lists use the columns that you last used. This doesn't<br>
|
||||
work well for "prepackaged queries", where you followed a link. You<br>
|
||||
can probably add a column by specifying a sort column, but this is<br>
|
||||
difficult and suboptimal.<br>
|
||||
<br>
|
||||
Furthermore, I find that when I want to add a column to a bug list,<br>
|
||||
it's usually a one off and I would prefer it to go away for the next<br>
|
||||
query. Hence, it would be nice to specify the columns that appear on<br>
|
||||
the bug list (and general summary report) pages. The default query<br>
|
||||
mechanism should be able to let you specify your default columns.<br>
|
||||
<br>
|
||||
Advanced Querying Redesign<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Keywords<br>
|
||||
<br>
|
||||
People have a need to apply tags to bugs. In the beginning, people<br>
|
||||
placed designators in the summary and status whiteboard. However,<br>
|
||||
these fields were not designed for that, and so there were many flaws<br>
|
||||
with this system:<br>
|
||||
* They pollute the field with information that was never intended to<br>
|
||||
be present.<br>
|
||||
* Removing them with a bulk change is a difficult problem that has<br>
|
||||
too many pitfalls to implement.<br>
|
||||
* You can easily get the capitalisation wrong.<br>
|
||||
<br>
|
||||
Then dependencies were introduced (when?), and people realised that<br>
|
||||
they could use them for "tracking bugs". Again, dependencies were not<br>
|
||||
designed for that, and so there were more flaws, albeit different<br>
|
||||
ones, including:<br>
|
||||
* They aren't really bugs, so it's difficult to distinguish issues<br>
|
||||
from bugs.<br>
|
||||
* They can pollute bugs counts, and you must somehow exclude them<br>
|
||||
from queries.<br>
|
||||
* There is a whole lot of useless information on them. They have an<br>
|
||||
assignee but there is nothing to fix, and that person can get<br>
|
||||
whined at by Bugzilla. They have target milestones which must be<br>
|
||||
manually maintained. And so on.<br>
|
||||
<br>
|
||||
Finally, keywords were introduced (when?) for this purpose to remove<br>
|
||||
the need for these two systems. Unfortunately, the simple keywords<br>
|
||||
implementation was itself lacking in certain features provided by the<br>
|
||||
two previous systems, and has remained almost unchanged since its<br>
|
||||
inception. Furthermore, it could not be forseen that in large<br>
|
||||
installations, the sheer number of keywords could become unwieldly and<br>
|
||||
could lead to a movement back to the other systems.<br>
|
||||
<br>
|
||||
The keywords system was the right idea, however, and it remains so.<br>
|
||||
Fixing the keywords system is one of the most important Bugzilla<br>
|
||||
issues.<br>
|
||||
<br>
|
||||
Bringing Keywords Up To Par<br>
|
||||
<br>
|
||||
For the most part, keywords are very good at what they do. It is easy<br>
|
||||
to add and remove them (unlike summary/whiteboard designators), we can<br>
|
||||
simply see what issues are present on a bug (unlike tracking bugs),<br>
|
||||
and we do not confuse bugs with issues (unlike tracking bugs).<br>
|
||||
<br>
|
||||
However, there are still some "regressions" in the keyword system over<br>
|
||||
previous systems:<br>
|
||||
* Users wish to view the "dependency forest" of a keyword. While a<br>
|
||||
dependency tree is of one bug, a dependency forest is of a bug<br>
|
||||
list, and consists of a dependency tree for each member of the bug<br>
|
||||
list. Users can work around this with tracking bugs by creating a<br>
|
||||
tracking bug and viewing the dependency tree of that tracking bug.<br>
|
||||
* Users wish to specify the keywords that initially apply to a bug,<br>
|
||||
but instead they must edit the bug once it has already been<br>
|
||||
submitted. They can work around this with summary designators,<br>
|
||||
since they specify the summary at reporting time.<br>
|
||||
* Users wish to store or share a bug list that contains a keywords<br>
|
||||
column. Hence they wish to be able to specify what columns appear<br>
|
||||
in the bug list URL, as mentioned earlier. They can work around<br>
|
||||
this using summary designators, since almost all bug lists have a<br>
|
||||
summary column.<br>
|
||||
* Users wish to be able to view keywords on a bug list. However<br>
|
||||
often they are only interested in a small number of keywords.<br>
|
||||
Having a bug list with a keywords column means that all keywords<br>
|
||||
will appear on a bug list. This can take a substantial amount of<br>
|
||||
space where a bug has a lot of keywords, since the table columns<br>
|
||||
in Bugzilla adjust to the largest cell in that column. Hence<br>
|
||||
users wish to be able to specify which keywords should appear in<br>
|
||||
the bug list. In a very real sense, each keyword is a field unto<br>
|
||||
itself. Users can work around this by using summary designators,<br>
|
||||
since they keywords will share the space in the summary column.<br>
|
||||
* Users wish to know when bugs with a specific issue are resolved.<br>
|
||||
Hence they wish to be able to receive notifications on all the<br>
|
||||
bugs with a specific keyword. The introduction a generic watching<br>
|
||||
facility (also for things like watching all bugs in a component)<br>
|
||||
would achieve this. Users can work around this by using tracking<br>
|
||||
bugs, as dependencies have an existing way of detecting fixes to<br>
|
||||
bug a bug was blocked by.<br>
|
||||
<br>
|
||||
Dealing With The Keyword Overload<br>
|
||||
<br>
|
||||
At the time of writing, the mozilla.org installation has approximately<br>
|
||||
100 keywords, and many more would be in use if the keywords system<br>
|
||||
didn't have the problems it does.<br>
|
||||
<br>
|
||||
Such a large number of keywords introduces logistical problems:<br>
|
||||
* It must be easy for someone to learn what a keyword means. If a<br>
|
||||
keyword is buried within a lot of other keywords, it can be<br>
|
||||
difficult to find.<br>
|
||||
* It must be easy to see what keywords are on a bug. If the number<br>
|
||||
of keywords is large, then this can be difficult.<br>
|
||||
<br>
|
||||
These lead some people to feel that there are "too many keywords".<br>
|
||||
<br>
|
||||
These problems are not without solutions however. It is harder to<br>
|
||||
find a list of designators or tracking bugs than it is a list of<br>
|
||||
keywords.<br>
|
||||
<br>
|
||||
The essential problem is it needs to be easy to find the keywords<br>
|
||||
we're interested in through the mass of keywords.<br>
|
||||
<br>
|
||||
Keyword Applicability<br>
|
||||
<br>
|
||||
As has been previously mentioned, it is desirable for fields to be<br>
|
||||
able to adapt to the values of other fields. This is certainly true<br>
|
||||
for keywords. Many keywords are simply not relevant because of the<br>
|
||||
bugs product, component, etc.<br>
|
||||
<br>
|
||||
Hence, by introducing keyword applicability, and not displaying<br>
|
||||
keywords that are not relevant to the current bug, or clearly<br>
|
||||
separating them, we can make the keyword overload problem less<br>
|
||||
significant.<br>
|
||||
<br>
|
||||
Currently when you click on "keywords" on a bug, you get a list of all<br>
|
||||
bugs. It would be desirable to introduce a list of keywords tailored<br>
|
||||
to a specific bug, that reports, in order:<br>
|
||||
* the keywords currently on the bug<br>
|
||||
* the keywords not currently on the bug, but applicable to the bug<br>
|
||||
* optionally, the keywords not applicable to the bug<br>
|
||||
<br>
|
||||
This essentially orders the keywords into three groups, where each<br>
|
||||
group is more important than the previous, and therefore appears<br>
|
||||
closer to the top.<br>
|
||||
<br>
|
||||
Keyword Grouping & Ordering<br>
|
||||
<br>
|
||||
We could further enhance both the global and bug specific keyword list<br>
|
||||
by grouping keywords. We should always have a "flat" view of<br>
|
||||
keywords, but other ways of viewing the keywords would be useful too.<br>
|
||||
<br>
|
||||
If keyword applicability was implemented, we could group keywords<br>
|
||||
based on their "applicability condition". Keywords that apply to all<br>
|
||||
bugs could be separated from keywords that apply to a specific<br>
|
||||
product, both on the global keyword list and the keyword list of a bug<br>
|
||||
that is in that product.<br>
|
||||
<br>
|
||||
We could specify groups of our own. For example, many keywords are in<br>
|
||||
a mutually exclusive group, essentially like radio buttons in a user<br>
|
||||
interface. This creates a natural grouping, although other groupings<br>
|
||||
occur (which depends on your keywords).<br>
|
||||
<br>
|
||||
It is possible that we could use collapsing/expanding operations on<br>
|
||||
"twisties" to only should the groups we are interested in.<br>
|
||||
<br>
|
||||
And instead of grouping keywords, we could order them on some metric<br>
|
||||
of usefulness, such as:<br>
|
||||
* when the keyword was last added to a bug<br>
|
||||
* how many bugs the keyword is on<br>
|
||||
* how many open bugs the keyword is on<br>
|
||||
<br>
|
||||
Opting Out Of Keywords<br>
|
||||
<br>
|
||||
Not all people are going to care about all keywords. Therefore it<br>
|
||||
makes sense that you may wish to specify which keywords you are<br>
|
||||
interested in, either on the bug page, or on notifications.<br>
|
||||
<br>
|
||||
Other keywords will therefore not bother users who are not interested<br>
|
||||
in them.<br>
|
||||
<br>
|
||||
Keyword Security<br>
|
||||
<br>
|
||||
Currently all keywords are available and editable to all people with<br>
|
||||
edit bugs access. This situation is clearly suboptimal.<br>
|
||||
<br>
|
||||
Although relying on good behaviour for people to not do what they<br>
|
||||
shouldn't works reasonably well on the mozilla.org, it is better to<br>
|
||||
enforce that behaviour - it can be breached through malice, accident<br>
|
||||
or ignorance.<br>
|
||||
<br>
|
||||
And in the situation where it is desirable for the presence or absence<br>
|
||||
of a keyword not to be revealed, organisations either need to be<br>
|
||||
content with the divulgence, or not use keywords at all.<br>
|
||||
<br>
|
||||
In the situation where they choose to divulge, introducing the ability<br>
|
||||
to restrict who can see the keyword would also reduce keyword<br>
|
||||
overload.<br>
|
||||
<br>
|
||||
Personal Keywords<br>
|
||||
<br>
|
||||
Keywords join together a set of bugs which would otherwise be<br>
|
||||
unrelated in the bug system.<br>
|
||||
<br>
|
||||
We allow users to store their own queries. However we don't allow<br>
|
||||
them to store their own keywords on a bug. This reduces the<br>
|
||||
usefulness of personal queries, since you cannot join a set of<br>
|
||||
unrelated bugs together in a way that you wish. Lists of bug numbers<br>
|
||||
can work, by they can only be used for small lists, and it is<br>
|
||||
impossible to share a list between multiple queries.<br>
|
||||
<br>
|
||||
Personal keywords are necessary to replace personal tracking bugs, as<br>
|
||||
they would not pollute the keyword space. Indeed, on many<br>
|
||||
installations this could remove some keywords out of the global<br>
|
||||
keyword space.<br>
|
||||
<br>
|
||||
In a similar vein and with similar effects, group keywords could be<br>
|
||||
introduced that are only available to members of a specific group.<br>
|
||||
<br>
|
||||
Keyword Restrictions<br>
|
||||
<br>
|
||||
Keywords are not islands unto themselves. Along with their potential<br>
|
||||
to be involved in the inter-field relationships mentioned earlier,<br>
|
||||
keywords can also be related to other keywords.<br>
|
||||
<br>
|
||||
Essentially, there are two possibilities:<br>
|
||||
* a set of keywords are mutually exclusive<br>
|
||||
* the presence of a keyword implies another keyword must be present<br>
|
||||
<br>
|
||||
Introduction of the ability to specify these restrictions would have<br>
|
||||
benefits.<br>
|
||||
<br>
|
||||
If mutually exclusive keywords were present on a bug, their removal<br>
|
||||
would fix up the database, as well as reducing the number of keywords<br>
|
||||
on that bug.<br>
|
||||
<br>
|
||||
In the situation where a keyword implies another keyword, there are<br>
|
||||
two possiblities as to how to handle the situation.<br>
|
||||
<br>
|
||||
The first is automatically add the keyword. This would fix up the<br>
|
||||
database, but it would increase the number of keywords on a bug.<br>
|
||||
<br>
|
||||
The second is to automatically remove the keyword, and alter queries<br>
|
||||
so they pick up the first keyword as well as the removed keyword.<br>
|
||||
This would fix up the database and reduce the number of keywords on a<br>
|
||||
bug, but it might confuse users who don't see the keyword.<br>
|
||||
Alternatively, the implied keywords could be listed separately.<br>
|
||||
<br>
|
||||
Notifications<br>
|
||||
<br>
|
||||
Every time a bug gets changed notifications get sent out to people<br>
|
||||
letting them know about what changes have been made. This is a<br>
|
||||
significant feature, and all sorts of questions can be raised, but<br>
|
||||
they mainly boil down to when they should be sent and what they should<br>
|
||||
look like.<br>
|
||||
<br>
|
||||
Changes You're Interested In<br>
|
||||
<br>
|
||||
As of version 2.12 users can specify what sort of changes they are<br>
|
||||
interested in receiving notifications for. However, this is still<br>
|
||||
limited. As yet there is no facility to specify which keywords you<br>
|
||||
care about, and whether you care about changes to fields such as the<br>
|
||||
QA contact changes.<br>
|
||||
Furthermore, often an unnecessary comment will go along with a change,<br>
|
||||
either because it is required, or the commenter is ignorant of how the<br>
|
||||
new system works. While explaining why you did something is useful,<br>
|
||||
merely commenting on what you did is not because that information is<br>
|
||||
already accessible view "Bug Activity".<br>
|
||||
<br>
|
||||
Because of this unnecessary comment, a lot of changes that would<br>
|
||||
otherwise not generate notifications for certain people do so, because<br>
|
||||
few people are willing to turn off comments. One way to deal with<br>
|
||||
this problem is to allow people to specify that their comments are<br>
|
||||
purely explanatory, and that anyone who is not interested in the<br>
|
||||
change will not be interested in the comment.<br>
|
||||
<br>
|
||||
Furthermore, one possible rationale for unnecessary comments is that<br>
|
||||
the bug activity does not display on the normal page and hence it is<br>
|
||||
difficult to cross reference comments and actions. Hence, it would be<br>
|
||||
beneficial to be able to do this.<br>
|
||||
<br>
|
||||
Bugs You're Watching<br>
|
||||
<br>
|
||||
Currently to receive a notification about a bug you need to have your<br>
|
||||
name on it. This is suboptimal because you need to know about a bug<br>
|
||||
before you can receive notifications on it. Often you are interested<br>
|
||||
in any bug with a field set to a specific value. For example, you<br>
|
||||
might be interested in all bugs with a specific product, component or<br>
|
||||
keyword.<br>
|
||||
<br>
|
||||
If someone could automatically receive notifications about these bugs,<br>
|
||||
it would make everyone's lives easier. Currently the default assignee<br>
|
||||
and QA contact for a component will automatically receive<br>
|
||||
notifications for<br>
|
||||
<br>
|
||||
Question: This moves half way to a BCC.<br>
|
||||
<br>
|
||||
Bulk Changes<br>
|
||||
<br>
|
||||
A very useful feature of Bugzilla is the ability to perform an action<br>
|
||||
on multiple bugs at once. However, this means that similar<br>
|
||||
notifications are currently generated for each bug modified.<br>
|
||||
<br>
|
||||
This can result in a torrent of notifications that can annoy.<br>
|
||||
<br>
|
||||
Furthermore, since the bugs are all changed close to each other in<br>
|
||||
time, it is easy for someone to mass delete all the notifications<br>
|
||||
generated by a bulk change and miss an unrelated notification in the<br>
|
||||
middle.<br>
|
||||
<br>
|
||||
These factors can lead to a tendency for people to delay bulk changes,<br>
|
||||
or avoid them entirely. This is suboptimal.<br>
|
||||
<br>
|
||||
It would be better if a bulk change generated only one notification<br>
|
||||
mail. This would vastly reduce the annoyance factor, and prevent<br>
|
||||
accidental deletion of notifications.<br>
|
||||
<br>
|
||||
One problem with this change is that some people separate out<br>
|
||||
notifications using filtering. This means that they would no longer<br>
|
||||
be match parts of a bulk change under different filtering rules.<br>
|
||||
<br>
|
||||
One possibility to resolve this is to allow people to specify groups<br>
|
||||
of bugs. All bugs within a group would go into the same<br>
|
||||
notification. The filters could then distinguish the different bug<br>
|
||||
groups.<br>
|
||||
<br>
|
||||
In any case, it is likely there would need to be a transition period<br>
|
||||
to allow people to alter their filters.<br>
|
||||
<br>
|
||||
Nominations<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Linking Bugzilla Installations<br>
|
||||
<br>
|
||||
The first example of linking Bugzilla installations together has is<br>
|
||||
the introduction of bug moving in version 2.12. However, it would be<br>
|
||||
useful to be able to link installations in more ways.<br>
|
||||
* Dependencies and other relationships between bugs in other<br>
|
||||
installations. This is difficult because dependencies are<br>
|
||||
synchronised on both bugs, so the installation that changes<br>
|
||||
dependencies would need to communicate the new state to the other<br>
|
||||
installation. It would also mean that relationships and<br>
|
||||
notifications that refer to other bugs would need to communicate<br>
|
||||
with the other installation.<br>
|
||||
* References to bugs in other installations. Currently if you type<br>
|
||||
"bug XXX" or "bug #XXX" where XXX is a number, you get an<br>
|
||||
automatic hyperlink to that bug. It would be useful if you could<br>
|
||||
say "YYY bug #XXX" where YYY is the name of another installation.<br>
|
||||
<br>
|
||||
Retirement<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Whiny Reports<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Group Redesign<br>
|
||||
<br>
|
||||
?<br>
|
||||
<br>
|
||||
Hard Wrapping Comments<br>
|
||||
<br>
|
||||
Currently Bugzilla "hard wraps" its comments to a specific line size,<br>
|
||||
similar to E-Mail. This has various problems:<br>
|
||||
* The way it currently works, wrapping is done in the browser at<br>
|
||||
submission time using a non-standard HTML extension not supported<br>
|
||||
by some (uncommon) browsers. These browsers generate comments<br>
|
||||
that scroll off the right side of the screen.<br>
|
||||
* Because comments are of fixed width, when you expand your browser<br>
|
||||
window, the comments do not expand to fit available space.<br>
|
||||
<br>
|
||||
It would be much better to move to a world of soft wrapping, where the<br>
|
||||
browser wraps the text at display time, similar to a world processor.<br>
|
||||
And as in a word processor, soft wrapping does not preclude the<br>
|
||||
insertion of newlines.<br>
|
||||
<br>
|
||||
Hard wrapping is too entrenched into text E-Mail to fix, but we can<br>
|
||||
fix Bugzilla without causing any problems. The old content will still<br>
|
||||
be wrapped too early, but at least new content will work.<br>
|
||||
</P
|
||||
>
|
||||
</P
|
||||
></DIV
|
||||
><DIV
|
||||
@@ -123,7 +712,7 @@ WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="faq.html"
|
||||
HREF="variants.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -142,7 +731,7 @@ VALIGN="top"
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>The Bugzilla FAQ</TD
|
||||
>Bugzilla Variants and Competitors</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
|
||||
@@ -78,7 +78,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN916"
|
||||
NAME="AEN941"
|
||||
>3.5.1. Modifying Your Running System</A
|
||||
></H2
|
||||
><P
|
||||
@@ -111,7 +111,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN923"
|
||||
NAME="AEN948"
|
||||
>3.5.2. Upgrading From Previous Versions</A
|
||||
></H2
|
||||
><P
|
||||
@@ -323,7 +323,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN964"
|
||||
NAME="UNIXHISTORY"
|
||||
>3.5.6. UNIX Installation Instructions History</A
|
||||
></H2
|
||||
><P
|
||||
@@ -335,9 +335,11 @@ NAME="AEN964"
|
||||
> The February 25, 1999 re-write of this page was done by Ry4an
|
||||
Brase <ry4an@ry4an.org>, with some edits by Terry
|
||||
Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But
|
||||
don't send bug reports to them; report them using bugzilla, at
|
||||
http://bugzilla.mozilla.org/enter_bug.cgi , project Webtools,
|
||||
component Bugzilla).
|
||||
don't send bug reports to them; report them using bugzilla, at <A
|
||||
HREF="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla"
|
||||
TARGET="_top"
|
||||
>http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla</A
|
||||
> ).
|
||||
</P
|
||||
><P
|
||||
> This document was heavily modified again Wednesday, March 07
|
||||
|
||||
@@ -10,8 +10,8 @@ REL="HOME"
|
||||
TITLE="The Bugzilla Guide"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="The Quicksearch Utility"
|
||||
HREF="quicksearch.html"><LINK
|
||||
TITLE="Hacking Bugzilla"
|
||||
HREF="bzhacking.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="PREAMBLE"
|
||||
HREF="gfdl_0.html"></HEAD
|
||||
@@ -41,7 +41,7 @@ WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="quicksearch.html"
|
||||
HREF="bzhacking.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
@@ -141,7 +141,7 @@ HREF="gfdl_howto.html"
|
||||
><P
|
||||
>Version 1.1, March 2000</P
|
||||
><A
|
||||
NAME="AEN2416"
|
||||
NAME="AEN2499"
|
||||
></A
|
||||
><BLOCKQUOTE
|
||||
CLASS="BLOCKQUOTE"
|
||||
@@ -167,7 +167,7 @@ WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="quicksearch.html"
|
||||
HREF="bzhacking.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
@@ -192,7 +192,7 @@ HREF="gfdl_0.html"
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>The Quicksearch Utility</TD
|
||||
>Hacking Bugzilla</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
|
||||
@@ -78,7 +78,7 @@ NAME="GFDL_HOWTO"
|
||||
a copy of the License in the document and put the following
|
||||
copyright and license notices just after the title page:</P
|
||||
><A
|
||||
NAME="AEN2506"
|
||||
NAME="AEN2589"
|
||||
></A
|
||||
><BLOCKQUOTE
|
||||
CLASS="BLOCKQUOTE"
|
||||
|
||||
@@ -68,7 +68,7 @@ CLASS="GLOSSDIV"
|
||||
><H1
|
||||
CLASS="GLOSSDIV"
|
||||
><A
|
||||
NAME="AEN2511"
|
||||
NAME="AEN2594"
|
||||
>0-9, high ascii</A
|
||||
></H1
|
||||
><DL
|
||||
@@ -402,7 +402,7 @@ NAME="GLOSS_P"
|
||||
><DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN2602"
|
||||
NAME="AEN2685"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
|
||||
@@ -16,8 +16,8 @@ REL="PREVIOUS"
|
||||
TITLE="MySQL Bugzilla Database Introduction"
|
||||
HREF="dbdoc.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Bugzilla Variants and Competitors"
|
||||
HREF="variants.html"></HEAD
|
||||
TITLE="Useful Patches and Utilities for Bugzilla"
|
||||
HREF="patches.html"></HEAD
|
||||
><BODY
|
||||
CLASS="SECTION"
|
||||
BGCOLOR="#FFFFFF"
|
||||
@@ -57,7 +57,7 @@ WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="variants.html"
|
||||
HREF="patches.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -313,7 +313,7 @@ WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="variants.html"
|
||||
HREF="patches.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -335,7 +335,7 @@ HREF="database.html"
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Bugzilla Variants and Competitors</TD
|
||||
>Useful Patches and Utilities for Bugzilla</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
|
||||
@@ -438,13 +438,13 @@ CLASS="QUOTE"
|
||||
>scrollbox</EM
|
||||
>. Using the down arrow on
|
||||
the scrollbox, scroll down until you can see an entry
|
||||
called "Webtools". Select this entry.
|
||||
called "Bugzilla". Select this entry.
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Did you notice that some of the boxes to the right changed
|
||||
when you selected "Webtools"? Every Program (or Product)
|
||||
when you selected "Bugzilla"? Every Program (or Product)
|
||||
has different Versions, Components, and Target Milestones
|
||||
associated with it. A "Version" is the number of a
|
||||
software program.
|
||||
@@ -519,7 +519,7 @@ NAME="AEN317"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
>Example 2-2. Mozilla Webtools Components</B
|
||||
>Example 2-2. Mozilla's Bugzilla Components</B
|
||||
></P
|
||||
><DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
@@ -529,7 +529,7 @@ NAME="AEN319"
|
||||
><P
|
||||
></P
|
||||
><P
|
||||
> Mozilla's "Webtools" Product is composed of several pieces (Components):
|
||||
> Mozilla's "Bugzilla" Product is composed of several pieces (Components):
|
||||
<P
|
||||
></P
|
||||
><TABLE
|
||||
@@ -538,60 +538,166 @@ BORDER="0"
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>Bonsai</EM
|
||||
>Administration</EM
|
||||
>,
|
||||
a tool to show recent changes to Mozilla</TD
|
||||
Administration of a bugzilla installation, including
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>editcomponents.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>editgroups.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>editkeywords.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>editparams.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>editproducts.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>editusers.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>editversions.cgi,</TT
|
||||
> and
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>sanitycheck.cgi</TT
|
||||
>.
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>Bugzilla</EM
|
||||
>Bugzilla-General</EM
|
||||
>,
|
||||
a defect-tracking tool</TD
|
||||
Anything that doesn't fit in the other components, or spans
|
||||
multiple components.
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>Build</EM
|
||||
>Creating/Changing Bugs</EM
|
||||
>,
|
||||
a tool to automatically compile source code
|
||||
into machine-readable form</TD
|
||||
Creating, changing, and viewing bugs.
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>enter_bug.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>post_bug.cgi</TT
|
||||
>,
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>show_bug.cgi</TT
|
||||
> and
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>process_bug.cgi</TT
|
||||
>.
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>Despot</EM
|
||||
>Documentation</EM
|
||||
>,
|
||||
a program that controls access to the other Webtools</TD
|
||||
The bugzilla documentation, including anything in the
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>docs/</TT
|
||||
> directory and The Bugzilla Guide
|
||||
(This document :)
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>LXR</EM
|
||||
>Email</EM
|
||||
>,
|
||||
a utility that automatically marks up text files
|
||||
to make them more readable</TD
|
||||
Anything to do with email sent by Bugzilla.
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>processmail</TT
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>MozBot</EM
|
||||
>Installation</EM
|
||||
>,
|
||||
a "robot" that announces changes to Mozilla in Chat</TD
|
||||
The installation process of Bugzilla. This includes
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>checksetup.pl</TT
|
||||
> and whatever else it evolves into.
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>TestManager</EM
|
||||
>Query/Buglist</EM
|
||||
>,
|
||||
a tool to help find bugs in Mozilla</TD
|
||||
Anything to do with searching for bugs and viewing the buglists.
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>query.cgi</TT
|
||||
> and
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>buglist.cgi</TT
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>Tinderbox</EM
|
||||
>Reporting/Charting</EM
|
||||
>,
|
||||
which displays reports from Build</TD
|
||||
Getting reports from Bugzilla.
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>reports.cgi</TT
|
||||
> and
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>duplicates.cgi</TT
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>User Accounts</EM
|
||||
>,
|
||||
Anything about managing a user account from the user's perspective.
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>userprefs.cgi</TT
|
||||
>, saved queries, creating accounts,
|
||||
changing passwords, logging in, etc.
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><EM
|
||||
>User Interface</EM
|
||||
>,
|
||||
General issues having to do with the user interface cosmetics (not
|
||||
functionality) including cosmetic issues, HTML templates, etc.
|
||||
</TD
|
||||
></TR
|
||||
></TBODY
|
||||
></TABLE
|
||||
@@ -600,11 +706,6 @@ BORDER="0"
|
||||
>
|
||||
</P
|
||||
><P
|
||||
> A different person is responsible for each of these Components.
|
||||
Tara Hernandez keeps
|
||||
the "Bugzilla" component up-to-date.
|
||||
</P
|
||||
><P
|
||||
></P
|
||||
></DIV
|
||||
></DIV
|
||||
|
||||
@@ -59,7 +59,7 @@ CLASS="AFFILIATION"
|
||||
CLASS="ADDRESS"
|
||||
><P
|
||||
CLASS="ADDRESS"
|
||||
>barnboy@NOSPAM.trilobyte.net</P
|
||||
>barnboy@trilobyte.net</P
|
||||
></DIV
|
||||
></DIV
|
||||
><SPAN
|
||||
@@ -73,7 +73,7 @@ CLASS="AFFILIATION"
|
||||
CLASS="ADDRESS"
|
||||
><P
|
||||
CLASS="ADDRESS"
|
||||
>zach@NOSPAM.zachlipton.com</P
|
||||
>zach AT zachlipton DOT com</P
|
||||
></DIV
|
||||
></DIV
|
||||
><BR></SPAN
|
||||
@@ -409,12 +409,12 @@ HREF="stepbystep.html"
|
||||
><DL
|
||||
><DT
|
||||
>3.2.1. <A
|
||||
HREF="stepbystep.html#AEN486"
|
||||
HREF="stepbystep.html#AEN509"
|
||||
>Introduction</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.2. <A
|
||||
HREF="stepbystep.html#AEN492"
|
||||
HREF="stepbystep.html#AEN515"
|
||||
>Installing the Prerequisites</A
|
||||
></DT
|
||||
><DT
|
||||
@@ -429,57 +429,57 @@ HREF="stepbystep.html#INSTALL-PERL"
|
||||
></DT
|
||||
><DT
|
||||
>3.2.5. <A
|
||||
HREF="stepbystep.html#AEN579"
|
||||
HREF="stepbystep.html#AEN602"
|
||||
>DBI Perl Module</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.6. <A
|
||||
HREF="stepbystep.html#AEN617"
|
||||
HREF="stepbystep.html#AEN640"
|
||||
>Data::Dumper Perl Module</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.7. <A
|
||||
HREF="stepbystep.html#AEN622"
|
||||
HREF="stepbystep.html#AEN645"
|
||||
>MySQL related Perl Module Collection</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.8. <A
|
||||
HREF="stepbystep.html#AEN631"
|
||||
HREF="stepbystep.html#AEN654"
|
||||
>TimeDate Perl Module Collection</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.9. <A
|
||||
HREF="stepbystep.html#AEN635"
|
||||
HREF="stepbystep.html#AEN658"
|
||||
>GD Perl Module (1.8.3)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.10. <A
|
||||
HREF="stepbystep.html#AEN644"
|
||||
HREF="stepbystep.html#AEN667"
|
||||
>Chart::Base Perl Module (0.99c)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.11. <A
|
||||
HREF="stepbystep.html#AEN648"
|
||||
HREF="stepbystep.html#AEN671"
|
||||
>DB_File Perl Module</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.12. <A
|
||||
HREF="stepbystep.html#AEN651"
|
||||
HREF="stepbystep.html#AEN674"
|
||||
>HTTP Server</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.13. <A
|
||||
HREF="stepbystep.html#AEN669"
|
||||
HREF="stepbystep.html#AEN692"
|
||||
>Installing the Bugzilla Files</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.14. <A
|
||||
HREF="stepbystep.html#AEN696"
|
||||
HREF="stepbystep.html#AEN721"
|
||||
>Setting Up the MySQL Database</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.15. <A
|
||||
HREF="stepbystep.html#AEN743"
|
||||
HREF="stepbystep.html#AEN768"
|
||||
>Tweaking <TT
|
||||
CLASS="FILENAME"
|
||||
>localconfig</TT
|
||||
@@ -487,22 +487,22 @@ CLASS="FILENAME"
|
||||
></DT
|
||||
><DT
|
||||
>3.2.16. <A
|
||||
HREF="stepbystep.html#AEN781"
|
||||
HREF="stepbystep.html#AEN806"
|
||||
>Setting Up Maintainers Manually (Optional)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.17. <A
|
||||
HREF="stepbystep.html#AEN792"
|
||||
HREF="stepbystep.html#AEN817"
|
||||
>The Whining Cron (Optional)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.18. <A
|
||||
HREF="stepbystep.html#AEN802"
|
||||
HREF="stepbystep.html#AEN827"
|
||||
>Bug Graphs (Optional)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.19. <A
|
||||
HREF="stepbystep.html#AEN814"
|
||||
HREF="stepbystep.html#AEN839"
|
||||
>Securing MySQL</A
|
||||
></DT
|
||||
></DL
|
||||
@@ -526,12 +526,12 @@ HREF="geninstall.html"
|
||||
><DL
|
||||
><DT
|
||||
>3.5.1. <A
|
||||
HREF="geninstall.html#AEN916"
|
||||
HREF="geninstall.html#AEN941"
|
||||
>Modifying Your Running System</A
|
||||
></DT
|
||||
><DT
|
||||
>3.5.2. <A
|
||||
HREF="geninstall.html#AEN923"
|
||||
HREF="geninstall.html#AEN948"
|
||||
>Upgrading From Previous Versions</A
|
||||
></DT
|
||||
><DT
|
||||
@@ -557,7 +557,7 @@ HREF="geninstall.html#CONTENT_TYPE"
|
||||
></DT
|
||||
><DT
|
||||
>3.5.6. <A
|
||||
HREF="geninstall.html#AEN964"
|
||||
HREF="geninstall.html#UNIXHISTORY"
|
||||
>UNIX Installation Instructions History</A
|
||||
></DT
|
||||
></DL
|
||||
@@ -579,6 +579,11 @@ HREF="win32.html#WININSTALL"
|
||||
HREF="win32.html#ADDLWINTIPS"
|
||||
>Additional Windows Tips</A
|
||||
></DT
|
||||
><DT
|
||||
>3.6.3. <A
|
||||
HREF="win32.html#BZLDAP"
|
||||
>Bugzilla LDAP Integration</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
@@ -720,58 +725,6 @@ HREF="future.html"
|
||||
>The Future of Bugzilla</A
|
||||
></DT
|
||||
><DT
|
||||
>A. <A
|
||||
HREF="faq.html"
|
||||
>The Bugzilla FAQ</A
|
||||
></DT
|
||||
><DT
|
||||
>B. <A
|
||||
HREF="downloadlinks.html"
|
||||
>Software Download Links</A
|
||||
></DT
|
||||
><DT
|
||||
>C. <A
|
||||
HREF="database.html"
|
||||
>The Bugzilla Database</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>C.1. <A
|
||||
HREF="dbschema.html"
|
||||
>Database Schema Chart</A
|
||||
></DT
|
||||
><DT
|
||||
>C.2. <A
|
||||
HREF="dbdoc.html"
|
||||
>MySQL Bugzilla Database Introduction</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>C.2.1. <A
|
||||
HREF="dbdoc.html#AEN2217"
|
||||
>Bugzilla Database Basics</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>C.2.1.1. <A
|
||||
HREF="dbdoc.html#AEN2246"
|
||||
>Bugzilla Database Tables</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>C.3. <A
|
||||
HREF="granttables.html"
|
||||
>MySQL Permissions & Grant Tables</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>7. <A
|
||||
HREF="variants.html"
|
||||
>Bugzilla Variants and Competitors</A
|
||||
@@ -811,6 +764,58 @@ HREF="variant_sourceforge.html"
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>A. <A
|
||||
HREF="faq.html"
|
||||
>The Bugzilla FAQ</A
|
||||
></DT
|
||||
><DT
|
||||
>B. <A
|
||||
HREF="downloadlinks.html"
|
||||
>Software Download Links</A
|
||||
></DT
|
||||
><DT
|
||||
>C. <A
|
||||
HREF="database.html"
|
||||
>The Bugzilla Database</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>C.1. <A
|
||||
HREF="dbschema.html"
|
||||
>Database Schema Chart</A
|
||||
></DT
|
||||
><DT
|
||||
>C.2. <A
|
||||
HREF="dbdoc.html"
|
||||
>MySQL Bugzilla Database Introduction</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>C.2.1. <A
|
||||
HREF="dbdoc.html#AEN2331"
|
||||
>Bugzilla Database Basics</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>C.2.1.1. <A
|
||||
HREF="dbdoc.html#AEN2360"
|
||||
>Bugzilla Database Tables</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>C.3. <A
|
||||
HREF="granttables.html"
|
||||
>MySQL Permissions & Grant Tables</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>D. <A
|
||||
HREF="patches.html"
|
||||
>Useful Patches and Utilities for Bugzilla</A
|
||||
@@ -840,6 +845,11 @@ HREF="cmdline.html"
|
||||
HREF="quicksearch.html"
|
||||
>The Quicksearch Utility</A
|
||||
></DT
|
||||
><DT
|
||||
>D.5. <A
|
||||
HREF="bzhacking.html"
|
||||
>Hacking Bugzilla</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
@@ -934,67 +944,72 @@ HREF="how.html#AEN307"
|
||||
><DT
|
||||
>2-2. <A
|
||||
HREF="how.html#AEN317"
|
||||
>Mozilla Webtools Components</A
|
||||
>Mozilla's Bugzilla Components</A
|
||||
></DT
|
||||
><DT
|
||||
>3-1. <A
|
||||
HREF="stepbystep.html#AEN685"
|
||||
HREF="stepbystep.html#AEN708"
|
||||
>Setting up bonsaitools symlink</A
|
||||
></DT
|
||||
><DT
|
||||
>3-2. <A
|
||||
HREF="stepbystep.html#AEN774"
|
||||
HREF="stepbystep.html#AEN799"
|
||||
>Running checksetup.pl as the web user</A
|
||||
></DT
|
||||
><DT
|
||||
>3-3. <A
|
||||
HREF="win32.html#AEN1012"
|
||||
HREF="win32.html#AEN1038"
|
||||
>Installing ActivePerl ppd Modules on Microsoft Windows</A
|
||||
></DT
|
||||
><DT
|
||||
>3-4. <A
|
||||
HREF="win32.html#AEN1180"
|
||||
HREF="win32.html#AEN1224"
|
||||
>Removing encrypt() for Windows NT Bugzilla version
|
||||
2.12 or earlier</A
|
||||
></DT
|
||||
><DT
|
||||
>4-1. <A
|
||||
HREF="programadmin.html#AEN1413"
|
||||
HREF="programadmin.html#AEN1461"
|
||||
>Creating some Components</A
|
||||
></DT
|
||||
><DT
|
||||
>4-2. <A
|
||||
HREF="programadmin.html#AEN1442"
|
||||
HREF="programadmin.html#AEN1490"
|
||||
>Common Use of Versions</A
|
||||
></DT
|
||||
><DT
|
||||
>4-3. <A
|
||||
HREF="programadmin.html#AEN1446"
|
||||
HREF="programadmin.html#AEN1494"
|
||||
>A Different Use of Versions</A
|
||||
></DT
|
||||
><DT
|
||||
>4-4. <A
|
||||
HREF="programadmin.html#AEN1474"
|
||||
HREF="programadmin.html#AEN1522"
|
||||
>Using SortKey with Target Milestone</A
|
||||
></DT
|
||||
><DT
|
||||
>4-5. <A
|
||||
HREF="programadmin.html#AEN1510"
|
||||
HREF="programadmin.html#AEN1558"
|
||||
>When to Use Group Security</A
|
||||
></DT
|
||||
><DT
|
||||
>4-6. <A
|
||||
HREF="programadmin.html#AEN1527"
|
||||
HREF="programadmin.html#AEN1575"
|
||||
>Creating a New Group</A
|
||||
></DT
|
||||
><DT
|
||||
>4-7. <A
|
||||
HREF="programadmin.html#AEN1592"
|
||||
>Bugzilla Groups</A
|
||||
></DT
|
||||
><DT
|
||||
>D-1. <A
|
||||
HREF="setperl.html#AEN2360"
|
||||
HREF="setperl.html#AEN2439"
|
||||
>Using Setperl to set your perl path</A
|
||||
></DT
|
||||
><DT
|
||||
>1. <A
|
||||
HREF="glossary.html#AEN2602"
|
||||
HREF="glossary.html#AEN2685"
|
||||
>A Sample Product</A
|
||||
></DT
|
||||
></DL
|
||||
|
||||
@@ -90,12 +90,12 @@ HREF="stepbystep.html"
|
||||
><DL
|
||||
><DT
|
||||
>3.2.1. <A
|
||||
HREF="stepbystep.html#AEN486"
|
||||
HREF="stepbystep.html#AEN509"
|
||||
>Introduction</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.2. <A
|
||||
HREF="stepbystep.html#AEN492"
|
||||
HREF="stepbystep.html#AEN515"
|
||||
>Installing the Prerequisites</A
|
||||
></DT
|
||||
><DT
|
||||
@@ -110,57 +110,57 @@ HREF="stepbystep.html#INSTALL-PERL"
|
||||
></DT
|
||||
><DT
|
||||
>3.2.5. <A
|
||||
HREF="stepbystep.html#AEN579"
|
||||
HREF="stepbystep.html#AEN602"
|
||||
>DBI Perl Module</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.6. <A
|
||||
HREF="stepbystep.html#AEN617"
|
||||
HREF="stepbystep.html#AEN640"
|
||||
>Data::Dumper Perl Module</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.7. <A
|
||||
HREF="stepbystep.html#AEN622"
|
||||
HREF="stepbystep.html#AEN645"
|
||||
>MySQL related Perl Module Collection</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.8. <A
|
||||
HREF="stepbystep.html#AEN631"
|
||||
HREF="stepbystep.html#AEN654"
|
||||
>TimeDate Perl Module Collection</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.9. <A
|
||||
HREF="stepbystep.html#AEN635"
|
||||
HREF="stepbystep.html#AEN658"
|
||||
>GD Perl Module (1.8.3)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.10. <A
|
||||
HREF="stepbystep.html#AEN644"
|
||||
HREF="stepbystep.html#AEN667"
|
||||
>Chart::Base Perl Module (0.99c)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.11. <A
|
||||
HREF="stepbystep.html#AEN648"
|
||||
HREF="stepbystep.html#AEN671"
|
||||
>DB_File Perl Module</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.12. <A
|
||||
HREF="stepbystep.html#AEN651"
|
||||
HREF="stepbystep.html#AEN674"
|
||||
>HTTP Server</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.13. <A
|
||||
HREF="stepbystep.html#AEN669"
|
||||
HREF="stepbystep.html#AEN692"
|
||||
>Installing the Bugzilla Files</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.14. <A
|
||||
HREF="stepbystep.html#AEN696"
|
||||
HREF="stepbystep.html#AEN721"
|
||||
>Setting Up the MySQL Database</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.15. <A
|
||||
HREF="stepbystep.html#AEN743"
|
||||
HREF="stepbystep.html#AEN768"
|
||||
>Tweaking <TT
|
||||
CLASS="FILENAME"
|
||||
>localconfig</TT
|
||||
@@ -168,22 +168,22 @@ CLASS="FILENAME"
|
||||
></DT
|
||||
><DT
|
||||
>3.2.16. <A
|
||||
HREF="stepbystep.html#AEN781"
|
||||
HREF="stepbystep.html#AEN806"
|
||||
>Setting Up Maintainers Manually (Optional)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.17. <A
|
||||
HREF="stepbystep.html#AEN792"
|
||||
HREF="stepbystep.html#AEN817"
|
||||
>The Whining Cron (Optional)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.18. <A
|
||||
HREF="stepbystep.html#AEN802"
|
||||
HREF="stepbystep.html#AEN827"
|
||||
>Bug Graphs (Optional)</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.19. <A
|
||||
HREF="stepbystep.html#AEN814"
|
||||
HREF="stepbystep.html#AEN839"
|
||||
>Securing MySQL</A
|
||||
></DT
|
||||
></DL
|
||||
@@ -207,12 +207,12 @@ HREF="geninstall.html"
|
||||
><DL
|
||||
><DT
|
||||
>3.5.1. <A
|
||||
HREF="geninstall.html#AEN916"
|
||||
HREF="geninstall.html#AEN941"
|
||||
>Modifying Your Running System</A
|
||||
></DT
|
||||
><DT
|
||||
>3.5.2. <A
|
||||
HREF="geninstall.html#AEN923"
|
||||
HREF="geninstall.html#AEN948"
|
||||
>Upgrading From Previous Versions</A
|
||||
></DT
|
||||
><DT
|
||||
@@ -238,7 +238,7 @@ HREF="geninstall.html#CONTENT_TYPE"
|
||||
></DT
|
||||
><DT
|
||||
>3.5.6. <A
|
||||
HREF="geninstall.html#AEN964"
|
||||
HREF="geninstall.html#UNIXHISTORY"
|
||||
>UNIX Installation Instructions History</A
|
||||
></DT
|
||||
></DL
|
||||
@@ -260,6 +260,11 @@ HREF="win32.html#WININSTALL"
|
||||
HREF="win32.html#ADDLWINTIPS"
|
||||
>Additional Windows Tips</A
|
||||
></DT
|
||||
><DT
|
||||
>3.6.3. <A
|
||||
HREF="win32.html#BZLDAP"
|
||||
>Bugzilla LDAP Integration</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
|
||||
@@ -10,8 +10,8 @@ REL="HOME"
|
||||
TITLE="The Bugzilla Guide"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="SourceForge"
|
||||
HREF="variant_sourceforge.html"><LINK
|
||||
TITLE="MySQL Permissions & Grant Tables"
|
||||
HREF="granttables.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Apache mod_rewrite magic"
|
||||
HREF="rewrite.html"></HEAD
|
||||
@@ -41,7 +41,7 @@ WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="variant_sourceforge.html"
|
||||
HREF="granttables.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
@@ -99,6 +99,11 @@ HREF="cmdline.html"
|
||||
HREF="quicksearch.html"
|
||||
>The Quicksearch Utility</A
|
||||
></DT
|
||||
><DT
|
||||
>D.5. <A
|
||||
HREF="bzhacking.html"
|
||||
>Hacking Bugzilla</A
|
||||
></DT
|
||||
></DL
|
||||
></DIV
|
||||
><P
|
||||
@@ -119,7 +124,7 @@ WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="variant_sourceforge.html"
|
||||
HREF="granttables.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
@@ -144,7 +149,7 @@ HREF="rewrite.html"
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>SourceForge</TD
|
||||
>MySQL Permissions & Grant Tables</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
|
||||
@@ -232,7 +232,7 @@ NAME="COMPONENTS"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1413"
|
||||
NAME="AEN1461"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -241,7 +241,7 @@ NAME="AEN1413"
|
||||
><DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN1415"
|
||||
NAME="AEN1463"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -387,7 +387,7 @@ NAME="VERSIONS"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1442"
|
||||
NAME="AEN1490"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -396,7 +396,7 @@ NAME="AEN1442"
|
||||
><DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN1444"
|
||||
NAME="AEN1492"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -418,7 +418,7 @@ NAME="AEN1444"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1446"
|
||||
NAME="AEN1494"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -427,7 +427,7 @@ NAME="AEN1446"
|
||||
><DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN1448"
|
||||
NAME="AEN1496"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -564,7 +564,7 @@ TYPE="1"
|
||||
><DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1474"
|
||||
NAME="AEN1522"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -573,7 +573,7 @@ NAME="AEN1474"
|
||||
><DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN1476"
|
||||
NAME="AEN1524"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -787,7 +787,7 @@ NAME="GROUPS"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1510"
|
||||
NAME="AEN1558"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -796,7 +796,7 @@ NAME="AEN1510"
|
||||
><DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN1512"
|
||||
NAME="AEN1560"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -913,7 +913,7 @@ TYPE="1"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1527"
|
||||
NAME="AEN1575"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -922,7 +922,7 @@ NAME="AEN1527"
|
||||
><DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN1529"
|
||||
NAME="AEN1577"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -1043,6 +1043,112 @@ VALIGN="TOP"
|
||||
</P
|
||||
></LI
|
||||
></OL
|
||||
><P
|
||||
> You may find this example illustrative for how bug groups work.
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1592"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
>Example 4-7. Bugzilla Groups</B
|
||||
></P
|
||||
><P
|
||||
CLASS="LITERALLAYOUT"
|
||||
>Bugzilla Groups example<br>
|
||||
-----------------------<br>
|
||||
<br>
|
||||
For this example, let us suppose we have four groups, call them<br>
|
||||
Group1, Group2, Group3, and Group4.<br>
|
||||
<br>
|
||||
We have 5 users, User1, User2, User3, User4, User5.<br>
|
||||
<br>
|
||||
We have 8 bugs, Bug1, ..., Bug8.<br>
|
||||
<br>
|
||||
Group membership is defined by this chart:<br>
|
||||
(X denotes that user is in that group.)<br>
|
||||
(I apologize for the nasty formatting of this table. Try viewing<br>
|
||||
it in a text-based browser or something for now. -MPB)<br>
|
||||
<br>
|
||||
G G G G<br>
|
||||
r r r r<br>
|
||||
o o o o<br>
|
||||
u u u u<br>
|
||||
p p p p<br>
|
||||
1 2 3 4<br>
|
||||
+-+-+-+-+<br>
|
||||
User1|X| | | |<br>
|
||||
+-+-+-+-+<br>
|
||||
User2| |X| | |<br>
|
||||
+-+-+-+-+<br>
|
||||
User3|X| |X| |<br>
|
||||
+-+-+-+-+<br>
|
||||
User4|X|X|X| |<br>
|
||||
+-+-+-+-+<br>
|
||||
User5| | | | |<br>
|
||||
+-+-+-+-+<br>
|
||||
<br>
|
||||
Bug restrictions are defined by this chart:<br>
|
||||
(X denotes that bug is restricted to that group.)<br>
|
||||
<br>
|
||||
G G G G<br>
|
||||
r r r r<br>
|
||||
o o o o<br>
|
||||
u u u u<br>
|
||||
p p p p<br>
|
||||
1 2 3 4<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug1| | | | |<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug2| |X| | |<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug3| | |X| |<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug4| | | |X|<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug5|X|X| | |<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug6|X| |X| |<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug7|X|X|X| |<br>
|
||||
+-+-+-+-+<br>
|
||||
Bug8|X|X|X|X|<br>
|
||||
+-+-+-+-+<br>
|
||||
<br>
|
||||
Who can see each bug?<br>
|
||||
<br>
|
||||
Bug1 has no group restrictions. Therefore, Bug1 can be seen by any<br>
|
||||
user, whatever their group membership. This is going to be the only<br>
|
||||
bug that User5 can see, because User5 isn't in any groups.<br>
|
||||
<br>
|
||||
Bug2 can be seen by anyone in Group2, that is User2 and User4.<br>
|
||||
<br>
|
||||
Bug3 can be seen by anyone in Group3, that is User3 and User4.<br>
|
||||
<br>
|
||||
Bug4 can be seen by anyone in Group4. Nobody is in Group4, so none of<br>
|
||||
these users can see Bug4.<br>
|
||||
<br>
|
||||
Bug5 can be seen by anyone who is in _both_ Group1 and Group2. This<br>
|
||||
is only User4. User1 cannot see it because he is not in Group2, and<br>
|
||||
User2 cannot see it because she is not in Group1.<br>
|
||||
<br>
|
||||
Bug6 can be seen by anyone who is in both Group1 and Group3. This<br>
|
||||
would include User3 and User4. Similar to Bug5, User1 cannot see Bug6<br>
|
||||
because he is not in Group3.<br>
|
||||
<br>
|
||||
Bug7 can be seen by anyone who is in Group1, Group2, and Group3. This<br>
|
||||
is only User4. All of the others are missing at least one of those<br>
|
||||
group priveleges, and thus cannot see the bug.<br>
|
||||
<br>
|
||||
Bug8 can be seen by anyone who is in Group1, Group2, Group3, and<br>
|
||||
Group4. There is nobody in all four of these groups, so nobody can<br>
|
||||
see Bug8. It doesn't matter that User4 is in Group1, Group2, and<br>
|
||||
Group3, since he isn't in Group4.<br>
|
||||
</P
|
||||
></DIV
|
||||
>
|
||||
</P
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
|
||||
@@ -16,8 +16,8 @@ REL="PREVIOUS"
|
||||
TITLE="Command-line Bugzilla Queries"
|
||||
HREF="cmdline.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="GNU Free Documentation License"
|
||||
HREF="gfdl.html"></HEAD
|
||||
TITLE="Hacking Bugzilla"
|
||||
HREF="bzhacking.html"></HEAD
|
||||
><BODY
|
||||
CLASS="SECTION"
|
||||
BGCOLOR="#FFFFFF"
|
||||
@@ -57,7 +57,7 @@ WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="gfdl.html"
|
||||
HREF="bzhacking.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -160,7 +160,7 @@ WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="gfdl.html"
|
||||
HREF="bzhacking.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -182,7 +182,7 @@ HREF="patches.html"
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>GNU Free Documentation License</TD
|
||||
>Hacking Bugzilla</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
|
||||
@@ -216,7 +216,7 @@ CLASS="COMMAND"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN2360"
|
||||
NAME="AEN2439"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
|
||||
@@ -78,7 +78,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN486"
|
||||
NAME="AEN509"
|
||||
>3.2.1. Introduction</A
|
||||
></H2
|
||||
><P
|
||||
@@ -109,7 +109,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN492"
|
||||
NAME="AEN515"
|
||||
>3.2.2. Installing the Prerequisites</A
|
||||
></H2
|
||||
><DIV
|
||||
@@ -613,7 +613,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN579"
|
||||
NAME="AEN602"
|
||||
>3.2.5. DBI Perl Module</A
|
||||
></H2
|
||||
><P
|
||||
@@ -642,7 +642,7 @@ HREF="downloadlinks.html"
|
||||
<DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN586"
|
||||
NAME="AEN609"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -696,7 +696,7 @@ VALIGN="TOP"
|
||||
<DIV
|
||||
CLASS="INFORMALEXAMPLE"
|
||||
><A
|
||||
NAME="AEN593"
|
||||
NAME="AEN616"
|
||||
></A
|
||||
><P
|
||||
></P
|
||||
@@ -789,7 +789,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN617"
|
||||
NAME="AEN640"
|
||||
>3.2.6. Data::Dumper Perl Module</A
|
||||
></H2
|
||||
><P
|
||||
@@ -814,7 +814,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN622"
|
||||
NAME="AEN645"
|
||||
>3.2.7. MySQL related Perl Module Collection</A
|
||||
></H2
|
||||
><P
|
||||
@@ -860,7 +860,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN631"
|
||||
NAME="AEN654"
|
||||
>3.2.8. TimeDate Perl Module Collection</A
|
||||
></H2
|
||||
><P
|
||||
@@ -882,7 +882,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN635"
|
||||
NAME="AEN658"
|
||||
>3.2.9. GD Perl Module (1.8.3)</A
|
||||
></H2
|
||||
><P
|
||||
@@ -948,7 +948,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN644"
|
||||
NAME="AEN667"
|
||||
>3.2.10. Chart::Base Perl Module (0.99c)</A
|
||||
></H2
|
||||
><P
|
||||
@@ -969,7 +969,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN648"
|
||||
NAME="AEN671"
|
||||
>3.2.11. DB_File Perl Module</A
|
||||
></H2
|
||||
><P
|
||||
@@ -985,7 +985,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN651"
|
||||
NAME="AEN674"
|
||||
>3.2.12. HTTP Server</A
|
||||
></H2
|
||||
><P
|
||||
@@ -1156,7 +1156,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN669"
|
||||
NAME="AEN692"
|
||||
>3.2.13. Installing the Bugzilla Files</A
|
||||
></H2
|
||||
><P
|
||||
@@ -1247,7 +1247,7 @@ HREF="patches.html"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN685"
|
||||
NAME="AEN708"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -1290,6 +1290,29 @@ bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
|
||||
></TABLE
|
||||
>
|
||||
</P
|
||||
><P
|
||||
> Alternately, you can simply run this perl one-liner to
|
||||
change your path to perl in all the files in your Bugzilla
|
||||
installation:
|
||||
<TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
WIDTH="100%"
|
||||
><TR
|
||||
><TD
|
||||
><FONT
|
||||
COLOR="#000000"
|
||||
><PRE
|
||||
CLASS="PROGRAMLISTING"
|
||||
>perl -pi -e 's@#!/usr/bonsaitools/bin/perl@/usr/bin/perl@' *cgi *pl Bug.pm
|
||||
</PRE
|
||||
></FONT
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
>
|
||||
Change the second path to perl to match your installation.
|
||||
</P
|
||||
></DIV
|
||||
>
|
||||
<DIV
|
||||
@@ -1335,7 +1358,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN696"
|
||||
NAME="AEN721"
|
||||
>3.2.14. Setting Up the MySQL Database</A
|
||||
></H2
|
||||
><P
|
||||
@@ -1573,7 +1596,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN743"
|
||||
NAME="AEN768"
|
||||
>3.2.15. Tweaking <TT
|
||||
CLASS="FILENAME"
|
||||
>localconfig</TT
|
||||
@@ -1699,7 +1722,7 @@ CLASS="QUOTE"
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN774"
|
||||
NAME="AEN799"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -1779,7 +1802,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN781"
|
||||
NAME="AEN806"
|
||||
>3.2.16. Setting Up Maintainers Manually (Optional)</A
|
||||
></H2
|
||||
><P
|
||||
@@ -1829,7 +1852,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN792"
|
||||
NAME="AEN817"
|
||||
>3.2.17. The Whining Cron (Optional)</A
|
||||
></H2
|
||||
><P
|
||||
@@ -1915,7 +1938,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN802"
|
||||
NAME="AEN827"
|
||||
>3.2.18. Bug Graphs (Optional)</A
|
||||
></H2
|
||||
><P
|
||||
@@ -1972,7 +1995,7 @@ CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="AEN814"
|
||||
NAME="AEN839"
|
||||
>3.2.19. Securing MySQL</A
|
||||
></H2
|
||||
><P
|
||||
|
||||
@@ -16,8 +16,8 @@ REL="PREVIOUS"
|
||||
TITLE="Perforce SCM"
|
||||
HREF="variant_perforce.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Useful Patches and Utilities for Bugzilla"
|
||||
HREF="patches.html"></HEAD
|
||||
TITLE="The Bugzilla FAQ"
|
||||
HREF="faq.html"></HEAD
|
||||
><BODY
|
||||
CLASS="SECTION"
|
||||
BGCOLOR="#FFFFFF"
|
||||
@@ -57,7 +57,7 @@ WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="patches.html"
|
||||
HREF="faq.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -117,7 +117,7 @@ WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="patches.html"
|
||||
HREF="faq.html"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
@@ -139,7 +139,7 @@ HREF="variants.html"
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Useful Patches and Utilities for Bugzilla</TD
|
||||
>The Bugzilla FAQ</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
|
||||
@@ -10,8 +10,8 @@ REL="HOME"
|
||||
TITLE="The Bugzilla Guide"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="MySQL Permissions & Grant Tables"
|
||||
HREF="granttables.html"><LINK
|
||||
TITLE="The Future of Bugzilla"
|
||||
HREF="future.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Red Hat Bugzilla"
|
||||
HREF="rhbugzilla.html"></HEAD
|
||||
@@ -41,7 +41,7 @@ WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="granttables.html"
|
||||
HREF="future.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
@@ -133,7 +133,7 @@ WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="granttables.html"
|
||||
HREF="future.html"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
@@ -158,7 +158,7 @@ HREF="rhbugzilla.html"
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>MySQL Permissions & Grant Tables</TD
|
||||
>The Future of Bugzilla</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
|
||||
@@ -301,7 +301,7 @@ CLASS="COMMAND"
|
||||
><DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1012"
|
||||
NAME="AEN1038"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -1130,7 +1130,9 @@ TARGET="_top"
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Modify the invocation of all system() calls in all perl scripts in your Bugzilla directory. For instance, change this line in processmail:
|
||||
> Modify the invocation of all system() calls in all perl
|
||||
scripts in your Bugzilla directory. For instance, change
|
||||
this line in processmail:
|
||||
<TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
@@ -1141,14 +1143,14 @@ WIDTH="100%"
|
||||
COLOR="#000000"
|
||||
><PRE
|
||||
CLASS="PROGRAMLISTING"
|
||||
>system ("./processmail.pl",@ARGLIST);
|
||||
>
|
||||
system ("./processmail.pl",@ARGLIST);
|
||||
</PRE
|
||||
></FONT
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
>
|
||||
to
|
||||
> to
|
||||
<TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
@@ -1159,7 +1161,8 @@ WIDTH="100%"
|
||||
COLOR="#000000"
|
||||
><PRE
|
||||
CLASS="PROGRAMLISTING"
|
||||
>system ("perl processmail.pl",@ARGLIST);
|
||||
>
|
||||
system ("perl processmail.pl",@ARGLIST);
|
||||
</PRE
|
||||
></FONT
|
||||
></TD
|
||||
@@ -1168,6 +1171,94 @@ CLASS="PROGRAMLISTING"
|
||||
>
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Add <TT
|
||||
CLASS="FUNCTION"
|
||||
>binmode()</TT
|
||||
> calls so attachments
|
||||
will work (<A
|
||||
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=62000"
|
||||
TARGET="_top"
|
||||
>bug 62000</A
|
||||
>).
|
||||
</P
|
||||
><P
|
||||
> Because Microsoft Windows based systems handle binary
|
||||
files different than Unix based systems, you need to add
|
||||
the following lines to
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>createattachment.cgi</TT
|
||||
> and
|
||||
<TT
|
||||
CLASS="FILENAME"
|
||||
>showattachment.cgi</TT
|
||||
> before the
|
||||
<TT
|
||||
CLASS="FUNCTION"
|
||||
>require 'CGI.pl';</TT
|
||||
> line.</P
|
||||
><P
|
||||
><TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
WIDTH="100%"
|
||||
><TR
|
||||
><TD
|
||||
><FONT
|
||||
COLOR="#000000"
|
||||
><PRE
|
||||
CLASS="PROGRAMLISTING"
|
||||
>binmode(STDIN);
|
||||
binmode(STDOUT);</PRE
|
||||
></FONT
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
>
|
||||
</P
|
||||
><DIV
|
||||
CLASS="NOTE"
|
||||
><P
|
||||
></P
|
||||
><TABLE
|
||||
CLASS="NOTE"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="25"
|
||||
ALIGN="CENTER"
|
||||
VALIGN="TOP"
|
||||
><IMG
|
||||
SRC="../images/note.gif"
|
||||
HSPACE="5"
|
||||
ALT="Note"></TD
|
||||
><TD
|
||||
ALIGN="LEFT"
|
||||
VALIGN="TOP"
|
||||
><P
|
||||
> According to <A
|
||||
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=62000"
|
||||
TARGET="_top"
|
||||
>bug 62000</A
|
||||
>, the perl documentation says that you should always use <TT
|
||||
CLASS="FUNCTION"
|
||||
>binmode()</TT
|
||||
> when dealing with binary files, but never when dealing with text files. That seems to suggest that rather than aribtrarily putting <TT
|
||||
CLASS="FUNCTION"
|
||||
>binmode()</TT
|
||||
> at the begining of the attachment files, there should be logic to determine if <TT
|
||||
CLASS="FUNCTION"
|
||||
>binmode()</TT
|
||||
> is needed or not.
|
||||
</P
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></LI
|
||||
></OL
|
||||
></DIV
|
||||
><DIV
|
||||
@@ -1195,7 +1286,9 @@ VALIGN="TOP"
|
||||
relationships to Properties -> Home directory (tab) ->
|
||||
Application Settings (section) -> Configuration (button),
|
||||
such as:
|
||||
<TABLE
|
||||
</P
|
||||
><P
|
||||
> <TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
WIDTH="100%"
|
||||
@@ -1254,7 +1347,7 @@ VALIGN="TOP"
|
||||
><P
|
||||
> From Andrew Pearson:
|
||||
<A
|
||||
NAME="AEN1169"
|
||||
NAME="AEN1212"
|
||||
></A
|
||||
><BLOCKQUOTE
|
||||
CLASS="BLOCKQUOTE"
|
||||
@@ -1272,7 +1365,23 @@ TARGET="_top"
|
||||
registry at the following location:
|
||||
</P
|
||||
><P
|
||||
> HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
|
||||
> <TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
WIDTH="100%"
|
||||
><TR
|
||||
><TD
|
||||
><FONT
|
||||
COLOR="#000000"
|
||||
><PRE
|
||||
CLASS="PROGRAMLISTING"
|
||||
>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
|
||||
</PRE
|
||||
></FONT
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
>
|
||||
</P
|
||||
><P
|
||||
> The keys should be called ".pl" and ".cgi", and both
|
||||
@@ -1319,11 +1428,12 @@ VALIGN="TOP"
|
||||
<EM
|
||||
>not necessary</EM
|
||||
> for Bugzilla 2.13 and
|
||||
later.
|
||||
later, which includes the current release, Bugzilla
|
||||
2.14.
|
||||
<DIV
|
||||
CLASS="EXAMPLE"
|
||||
><A
|
||||
NAME="AEN1180"
|
||||
NAME="AEN1224"
|
||||
></A
|
||||
><P
|
||||
><B
|
||||
@@ -1331,7 +1441,7 @@ NAME="AEN1180"
|
||||
2.12 or earlier</B
|
||||
></P
|
||||
><P
|
||||
> Replace this:
|
||||
> Replace this:
|
||||
<TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
@@ -1342,16 +1452,16 @@ WIDTH="100%"
|
||||
COLOR="#000000"
|
||||
><PRE
|
||||
CLASS="PROGRAMLISTING"
|
||||
>
|
||||
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($realcryptpwd, 0, 2)) . ")");
|
||||
my $enteredcryptpwd = FetchOneColumn();
|
||||
>
|
||||
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($realcryptpwd, 0, 2)) . ")");
|
||||
my $enteredcryptpwd = FetchOneColumn();
|
||||
</PRE
|
||||
></FONT
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
>
|
||||
with this:
|
||||
>
|
||||
with this:
|
||||
<TABLE
|
||||
BORDER="0"
|
||||
BGCOLOR="#E0E0E0"
|
||||
@@ -1362,14 +1472,14 @@ WIDTH="100%"
|
||||
COLOR="#000000"
|
||||
><PRE
|
||||
CLASS="PROGRAMLISTING"
|
||||
>
|
||||
my $enteredcryptpwd = $enteredpwd
|
||||
>
|
||||
my $enteredcryptpwd = $enteredpwd
|
||||
</PRE
|
||||
></FONT
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
>
|
||||
>
|
||||
in cgi.pl.
|
||||
</P
|
||||
></DIV
|
||||
@@ -1380,6 +1490,87 @@ my $enteredcryptpwd = $enteredpwd
|
||||
></TABLE
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="SECTION"
|
||||
><H2
|
||||
CLASS="SECTION"
|
||||
><A
|
||||
NAME="BZLDAP"
|
||||
>3.6.3. Bugzilla LDAP Integration</A
|
||||
></H2
|
||||
><P
|
||||
> What follows is some late-breaking information on using the
|
||||
LDAP authentication options with Bugzilla. The author has not
|
||||
tested these (nor even formatted this section!) so please
|
||||
contribute feedback to the newsgroup.
|
||||
</P
|
||||
><P
|
||||
CLASS="LITERALLAYOUT"
|
||||
>Mozilla::LDAP module<br>
|
||||
<br>
|
||||
The Mozilla::LDAP module allows you to use LDAP for authentication to<br>
|
||||
the Bugzilla system. This module is not required if you are not using<br>
|
||||
LDAP.<br>
|
||||
<br>
|
||||
Mozilla::LDAP (aka PerLDAP) is available for download from<br>
|
||||
http://www.mozilla.org/directory.<br>
|
||||
<br>
|
||||
NOTE: The Mozilla::LDAP module requires Netscape's Directory SDK.<br>
|
||||
Follow the link for "Directory SDK for C" on that same page to<br>
|
||||
download the SDK first. After you have installed this SDK, then<br>
|
||||
install the PerLDAP module.<br>
|
||||
----------------------------------------------------------------------<br>
|
||||
<br>
|
||||
Post-Installation Checklist<br>
|
||||
----------------------------------------------------------------------<br>
|
||||
Set useLDAP to "On" **only** if you will be using an LDAP directory<br>
|
||||
for authentication. Be very careful when setting up this parameter;<br>
|
||||
if you set LDAP authentication, but do not have a valid LDAP directory<br>
|
||||
set up, you will not be able to log back in to Bugzilla once you log<br>
|
||||
out. (If this happens, you can get back in by manually editing the<br>
|
||||
data/params file, and setting useLDAP back to 0.)<br>
|
||||
<br>
|
||||
If using LDAP, you must set the three additional parameters:<br>
|
||||
<br>
|
||||
Set LDAPserver to the name (and optionally port) of your LDAP server.<br>
|
||||
If no port is specified, it defaults to the default port of 389. (e.g<br>
|
||||
"ldap.mycompany.com" or "ldap.mycompany.com:1234")<br>
|
||||
<br>
|
||||
Set LDAPBaseDN to the base DN for searching for users in your LDAP<br>
|
||||
directory. (e.g. "ou=People,o=MyCompany") uids must be unique under<br>
|
||||
the DN specified here.<br>
|
||||
<br>
|
||||
Set LDAPmailattribute to the name of the attribute in your LDAP<br>
|
||||
directory which contains the primary email address. On most directory<br>
|
||||
servers available, this is "mail", but you may need to change this.<br>
|
||||
----------------------------------------------------------------------<br>
|
||||
<br>
|
||||
(Not sure where this bit should go, but it's important that it be in<br>
|
||||
there somewhere...)<br>
|
||||
----------------------------------------------------------------------<br>
|
||||
Using LDAP authentication for Bugzilla:<br>
|
||||
<br>
|
||||
The existing authentication scheme for Bugzilla uses email addresses<br>
|
||||
as the primary user ID, and a password to authenticate that user. All<br>
|
||||
places within Bugzilla where you need to deal with user ID (e.g<br>
|
||||
assigning a bug) use the email address.<br>
|
||||
<br>
|
||||
The LDAP authentication builds on top of this scheme, rather than<br>
|
||||
replacing it. The initial log in is done with a username and password<br>
|
||||
for the LDAP directory. This then fetches the email address from LDAP<br>
|
||||
and authenticates seamlessly in the standard Bugzilla authentication<br>
|
||||
scheme using this email address. If an account for this address<br>
|
||||
already exists in your Bugzilla system, it will log in to that<br>
|
||||
account. If no account for that email address exists, one is created<br>
|
||||
at the time of login. (In this case, Bugzilla will attempt to use the<br>
|
||||
"displayName" or "cn" attribute to determine the user's full name.)<br>
|
||||
<br>
|
||||
After authentication, all other user-related tasks are still handled<br>
|
||||
by email address, not LDAP username. You still assign bugs by email<br>
|
||||
address, query on users by email address, etc.<br>
|
||||
----------------------------------------------------------------------<br>
|
||||
</P
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
|
||||
|
Before Width: | Height: | Size: 215 KiB After Width: | Height: | Size: 215 KiB |
@@ -26,7 +26,7 @@
|
||||
<!ENTITY bzg-ver "2.14">
|
||||
<!ENTITY bzg-cvs-ver "2.15.0">
|
||||
<!ENTITY bzg-auth "Matthew P. Barnson">
|
||||
<!ENTITY bzg-auth-email "<email>barnboy@NOSPAM.trilobyte.net</email>">
|
||||
<!ENTITY bzg-auth-email "<email>barnboy@trilobyte.net</email>">
|
||||
<!ENTITY mysql "http://www.mysql.com/">
|
||||
<!ENTITY perl-ver "5.6.1">
|
||||
|
||||
@@ -126,14 +126,14 @@ try to avoid clutter and feel free to waste space in the code to make it more re
|
||||
<othername>P.</othername>
|
||||
<surname>Barnson</surname>
|
||||
<affiliation>
|
||||
<address><email>barnboy@NOSPAM.trilobyte.net</email></address>
|
||||
<address><email>barnboy@trilobyte.net</email></address>
|
||||
</affiliation>
|
||||
</author>
|
||||
|
||||
<collab>
|
||||
<collabname>Zach Lipton</collabname>
|
||||
<affiliation>
|
||||
<address><email>zach@NOSPAM.zachlipton.com</email></address>
|
||||
<address><email>zach AT zachlipton DOT com</email></address>
|
||||
</affiliation>
|
||||
</collab>
|
||||
|
||||
@@ -196,6 +196,9 @@ try to avoid clutter and feel free to waste space in the code to make it more re
|
||||
<!-- The Future of Bugzilla -->
|
||||
&future;
|
||||
|
||||
<!-- Major Bugzilla Variants -->
|
||||
&variants;
|
||||
|
||||
<!-- Appendix: The Frequently Asked Questions -->
|
||||
&faq;
|
||||
|
||||
@@ -205,9 +208,6 @@ try to avoid clutter and feel free to waste space in the code to make it more re
|
||||
<!-- Appendix: The Database Schema -->
|
||||
&database;
|
||||
|
||||
<!-- Appendix: Major Bugzilla Variants -->
|
||||
&variants;
|
||||
|
||||
<!-- Appendix: Custom Patches -->
|
||||
&patches;
|
||||
|
||||
|
||||
@@ -70,8 +70,7 @@
|
||||
<para>
|
||||
If you have any questions regarding this document, its
|
||||
copyright, or publishing this document in non-electronic form,
|
||||
please contact &bzg-auth;. Remove "NOSPAM" from email address
|
||||
to send.
|
||||
please contact &bzg-auth;.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
@@ -172,8 +171,8 @@
|
||||
</para>
|
||||
<para>
|
||||
<ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink>
|
||||
for initially converting Bugzilla from BugSplat! and writing the
|
||||
README upon which this documentation is largely based.
|
||||
for initially writing Bugzilla and creating the
|
||||
README upon which the UNIX installation documentation is largely based.
|
||||
</para>
|
||||
<para>
|
||||
<ulink url="mailto://tara@tequilarista.org">Tara
|
||||
@@ -204,7 +203,8 @@
|
||||
documentation (in no particular order):
|
||||
</para>
|
||||
<para>
|
||||
Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron Teitelbaum
|
||||
Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron
|
||||
Teitelbaum, Jacob Steenhagen, Joe Robins
|
||||
</para>
|
||||
</section>
|
||||
<section id="feedback">
|
||||
|
||||
@@ -1192,6 +1192,103 @@
|
||||
</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>
|
||||
You may find this example illustrative for how bug groups work.
|
||||
<example>
|
||||
<title>Bugzilla Groups</title>
|
||||
<literallayout>
|
||||
Bugzilla Groups example
|
||||
-----------------------
|
||||
|
||||
For this example, let us suppose we have four groups, call them
|
||||
Group1, Group2, Group3, and Group4.
|
||||
|
||||
We have 5 users, User1, User2, User3, User4, User5.
|
||||
|
||||
We have 8 bugs, Bug1, ..., Bug8.
|
||||
|
||||
Group membership is defined by this chart:
|
||||
(X denotes that user is in that group.)
|
||||
(I apologize for the nasty formatting of this table. Try viewing
|
||||
it in a text-based browser or something for now. -MPB)
|
||||
|
||||
G G G G
|
||||
r r r r
|
||||
o o o o
|
||||
u u u u
|
||||
p p p p
|
||||
1 2 3 4
|
||||
+-+-+-+-+
|
||||
User1|X| | | |
|
||||
+-+-+-+-+
|
||||
User2| |X| | |
|
||||
+-+-+-+-+
|
||||
User3|X| |X| |
|
||||
+-+-+-+-+
|
||||
User4|X|X|X| |
|
||||
+-+-+-+-+
|
||||
User5| | | | |
|
||||
+-+-+-+-+
|
||||
|
||||
Bug restrictions are defined by this chart:
|
||||
(X denotes that bug is restricted to that group.)
|
||||
|
||||
G G G G
|
||||
r r r r
|
||||
o o o o
|
||||
u u u u
|
||||
p p p p
|
||||
1 2 3 4
|
||||
+-+-+-+-+
|
||||
Bug1| | | | |
|
||||
+-+-+-+-+
|
||||
Bug2| |X| | |
|
||||
+-+-+-+-+
|
||||
Bug3| | |X| |
|
||||
+-+-+-+-+
|
||||
Bug4| | | |X|
|
||||
+-+-+-+-+
|
||||
Bug5|X|X| | |
|
||||
+-+-+-+-+
|
||||
Bug6|X| |X| |
|
||||
+-+-+-+-+
|
||||
Bug7|X|X|X| |
|
||||
+-+-+-+-+
|
||||
Bug8|X|X|X|X|
|
||||
+-+-+-+-+
|
||||
|
||||
Who can see each bug?
|
||||
|
||||
Bug1 has no group restrictions. Therefore, Bug1 can be seen by any
|
||||
user, whatever their group membership. This is going to be the only
|
||||
bug that User5 can see, because User5 isn't in any groups.
|
||||
|
||||
Bug2 can be seen by anyone in Group2, that is User2 and User4.
|
||||
|
||||
Bug3 can be seen by anyone in Group3, that is User3 and User4.
|
||||
|
||||
Bug4 can be seen by anyone in Group4. Nobody is in Group4, so none of
|
||||
these users can see Bug4.
|
||||
|
||||
Bug5 can be seen by anyone who is in _both_ Group1 and Group2. This
|
||||
is only User4. User1 cannot see it because he is not in Group2, and
|
||||
User2 cannot see it because she is not in Group1.
|
||||
|
||||
Bug6 can be seen by anyone who is in both Group1 and Group3. This
|
||||
would include User3 and User4. Similar to Bug5, User1 cannot see Bug6
|
||||
because he is not in Group3.
|
||||
|
||||
Bug7 can be seen by anyone who is in Group1, Group2, and Group3. This
|
||||
is only User4. All of the others are missing at least one of those
|
||||
group priveleges, and thus cannot see the bug.
|
||||
|
||||
Bug8 can be seen by anyone who is in Group1, Group2, Group3, and
|
||||
Group4. There is nobody in all four of these groups, so nobody can
|
||||
see Bug8. It doesn't matter that User4 is in Group1, Group2, and
|
||||
Group3, since he isn't in Group4.
|
||||
</literallayout>
|
||||
</example>
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
<para>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="dbschema.jpg" format="jpg">
|
||||
<imagedata fileref="../images/dbschema.jpg" format="jpg">
|
||||
</imageobject>
|
||||
|
||||
<textobject>
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 215 KiB |
@@ -620,6 +620,12 @@
|
||||
progression states, also require adjusting the program logic to
|
||||
compensate for the change.
|
||||
</para>
|
||||
<para>
|
||||
There is no GUI for adding fields to Bugzilla at this
|
||||
time. You can follow development of this feature at
|
||||
<ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=91037">http://bugzilla.mozilla.org/show_bug.cgi?id=91037</ulink>
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
@@ -633,42 +639,62 @@
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
This was a late-breaking question for the Guide, so I just have to
|
||||
quote the relevant newsgroup thread on it.
|
||||
</para>
|
||||
<literallayout>
|
||||
> AFAIK, most sites (even if they have SSI enabled) won't have #exec cmd
|
||||
> enabled. Perhaps what would be better is a #include virtual and a
|
||||
> footer.cgi the basically has the "require 'CGI.pl' and PutFooter command.
|
||||
>
|
||||
> Please note that under most configurations, this also requires naming
|
||||
> the file from index.html to index.shtml (and making sure that it will
|
||||
> still be reconized as an index). Personally, I think this is better on
|
||||
> a per-installation basis (perhaps add something to the FAQ that says how
|
||||
> to do this).
|
||||
<para>
|
||||
It's possible to get the footer on the static index page using
|
||||
Server Side Includes (SSI). The trick to doing this is making
|
||||
sure that your web server is set up to allow SSI and specifically,
|
||||
the #exec directive. You should also rename <filename>index.html</filename>
|
||||
to <filename>index.shtml</filename>.
|
||||
</para>
|
||||
<para>
|
||||
After you've done all that, you can add the following line to
|
||||
<filename>index.shtml</filename>:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<!--#exec cmd="/usr/bin/perl -e "require 'CGI.pl'; PutFooter();"" -->
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
<para><note>
|
||||
<para>
|
||||
This line will be replaced with the actual HTML for the footer
|
||||
when the page is requested, so you should put this line where you
|
||||
want the footer to appear.
|
||||
</para>
|
||||
</note></para>
|
||||
<para>
|
||||
Because this method depends on being able to use a #exec directive,
|
||||
and most ISP's will not allow that, there is an alternative method.
|
||||
You could have a small script (such as <filename>api.cgi</filename>)
|
||||
that basically looks like:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
#!/usr/bonsaitools/bin/perl -w
|
||||
|
||||
Good point. Yeah, easy enough to do, that it shouldn't be a big deal for
|
||||
someone to take it on if they want it. FAQ is a good place for it.
|
||||
require 'globals.pl';
|
||||
|
||||
> Dave Miller wrote:
|
||||
>
|
||||
>> I did a little experimenting with getting the command menu and footer on
|
||||
>> the end of the index page while leaving it as an HTML file...
|
||||
>>
|
||||
>> I was successful. :)
|
||||
>>
|
||||
>> I added this line:
|
||||
>>
|
||||
>> <!--#exec cmd="/usr/bin/perl -e "require 'CGI.pl';
|
||||
>>PutFooter();"" -->
|
||||
>>
|
||||
>> Just before the </BODY> </HTML> at the end of the file. And it worked.
|
||||
>>
|
||||
>> Thought I'd toss that out there. Should I check this in? For those that
|
||||
>> have SSI disabled, it'll act like a comment, so I wouldn't think it would
|
||||
>> break anything.
|
||||
</literallayout>
|
||||
if ($::FORM{sub} eq 'PutFooter') {
|
||||
PutFooter();
|
||||
} else {
|
||||
die 'api.cgi was incorrectly called';
|
||||
}
|
||||
]]>
|
||||
</programlisting>
|
||||
and then put this line in <filename>index.shtml</filename>.
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<!--#include virtual="api.cgi?sub=PutFooter"-->
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
<para> <note>
|
||||
<para>
|
||||
This still requires being able to use Server Side Includes, if
|
||||
this simply will not work for you, see <ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=80183">bug 80183</ulink>
|
||||
for a third option.
|
||||
</para>
|
||||
</note></para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
<qandaentry>
|
||||
@@ -804,21 +830,6 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
Does Bugzilla allow fields to be added, changed or deleted? If I want to
|
||||
customize the bug submission form to meet our needs, can I do that using our
|
||||
terminology?
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Yes.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
@@ -1221,20 +1232,11 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
<para>
|
||||
If you are using an alternate Mail Transport Agent (MTA other than
|
||||
sendmail), make sure the options given in the "processmail" script for all
|
||||
instances of "sendmail" are correct for your MTA. If you are using Sendmail,
|
||||
you may wish to delete the "-ODeliveryMode=deferred" option in the
|
||||
"processmail" script for every invocation of "sendmail". (Be sure and leave
|
||||
the "-t" option, though!)
|
||||
instances of "sendmail" are correct for your MTA.
|
||||
</para>
|
||||
<para>
|
||||
A better alternative is to change the "-O" option to
|
||||
"-ODeliveryMode=background". This prevents Sendmail from hanging your
|
||||
Bugzilla Perl processes if the domain to which it must send mail
|
||||
is unavailable.
|
||||
</para>
|
||||
<para>
|
||||
This is now a configurable parameter called "sendmailnow", available
|
||||
from editparams.cgi.
|
||||
If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi.
|
||||
If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
@@ -1315,12 +1317,21 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Run the "sanity check" utility (./sanitycheck.cgi in the bugzilla_home
|
||||
directory) to see! If it all comes back, you're 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 it can't auto-recover, I hope you're
|
||||
familiar with mysqladmin commands or have installed another way to manage
|
||||
your database...
|
||||
Run the <quote>sanity check</quote> utility
|
||||
(<filename>./sanitycheck.cgi</filename> in the
|
||||
Bugzilla_home directory) from your web browser to see! If
|
||||
it finishes without errors, you're
|
||||
<emphasis>probably</emphasis> 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
|
||||
it can't auto-recover, I hope you're familiar with
|
||||
mysqladmin commands or have installed another way to
|
||||
manage your database. Sanity Check, although it is a good
|
||||
basic check on your database integrity, by no means is a
|
||||
substitute for competent database administration and
|
||||
avoiding deletion of data. It is not exhaustive, and was
|
||||
created to do a basic check for the most common problems
|
||||
in Bugzilla databases.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
@@ -1428,10 +1439,12 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Delete everything from $BUZILLA_HOME/shadow. Bugzilla creates shadow
|
||||
files there, with each filename corresponding to a
|
||||
bug number. Also be sure to run syncshadowdb to make sure, if you are using
|
||||
a shadow database, that the shadow database is current.
|
||||
This should only happen with Bugzilla &bz-ver; if you are
|
||||
using the <quote>shadow database</quote> feature, and your
|
||||
shadow database is out of sync. Try running
|
||||
<filename>syncshadowdb</filename>
|
||||
<option>-syncall</option> to make sure your shadow
|
||||
database is in synch with your primary database.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
@@ -1752,14 +1765,14 @@ A: Sure! Here ya go!
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Webtools&component=Bugzilla">
|
||||
Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Bugzilla">
|
||||
this link</ulink> to view current bugs or requests for
|
||||
enhancement for Bugzilla.
|
||||
</para>
|
||||
<para>
|
||||
You can view bugs marked for 2.14 release
|
||||
<ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Webtools&component=Bugzilla&target_milestone=Bugzilla+2.14">here</ulink>.
|
||||
This list includes bugs for the 2.14 release that have already
|
||||
You can view bugs marked for 2.16 release
|
||||
<ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Bugzilla&target_milestone=Bugzilla+2.16">here</ulink>.
|
||||
This list includes bugs for the 2.16 release that have already
|
||||
been fixed and checked into CVS. Please consult the
|
||||
<ulink url="http://www.mozilla.org/projects/bugzilla/">
|
||||
Bugzilla Project Page</ulink> for details on how to
|
||||
@@ -1800,8 +1813,9 @@ A: Sure! Here ya go!
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Enter a bug into bugzilla.mozilla.org for the "Webtools" product,
|
||||
"Bugzilla" component.
|
||||
Enter a bug into bugzilla.mozilla.org for the <quote><ulink
|
||||
url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">Bugzilla</ulink></quote>
|
||||
product.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
|
||||
@@ -4,11 +4,595 @@
|
||||
<title>The Future of Bugzilla</title>
|
||||
<synopsis>Bugzilla's Future. Much of this is the present, now.</synopsis>
|
||||
<para>
|
||||
The future of Bugzilla is Bugzilla 3.0. Unfortunately, I do
|
||||
not have more information about it right now, and most of what
|
||||
went into the "future" section is now present. That stuff was
|
||||
blue-sky a year ago; MattyT should have me a new document
|
||||
sometime...
|
||||
Bugzilla's future is a constantly-changing thing, as various developers
|
||||
<quote>scratch an itch</quote> when it comes to functionality.
|
||||
Thus this section is very malleable, subject to change without notice, etc.
|
||||
You'll probably also notice the lack of formatting. I apologize that it's
|
||||
not quite as readable as the rest of the Guide.
|
||||
</para>
|
||||
<para>
|
||||
<literallayout>
|
||||
Bugzilla Blue Sky
|
||||
|
||||
Customisability
|
||||
|
||||
One of the major stumbling blocks of Bugzilla has been that it is too
|
||||
rigid and does not adapt itself well enough to the needs of an
|
||||
organisation. This has led to organisations making changes to the
|
||||
Bugzilla code that need to be redone each new version of Bugzilla.
|
||||
Bugzilla should attempt to move away from this to a world where this
|
||||
doesn't need to occur.
|
||||
|
||||
Most of the subsections in this section are currently explicit design
|
||||
goals for the "Bugzilla 3" rewrite. This does not necessarily mean
|
||||
that they will not occur before them in Bugzilla 2, but most are
|
||||
significant undertakings.
|
||||
|
||||
Field Customisation
|
||||
|
||||
Many installations wish to customise the fields that appear on bug
|
||||
reports. Current versions of Bugzilla offer limited
|
||||
customisability. In particular, some fields can be turned off.
|
||||
|
||||
However, many administrators wish to add their own fields, and rename
|
||||
or otherwise modify existing fields. An architecture that supports
|
||||
this would be extraordinarily useful.
|
||||
|
||||
Indeed, many fields work similarly and could be abstracted into "field
|
||||
types", so that an administrator need write little or no code to
|
||||
support the new fields they desire.
|
||||
|
||||
Possible field types include text (eg status whiteboard), numbers,
|
||||
dates (eg report time), accounts (eg reporter, qa, cc), inter-bug
|
||||
relationships (dependencies, duplicates), option groups (platform, os,
|
||||
severity, priority, target milestone, version) etc.
|
||||
|
||||
Ideally an administrator could configure their fields through a
|
||||
Bugzilla interface that requires no code to be added. However, it is
|
||||
highly unlikely this ideal will never be met, and in a similar way
|
||||
that office applications have scripting languages, Bugzilla should
|
||||
allow new field types to be written.
|
||||
|
||||
Similarly, a common desire is for resolutions to be added or removed.
|
||||
|
||||
Allocations
|
||||
|
||||
?
|
||||
|
||||
Option Groups
|
||||
|
||||
?
|
||||
|
||||
Relations
|
||||
|
||||
?
|
||||
|
||||
Database Integrity
|
||||
|
||||
Furthermore, it is desirable for administrators to be able to specify
|
||||
rules that must or should apply between the fields on a bug report.
|
||||
|
||||
For example, you might wish to specify that a bug with status ASSIGNED
|
||||
must have a target milestone field that that is not untargetted. Or
|
||||
that a bug with a certain number of votes should get ASSIGNED. Or
|
||||
that the QA contact must be different from the assignee.
|
||||
|
||||
"Must" relationships could be implemented by refusing to make changes
|
||||
that violate the relationships, or alternatively, automatically
|
||||
updating certain fields in order to satisfy the criteria. Which
|
||||
occurs should be up to the administrator.
|
||||
|
||||
"Should" relationships could be implemented by a combination of
|
||||
emitting warnings on the process bug page, the same on notification
|
||||
mails, or emitting periodic whine mails about the situation. Again,
|
||||
which occurs should be up to the administrator.
|
||||
|
||||
It should also be possible for whine mails to be emitted for "must"
|
||||
relationships, as they might become violated through direct database
|
||||
access, Bugzilla bugs, or because they were there before the
|
||||
relationship was enforced.
|
||||
|
||||
As well as implementing intra-bug constraints, it would be useful to
|
||||
create inter-bug constraints. For example, a bug that is dependent on
|
||||
another bug should not have an earlier milestone or greater priority
|
||||
than that bug.
|
||||
|
||||
Database Adaptability
|
||||
|
||||
Often an administrator desires that fields adapt to the values of
|
||||
other fields. For example, the value of a field might determine the
|
||||
possible values of another field or even whether it appears (whether
|
||||
it is "applicable").
|
||||
|
||||
Limited adaptability is present in Bugzilla 2, and only on the
|
||||
"Product" field:
|
||||
* The possible values of the target milestone, version and component
|
||||
fields depend on the product.
|
||||
* UNCONFIRMED can be turned off for specific products.
|
||||
* Voting can be configured differently or turned off for different
|
||||
products, and there is a separate user vote limits for each
|
||||
product.
|
||||
|
||||
It would be good if more adaptability was present, both in terms of
|
||||
all fields relying on the product, as well as the ability to adapt
|
||||
based on the value of all fields.
|
||||
|
||||
Example ???
|
||||
|
||||
General adaptability raises the issue of circular references between
|
||||
fields causing problems. One possible solution to this is to place
|
||||
the fields in a total ordering and require a field refer only to the
|
||||
previous fields.
|
||||
|
||||
In Bugzilla 2, changing the product of a bug meant a second page would
|
||||
appear that allowed you to choose a new milestone, component and
|
||||
version, as those fields adapted themselves to the new product. This
|
||||
page could be generalised to support all instances where:
|
||||
* a field value must or might be changed because the possible values
|
||||
have changed
|
||||
* is going to drop off because it it is no longer applicable, and
|
||||
this should be confirmed
|
||||
* must be specified because it is suddenly applicable, and the
|
||||
default value, if one exists, might not be acceptable
|
||||
|
||||
Database Independence
|
||||
|
||||
Currently Bugzilla only runs on the MySQL database. It would be
|
||||
desirable for Bugzilla to run on other databases, because:
|
||||
* Organisations may have existing database products they use and
|
||||
would prefer to run a homogenous environment.
|
||||
* Databases each have their own shortcomings, including MySQL. An
|
||||
administrator might choose a database that would work better with
|
||||
their Bugzilla.
|
||||
|
||||
This raises the possibility that we could use features that are only
|
||||
present in some databases, by appropriately falling back. For
|
||||
example, in the MySQL world, we live without:
|
||||
* record-level locking, instead we use table-level locking
|
||||
* referential and record constraints, instead we checking code
|
||||
* subselects, instead we use multiple queries and redundant "caches"
|
||||
|
||||
Multiple Front Ends
|
||||
|
||||
Currently Bugzilla is manipulated via the Web, and notifies via
|
||||
E-Mail. It would be desirable for Bugzilla to easily support various
|
||||
front ends.
|
||||
|
||||
There is no reason that Bugzilla could not be controlled via a whole
|
||||
range of front ends, including Web, E-Mail, IRC, ICQ, etc, and
|
||||
similarly for how it notifies. It's also possible that we could
|
||||
introduce a special Bugzilla client that uses its own protocol, for
|
||||
maximum user productivity.
|
||||
|
||||
Indeed a request reply might be returned via a totally different
|
||||
transport method than was use to submit the request.
|
||||
|
||||
Internationalisation
|
||||
|
||||
Bugzilla currently supports only English. All of the field names,
|
||||
user instructions, etc are written in English. It would be desirable
|
||||
to allow "language packs" so Bugzilla can be easily used in
|
||||
non-English speaking locales.
|
||||
|
||||
To a degree field customisation supports this, because administrators
|
||||
could specify their own fields names anyway. However, there will
|
||||
always be some basic facilities not covered by this, and it is
|
||||
desirable that the administrator's interface also is
|
||||
internationalisable.
|
||||
|
||||
Better Searching
|
||||
|
||||
General Summary Reports
|
||||
|
||||
Sometimes, the normal querying page leaves a lot to be desired. There
|
||||
are other facilities already in place or which people have asked for:
|
||||
|
||||
Most Doomed Reports - All Bugs or All Bugs In A Product, Categorised
|
||||
On Assignee, Shows and Counts Number of Bugs For Each Assignee
|
||||
Most Voted For Bugs - All Bugs, Categorised On Product, Shows Top Ten
|
||||
Bugs Voters Most Want Fixed
|
||||
Number of Open Bugs For An Assignee - Bug List, Categorised On
|
||||
Developers, Counts Number of Bugs In Category
|
||||
|
||||
The important thing to realise is that people want categorised reports
|
||||
on all sorts of things - a general summary report.
|
||||
|
||||
In a categorised report, you choose the subset of bugs you wish to
|
||||
operate on (similar to how you would specify a query), and then
|
||||
categorise them on one or more fields.
|
||||
|
||||
For each category you display the count of the number of things in
|
||||
that category. You can optionally display the bugs themselves, or
|
||||
leave them out, just showing the counts. And you can optionally limit
|
||||
the number of things (bugs or subcategories) that display in each
|
||||
category.
|
||||
|
||||
Such a mechanism would let you do all of the above and more.
|
||||
Applications of this mechanism would only be recognised once it was
|
||||
implemented.
|
||||
|
||||
Related Bugs
|
||||
|
||||
It would be nice to have a field where you could enter other bugs
|
||||
related to the current bug. It would be handy for navigation and
|
||||
possibly even finding duplicates.
|
||||
|
||||
Column Specification Support
|
||||
|
||||
Currently bug lists use the columns that you last used. This doesn't
|
||||
work well for "prepackaged queries", where you followed a link. You
|
||||
can probably add a column by specifying a sort column, but this is
|
||||
difficult and suboptimal.
|
||||
|
||||
Furthermore, I find that when I want to add a column to a bug list,
|
||||
it's usually a one off and I would prefer it to go away for the next
|
||||
query. Hence, it would be nice to specify the columns that appear on
|
||||
the bug list (and general summary report) pages. The default query
|
||||
mechanism should be able to let you specify your default columns.
|
||||
|
||||
Advanced Querying Redesign
|
||||
|
||||
?
|
||||
|
||||
Keywords
|
||||
|
||||
People have a need to apply tags to bugs. In the beginning, people
|
||||
placed designators in the summary and status whiteboard. However,
|
||||
these fields were not designed for that, and so there were many flaws
|
||||
with this system:
|
||||
* They pollute the field with information that was never intended to
|
||||
be present.
|
||||
* Removing them with a bulk change is a difficult problem that has
|
||||
too many pitfalls to implement.
|
||||
* You can easily get the capitalisation wrong.
|
||||
|
||||
Then dependencies were introduced (when?), and people realised that
|
||||
they could use them for "tracking bugs". Again, dependencies were not
|
||||
designed for that, and so there were more flaws, albeit different
|
||||
ones, including:
|
||||
* They aren't really bugs, so it's difficult to distinguish issues
|
||||
from bugs.
|
||||
* They can pollute bugs counts, and you must somehow exclude them
|
||||
from queries.
|
||||
* There is a whole lot of useless information on them. They have an
|
||||
assignee but there is nothing to fix, and that person can get
|
||||
whined at by Bugzilla. They have target milestones which must be
|
||||
manually maintained. And so on.
|
||||
|
||||
Finally, keywords were introduced (when?) for this purpose to remove
|
||||
the need for these two systems. Unfortunately, the simple keywords
|
||||
implementation was itself lacking in certain features provided by the
|
||||
two previous systems, and has remained almost unchanged since its
|
||||
inception. Furthermore, it could not be forseen that in large
|
||||
installations, the sheer number of keywords could become unwieldly and
|
||||
could lead to a movement back to the other systems.
|
||||
|
||||
The keywords system was the right idea, however, and it remains so.
|
||||
Fixing the keywords system is one of the most important Bugzilla
|
||||
issues.
|
||||
|
||||
Bringing Keywords Up To Par
|
||||
|
||||
For the most part, keywords are very good at what they do. It is easy
|
||||
to add and remove them (unlike summary/whiteboard designators), we can
|
||||
simply see what issues are present on a bug (unlike tracking bugs),
|
||||
and we do not confuse bugs with issues (unlike tracking bugs).
|
||||
|
||||
However, there are still some "regressions" in the keyword system over
|
||||
previous systems:
|
||||
* Users wish to view the "dependency forest" of a keyword. While a
|
||||
dependency tree is of one bug, a dependency forest is of a bug
|
||||
list, and consists of a dependency tree for each member of the bug
|
||||
list. Users can work around this with tracking bugs by creating a
|
||||
tracking bug and viewing the dependency tree of that tracking bug.
|
||||
* Users wish to specify the keywords that initially apply to a bug,
|
||||
but instead they must edit the bug once it has already been
|
||||
submitted. They can work around this with summary designators,
|
||||
since they specify the summary at reporting time.
|
||||
* Users wish to store or share a bug list that contains a keywords
|
||||
column. Hence they wish to be able to specify what columns appear
|
||||
in the bug list URL, as mentioned earlier. They can work around
|
||||
this using summary designators, since almost all bug lists have a
|
||||
summary column.
|
||||
* Users wish to be able to view keywords on a bug list. However
|
||||
often they are only interested in a small number of keywords.
|
||||
Having a bug list with a keywords column means that all keywords
|
||||
will appear on a bug list. This can take a substantial amount of
|
||||
space where a bug has a lot of keywords, since the table columns
|
||||
in Bugzilla adjust to the largest cell in that column. Hence
|
||||
users wish to be able to specify which keywords should appear in
|
||||
the bug list. In a very real sense, each keyword is a field unto
|
||||
itself. Users can work around this by using summary designators,
|
||||
since they keywords will share the space in the summary column.
|
||||
* Users wish to know when bugs with a specific issue are resolved.
|
||||
Hence they wish to be able to receive notifications on all the
|
||||
bugs with a specific keyword. The introduction a generic watching
|
||||
facility (also for things like watching all bugs in a component)
|
||||
would achieve this. Users can work around this by using tracking
|
||||
bugs, as dependencies have an existing way of detecting fixes to
|
||||
bug a bug was blocked by.
|
||||
|
||||
Dealing With The Keyword Overload
|
||||
|
||||
At the time of writing, the mozilla.org installation has approximately
|
||||
100 keywords, and many more would be in use if the keywords system
|
||||
didn't have the problems it does.
|
||||
|
||||
Such a large number of keywords introduces logistical problems:
|
||||
* It must be easy for someone to learn what a keyword means. If a
|
||||
keyword is buried within a lot of other keywords, it can be
|
||||
difficult to find.
|
||||
* It must be easy to see what keywords are on a bug. If the number
|
||||
of keywords is large, then this can be difficult.
|
||||
|
||||
These lead some people to feel that there are "too many keywords".
|
||||
|
||||
These problems are not without solutions however. It is harder to
|
||||
find a list of designators or tracking bugs than it is a list of
|
||||
keywords.
|
||||
|
||||
The essential problem is it needs to be easy to find the keywords
|
||||
we're interested in through the mass of keywords.
|
||||
|
||||
Keyword Applicability
|
||||
|
||||
As has been previously mentioned, it is desirable for fields to be
|
||||
able to adapt to the values of other fields. This is certainly true
|
||||
for keywords. Many keywords are simply not relevant because of the
|
||||
bugs product, component, etc.
|
||||
|
||||
Hence, by introducing keyword applicability, and not displaying
|
||||
keywords that are not relevant to the current bug, or clearly
|
||||
separating them, we can make the keyword overload problem less
|
||||
significant.
|
||||
|
||||
Currently when you click on "keywords" on a bug, you get a list of all
|
||||
bugs. It would be desirable to introduce a list of keywords tailored
|
||||
to a specific bug, that reports, in order:
|
||||
* the keywords currently on the bug
|
||||
* the keywords not currently on the bug, but applicable to the bug
|
||||
* optionally, the keywords not applicable to the bug
|
||||
|
||||
This essentially orders the keywords into three groups, where each
|
||||
group is more important than the previous, and therefore appears
|
||||
closer to the top.
|
||||
|
||||
Keyword Grouping & Ordering
|
||||
|
||||
We could further enhance both the global and bug specific keyword list
|
||||
by grouping keywords. We should always have a "flat" view of
|
||||
keywords, but other ways of viewing the keywords would be useful too.
|
||||
|
||||
If keyword applicability was implemented, we could group keywords
|
||||
based on their "applicability condition". Keywords that apply to all
|
||||
bugs could be separated from keywords that apply to a specific
|
||||
product, both on the global keyword list and the keyword list of a bug
|
||||
that is in that product.
|
||||
|
||||
We could specify groups of our own. For example, many keywords are in
|
||||
a mutually exclusive group, essentially like radio buttons in a user
|
||||
interface. This creates a natural grouping, although other groupings
|
||||
occur (which depends on your keywords).
|
||||
|
||||
It is possible that we could use collapsing/expanding operations on
|
||||
"twisties" to only should the groups we are interested in.
|
||||
|
||||
And instead of grouping keywords, we could order them on some metric
|
||||
of usefulness, such as:
|
||||
* when the keyword was last added to a bug
|
||||
* how many bugs the keyword is on
|
||||
* how many open bugs the keyword is on
|
||||
|
||||
Opting Out Of Keywords
|
||||
|
||||
Not all people are going to care about all keywords. Therefore it
|
||||
makes sense that you may wish to specify which keywords you are
|
||||
interested in, either on the bug page, or on notifications.
|
||||
|
||||
Other keywords will therefore not bother users who are not interested
|
||||
in them.
|
||||
|
||||
Keyword Security
|
||||
|
||||
Currently all keywords are available and editable to all people with
|
||||
edit bugs access. This situation is clearly suboptimal.
|
||||
|
||||
Although relying on good behaviour for people to not do what they
|
||||
shouldn't works reasonably well on the mozilla.org, it is better to
|
||||
enforce that behaviour - it can be breached through malice, accident
|
||||
or ignorance.
|
||||
|
||||
And in the situation where it is desirable for the presence or absence
|
||||
of a keyword not to be revealed, organisations either need to be
|
||||
content with the divulgence, or not use keywords at all.
|
||||
|
||||
In the situation where they choose to divulge, introducing the ability
|
||||
to restrict who can see the keyword would also reduce keyword
|
||||
overload.
|
||||
|
||||
Personal Keywords
|
||||
|
||||
Keywords join together a set of bugs which would otherwise be
|
||||
unrelated in the bug system.
|
||||
|
||||
We allow users to store their own queries. However we don't allow
|
||||
them to store their own keywords on a bug. This reduces the
|
||||
usefulness of personal queries, since you cannot join a set of
|
||||
unrelated bugs together in a way that you wish. Lists of bug numbers
|
||||
can work, by they can only be used for small lists, and it is
|
||||
impossible to share a list between multiple queries.
|
||||
|
||||
Personal keywords are necessary to replace personal tracking bugs, as
|
||||
they would not pollute the keyword space. Indeed, on many
|
||||
installations this could remove some keywords out of the global
|
||||
keyword space.
|
||||
|
||||
In a similar vein and with similar effects, group keywords could be
|
||||
introduced that are only available to members of a specific group.
|
||||
|
||||
Keyword Restrictions
|
||||
|
||||
Keywords are not islands unto themselves. Along with their potential
|
||||
to be involved in the inter-field relationships mentioned earlier,
|
||||
keywords can also be related to other keywords.
|
||||
|
||||
Essentially, there are two possibilities:
|
||||
* a set of keywords are mutually exclusive
|
||||
* the presence of a keyword implies another keyword must be present
|
||||
|
||||
Introduction of the ability to specify these restrictions would have
|
||||
benefits.
|
||||
|
||||
If mutually exclusive keywords were present on a bug, their removal
|
||||
would fix up the database, as well as reducing the number of keywords
|
||||
on that bug.
|
||||
|
||||
In the situation where a keyword implies another keyword, there are
|
||||
two possiblities as to how to handle the situation.
|
||||
|
||||
The first is automatically add the keyword. This would fix up the
|
||||
database, but it would increase the number of keywords on a bug.
|
||||
|
||||
The second is to automatically remove the keyword, and alter queries
|
||||
so they pick up the first keyword as well as the removed keyword.
|
||||
This would fix up the database and reduce the number of keywords on a
|
||||
bug, but it might confuse users who don't see the keyword.
|
||||
Alternatively, the implied keywords could be listed separately.
|
||||
|
||||
Notifications
|
||||
|
||||
Every time a bug gets changed notifications get sent out to people
|
||||
letting them know about what changes have been made. This is a
|
||||
significant feature, and all sorts of questions can be raised, but
|
||||
they mainly boil down to when they should be sent and what they should
|
||||
look like.
|
||||
|
||||
Changes You're Interested In
|
||||
|
||||
As of version 2.12 users can specify what sort of changes they are
|
||||
interested in receiving notifications for. However, this is still
|
||||
limited. As yet there is no facility to specify which keywords you
|
||||
care about, and whether you care about changes to fields such as the
|
||||
QA contact changes.
|
||||
Furthermore, often an unnecessary comment will go along with a change,
|
||||
either because it is required, or the commenter is ignorant of how the
|
||||
new system works. While explaining why you did something is useful,
|
||||
merely commenting on what you did is not because that information is
|
||||
already accessible view "Bug Activity".
|
||||
|
||||
Because of this unnecessary comment, a lot of changes that would
|
||||
otherwise not generate notifications for certain people do so, because
|
||||
few people are willing to turn off comments. One way to deal with
|
||||
this problem is to allow people to specify that their comments are
|
||||
purely explanatory, and that anyone who is not interested in the
|
||||
change will not be interested in the comment.
|
||||
|
||||
Furthermore, one possible rationale for unnecessary comments is that
|
||||
the bug activity does not display on the normal page and hence it is
|
||||
difficult to cross reference comments and actions. Hence, it would be
|
||||
beneficial to be able to do this.
|
||||
|
||||
Bugs You're Watching
|
||||
|
||||
Currently to receive a notification about a bug you need to have your
|
||||
name on it. This is suboptimal because you need to know about a bug
|
||||
before you can receive notifications on it. Often you are interested
|
||||
in any bug with a field set to a specific value. For example, you
|
||||
might be interested in all bugs with a specific product, component or
|
||||
keyword.
|
||||
|
||||
If someone could automatically receive notifications about these bugs,
|
||||
it would make everyone's lives easier. Currently the default assignee
|
||||
and QA contact for a component will automatically receive
|
||||
notifications for
|
||||
|
||||
Question: This moves half way to a BCC.
|
||||
|
||||
Bulk Changes
|
||||
|
||||
A very useful feature of Bugzilla is the ability to perform an action
|
||||
on multiple bugs at once. However, this means that similar
|
||||
notifications are currently generated for each bug modified.
|
||||
|
||||
This can result in a torrent of notifications that can annoy.
|
||||
|
||||
Furthermore, since the bugs are all changed close to each other in
|
||||
time, it is easy for someone to mass delete all the notifications
|
||||
generated by a bulk change and miss an unrelated notification in the
|
||||
middle.
|
||||
|
||||
These factors can lead to a tendency for people to delay bulk changes,
|
||||
or avoid them entirely. This is suboptimal.
|
||||
|
||||
It would be better if a bulk change generated only one notification
|
||||
mail. This would vastly reduce the annoyance factor, and prevent
|
||||
accidental deletion of notifications.
|
||||
|
||||
One problem with this change is that some people separate out
|
||||
notifications using filtering. This means that they would no longer
|
||||
be match parts of a bulk change under different filtering rules.
|
||||
|
||||
One possibility to resolve this is to allow people to specify groups
|
||||
of bugs. All bugs within a group would go into the same
|
||||
notification. The filters could then distinguish the different bug
|
||||
groups.
|
||||
|
||||
In any case, it is likely there would need to be a transition period
|
||||
to allow people to alter their filters.
|
||||
|
||||
Nominations
|
||||
|
||||
?
|
||||
|
||||
Linking Bugzilla Installations
|
||||
|
||||
The first example of linking Bugzilla installations together has is
|
||||
the introduction of bug moving in version 2.12. However, it would be
|
||||
useful to be able to link installations in more ways.
|
||||
* Dependencies and other relationships between bugs in other
|
||||
installations. This is difficult because dependencies are
|
||||
synchronised on both bugs, so the installation that changes
|
||||
dependencies would need to communicate the new state to the other
|
||||
installation. It would also mean that relationships and
|
||||
notifications that refer to other bugs would need to communicate
|
||||
with the other installation.
|
||||
* References to bugs in other installations. Currently if you type
|
||||
"bug XXX" or "bug #XXX" where XXX is a number, you get an
|
||||
automatic hyperlink to that bug. It would be useful if you could
|
||||
say "YYY bug #XXX" where YYY is the name of another installation.
|
||||
|
||||
Retirement
|
||||
|
||||
?
|
||||
|
||||
Whiny Reports
|
||||
|
||||
?
|
||||
|
||||
Group Redesign
|
||||
|
||||
?
|
||||
|
||||
Hard Wrapping Comments
|
||||
|
||||
Currently Bugzilla "hard wraps" its comments to a specific line size,
|
||||
similar to E-Mail. This has various problems:
|
||||
* The way it currently works, wrapping is done in the browser at
|
||||
submission time using a non-standard HTML extension not supported
|
||||
by some (uncommon) browsers. These browsers generate comments
|
||||
that scroll off the right side of the screen.
|
||||
* Because comments are of fixed width, when you expand your browser
|
||||
window, the comments do not expand to fit available space.
|
||||
|
||||
It would be much better to move to a world of soft wrapping, where the
|
||||
browser wraps the text at display time, similar to a world processor.
|
||||
And as in a word processor, soft wrapping does not preclude the
|
||||
insertion of newlines.
|
||||
|
||||
Hard wrapping is too entrenched into text E-Mail to fix, but we can
|
||||
fix Bugzilla without causing any problems. The old content will still
|
||||
be wrapped too early, but at least new content will work.
|
||||
</literallayout>
|
||||
</para>
|
||||
</chapter>
|
||||
|
||||
@@ -32,3 +616,4 @@ sgml-shorttag:t
|
||||
sgml-tag-region-if-active:t
|
||||
End:
|
||||
-->
|
||||
|
||||
|
||||
@@ -616,6 +616,15 @@ bash# mkdir /usr/bonsaitools/bin
|
||||
bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
|
||||
</programlisting>
|
||||
</para>
|
||||
<para>
|
||||
Alternately, you can simply run this perl one-liner to
|
||||
change your path to perl in all the files in your Bugzilla
|
||||
installation:
|
||||
<programlisting>
|
||||
perl -pi -e 's@#!/usr/bonsaitools/bin/perl@/usr/bin/perl@' *cgi *pl Bug.pm
|
||||
</programlisting>
|
||||
Change the second path to perl to match your installation.
|
||||
</para>
|
||||
</example>
|
||||
<tip>
|
||||
<para>
|
||||
@@ -1241,7 +1250,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \
|
||||
</section>
|
||||
|
||||
|
||||
<section>
|
||||
<section id="unixhistory">
|
||||
<title>UNIX Installation Instructions History</title>
|
||||
<para>
|
||||
This document was originally adapted from the Bonsai
|
||||
@@ -1252,9 +1261,8 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \
|
||||
The February 25, 1999 re-write of this page was done by Ry4an
|
||||
Brase <ry4an@ry4an.org>, with some edits by Terry
|
||||
Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But
|
||||
don't send bug reports to them; report them using bugzilla, at
|
||||
http://bugzilla.mozilla.org/enter_bug.cgi , project Webtools,
|
||||
component Bugzilla).
|
||||
don't send bug reports to them; report them using bugzilla, at <ulink
|
||||
url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla</ulink> ).
|
||||
</para>
|
||||
<para>
|
||||
This document was heavily modified again Wednesday, March 07
|
||||
@@ -1696,16 +1704,46 @@ exit;
|
||||
|
||||
<step>
|
||||
<para>
|
||||
Modify the invocation of all system() calls in all perl scripts in your Bugzilla directory. For instance, change this line in processmail:
|
||||
<programlisting>
|
||||
system ("./processmail.pl",@ARGLIST);
|
||||
</programlisting>
|
||||
to
|
||||
<programlisting>
|
||||
Modify the invocation of all system() calls in all perl
|
||||
scripts in your Bugzilla directory. For instance, change
|
||||
this line in processmail:
|
||||
<programlisting>
|
||||
system ("./processmail.pl",@ARGLIST);
|
||||
</programlisting> to
|
||||
<programlisting>
|
||||
system ("perl processmail.pl",@ARGLIST);
|
||||
</programlisting>
|
||||
</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>
|
||||
Add <function>binmode()</function> calls so attachments
|
||||
will work (<ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=62000">bug 62000</ulink>).
|
||||
</para>
|
||||
<para>
|
||||
Because Microsoft Windows based systems handle binary
|
||||
files different than Unix based systems, you need to add
|
||||
the following lines to
|
||||
<filename>createattachment.cgi</filename> and
|
||||
<filename>showattachment.cgi</filename> before the
|
||||
<function>require 'CGI.pl';</function> line.
|
||||
</para>
|
||||
<para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
binmode(STDIN);
|
||||
binmode(STDOUT);
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
According to <ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=62000">bug 62000</ulink>, the perl documentation says that you should always use <function>binmode()</function> when dealing with binary files, but never when dealing with text files. That seems to suggest that rather than aribtrarily putting <function>binmode()</function> at the begining of the attachment files, there should be logic to determine if <function>binmode()</function> is needed or not.
|
||||
</para>
|
||||
</note>
|
||||
</step>
|
||||
</procedure>
|
||||
|
||||
<tip>
|
||||
@@ -1714,6 +1752,8 @@ system ("perl processmail.pl",@ARGLIST);
|
||||
relationships to Properties -> Home directory (tab) ->
|
||||
Application Settings (section) -> Configuration (button),
|
||||
such as:
|
||||
</para>
|
||||
<para>
|
||||
<programlisting>
|
||||
.cgi to: <perl install directory>\perl.exe %s %s
|
||||
.pl to: <perl install directory>\perl.exe %s %s
|
||||
@@ -1742,7 +1782,9 @@ GET,HEAD,POST
|
||||
registry at the following location:
|
||||
</para>
|
||||
<para>
|
||||
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
|
||||
<programlisting>
|
||||
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
|
||||
</programlisting>
|
||||
</para>
|
||||
<para>
|
||||
The keys should be called ".pl" and ".cgi", and both
|
||||
@@ -1761,26 +1803,102 @@ GET,HEAD,POST
|
||||
If attempting to run Bugzilla 2.12 or older, you will need
|
||||
to remove encrypt() calls from the Perl source. This is
|
||||
<emphasis>not necessary</emphasis> for Bugzilla 2.13 and
|
||||
later.
|
||||
later, which includes the current release, Bugzilla
|
||||
&bz-ver;.
|
||||
<example>
|
||||
<title>Removing encrypt() for Windows NT Bugzilla version
|
||||
2.12 or earlier</title>
|
||||
<para>
|
||||
Replace this:
|
||||
<programlisting>
|
||||
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($realcryptpwd, 0, 2)) . ")");
|
||||
my $enteredcryptpwd = FetchOneColumn();
|
||||
</programlisting>
|
||||
with this:
|
||||
<programlisting>
|
||||
my $enteredcryptpwd = $enteredpwd
|
||||
</programlisting>
|
||||
Replace this:
|
||||
<programlisting>
|
||||
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($realcryptpwd, 0, 2)) . ")");
|
||||
my $enteredcryptpwd = FetchOneColumn();
|
||||
</programlisting>
|
||||
with this:
|
||||
<programlisting>
|
||||
my $enteredcryptpwd = $enteredpwd
|
||||
</programlisting>
|
||||
in cgi.pl.
|
||||
</para>
|
||||
</example>
|
||||
</para>
|
||||
</tip>
|
||||
</section>
|
||||
|
||||
<section id="bzldap">
|
||||
<title>Bugzilla LDAP Integration</title>
|
||||
<para>
|
||||
What follows is some late-breaking information on using the
|
||||
LDAP authentication options with Bugzilla. The author has not
|
||||
tested these (nor even formatted this section!) so please
|
||||
contribute feedback to the newsgroup.
|
||||
</para>
|
||||
<literallayout>
|
||||
Mozilla::LDAP module
|
||||
|
||||
The Mozilla::LDAP module allows you to use LDAP for authentication to
|
||||
the Bugzilla system. This module is not required if you are not using
|
||||
LDAP.
|
||||
|
||||
Mozilla::LDAP (aka PerLDAP) is available for download from
|
||||
http://www.mozilla.org/directory.
|
||||
|
||||
NOTE: The Mozilla::LDAP module requires Netscape's Directory SDK.
|
||||
Follow the link for "Directory SDK for C" on that same page to
|
||||
download the SDK first. After you have installed this SDK, then
|
||||
install the PerLDAP module.
|
||||
----------------------------------------------------------------------
|
||||
|
||||
Post-Installation Checklist
|
||||
----------------------------------------------------------------------
|
||||
Set useLDAP to "On" **only** if you will be using an LDAP directory
|
||||
for authentication. Be very careful when setting up this parameter;
|
||||
if you set LDAP authentication, but do not have a valid LDAP directory
|
||||
set up, you will not be able to log back in to Bugzilla once you log
|
||||
out. (If this happens, you can get back in by manually editing the
|
||||
data/params file, and setting useLDAP back to 0.)
|
||||
|
||||
If using LDAP, you must set the three additional parameters:
|
||||
|
||||
Set LDAPserver to the name (and optionally port) of your LDAP server.
|
||||
If no port is specified, it defaults to the default port of 389. (e.g
|
||||
"ldap.mycompany.com" or "ldap.mycompany.com:1234")
|
||||
|
||||
Set LDAPBaseDN to the base DN for searching for users in your LDAP
|
||||
directory. (e.g. "ou=People,o=MyCompany") uids must be unique under
|
||||
the DN specified here.
|
||||
|
||||
Set LDAPmailattribute to the name of the attribute in your LDAP
|
||||
directory which contains the primary email address. On most directory
|
||||
servers available, this is "mail", but you may need to change this.
|
||||
----------------------------------------------------------------------
|
||||
|
||||
(Not sure where this bit should go, but it's important that it be in
|
||||
there somewhere...)
|
||||
----------------------------------------------------------------------
|
||||
Using LDAP authentication for Bugzilla:
|
||||
|
||||
The existing authentication scheme for Bugzilla uses email addresses
|
||||
as the primary user ID, and a password to authenticate that user. All
|
||||
places within Bugzilla where you need to deal with user ID (e.g
|
||||
assigning a bug) use the email address.
|
||||
|
||||
The LDAP authentication builds on top of this scheme, rather than
|
||||
replacing it. The initial log in is done with a username and password
|
||||
for the LDAP directory. This then fetches the email address from LDAP
|
||||
and authenticates seamlessly in the standard Bugzilla authentication
|
||||
scheme using this email address. If an account for this address
|
||||
already exists in your Bugzilla system, it will log in to that
|
||||
account. If no account for that email address exists, one is created
|
||||
at the time of login. (In this case, Bugzilla will attempt to use the
|
||||
"displayName" or "cn" attribute to determine the user's full name.)
|
||||
|
||||
After authentication, all other user-related tasks are still handled
|
||||
by email address, not LDAP username. You still assign bugs by email
|
||||
address, query on users by email address, etc.
|
||||
----------------------------------------------------------------------
|
||||
</literallayout>
|
||||
</section>
|
||||
</section>
|
||||
</chapter>
|
||||
|
||||
|
||||
@@ -35,6 +35,14 @@
|
||||
an @resolution field, you can even change the Bugzilla bug
|
||||
state.
|
||||
</para>
|
||||
<para>
|
||||
There is also a project, based upon somewhat dated Bugzilla
|
||||
code, to integrate CVS and Bugzilla through CVS' ability to
|
||||
email. Check it out at:
|
||||
<ulink url="http://homepages.kcbbs.gen.nz/~tonyg/">
|
||||
http://homepages.kcbbs.gen.nz/~tonyg/</ulink>, under the
|
||||
<quote>cvszilla</quote> link.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="scm" xreflabel="Perforce SCM (Fast Software Configuration Management System, a powerful commercial alternative to CVS">
|
||||
|
||||
@@ -247,6 +247,104 @@ RewriteRule ^/([0-9]+)$ http://foo.bar.com/show_bug.cgi?id=$1 [L,R]
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="bzhacking">
|
||||
<title>Hacking Bugzilla</title>
|
||||
<para>
|
||||
What follows are some general guidelines for changing Bugzilla, and adhering to good coding practice while doing so. We've had some checkins in the past which ruined Bugzilla installations because of disregard for these conventions. Sorry for the lack of formatting; I got this info into the Guide on the day of 2.14 release and haven't formatted it yet.
|
||||
</para>
|
||||
<literallayout>
|
||||
|
||||
The following is a guide for reviewers when checking code into Bugzilla's
|
||||
CVS repostory at mozilla.org. If you wish to submit patches to Bugzilla,
|
||||
you should follow the rules and style conventions below. Any code that
|
||||
does not adhere to these basic rules will not be added to Bugzilla's
|
||||
codebase.
|
||||
|
||||
1. Usage of variables in Regular Expressions
|
||||
|
||||
It is very important that you don't use a variable in a regular
|
||||
expression unless that variable is supposed to contain an expression.
|
||||
This especially applies when using grep. You should use:
|
||||
|
||||
grep ($_ eq $value, @array);
|
||||
|
||||
- NOT -
|
||||
|
||||
grep (/$value/, @array);
|
||||
|
||||
If you need to use a non-expression variable inside of an expression, be
|
||||
sure to quote it properly (using \Q..\E).
|
||||
|
||||
Coding Style for Bugzilla
|
||||
-------------------------
|
||||
|
||||
While it's true that not all of the code currently in Bugzilla adheres to
|
||||
this styleguide, it is something that is being worked toward. Therefore,
|
||||
we ask that all new code (submitted patches and new files) follow this guide
|
||||
as closely as possible (if you're only changing 1 or 2 lines, you don't have
|
||||
to reformat the entire file :).
|
||||
|
||||
1. Whitespace
|
||||
|
||||
Bugzilla's prefered indentation is 4 spaces (no tabs, please).
|
||||
|
||||
2. Curly braces.
|
||||
|
||||
The opening brace of a block should be on the same line as the statement
|
||||
that is causing the block and the closing brace should be at the same
|
||||
indentation level as that statement, for example:
|
||||
|
||||
if ($var) {
|
||||
print "The variable is true";
|
||||
} else {
|
||||
print "Try again";
|
||||
}
|
||||
|
||||
- NOT -
|
||||
|
||||
if ($var)
|
||||
{
|
||||
print "The variable is true";
|
||||
}
|
||||
else
|
||||
{
|
||||
print "Try again";
|
||||
}
|
||||
|
||||
3. File Names
|
||||
|
||||
File names for bugzilla code and support documention should be legal across
|
||||
multiple platforms. \ / : * ? " < > and | are all illegal characters for
|
||||
filenames on various platforms. Also, file names should not have spaces in
|
||||
them as they can cause confusion in CVS and other mozilla.org utilities.
|
||||
|
||||
4. Variable Names
|
||||
|
||||
If a variable is scoped globally ($::variable) its name should be descriptive
|
||||
of what it contains. Local variables can be named a bit looser, provided the
|
||||
context makes their content obvious. For example, $ret could be used as a
|
||||
staging variable for a routine's return value as the line |return $ret;| will
|
||||
make it blatently obvious what the variable holds and most likely be shown
|
||||
on the same screen as |my $ret = "";|.
|
||||
|
||||
5. Cross Database Compatability
|
||||
|
||||
Bugzilla was originally written to work with MySQL and therefore took advantage
|
||||
of some of its features that aren't contained in other RDBMS software. These
|
||||
should be avoided in all new code. Examples of these features are enums and
|
||||
encrypt().
|
||||
|
||||
6. Cross Platform Compatability
|
||||
|
||||
While Bugzilla was written to be used on Unix based systems (and Unix/Linux is
|
||||
still the only officially supported platform) there are many who desire/need to
|
||||
run Bugzilla on Microsoft Windows boxes. Whenever possible, we should strive
|
||||
not to make the lives of these people any more complicated and avoid doing things
|
||||
that break Bugzilla's ability to run on multiple operating systems.
|
||||
|
||||
</literallayout>
|
||||
</section>
|
||||
|
||||
</appendix>
|
||||
|
||||
|
||||
|
||||
@@ -399,13 +399,13 @@ system against which all others are measured.
|
||||
our Bugzilla database. Please notice the box is a
|
||||
<emphasis>scrollbox</emphasis>. Using the down arrow on
|
||||
the scrollbox, scroll down until you can see an entry
|
||||
called "Webtools". Select this entry.
|
||||
called "Bugzilla". Select this entry.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Did you notice that some of the boxes to the right changed
|
||||
when you selected "Webtools"? Every Program (or Product)
|
||||
when you selected "Bugzilla"? Every Program (or Product)
|
||||
has different Versions, Components, and Target Milestones
|
||||
associated with it. A "Version" is the number of a
|
||||
software program.
|
||||
@@ -452,36 +452,67 @@ system against which all others are measured.
|
||||
Normally, a Component has a single Owner, who is responsible
|
||||
for overseeing efforts to improve that Component.
|
||||
<example>
|
||||
<title>Mozilla Webtools Components</title>
|
||||
<title>Mozilla's Bugzilla Components</title>
|
||||
<informalexample>
|
||||
<para>
|
||||
Mozilla's "Webtools" Product is composed of several pieces (Components):
|
||||
Mozilla's "Bugzilla" Product is composed of several pieces (Components):
|
||||
<simplelist>
|
||||
<member><emphasis>Bonsai</emphasis>,
|
||||
a tool to show recent changes to Mozilla</member>
|
||||
<member><emphasis>Bugzilla</emphasis>,
|
||||
a defect-tracking tool</member>
|
||||
<member><emphasis>Build</emphasis>,
|
||||
a tool to automatically compile source code
|
||||
into machine-readable form</member>
|
||||
<member><emphasis>Despot</emphasis>,
|
||||
a program that controls access to the other Webtools</member>
|
||||
<member><emphasis>LXR</emphasis>,
|
||||
a utility that automatically marks up text files
|
||||
to make them more readable</member>
|
||||
<member><emphasis>MozBot</emphasis>,
|
||||
a "robot" that announces changes to Mozilla in Chat</member>
|
||||
<member><emphasis>TestManager</emphasis>,
|
||||
a tool to help find bugs in Mozilla</member>
|
||||
<member><emphasis>Tinderbox</emphasis>,
|
||||
which displays reports from Build</member>
|
||||
<member><emphasis>Administration</emphasis>,
|
||||
Administration of a bugzilla installation, including
|
||||
<filename>editcomponents.cgi</filename>,
|
||||
<filename>editgroups.cgi</filename>,
|
||||
<filename>editkeywords.cgi</filename>,
|
||||
<filename>editparams.cgi</filename>,
|
||||
<filename>editproducts.cgi</filename>,
|
||||
<filename>editusers.cgi</filename>,
|
||||
<filename>editversions.cgi,</filename> and
|
||||
<filename>sanitycheck.cgi</filename>.
|
||||
</member>
|
||||
<member><emphasis>Bugzilla-General</emphasis>,
|
||||
Anything that doesn't fit in the other components, or spans
|
||||
multiple components.
|
||||
</member>
|
||||
<member><emphasis>Creating/Changing Bugs</emphasis>,
|
||||
Creating, changing, and viewing bugs.
|
||||
<filename>enter_bug.cgi</filename>,
|
||||
<filename>post_bug.cgi</filename>,
|
||||
<filename>show_bug.cgi</filename> and
|
||||
<filename>process_bug.cgi</filename>.
|
||||
</member>
|
||||
<member><emphasis>Documentation</emphasis>,
|
||||
The bugzilla documentation, including anything in the
|
||||
<filename>docs/</filename> directory and The Bugzilla Guide
|
||||
(This document :)
|
||||
</member>
|
||||
<member><emphasis>Email</emphasis>,
|
||||
Anything to do with email sent by Bugzilla.
|
||||
<filename>processmail</filename>
|
||||
</member>
|
||||
<member><emphasis>Installation</emphasis>,
|
||||
The installation process of Bugzilla. This includes
|
||||
<filename>checksetup.pl</filename> and whatever else it evolves into.
|
||||
</member>
|
||||
<member><emphasis>Query/Buglist</emphasis>,
|
||||
Anything to do with searching for bugs and viewing the buglists.
|
||||
<filename>query.cgi</filename> and
|
||||
<filename>buglist.cgi</filename>
|
||||
</member>
|
||||
<member><emphasis>Reporting/Charting</emphasis>,
|
||||
Getting reports from Bugzilla.
|
||||
<filename>reports.cgi</filename> and
|
||||
<filename>duplicates.cgi</filename>
|
||||
</member>
|
||||
<member><emphasis>User Accounts</emphasis>,
|
||||
Anything about managing a user account from the user's perspective.
|
||||
<filename>userprefs.cgi</filename>, saved queries, creating accounts,
|
||||
changing passwords, logging in, etc.
|
||||
</member>
|
||||
<member><emphasis>User Interface</emphasis>,
|
||||
General issues having to do with the user interface cosmetics (not
|
||||
functionality) including cosmetic issues, HTML templates, etc.
|
||||
</member>
|
||||
</simplelist>
|
||||
</para>
|
||||
<para>
|
||||
A different person is responsible for each of these Components.
|
||||
Tara Hernandez keeps
|
||||
the "Bugzilla" component up-to-date.
|
||||
</para>
|
||||
</informalexample>
|
||||
</example>
|
||||
</para>
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -26,7 +26,7 @@
|
||||
<!ENTITY bzg-ver "2.14">
|
||||
<!ENTITY bzg-cvs-ver "2.15.0">
|
||||
<!ENTITY bzg-auth "Matthew P. Barnson">
|
||||
<!ENTITY bzg-auth-email "<email>barnboy@NOSPAM.trilobyte.net</email>">
|
||||
<!ENTITY bzg-auth-email "<email>barnboy@trilobyte.net</email>">
|
||||
<!ENTITY mysql "http://www.mysql.com/">
|
||||
<!ENTITY perl-ver "5.6.1">
|
||||
|
||||
@@ -126,14 +126,14 @@ try to avoid clutter and feel free to waste space in the code to make it more re
|
||||
<othername>P.</othername>
|
||||
<surname>Barnson</surname>
|
||||
<affiliation>
|
||||
<address><email>barnboy@NOSPAM.trilobyte.net</email></address>
|
||||
<address><email>barnboy@trilobyte.net</email></address>
|
||||
</affiliation>
|
||||
</author>
|
||||
|
||||
<collab>
|
||||
<collabname>Zach Lipton</collabname>
|
||||
<affiliation>
|
||||
<address><email>zach@NOSPAM.zachlipton.com</email></address>
|
||||
<address><email>zach AT zachlipton DOT com</email></address>
|
||||
</affiliation>
|
||||
</collab>
|
||||
|
||||
@@ -196,6 +196,9 @@ try to avoid clutter and feel free to waste space in the code to make it more re
|
||||
<!-- The Future of Bugzilla -->
|
||||
&future;
|
||||
|
||||
<!-- Major Bugzilla Variants -->
|
||||
&variants;
|
||||
|
||||
<!-- Appendix: The Frequently Asked Questions -->
|
||||
&faq;
|
||||
|
||||
@@ -205,9 +208,6 @@ try to avoid clutter and feel free to waste space in the code to make it more re
|
||||
<!-- Appendix: The Database Schema -->
|
||||
&database;
|
||||
|
||||
<!-- Appendix: Major Bugzilla Variants -->
|
||||
&variants;
|
||||
|
||||
<!-- Appendix: Custom Patches -->
|
||||
&patches;
|
||||
|
||||
|
||||
@@ -70,8 +70,7 @@
|
||||
<para>
|
||||
If you have any questions regarding this document, its
|
||||
copyright, or publishing this document in non-electronic form,
|
||||
please contact &bzg-auth;. Remove "NOSPAM" from email address
|
||||
to send.
|
||||
please contact &bzg-auth;.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
@@ -172,8 +171,8 @@
|
||||
</para>
|
||||
<para>
|
||||
<ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink>
|
||||
for initially converting Bugzilla from BugSplat! and writing the
|
||||
README upon which this documentation is largely based.
|
||||
for initially writing Bugzilla and creating the
|
||||
README upon which the UNIX installation documentation is largely based.
|
||||
</para>
|
||||
<para>
|
||||
<ulink url="mailto://tara@tequilarista.org">Tara
|
||||
@@ -204,7 +203,8 @@
|
||||
documentation (in no particular order):
|
||||
</para>
|
||||
<para>
|
||||
Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron Teitelbaum
|
||||
Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron
|
||||
Teitelbaum, Jacob Steenhagen, Joe Robins
|
||||
</para>
|
||||
</section>
|
||||
<section id="feedback">
|
||||
|
||||
@@ -1192,6 +1192,103 @@
|
||||
</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>
|
||||
You may find this example illustrative for how bug groups work.
|
||||
<example>
|
||||
<title>Bugzilla Groups</title>
|
||||
<literallayout>
|
||||
Bugzilla Groups example
|
||||
-----------------------
|
||||
|
||||
For this example, let us suppose we have four groups, call them
|
||||
Group1, Group2, Group3, and Group4.
|
||||
|
||||
We have 5 users, User1, User2, User3, User4, User5.
|
||||
|
||||
We have 8 bugs, Bug1, ..., Bug8.
|
||||
|
||||
Group membership is defined by this chart:
|
||||
(X denotes that user is in that group.)
|
||||
(I apologize for the nasty formatting of this table. Try viewing
|
||||
it in a text-based browser or something for now. -MPB)
|
||||
|
||||
G G G G
|
||||
r r r r
|
||||
o o o o
|
||||
u u u u
|
||||
p p p p
|
||||
1 2 3 4
|
||||
+-+-+-+-+
|
||||
User1|X| | | |
|
||||
+-+-+-+-+
|
||||
User2| |X| | |
|
||||
+-+-+-+-+
|
||||
User3|X| |X| |
|
||||
+-+-+-+-+
|
||||
User4|X|X|X| |
|
||||
+-+-+-+-+
|
||||
User5| | | | |
|
||||
+-+-+-+-+
|
||||
|
||||
Bug restrictions are defined by this chart:
|
||||
(X denotes that bug is restricted to that group.)
|
||||
|
||||
G G G G
|
||||
r r r r
|
||||
o o o o
|
||||
u u u u
|
||||
p p p p
|
||||
1 2 3 4
|
||||
+-+-+-+-+
|
||||
Bug1| | | | |
|
||||
+-+-+-+-+
|
||||
Bug2| |X| | |
|
||||
+-+-+-+-+
|
||||
Bug3| | |X| |
|
||||
+-+-+-+-+
|
||||
Bug4| | | |X|
|
||||
+-+-+-+-+
|
||||
Bug5|X|X| | |
|
||||
+-+-+-+-+
|
||||
Bug6|X| |X| |
|
||||
+-+-+-+-+
|
||||
Bug7|X|X|X| |
|
||||
+-+-+-+-+
|
||||
Bug8|X|X|X|X|
|
||||
+-+-+-+-+
|
||||
|
||||
Who can see each bug?
|
||||
|
||||
Bug1 has no group restrictions. Therefore, Bug1 can be seen by any
|
||||
user, whatever their group membership. This is going to be the only
|
||||
bug that User5 can see, because User5 isn't in any groups.
|
||||
|
||||
Bug2 can be seen by anyone in Group2, that is User2 and User4.
|
||||
|
||||
Bug3 can be seen by anyone in Group3, that is User3 and User4.
|
||||
|
||||
Bug4 can be seen by anyone in Group4. Nobody is in Group4, so none of
|
||||
these users can see Bug4.
|
||||
|
||||
Bug5 can be seen by anyone who is in _both_ Group1 and Group2. This
|
||||
is only User4. User1 cannot see it because he is not in Group2, and
|
||||
User2 cannot see it because she is not in Group1.
|
||||
|
||||
Bug6 can be seen by anyone who is in both Group1 and Group3. This
|
||||
would include User3 and User4. Similar to Bug5, User1 cannot see Bug6
|
||||
because he is not in Group3.
|
||||
|
||||
Bug7 can be seen by anyone who is in Group1, Group2, and Group3. This
|
||||
is only User4. All of the others are missing at least one of those
|
||||
group priveleges, and thus cannot see the bug.
|
||||
|
||||
Bug8 can be seen by anyone who is in Group1, Group2, Group3, and
|
||||
Group4. There is nobody in all four of these groups, so nobody can
|
||||
see Bug8. It doesn't matter that User4 is in Group1, Group2, and
|
||||
Group3, since he isn't in Group4.
|
||||
</literallayout>
|
||||
</example>
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
<para>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="dbschema.jpg" format="jpg">
|
||||
<imagedata fileref="../images/dbschema.jpg" format="jpg">
|
||||
</imageobject>
|
||||
|
||||
<textobject>
|
||||
|
||||
@@ -620,6 +620,12 @@
|
||||
progression states, also require adjusting the program logic to
|
||||
compensate for the change.
|
||||
</para>
|
||||
<para>
|
||||
There is no GUI for adding fields to Bugzilla at this
|
||||
time. You can follow development of this feature at
|
||||
<ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=91037">http://bugzilla.mozilla.org/show_bug.cgi?id=91037</ulink>
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
@@ -633,42 +639,62 @@
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
This was a late-breaking question for the Guide, so I just have to
|
||||
quote the relevant newsgroup thread on it.
|
||||
</para>
|
||||
<literallayout>
|
||||
> AFAIK, most sites (even if they have SSI enabled) won't have #exec cmd
|
||||
> enabled. Perhaps what would be better is a #include virtual and a
|
||||
> footer.cgi the basically has the "require 'CGI.pl' and PutFooter command.
|
||||
>
|
||||
> Please note that under most configurations, this also requires naming
|
||||
> the file from index.html to index.shtml (and making sure that it will
|
||||
> still be reconized as an index). Personally, I think this is better on
|
||||
> a per-installation basis (perhaps add something to the FAQ that says how
|
||||
> to do this).
|
||||
<para>
|
||||
It's possible to get the footer on the static index page using
|
||||
Server Side Includes (SSI). The trick to doing this is making
|
||||
sure that your web server is set up to allow SSI and specifically,
|
||||
the #exec directive. You should also rename <filename>index.html</filename>
|
||||
to <filename>index.shtml</filename>.
|
||||
</para>
|
||||
<para>
|
||||
After you've done all that, you can add the following line to
|
||||
<filename>index.shtml</filename>:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<!--#exec cmd="/usr/bin/perl -e "require 'CGI.pl'; PutFooter();"" -->
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
<para><note>
|
||||
<para>
|
||||
This line will be replaced with the actual HTML for the footer
|
||||
when the page is requested, so you should put this line where you
|
||||
want the footer to appear.
|
||||
</para>
|
||||
</note></para>
|
||||
<para>
|
||||
Because this method depends on being able to use a #exec directive,
|
||||
and most ISP's will not allow that, there is an alternative method.
|
||||
You could have a small script (such as <filename>api.cgi</filename>)
|
||||
that basically looks like:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
#!/usr/bonsaitools/bin/perl -w
|
||||
|
||||
Good point. Yeah, easy enough to do, that it shouldn't be a big deal for
|
||||
someone to take it on if they want it. FAQ is a good place for it.
|
||||
require 'globals.pl';
|
||||
|
||||
> Dave Miller wrote:
|
||||
>
|
||||
>> I did a little experimenting with getting the command menu and footer on
|
||||
>> the end of the index page while leaving it as an HTML file...
|
||||
>>
|
||||
>> I was successful. :)
|
||||
>>
|
||||
>> I added this line:
|
||||
>>
|
||||
>> <!--#exec cmd="/usr/bin/perl -e "require 'CGI.pl';
|
||||
>>PutFooter();"" -->
|
||||
>>
|
||||
>> Just before the </BODY> </HTML> at the end of the file. And it worked.
|
||||
>>
|
||||
>> Thought I'd toss that out there. Should I check this in? For those that
|
||||
>> have SSI disabled, it'll act like a comment, so I wouldn't think it would
|
||||
>> break anything.
|
||||
</literallayout>
|
||||
if ($::FORM{sub} eq 'PutFooter') {
|
||||
PutFooter();
|
||||
} else {
|
||||
die 'api.cgi was incorrectly called';
|
||||
}
|
||||
]]>
|
||||
</programlisting>
|
||||
and then put this line in <filename>index.shtml</filename>.
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<!--#include virtual="api.cgi?sub=PutFooter"-->
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
<para> <note>
|
||||
<para>
|
||||
This still requires being able to use Server Side Includes, if
|
||||
this simply will not work for you, see <ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=80183">bug 80183</ulink>
|
||||
for a third option.
|
||||
</para>
|
||||
</note></para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
<qandaentry>
|
||||
@@ -804,21 +830,6 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
Does Bugzilla allow fields to be added, changed or deleted? If I want to
|
||||
customize the bug submission form to meet our needs, can I do that using our
|
||||
terminology?
|
||||
</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Yes.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>
|
||||
@@ -1221,20 +1232,11 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
<para>
|
||||
If you are using an alternate Mail Transport Agent (MTA other than
|
||||
sendmail), make sure the options given in the "processmail" script for all
|
||||
instances of "sendmail" are correct for your MTA. If you are using Sendmail,
|
||||
you may wish to delete the "-ODeliveryMode=deferred" option in the
|
||||
"processmail" script for every invocation of "sendmail". (Be sure and leave
|
||||
the "-t" option, though!)
|
||||
instances of "sendmail" are correct for your MTA.
|
||||
</para>
|
||||
<para>
|
||||
A better alternative is to change the "-O" option to
|
||||
"-ODeliveryMode=background". This prevents Sendmail from hanging your
|
||||
Bugzilla Perl processes if the domain to which it must send mail
|
||||
is unavailable.
|
||||
</para>
|
||||
<para>
|
||||
This is now a configurable parameter called "sendmailnow", available
|
||||
from editparams.cgi.
|
||||
If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi.
|
||||
If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
@@ -1315,12 +1317,21 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Run the "sanity check" utility (./sanitycheck.cgi in the bugzilla_home
|
||||
directory) to see! If it all comes back, you're 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 it can't auto-recover, I hope you're
|
||||
familiar with mysqladmin commands or have installed another way to manage
|
||||
your database...
|
||||
Run the <quote>sanity check</quote> utility
|
||||
(<filename>./sanitycheck.cgi</filename> in the
|
||||
Bugzilla_home directory) from your web browser to see! If
|
||||
it finishes without errors, you're
|
||||
<emphasis>probably</emphasis> 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
|
||||
it can't auto-recover, I hope you're familiar with
|
||||
mysqladmin commands or have installed another way to
|
||||
manage your database. Sanity Check, although it is a good
|
||||
basic check on your database integrity, by no means is a
|
||||
substitute for competent database administration and
|
||||
avoiding deletion of data. It is not exhaustive, and was
|
||||
created to do a basic check for the most common problems
|
||||
in Bugzilla databases.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
@@ -1428,10 +1439,12 @@ someone to take it on if they want it. FAQ is a good place for it.
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Delete everything from $BUZILLA_HOME/shadow. Bugzilla creates shadow
|
||||
files there, with each filename corresponding to a
|
||||
bug number. Also be sure to run syncshadowdb to make sure, if you are using
|
||||
a shadow database, that the shadow database is current.
|
||||
This should only happen with Bugzilla &bz-ver; if you are
|
||||
using the <quote>shadow database</quote> feature, and your
|
||||
shadow database is out of sync. Try running
|
||||
<filename>syncshadowdb</filename>
|
||||
<option>-syncall</option> to make sure your shadow
|
||||
database is in synch with your primary database.
|
||||
</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
@@ -1752,14 +1765,14 @@ A: Sure! Here ya go!
|
||||
</question>
|
||||
<answer>
|
||||
<para>
|
||||
Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Webtools&component=Bugzilla">
|
||||
Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Bugzilla">
|
||||
this link</ulink> to view current bugs or requests for
|
||||
enhancement for Bugzilla.
|
||||
</para>
|
||||
<para>
|
||||
You can view bugs marked for 2.14 release
|
||||
<ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Webtools&component=Bugzilla&target_milestone=Bugzilla+2.14">here</ulink>.
|
||||
This list includes bugs for the 2.14 release that have already
|
||||
You can view bugs marked for 2.16 release
|
||||
<ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Bugzilla&target_milestone=Bugzilla+2.16">here</ulink>.
|
||||
This list includes bugs for the 2.16 release that have already
|
||||
been fixed and checked into CVS. Please consult the
|
||||
<ulink url="http://www.mozilla.org/projects/bugzilla/">
|
||||
Bugzilla Project Page</ulink> for details on how to
|
||||
@@ -1800,8 +1813,9 @@ A: Sure! Here ya go!
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Enter a bug into bugzilla.mozilla.org for the "Webtools" product,
|
||||
"Bugzilla" component.
|
||||
Enter a bug into bugzilla.mozilla.org for the <quote><ulink
|
||||
url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">Bugzilla</ulink></quote>
|
||||
product.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
|
||||
@@ -616,6 +616,15 @@ bash# mkdir /usr/bonsaitools/bin
|
||||
bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
|
||||
</programlisting>
|
||||
</para>
|
||||
<para>
|
||||
Alternately, you can simply run this perl one-liner to
|
||||
change your path to perl in all the files in your Bugzilla
|
||||
installation:
|
||||
<programlisting>
|
||||
perl -pi -e 's@#!/usr/bonsaitools/bin/perl@/usr/bin/perl@' *cgi *pl Bug.pm
|
||||
</programlisting>
|
||||
Change the second path to perl to match your installation.
|
||||
</para>
|
||||
</example>
|
||||
<tip>
|
||||
<para>
|
||||
@@ -1241,7 +1250,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \
|
||||
</section>
|
||||
|
||||
|
||||
<section>
|
||||
<section id="unixhistory">
|
||||
<title>UNIX Installation Instructions History</title>
|
||||
<para>
|
||||
This document was originally adapted from the Bonsai
|
||||
@@ -1252,9 +1261,8 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \
|
||||
The February 25, 1999 re-write of this page was done by Ry4an
|
||||
Brase <ry4an@ry4an.org>, with some edits by Terry
|
||||
Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But
|
||||
don't send bug reports to them; report them using bugzilla, at
|
||||
http://bugzilla.mozilla.org/enter_bug.cgi , project Webtools,
|
||||
component Bugzilla).
|
||||
don't send bug reports to them; report them using bugzilla, at <ulink
|
||||
url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla</ulink> ).
|
||||
</para>
|
||||
<para>
|
||||
This document was heavily modified again Wednesday, March 07
|
||||
@@ -1696,16 +1704,46 @@ exit;
|
||||
|
||||
<step>
|
||||
<para>
|
||||
Modify the invocation of all system() calls in all perl scripts in your Bugzilla directory. For instance, change this line in processmail:
|
||||
<programlisting>
|
||||
system ("./processmail.pl",@ARGLIST);
|
||||
</programlisting>
|
||||
to
|
||||
<programlisting>
|
||||
Modify the invocation of all system() calls in all perl
|
||||
scripts in your Bugzilla directory. For instance, change
|
||||
this line in processmail:
|
||||
<programlisting>
|
||||
system ("./processmail.pl",@ARGLIST);
|
||||
</programlisting> to
|
||||
<programlisting>
|
||||
system ("perl processmail.pl",@ARGLIST);
|
||||
</programlisting>
|
||||
</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>
|
||||
Add <function>binmode()</function> calls so attachments
|
||||
will work (<ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=62000">bug 62000</ulink>).
|
||||
</para>
|
||||
<para>
|
||||
Because Microsoft Windows based systems handle binary
|
||||
files different than Unix based systems, you need to add
|
||||
the following lines to
|
||||
<filename>createattachment.cgi</filename> and
|
||||
<filename>showattachment.cgi</filename> before the
|
||||
<function>require 'CGI.pl';</function> line.
|
||||
</para>
|
||||
<para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
binmode(STDIN);
|
||||
binmode(STDOUT);
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
According to <ulink
|
||||
url="http://bugzilla.mozilla.org/show_bug.cgi?id=62000">bug 62000</ulink>, the perl documentation says that you should always use <function>binmode()</function> when dealing with binary files, but never when dealing with text files. That seems to suggest that rather than aribtrarily putting <function>binmode()</function> at the begining of the attachment files, there should be logic to determine if <function>binmode()</function> is needed or not.
|
||||
</para>
|
||||
</note>
|
||||
</step>
|
||||
</procedure>
|
||||
|
||||
<tip>
|
||||
@@ -1714,6 +1752,8 @@ system ("perl processmail.pl",@ARGLIST);
|
||||
relationships to Properties -> Home directory (tab) ->
|
||||
Application Settings (section) -> Configuration (button),
|
||||
such as:
|
||||
</para>
|
||||
<para>
|
||||
<programlisting>
|
||||
.cgi to: <perl install directory>\perl.exe %s %s
|
||||
.pl to: <perl install directory>\perl.exe %s %s
|
||||
@@ -1742,7 +1782,9 @@ GET,HEAD,POST
|
||||
registry at the following location:
|
||||
</para>
|
||||
<para>
|
||||
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
|
||||
<programlisting>
|
||||
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
|
||||
</programlisting>
|
||||
</para>
|
||||
<para>
|
||||
The keys should be called ".pl" and ".cgi", and both
|
||||
@@ -1761,26 +1803,102 @@ GET,HEAD,POST
|
||||
If attempting to run Bugzilla 2.12 or older, you will need
|
||||
to remove encrypt() calls from the Perl source. This is
|
||||
<emphasis>not necessary</emphasis> for Bugzilla 2.13 and
|
||||
later.
|
||||
later, which includes the current release, Bugzilla
|
||||
&bz-ver;.
|
||||
<example>
|
||||
<title>Removing encrypt() for Windows NT Bugzilla version
|
||||
2.12 or earlier</title>
|
||||
<para>
|
||||
Replace this:
|
||||
<programlisting>
|
||||
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($realcryptpwd, 0, 2)) . ")");
|
||||
my $enteredcryptpwd = FetchOneColumn();
|
||||
</programlisting>
|
||||
with this:
|
||||
<programlisting>
|
||||
my $enteredcryptpwd = $enteredpwd
|
||||
</programlisting>
|
||||
Replace this:
|
||||
<programlisting>
|
||||
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($realcryptpwd, 0, 2)) . ")");
|
||||
my $enteredcryptpwd = FetchOneColumn();
|
||||
</programlisting>
|
||||
with this:
|
||||
<programlisting>
|
||||
my $enteredcryptpwd = $enteredpwd
|
||||
</programlisting>
|
||||
in cgi.pl.
|
||||
</para>
|
||||
</example>
|
||||
</para>
|
||||
</tip>
|
||||
</section>
|
||||
|
||||
<section id="bzldap">
|
||||
<title>Bugzilla LDAP Integration</title>
|
||||
<para>
|
||||
What follows is some late-breaking information on using the
|
||||
LDAP authentication options with Bugzilla. The author has not
|
||||
tested these (nor even formatted this section!) so please
|
||||
contribute feedback to the newsgroup.
|
||||
</para>
|
||||
<literallayout>
|
||||
Mozilla::LDAP module
|
||||
|
||||
The Mozilla::LDAP module allows you to use LDAP for authentication to
|
||||
the Bugzilla system. This module is not required if you are not using
|
||||
LDAP.
|
||||
|
||||
Mozilla::LDAP (aka PerLDAP) is available for download from
|
||||
http://www.mozilla.org/directory.
|
||||
|
||||
NOTE: The Mozilla::LDAP module requires Netscape's Directory SDK.
|
||||
Follow the link for "Directory SDK for C" on that same page to
|
||||
download the SDK first. After you have installed this SDK, then
|
||||
install the PerLDAP module.
|
||||
----------------------------------------------------------------------
|
||||
|
||||
Post-Installation Checklist
|
||||
----------------------------------------------------------------------
|
||||
Set useLDAP to "On" **only** if you will be using an LDAP directory
|
||||
for authentication. Be very careful when setting up this parameter;
|
||||
if you set LDAP authentication, but do not have a valid LDAP directory
|
||||
set up, you will not be able to log back in to Bugzilla once you log
|
||||
out. (If this happens, you can get back in by manually editing the
|
||||
data/params file, and setting useLDAP back to 0.)
|
||||
|
||||
If using LDAP, you must set the three additional parameters:
|
||||
|
||||
Set LDAPserver to the name (and optionally port) of your LDAP server.
|
||||
If no port is specified, it defaults to the default port of 389. (e.g
|
||||
"ldap.mycompany.com" or "ldap.mycompany.com:1234")
|
||||
|
||||
Set LDAPBaseDN to the base DN for searching for users in your LDAP
|
||||
directory. (e.g. "ou=People,o=MyCompany") uids must be unique under
|
||||
the DN specified here.
|
||||
|
||||
Set LDAPmailattribute to the name of the attribute in your LDAP
|
||||
directory which contains the primary email address. On most directory
|
||||
servers available, this is "mail", but you may need to change this.
|
||||
----------------------------------------------------------------------
|
||||
|
||||
(Not sure where this bit should go, but it's important that it be in
|
||||
there somewhere...)
|
||||
----------------------------------------------------------------------
|
||||
Using LDAP authentication for Bugzilla:
|
||||
|
||||
The existing authentication scheme for Bugzilla uses email addresses
|
||||
as the primary user ID, and a password to authenticate that user. All
|
||||
places within Bugzilla where you need to deal with user ID (e.g
|
||||
assigning a bug) use the email address.
|
||||
|
||||
The LDAP authentication builds on top of this scheme, rather than
|
||||
replacing it. The initial log in is done with a username and password
|
||||
for the LDAP directory. This then fetches the email address from LDAP
|
||||
and authenticates seamlessly in the standard Bugzilla authentication
|
||||
scheme using this email address. If an account for this address
|
||||
already exists in your Bugzilla system, it will log in to that
|
||||
account. If no account for that email address exists, one is created
|
||||
at the time of login. (In this case, Bugzilla will attempt to use the
|
||||
"displayName" or "cn" attribute to determine the user's full name.)
|
||||
|
||||
After authentication, all other user-related tasks are still handled
|
||||
by email address, not LDAP username. You still assign bugs by email
|
||||
address, query on users by email address, etc.
|
||||
----------------------------------------------------------------------
|
||||
</literallayout>
|
||||
</section>
|
||||
</section>
|
||||
</chapter>
|
||||
|
||||
|
||||
@@ -35,6 +35,14 @@
|
||||
an @resolution field, you can even change the Bugzilla bug
|
||||
state.
|
||||
</para>
|
||||
<para>
|
||||
There is also a project, based upon somewhat dated Bugzilla
|
||||
code, to integrate CVS and Bugzilla through CVS' ability to
|
||||
email. Check it out at:
|
||||
<ulink url="http://homepages.kcbbs.gen.nz/~tonyg/">
|
||||
http://homepages.kcbbs.gen.nz/~tonyg/</ulink>, under the
|
||||
<quote>cvszilla</quote> link.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="scm" xreflabel="Perforce SCM (Fast Software Configuration Management System, a powerful commercial alternative to CVS">
|
||||
|
||||
@@ -247,6 +247,104 @@ RewriteRule ^/([0-9]+)$ http://foo.bar.com/show_bug.cgi?id=$1 [L,R]
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="bzhacking">
|
||||
<title>Hacking Bugzilla</title>
|
||||
<para>
|
||||
What follows are some general guidelines for changing Bugzilla, and adhering to good coding practice while doing so. We've had some checkins in the past which ruined Bugzilla installations because of disregard for these conventions. Sorry for the lack of formatting; I got this info into the Guide on the day of 2.14 release and haven't formatted it yet.
|
||||
</para>
|
||||
<literallayout>
|
||||
|
||||
The following is a guide for reviewers when checking code into Bugzilla's
|
||||
CVS repostory at mozilla.org. If you wish to submit patches to Bugzilla,
|
||||
you should follow the rules and style conventions below. Any code that
|
||||
does not adhere to these basic rules will not be added to Bugzilla's
|
||||
codebase.
|
||||
|
||||
1. Usage of variables in Regular Expressions
|
||||
|
||||
It is very important that you don't use a variable in a regular
|
||||
expression unless that variable is supposed to contain an expression.
|
||||
This especially applies when using grep. You should use:
|
||||
|
||||
grep ($_ eq $value, @array);
|
||||
|
||||
- NOT -
|
||||
|
||||
grep (/$value/, @array);
|
||||
|
||||
If you need to use a non-expression variable inside of an expression, be
|
||||
sure to quote it properly (using \Q..\E).
|
||||
|
||||
Coding Style for Bugzilla
|
||||
-------------------------
|
||||
|
||||
While it's true that not all of the code currently in Bugzilla adheres to
|
||||
this styleguide, it is something that is being worked toward. Therefore,
|
||||
we ask that all new code (submitted patches and new files) follow this guide
|
||||
as closely as possible (if you're only changing 1 or 2 lines, you don't have
|
||||
to reformat the entire file :).
|
||||
|
||||
1. Whitespace
|
||||
|
||||
Bugzilla's prefered indentation is 4 spaces (no tabs, please).
|
||||
|
||||
2. Curly braces.
|
||||
|
||||
The opening brace of a block should be on the same line as the statement
|
||||
that is causing the block and the closing brace should be at the same
|
||||
indentation level as that statement, for example:
|
||||
|
||||
if ($var) {
|
||||
print "The variable is true";
|
||||
} else {
|
||||
print "Try again";
|
||||
}
|
||||
|
||||
- NOT -
|
||||
|
||||
if ($var)
|
||||
{
|
||||
print "The variable is true";
|
||||
}
|
||||
else
|
||||
{
|
||||
print "Try again";
|
||||
}
|
||||
|
||||
3. File Names
|
||||
|
||||
File names for bugzilla code and support documention should be legal across
|
||||
multiple platforms. \ / : * ? " < > and | are all illegal characters for
|
||||
filenames on various platforms. Also, file names should not have spaces in
|
||||
them as they can cause confusion in CVS and other mozilla.org utilities.
|
||||
|
||||
4. Variable Names
|
||||
|
||||
If a variable is scoped globally ($::variable) its name should be descriptive
|
||||
of what it contains. Local variables can be named a bit looser, provided the
|
||||
context makes their content obvious. For example, $ret could be used as a
|
||||
staging variable for a routine's return value as the line |return $ret;| will
|
||||
make it blatently obvious what the variable holds and most likely be shown
|
||||
on the same screen as |my $ret = "";|.
|
||||
|
||||
5. Cross Database Compatability
|
||||
|
||||
Bugzilla was originally written to work with MySQL and therefore took advantage
|
||||
of some of its features that aren't contained in other RDBMS software. These
|
||||
should be avoided in all new code. Examples of these features are enums and
|
||||
encrypt().
|
||||
|
||||
6. Cross Platform Compatability
|
||||
|
||||
While Bugzilla was written to be used on Unix based systems (and Unix/Linux is
|
||||
still the only officially supported platform) there are many who desire/need to
|
||||
run Bugzilla on Microsoft Windows boxes. Whenever possible, we should strive
|
||||
not to make the lives of these people any more complicated and avoid doing things
|
||||
that break Bugzilla's ability to run on multiple operating systems.
|
||||
|
||||
</literallayout>
|
||||
</section>
|
||||
|
||||
</appendix>
|
||||
|
||||
|
||||
|
||||
@@ -399,13 +399,13 @@ system against which all others are measured.
|
||||
our Bugzilla database. Please notice the box is a
|
||||
<emphasis>scrollbox</emphasis>. Using the down arrow on
|
||||
the scrollbox, scroll down until you can see an entry
|
||||
called "Webtools". Select this entry.
|
||||
called "Bugzilla". Select this entry.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Did you notice that some of the boxes to the right changed
|
||||
when you selected "Webtools"? Every Program (or Product)
|
||||
when you selected "Bugzilla"? Every Program (or Product)
|
||||
has different Versions, Components, and Target Milestones
|
||||
associated with it. A "Version" is the number of a
|
||||
software program.
|
||||
@@ -452,36 +452,67 @@ system against which all others are measured.
|
||||
Normally, a Component has a single Owner, who is responsible
|
||||
for overseeing efforts to improve that Component.
|
||||
<example>
|
||||
<title>Mozilla Webtools Components</title>
|
||||
<title>Mozilla's Bugzilla Components</title>
|
||||
<informalexample>
|
||||
<para>
|
||||
Mozilla's "Webtools" Product is composed of several pieces (Components):
|
||||
Mozilla's "Bugzilla" Product is composed of several pieces (Components):
|
||||
<simplelist>
|
||||
<member><emphasis>Bonsai</emphasis>,
|
||||
a tool to show recent changes to Mozilla</member>
|
||||
<member><emphasis>Bugzilla</emphasis>,
|
||||
a defect-tracking tool</member>
|
||||
<member><emphasis>Build</emphasis>,
|
||||
a tool to automatically compile source code
|
||||
into machine-readable form</member>
|
||||
<member><emphasis>Despot</emphasis>,
|
||||
a program that controls access to the other Webtools</member>
|
||||
<member><emphasis>LXR</emphasis>,
|
||||
a utility that automatically marks up text files
|
||||
to make them more readable</member>
|
||||
<member><emphasis>MozBot</emphasis>,
|
||||
a "robot" that announces changes to Mozilla in Chat</member>
|
||||
<member><emphasis>TestManager</emphasis>,
|
||||
a tool to help find bugs in Mozilla</member>
|
||||
<member><emphasis>Tinderbox</emphasis>,
|
||||
which displays reports from Build</member>
|
||||
<member><emphasis>Administration</emphasis>,
|
||||
Administration of a bugzilla installation, including
|
||||
<filename>editcomponents.cgi</filename>,
|
||||
<filename>editgroups.cgi</filename>,
|
||||
<filename>editkeywords.cgi</filename>,
|
||||
<filename>editparams.cgi</filename>,
|
||||
<filename>editproducts.cgi</filename>,
|
||||
<filename>editusers.cgi</filename>,
|
||||
<filename>editversions.cgi,</filename> and
|
||||
<filename>sanitycheck.cgi</filename>.
|
||||
</member>
|
||||
<member><emphasis>Bugzilla-General</emphasis>,
|
||||
Anything that doesn't fit in the other components, or spans
|
||||
multiple components.
|
||||
</member>
|
||||
<member><emphasis>Creating/Changing Bugs</emphasis>,
|
||||
Creating, changing, and viewing bugs.
|
||||
<filename>enter_bug.cgi</filename>,
|
||||
<filename>post_bug.cgi</filename>,
|
||||
<filename>show_bug.cgi</filename> and
|
||||
<filename>process_bug.cgi</filename>.
|
||||
</member>
|
||||
<member><emphasis>Documentation</emphasis>,
|
||||
The bugzilla documentation, including anything in the
|
||||
<filename>docs/</filename> directory and The Bugzilla Guide
|
||||
(This document :)
|
||||
</member>
|
||||
<member><emphasis>Email</emphasis>,
|
||||
Anything to do with email sent by Bugzilla.
|
||||
<filename>processmail</filename>
|
||||
</member>
|
||||
<member><emphasis>Installation</emphasis>,
|
||||
The installation process of Bugzilla. This includes
|
||||
<filename>checksetup.pl</filename> and whatever else it evolves into.
|
||||
</member>
|
||||
<member><emphasis>Query/Buglist</emphasis>,
|
||||
Anything to do with searching for bugs and viewing the buglists.
|
||||
<filename>query.cgi</filename> and
|
||||
<filename>buglist.cgi</filename>
|
||||
</member>
|
||||
<member><emphasis>Reporting/Charting</emphasis>,
|
||||
Getting reports from Bugzilla.
|
||||
<filename>reports.cgi</filename> and
|
||||
<filename>duplicates.cgi</filename>
|
||||
</member>
|
||||
<member><emphasis>User Accounts</emphasis>,
|
||||
Anything about managing a user account from the user's perspective.
|
||||
<filename>userprefs.cgi</filename>, saved queries, creating accounts,
|
||||
changing passwords, logging in, etc.
|
||||
</member>
|
||||
<member><emphasis>User Interface</emphasis>,
|
||||
General issues having to do with the user interface cosmetics (not
|
||||
functionality) including cosmetic issues, HTML templates, etc.
|
||||
</member>
|
||||
</simplelist>
|
||||
</para>
|
||||
<para>
|
||||
A different person is responsible for each of these Components.
|
||||
Tara Hernandez keeps
|
||||
the "Bugzilla" component up-to-date.
|
||||
</para>
|
||||
</informalexample>
|
||||
</example>
|
||||
</para>
|
||||
|
||||
Reference in New Issue
Block a user