Skip to content

bugzilla
bugzilla
Commit 58593ba9 authored by barnboy%trilobyte.net's avatar barnboy%trilobyte.net
Browse files
Options

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
parent 073c4767
Hide whitespace changes
Inline Side-by-side
Showing with 4589 additions and 1007 deletions
docs/html/Bugzilla-Guide.html
View file @ 58593ba9
This source diff could not be displayed because it is too large. You can view the blob instead.
docs/html/aboutthisguide.html
View file @ 58593ba9
...@@ -131,8 +131,8 @@ TARGET="_top" ...@@ -131,8 +131,8 @@ TARGET="_top"
<TT <TT
CLASS="EMAIL" CLASS="EMAIL"
>&#60;<A >&#60;<A
HREF="mailto:barnboy@NOSPAM.trilobyte.net" HREF="mailto:barnboy@trilobyte.net"
>barnboy@NOSPAM.trilobyte.net</A >barnboy@trilobyte.net</A
>&#62;</TT >&#62;</TT
> to correct them. > to correct them.
</P </P
......
docs/html/bzhacking.html 0 → 100644
View file @ 58593ba9
<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&nbsp;following&nbsp;is&nbsp;a&nbsp;guide&nbsp;for&nbsp;reviewers&nbsp;when&nbsp;checking&nbsp;code&nbsp;into&nbsp;Bugzilla's<br>
CVS&nbsp;repostory&nbsp;at&nbsp;mozilla.org.&nbsp;&nbsp;If&nbsp;you&nbsp;wish&nbsp;to&nbsp;submit&nbsp;patches&nbsp;to&nbsp;Bugzilla,<br>
you&nbsp;should&nbsp;follow&nbsp;the&nbsp;rules&nbsp;and&nbsp;style&nbsp;conventions&nbsp;below.&nbsp;&nbsp;Any&nbsp;code&nbsp;that<br>
does&nbsp;not&nbsp;adhere&nbsp;to&nbsp;these&nbsp;basic&nbsp;rules&nbsp;will&nbsp;not&nbsp;be&nbsp;added&nbsp;to&nbsp;Bugzilla's<br>
codebase.<br>
<br>
&nbsp;1.&nbsp;Usage&nbsp;of&nbsp;variables&nbsp;in&nbsp;Regular&nbsp;Expressions<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;It&nbsp;is&nbsp;very&nbsp;important&nbsp;that&nbsp;you&nbsp;don't&nbsp;use&nbsp;a&nbsp;variable&nbsp;in&nbsp;a&nbsp;regular<br>
&nbsp;&nbsp;&nbsp;&nbsp;expression&nbsp;unless&nbsp;that&nbsp;variable&nbsp;is&nbsp;supposed&nbsp;to&nbsp;contain&nbsp;an&nbsp;expression.<br>
&nbsp;&nbsp;&nbsp;&nbsp;This&nbsp;especially&nbsp;applies&nbsp;when&nbsp;using&nbsp;grep.&nbsp;&nbsp;You&nbsp;should&nbsp;use:<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;grep&nbsp;($_&nbsp;eq&nbsp;$value,&nbsp;@array);<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;-&nbsp;NOT&nbsp;-<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;grep&nbsp;(/$value/,&nbsp;@array);<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;If&nbsp;you&nbsp;need&nbsp;to&nbsp;use&nbsp;a&nbsp;non-expression&nbsp;variable&nbsp;inside&nbsp;of&nbsp;an&nbsp;expression,&nbsp;be<br>
&nbsp;&nbsp;&nbsp;&nbsp;sure&nbsp;to&nbsp;quote&nbsp;it&nbsp;properly&nbsp;(using&nbsp;\Q..\E).<br>
<br>
Coding&nbsp;Style&nbsp;for&nbsp;Bugzilla<br>
-------------------------<br>
<br>
While&nbsp;it's&nbsp;true&nbsp;that&nbsp;not&nbsp;all&nbsp;of&nbsp;the&nbsp;code&nbsp;currently&nbsp;in&nbsp;Bugzilla&nbsp;adheres&nbsp;to<br>
this&nbsp;styleguide,&nbsp;it&nbsp;is&nbsp;something&nbsp;that&nbsp;is&nbsp;being&nbsp;worked&nbsp;toward.&nbsp;&nbsp;Therefore,<br>
we&nbsp;ask&nbsp;that&nbsp;all&nbsp;new&nbsp;code&nbsp;(submitted&nbsp;patches&nbsp;and&nbsp;new&nbsp;files)&nbsp;follow&nbsp;this&nbsp;guide<br>
as&nbsp;closely&nbsp;as&nbsp;possible&nbsp;(if&nbsp;you're&nbsp;only&nbsp;changing&nbsp;1&nbsp;or&nbsp;2&nbsp;lines,&nbsp;you&nbsp;don't&nbsp;have<br>
to&nbsp;reformat&nbsp;the&nbsp;entire&nbsp;file&nbsp;:).<br>
<br>
&nbsp;1.&nbsp;Whitespace<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Bugzilla's&nbsp;prefered&nbsp;indentation&nbsp;is&nbsp;4&nbsp;spaces&nbsp;(no&nbsp;tabs,&nbsp;please).<br>
<br>
&nbsp;2.&nbsp;Curly&nbsp;braces.<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;opening&nbsp;brace&nbsp;of&nbsp;a&nbsp;block&nbsp;should&nbsp;be&nbsp;on&nbsp;the&nbsp;same&nbsp;line&nbsp;as&nbsp;the&nbsp;statement<br>
&nbsp;&nbsp;&nbsp;&nbsp;that&nbsp;is&nbsp;causing&nbsp;the&nbsp;block&nbsp;and&nbsp;the&nbsp;closing&nbsp;brace&nbsp;should&nbsp;be&nbsp;at&nbsp;the&nbsp;same<br>
&nbsp;&nbsp;&nbsp;&nbsp;indentation&nbsp;level&nbsp;as&nbsp;that&nbsp;statement,&nbsp;for&nbsp;example:<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;($var)&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"The&nbsp;variable&nbsp;is&nbsp;true";<br>
&nbsp;&nbsp;&nbsp;&nbsp;}&nbsp;else&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Try&nbsp;again";<br>
&nbsp;&nbsp;&nbsp;&nbsp;}<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;-&nbsp;NOT&nbsp;-<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;($var)<br>
&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"The&nbsp;variable&nbsp;is&nbsp;true";<br>
&nbsp;&nbsp;&nbsp;&nbsp;}<br>
&nbsp;&nbsp;&nbsp;&nbsp;else<br>
&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Try&nbsp;again";<br>
&nbsp;&nbsp;&nbsp;&nbsp;}<br>
<br>
&nbsp;3.&nbsp;File&nbsp;Names<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;File&nbsp;names&nbsp;for&nbsp;bugzilla&nbsp;code&nbsp;and&nbsp;support&nbsp;documention&nbsp;should&nbsp;be&nbsp;legal&nbsp;across<br>
&nbsp;&nbsp;&nbsp;&nbsp;multiple&nbsp;platforms.&nbsp;&nbsp;\&nbsp;/&nbsp;:&nbsp;*&nbsp;?&nbsp;"&nbsp;&#60;&nbsp;&#62;&nbsp;and&nbsp;|&nbsp;are&nbsp;all&nbsp;illegal&nbsp;characters&nbsp;for<br>
&nbsp;&nbsp;&nbsp;&nbsp;filenames&nbsp;on&nbsp;various&nbsp;platforms.&nbsp;&nbsp;Also,&nbsp;file&nbsp;names&nbsp;should&nbsp;not&nbsp;have&nbsp;spaces&nbsp;in<br>
&nbsp;&nbsp;&nbsp;&nbsp;them&nbsp;as&nbsp;they&nbsp;can&nbsp;cause&nbsp;confusion&nbsp;in&nbsp;CVS&nbsp;and&nbsp;other&nbsp;mozilla.org&nbsp;utilities.<br>
<br>
&nbsp;4.&nbsp;Variable&nbsp;Names<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;If&nbsp;a&nbsp;variable&nbsp;is&nbsp;scoped&nbsp;globally&nbsp;($::variable)&nbsp;its&nbsp;name&nbsp;should&nbsp;be&nbsp;descriptive<br>
&nbsp;&nbsp;&nbsp;&nbsp;of&nbsp;what&nbsp;it&nbsp;contains.&nbsp;&nbsp;Local&nbsp;variables&nbsp;can&nbsp;be&nbsp;named&nbsp;a&nbsp;bit&nbsp;looser,&nbsp;provided&nbsp;the<br>
&nbsp;&nbsp;&nbsp;&nbsp;context&nbsp;makes&nbsp;their&nbsp;content&nbsp;obvious.&nbsp;&nbsp;For&nbsp;example,&nbsp;$ret&nbsp;could&nbsp;be&nbsp;used&nbsp;as&nbsp;a<br>
&nbsp;&nbsp;&nbsp;&nbsp;staging&nbsp;variable&nbsp;for&nbsp;a&nbsp;routine's&nbsp;return&nbsp;value&nbsp;as&nbsp;the&nbsp;line&nbsp;|return&nbsp;$ret;|&nbsp;will<br>
&nbsp;&nbsp;&nbsp;&nbsp;make&nbsp;it&nbsp;blatently&nbsp;obvious&nbsp;what&nbsp;the&nbsp;variable&nbsp;holds&nbsp;and&nbsp;most&nbsp;likely&nbsp;be&nbsp;shown<br>
&nbsp;&nbsp;&nbsp;&nbsp;on&nbsp;the&nbsp;same&nbsp;screen&nbsp;as&nbsp;|my&nbsp;$ret&nbsp;=&nbsp;"";|.<br>
<br>
&nbsp;5.&nbsp;Cross&nbsp;Database&nbsp;Compatability<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Bugzilla&nbsp;was&nbsp;originally&nbsp;written&nbsp;to&nbsp;work&nbsp;with&nbsp;MySQL&nbsp;and&nbsp;therefore&nbsp;took&nbsp;advantage<br>
&nbsp;&nbsp;&nbsp;&nbsp;of&nbsp;some&nbsp;of&nbsp;its&nbsp;features&nbsp;that&nbsp;aren't&nbsp;contained&nbsp;in&nbsp;other&nbsp;RDBMS&nbsp;software.&nbsp;&nbsp;These<br>
&nbsp;&nbsp;&nbsp;&nbsp;should&nbsp;be&nbsp;avoided&nbsp;in&nbsp;all&nbsp;new&nbsp;code.&nbsp;&nbsp;Examples&nbsp;of&nbsp;these&nbsp;features&nbsp;are&nbsp;enums&nbsp;and<br>
&nbsp;&nbsp;&nbsp;&nbsp;encrypt().<br>
<br>
&nbsp;6.&nbsp;Cross&nbsp;Platform&nbsp;Compatability<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;While&nbsp;Bugzilla&nbsp;was&nbsp;written&nbsp;to&nbsp;be&nbsp;used&nbsp;on&nbsp;Unix&nbsp;based&nbsp;systems&nbsp;(and&nbsp;Unix/Linux&nbsp;is<br>
&nbsp;&nbsp;&nbsp;&nbsp;still&nbsp;the&nbsp;only&nbsp;officially&nbsp;supported&nbsp;platform)&nbsp;there&nbsp;are&nbsp;many&nbsp;who&nbsp;desire/need&nbsp;to<br>
&nbsp;&nbsp;&nbsp;&nbsp;run&nbsp;Bugzilla&nbsp;on&nbsp;Microsoft&nbsp;Windows&nbsp;boxes.&nbsp;&nbsp;Whenever&nbsp;possible,&nbsp;we&nbsp;should&nbsp;strive<br>
&nbsp;&nbsp;&nbsp;&nbsp;not&nbsp;to&nbsp;make&nbsp;the&nbsp;lives&nbsp;of&nbsp;these&nbsp;people&nbsp;any&nbsp;more&nbsp;complicated&nbsp;and&nbsp;avoid&nbsp;doing&nbsp;things<br>
&nbsp;&nbsp;&nbsp;&nbsp;that&nbsp;break&nbsp;Bugzilla's&nbsp;ability&nbsp;to&nbsp;run&nbsp;on&nbsp;multiple&nbsp;operating&nbsp;systems.<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;</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
>
\ No newline at end of file
docs/html/contributors.html
View file @ 58593ba9
...@@ -78,7 +78,8 @@ NAME="CONTRIBUTORS" ...@@ -78,7 +78,8 @@ NAME="CONTRIBUTORS"
documentation (in no particular order): documentation (in no particular order):
</P </P
><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 </P
></DIV ></DIV
><DIV ><DIV
......
docs/html/copyright.html
View file @ 58593ba9
...@@ -122,8 +122,7 @@ WIDTH="10%" ...@@ -122,8 +122,7 @@ WIDTH="10%"
><P ><P
> If you have any questions regarding this document, its > If you have any questions regarding this document, its
copyright, or publishing this document in non-electronic form, copyright, or publishing this document in non-electronic form,
please contact Matthew P. Barnson. Remove "NOSPAM" from email address please contact Matthew P. Barnson.
to send.
</P </P
></DIV ></DIV
><DIV ><DIV
......
docs/html/credits.html
View file @ 58593ba9
...@@ -85,8 +85,8 @@ HREF="mailto://terry@mozilla.org" ...@@ -85,8 +85,8 @@ HREF="mailto://terry@mozilla.org"
TARGET="_top" TARGET="_top"
>Terry Weissman</A >Terry Weissman</A
> >
for initially converting Bugzilla from BugSplat! and writing the for initially writing Bugzilla and creating the
README upon which this documentation is largely based. README upon which the UNIX installation documentation is largely based.
</P </P
><P ><P
> <A > <A
......
docs/html/cvs.html
View file @ 58593ba9
...@@ -91,6 +91,20 @@ CLASS="QUOTE" ...@@ -91,6 +91,20 @@ CLASS="QUOTE"
an @resolution field, you can even change the Bugzilla bug an @resolution field, you can even change the Bugzilla bug
state. state.
</P </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
><DIV ><DIV
CLASS="NAVFOOTER" CLASS="NAVFOOTER"
......
docs/html/dbdoc.html
View file @ 58593ba9
...@@ -137,7 +137,7 @@ CLASS="SECTION" ...@@ -137,7 +137,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN2217" NAME="AEN2331"
>C.2.1. Bugzilla Database Basics</A >C.2.1. Bugzilla Database Basics</A
></H2 ></H2
><P ><P
...@@ -260,7 +260,7 @@ CLASS="SECTION" ...@@ -260,7 +260,7 @@ CLASS="SECTION"
><H3 ><H3
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN2246" NAME="AEN2360"
>C.2.1.1. Bugzilla Database Tables</A >C.2.1.1. Bugzilla Database Tables</A
></H3 ></H3
><P ><P
......
docs/html/dbschema.html
View file @ 58593ba9
...@@ -78,7 +78,7 @@ NAME="DBSCHEMA" ...@@ -78,7 +78,7 @@ NAME="DBSCHEMA"
CLASS="MEDIAOBJECT" CLASS="MEDIAOBJECT"
><P ><P
><IMG ><IMG
SRC="dbschema.jpg" SRC="../images/dbschema.jpg"
ALT="Database Relationships" ALT="Database Relationships"
></IMG ></IMG
><DIV ><DIV
......
docs/html/faq.html
View file @ 58593ba9
...@@ -10,8 +10,8 @@ REL="HOME" ...@@ -10,8 +10,8 @@ REL="HOME"
TITLE="The Bugzilla Guide" TITLE="The Bugzilla Guide"
HREF="index.html"><LINK HREF="index.html"><LINK
REL="PREVIOUS" REL="PREVIOUS"
TITLE="The Future of Bugzilla" TITLE="SourceForge"
HREF="future.html"><LINK HREF="variant_sourceforge.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Software Download Links" TITLE="Software Download Links"
HREF="downloadlinks.html"></HEAD HREF="downloadlinks.html"></HEAD
...@@ -41,7 +41,7 @@ WIDTH="10%" ...@@ -41,7 +41,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="future.html" HREF="variant_sourceforge.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -81,63 +81,63 @@ HREF="faq.html#FAQ_GENERAL" ...@@ -81,63 +81,63 @@ HREF="faq.html#FAQ_GENERAL"
><DL ><DL
><DT ><DT
>A.1.1. <A >A.1.1. <A
HREF="faq.html#AEN1620" HREF="faq.html#AEN1713"
> Where can I find information about Bugzilla?</A > Where can I find information about Bugzilla?</A
></DT ></DT
><DT ><DT
>A.1.2. <A >A.1.2. <A
HREF="faq.html#AEN1626" HREF="faq.html#AEN1719"
> What license is Bugzilla distributed under? > What license is Bugzilla distributed under?
</A </A
></DT ></DT
><DT ><DT
>A.1.3. <A >A.1.3. <A
HREF="faq.html#AEN1632" HREF="faq.html#AEN1725"
> How do I get commercial support for Bugzilla? > How do I get commercial support for Bugzilla?
</A </A
></DT ></DT
><DT ><DT
>A.1.4. <A >A.1.4. <A
HREF="faq.html#AEN1639" HREF="faq.html#AEN1732"
> What major companies or projects are currently using Bugzilla > What major companies or projects are currently using Bugzilla
for bug-tracking? for bug-tracking?
</A </A
></DT ></DT
><DT ><DT
>A.1.5. <A >A.1.5. <A
HREF="faq.html#AEN1664" HREF="faq.html#AEN1757"
> Who maintains Bugzilla? > Who maintains Bugzilla?
</A </A
></DT ></DT
><DT ><DT
>A.1.6. <A >A.1.6. <A
HREF="faq.html#AEN1670" HREF="faq.html#AEN1763"
> How does Bugzilla stack up against other bug-tracking databases? > How does Bugzilla stack up against other bug-tracking databases?
</A </A
></DT ></DT
><DT ><DT
>A.1.7. <A >A.1.7. <A
HREF="faq.html#AEN1677" HREF="faq.html#AEN1770"
> How do I change my user name in Bugzilla? > How do I change my user name in Bugzilla?
</A </A
></DT ></DT
><DT ><DT
>A.1.8. <A >A.1.8. <A
HREF="faq.html#AEN1682" HREF="faq.html#AEN1775"
> Why doesn't Bugzilla offer this or that feature or compatability > Why doesn't Bugzilla offer this or that feature or compatability
with this other tracking software? with this other tracking software?
</A </A
></DT ></DT
><DT ><DT
>A.1.9. <A >A.1.9. <A
HREF="faq.html#AEN1689" HREF="faq.html#AEN1782"
> Why MySQL? I'm interested in seeing Bugzilla run on > Why MySQL? I'm interested in seeing Bugzilla run on
Oracle/Sybase/Msql/PostgreSQL/MSSQL? Oracle/Sybase/Msql/PostgreSQL/MSSQL?
</A </A
></DT ></DT
><DT ><DT
>A.1.10. <A >A.1.10. <A
HREF="faq.html#AEN1707" HREF="faq.html#AEN1800"
> Why do the scripts say "/usr/bonsaitools/bin/perl" instead of > Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
"/usr/bin/perl" or something else? "/usr/bin/perl" or something else?
</A </A
...@@ -153,19 +153,19 @@ HREF="faq.html#FAQ_REDHAT" ...@@ -153,19 +153,19 @@ HREF="faq.html#FAQ_REDHAT"
><DL ><DL
><DT ><DT
>A.2.1. <A >A.2.1. <A
HREF="faq.html#AEN1724" HREF="faq.html#AEN1817"
> What about Red Hat Bugzilla? > What about Red Hat Bugzilla?
</A </A
></DT ></DT
><DT ><DT
>A.2.2. <A >A.2.2. <A
HREF="faq.html#AEN1732" HREF="faq.html#AEN1825"
> What are the primary benefits of Red Hat Bugzilla? > What are the primary benefits of Red Hat Bugzilla?
</A </A
></DT ></DT
><DT ><DT
>A.2.3. <A >A.2.3. <A
HREF="faq.html#AEN1760" HREF="faq.html#AEN1853"
> What's the current status of Red Hat Bugzilla? > What's the current status of Red Hat Bugzilla?
</A </A
></DT ></DT
...@@ -180,7 +180,7 @@ HREF="faq.html#FAQ_LOKI" ...@@ -180,7 +180,7 @@ HREF="faq.html#FAQ_LOKI"
><DL ><DL
><DT ><DT
>A.3.1. <A >A.3.1. <A
HREF="faq.html#AEN1773" HREF="faq.html#AEN1866"
> What is Loki Bugzilla (Fenris)? > What is Loki Bugzilla (Fenris)?
</A </A
></DT ></DT
...@@ -195,41 +195,41 @@ HREF="faq.html#FAQ_PHB" ...@@ -195,41 +195,41 @@ HREF="faq.html#FAQ_PHB"
><DL ><DL
><DT ><DT
>A.4.1. <A >A.4.1. <A
HREF="faq.html#AEN1784" HREF="faq.html#AEN1877"
> Is Bugzilla web-based or do you have to have specific software or > Is Bugzilla web-based or do you have to have specific software or
specific operating system on your machine? specific operating system on your machine?
</A </A
></DT ></DT
><DT ><DT
>A.4.2. <A >A.4.2. <A
HREF="faq.html#AEN1789" HREF="faq.html#AEN1882"
> Has anyone you know of already done any Bugzilla integration with > Has anyone you know of already done any Bugzilla integration with
Perforce (SCM software)? Perforce (SCM software)?
</A </A
></DT ></DT
><DT ><DT
>A.4.3. <A >A.4.3. <A
HREF="faq.html#AEN1794" HREF="faq.html#AEN1887"
> Does Bugzilla allow the user to track multiple projects? > Does Bugzilla allow the user to track multiple projects?
</A </A
></DT ></DT
><DT ><DT
>A.4.4. <A >A.4.4. <A
HREF="faq.html#AEN1799" HREF="faq.html#AEN1892"
> If I am on many projects, and search for all bugs assigned to me, will > If I am on many projects, and search for all bugs assigned to me, will
Bugzilla list them for me and allow me to sort by project, severity etc? Bugzilla list them for me and allow me to sort by project, severity etc?
</A </A
></DT ></DT
><DT ><DT
>A.4.5. <A >A.4.5. <A
HREF="faq.html#AEN1804" HREF="faq.html#AEN1897"
> Does Bugzilla allow attachments (text, screenshots, urls etc)? If yes, > Does Bugzilla allow attachments (text, screenshots, urls etc)? If yes,
are there any that are NOT allowed? are there any that are NOT allowed?
</A </A
></DT ></DT
><DT ><DT
>A.4.6. <A >A.4.6. <A
HREF="faq.html#AEN1809" HREF="faq.html#AEN1902"
> Does Bugzilla allow us to define our own priorities and levels? Do we > Does Bugzilla allow us to define our own priorities and levels? Do we
have complete freedom to change the labels of fields and format of them, and have complete freedom to change the labels of fields and format of them, and
the choice of acceptable values? the choice of acceptable values?
...@@ -237,7 +237,7 @@ HREF="faq.html#AEN1809" ...@@ -237,7 +237,7 @@ HREF="faq.html#AEN1809"
></DT ></DT
><DT ><DT
>A.4.7. <A >A.4.7. <A
HREF="faq.html#AEN1814" HREF="faq.html#AEN1909"
> The index.html page doesn't show the footer. It's really annoying to have > The index.html page doesn't show the footer. It's really annoying to have
to go to the querypage just to check my "my bugs" link. How do I get a footer to go to the querypage just to check my "my bugs" link. How do I get a footer
on static HTML pages? on static HTML pages?
...@@ -245,35 +245,35 @@ HREF="faq.html#AEN1814" ...@@ -245,35 +245,35 @@ HREF="faq.html#AEN1814"
></DT ></DT
><DT ><DT
>A.4.8. <A >A.4.8. <A
HREF="faq.html#AEN1820" HREF="faq.html#AEN1931"
> Does Bugzilla provide any reporting features, metrics, graphs, etc? You > Does Bugzilla provide any reporting features, metrics, graphs, etc? You
know, the type of stuff that management likes to see. :) know, the type of stuff that management likes to see. :)
</A </A
></DT ></DT
><DT ><DT
>A.4.9. <A >A.4.9. <A
HREF="faq.html#AEN1828" HREF="faq.html#AEN1939"
> Is there email notification and if so, what do you see when you get an > Is there email notification and if so, what do you see when you get an
email? Do you see bug number and title or is it only the number? email? Do you see bug number and title or is it only the number?
</A </A
></DT ></DT
><DT ><DT
>A.4.10. <A >A.4.10. <A
HREF="faq.html#AEN1833" HREF="faq.html#AEN1944"
> Can email notification be set up to send to multiple > Can email notification be set up to send to multiple
people, some on the To List, CC List, BCC List etc? people, some on the To List, CC List, BCC List etc?
</A </A
></DT ></DT
><DT ><DT
>A.4.11. <A >A.4.11. <A
HREF="faq.html#AEN1838" HREF="faq.html#AEN1949"
> If there is email notification, do users have to have any particular > If there is email notification, do users have to have any particular
type of email application? type of email application?
</A </A
></DT ></DT
><DT ><DT
>A.4.12. <A >A.4.12. <A
HREF="faq.html#AEN1845" HREF="faq.html#AEN1956"
> If I just wanted to track certain bugs, as they go through life, can I > If I just wanted to track certain bugs, as they go through life, can I
set it up to alert me via email whenever that bug changes, whether it be set it up to alert me via email whenever that bug changes, whether it be
owner, status or description etc.? owner, status or description etc.?
...@@ -281,7 +281,7 @@ HREF="faq.html#AEN1845" ...@@ -281,7 +281,7 @@ HREF="faq.html#AEN1845"
></DT ></DT
><DT ><DT
>A.4.13. <A >A.4.13. <A
HREF="faq.html#AEN1850" HREF="faq.html#AEN1961"
> Does Bugzilla allow data to be imported and exported? If I had outsiders > Does Bugzilla allow data to be imported and exported? If I had outsiders
write up a bug report using a MS Word bug template, could that template be write up a bug report using a MS Word bug template, could that template be
imported into "matching" fields? If I wanted to take the results of a query imported into "matching" fields? If I wanted to take the results of a query
...@@ -290,75 +290,67 @@ HREF="faq.html#AEN1850" ...@@ -290,75 +290,67 @@ HREF="faq.html#AEN1850"
></DT ></DT
><DT ><DT
>A.4.14. <A >A.4.14. <A
HREF="faq.html#AEN1858" HREF="faq.html#AEN1969"
> 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?
</A
></DT
><DT
>A.4.15. <A
HREF="faq.html#AEN1863"
> Has anyone converted Bugzilla to another language to be used in other > Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable? countries? Is it localizable?
</A </A
></DT ></DT
><DT ><DT
>A.4.16. <A >A.4.15. <A
HREF="faq.html#AEN1868" HREF="faq.html#AEN1974"
> Can a user create and save reports? Can they do this in Word format? > Can a user create and save reports? Can they do this in Word format?
Excel format? Excel format?
</A </A
></DT ></DT
><DT ><DT
>A.4.17. <A >A.4.16. <A
HREF="faq.html#AEN1873" HREF="faq.html#AEN1979"
> Can a user re-run a report with a new project, same query? > Can a user re-run a report with a new project, same query?
</A </A
></DT ></DT
><DT ><DT
>A.4.18. <A >A.4.17. <A
HREF="faq.html#AEN1878" HREF="faq.html#AEN1984"
> Can a user modify an existing report and then save it into another name? > Can a user modify an existing report and then save it into another name?
</A </A
></DT ></DT
><DT ><DT
>A.4.19. <A >A.4.18. <A
HREF="faq.html#AEN1883" HREF="faq.html#AEN1989"
> Does Bugzilla have the ability to search by word, phrase, compound > Does Bugzilla have the ability to search by word, phrase, compound
search? search?
</A </A
></DT ></DT
><DT ><DT
>A.4.20. <A >A.4.19. <A
HREF="faq.html#AEN1888" HREF="faq.html#AEN1994"
> Can the admin person establish separate group and individual user > Can the admin person establish separate group and individual user
privileges? privileges?
</A </A
></DT ></DT
><DT ><DT
>A.4.21. <A >A.4.20. <A
HREF="faq.html#AEN1893" HREF="faq.html#AEN1999"
> Does Bugzilla provide record locking when there is simultaneous access > Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use to the same bug? Does the second person get a notice that the bug is in use
or how are they notified? or how are they notified?
</A </A
></DT ></DT
><DT ><DT
>A.4.22. <A >A.4.21. <A
HREF="faq.html#AEN1898" HREF="faq.html#AEN2004"
> Are there any backup features provided? > Are there any backup features provided?
</A </A
></DT ></DT
><DT ><DT
>A.4.23. <A >A.4.22. <A
HREF="faq.html#AEN1904" HREF="faq.html#AEN2010"
> Can users be on the system while a backup is in progress? > Can users be on the system while a backup is in progress?
</A </A
></DT ></DT
><DT ><DT
>A.4.24. <A >A.4.23. <A
HREF="faq.html#AEN1909" HREF="faq.html#AEN2015"
> What type of human resources are needed to be on staff to install and > What type of human resources are needed to be on staff to install and
maintain Bugzilla? Specifically, what type of skills does the person need to maintain Bugzilla? Specifically, what type of skills does the person need to
have? I need to find out if we were to go with Bugzilla, what types of have? I need to find out if we were to go with Bugzilla, what types of
...@@ -367,8 +359,8 @@ HREF="faq.html#AEN1909" ...@@ -367,8 +359,8 @@ HREF="faq.html#AEN1909"
</A </A
></DT ></DT
><DT ><DT
>A.4.25. <A >A.4.24. <A
HREF="faq.html#AEN1916" HREF="faq.html#AEN2022"
> What time frame are we looking at if we decide to hire people to install > What time frame are we looking at if we decide to hire people to install
and maintain the Bugzilla? Is this something that takes hours or weeks to and maintain the Bugzilla? Is this something that takes hours or weeks to
install and a couple of hours per week to maintain and customize or is this install and a couple of hours per week to maintain and customize or is this
...@@ -377,8 +369,8 @@ HREF="faq.html#AEN1916" ...@@ -377,8 +369,8 @@ HREF="faq.html#AEN1916"
</A </A
></DT ></DT
><DT ><DT
>A.4.26. <A >A.4.25. <A
HREF="faq.html#AEN1921" HREF="faq.html#AEN2027"
> Is there any licensing fee or other fees for using Bugzilla? Any > Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above? out-of-pocket cost other than the bodies needed as identified above?
</A </A
...@@ -394,19 +386,19 @@ HREF="faq.html#FAQ_INSTALL" ...@@ -394,19 +386,19 @@ HREF="faq.html#FAQ_INSTALL"
><DL ><DL
><DT ><DT
>A.5.1. <A >A.5.1. <A
HREF="faq.html#AEN1928" HREF="faq.html#AEN2034"
> How do I download and install Bugzilla? > How do I download and install Bugzilla?
</A </A
></DT ></DT
><DT ><DT
>A.5.2. <A >A.5.2. <A
HREF="faq.html#AEN1934" HREF="faq.html#AEN2040"
> How do I install Bugzilla on Windows NT? > How do I install Bugzilla on Windows NT?
</A </A
></DT ></DT
><DT ><DT
>A.5.3. <A >A.5.3. <A
HREF="faq.html#AEN1939" HREF="faq.html#AEN2045"
> Is there an easy way to change the Bugzilla cookie name? > Is there an easy way to change the Bugzilla cookie name?
</A </A
></DT ></DT
...@@ -421,20 +413,20 @@ HREF="faq.html#FAQ_SECURITY" ...@@ -421,20 +413,20 @@ HREF="faq.html#FAQ_SECURITY"
><DL ><DL
><DT ><DT
>A.6.1. <A >A.6.1. <A
HREF="faq.html#AEN1946" HREF="faq.html#AEN2052"
> How do I completely disable MySQL security if it's giving me problems > How do I completely disable MySQL security if it's giving me problems
(I've followed the instructions in the installation section of this guide!)? (I've followed the instructions in the installation section of this guide!)?
</A </A
></DT ></DT
><DT ><DT
>A.6.2. <A >A.6.2. <A
HREF="faq.html#AEN1952" HREF="faq.html#AEN2058"
> Are there any security problems with Bugzilla? > Are there any security problems with Bugzilla?
</A </A
></DT ></DT
><DT ><DT
>A.6.3. <A >A.6.3. <A
HREF="faq.html#AEN1957" HREF="faq.html#AEN2063"
> I've implemented the security fixes mentioned in Chris Yeh's security > I've implemented the security fixes mentioned in Chris Yeh's security
advisory of 5/10/2000 advising not to run MySQL as root, and am running into advisory of 5/10/2000 advising not to run MySQL as root, and am running into
problems with MySQL no longer working correctly. problems with MySQL no longer working correctly.
...@@ -451,48 +443,48 @@ HREF="faq.html#FAQ_EMAIL" ...@@ -451,48 +443,48 @@ HREF="faq.html#FAQ_EMAIL"
><DL ><DL
><DT ><DT
>A.7.1. <A >A.7.1. <A
HREF="faq.html#AEN1964" HREF="faq.html#AEN2070"
> I have a user who doesn't want to receive any more email from Bugzilla. > I have a user who doesn't want to receive any more email from Bugzilla.
How do I stop it entirely for this user? How do I stop it entirely for this user?
</A </A
></DT ></DT
><DT ><DT
>A.7.2. <A >A.7.2. <A
HREF="faq.html#AEN1969" HREF="faq.html#AEN2075"
> I'm evaluating/testing Bugzilla, and don't want it to send email to > I'm evaluating/testing Bugzilla, and don't want it to send email to
anyone but me. How do I do it? anyone but me. How do I do it?
</A </A
></DT ></DT
><DT ><DT
>A.7.3. <A >A.7.3. <A
HREF="faq.html#AEN1974" HREF="faq.html#AEN2080"
> I want whineatnews.pl to whine at something more, or other than, only new > I want whineatnews.pl to whine at something more, or other than, only new
bugs. How do I do it? bugs. How do I do it?
</A </A
></DT ></DT
><DT ><DT
>A.7.4. <A >A.7.4. <A
HREF="faq.html#AEN1980" HREF="faq.html#AEN2086"
> I don't like/want to use Procmail to hand mail off to bug_email.pl. > I don't like/want to use Procmail to hand mail off to bug_email.pl.
What alternatives do I have? What alternatives do I have?
</A </A
></DT ></DT
><DT ><DT
>A.7.5. <A >A.7.5. <A
HREF="faq.html#AEN1987" HREF="faq.html#AEN2093"
> How do I set up the email interface to submit/change bugs via email? > How do I set up the email interface to submit/change bugs via email?
</A </A
></DT ></DT
><DT ><DT
>A.7.6. <A >A.7.6. <A
HREF="faq.html#AEN1992" HREF="faq.html#AEN2098"
> Email takes FOREVER to reach me from bugzilla -- it's extremely slow. > Email takes FOREVER to reach me from bugzilla -- it's extremely slow.
What gives? What gives?
</A </A
></DT ></DT
><DT ><DT
>A.7.7. <A >A.7.7. <A
HREF="faq.html#AEN1999" HREF="faq.html#AEN2105"
> How come email never reaches me from bugzilla changes? > How come email never reaches me from bugzilla changes?
</A </A
></DT ></DT
...@@ -507,60 +499,60 @@ HREF="faq.html#FAQ_DB" ...@@ -507,60 +499,60 @@ HREF="faq.html#FAQ_DB"
><DL ><DL
><DT ><DT
>A.8.1. <A >A.8.1. <A
HREF="faq.html#AEN2007" HREF="faq.html#AEN2113"
> I've heard Bugzilla can be used with Oracle? > I've heard Bugzilla can be used with Oracle?
</A </A
></DT ></DT
><DT ><DT
>A.8.2. <A >A.8.2. <A
HREF="faq.html#AEN2012" HREF="faq.html#AEN2118"
> Bugs are missing from queries, but exist in the database (and I can pull > Bugs are missing from queries, but exist in the database (and I can pull
them up by specifying the bug ID). What's wrong? them up by specifying the bug ID). What's wrong?
</A </A
></DT ></DT
><DT ><DT
>A.8.3. <A >A.8.3. <A
HREF="faq.html#AEN2017" HREF="faq.html#AEN2123"
> I think my database might be corrupted, or contain invalid entries. What > I think my database might be corrupted, or contain invalid entries. What
do I do? do I do?
</A </A
></DT ></DT
><DT ><DT
>A.8.4. <A >A.8.4. <A
HREF="faq.html#AEN2022" HREF="faq.html#AEN2131"
> I want to manually edit some entries in my database. How? > I want to manually edit some entries in my database. How?
</A </A
></DT ></DT
><DT ><DT
>A.8.5. <A >A.8.5. <A
HREF="faq.html#AEN2027" HREF="faq.html#AEN2136"
> I try to add myself as a user, but Bugzilla always tells me my password is wrong. > I try to add myself as a user, but Bugzilla always tells me my password is wrong.
</A </A
></DT ></DT
><DT ><DT
>A.8.6. <A >A.8.6. <A
HREF="faq.html#AEN2032" HREF="faq.html#AEN2141"
> I think I've set up MySQL permissions correctly, but bugzilla still can't > I think I've set up MySQL permissions correctly, but bugzilla still can't
connect. connect.
</A </A
></DT ></DT
><DT ><DT
>A.8.7. <A >A.8.7. <A
HREF="faq.html#AEN2037" HREF="faq.html#AEN2146"
> How do I synchronize bug information among multiple different Bugzilla > How do I synchronize bug information among multiple different Bugzilla
databases? databases?
</A </A
></DT ></DT
><DT ><DT
>A.8.8. <A >A.8.8. <A
HREF="faq.html#AEN2044" HREF="faq.html#AEN2153"
> Why do I get bizarre errors when trying to submit data, particularly problems > Why do I get bizarre errors when trying to submit data, particularly problems
with "groupset"? with "groupset"?
</A </A
></DT ></DT
><DT ><DT
>A.8.9. <A >A.8.9. <A
HREF="faq.html#AEN2049" HREF="faq.html#AEN2158"
> How come even after I delete bugs, the long descriptions show up? > How come even after I delete bugs, the long descriptions show up?
</A </A
></DT ></DT
...@@ -575,32 +567,32 @@ HREF="faq.html#FAQ_NT" ...@@ -575,32 +567,32 @@ HREF="faq.html#FAQ_NT"
><DL ><DL
><DT ><DT
>A.9.1. <A >A.9.1. <A
HREF="faq.html#AEN2056" HREF="faq.html#AEN2168"
> What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)? > What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
</A </A
></DT ></DT
><DT ><DT
>A.9.2. <A >A.9.2. <A
HREF="faq.html#AEN2061" HREF="faq.html#AEN2173"
> Is there a "Bundle::Bugzilla" equivalent for Win32? > Is there a "Bundle::Bugzilla" equivalent for Win32?
</A </A
></DT ></DT
><DT ><DT
>A.9.3. <A >A.9.3. <A
HREF="faq.html#AEN2066" HREF="faq.html#AEN2178"
> CGI's are failing with a "something.cgi is not a valid Windows NT > CGI's are failing with a "something.cgi is not a valid Windows NT
application" error. Why? application" error. Why?
</A </A
></DT ></DT
><DT ><DT
>A.9.4. <A >A.9.4. <A
HREF="faq.html#AEN2074" HREF="faq.html#AEN2186"
> Can I have some general instructions on how to make Bugzilla on Win32 work? > Can I have some general instructions on how to make Bugzilla on Win32 work?
</A </A
></DT ></DT
><DT ><DT
>A.9.5. <A >A.9.5. <A
HREF="faq.html#AEN2080" HREF="faq.html#AEN2192"
> I'm having trouble with the perl modules for NT not being able to talk to > I'm having trouble with the perl modules for NT not being able to talk to
to the database. to the database.
</A </A
...@@ -616,34 +608,34 @@ HREF="faq.html#FAQ_USE" ...@@ -616,34 +608,34 @@ HREF="faq.html#FAQ_USE"
><DL ><DL
><DT ><DT
>A.10.1. <A >A.10.1. <A
HREF="faq.html#AEN2101" HREF="faq.html#AEN2213"
> The query page is very confusing. Isn't there a simpler way to query? > The query page is very confusing. Isn't there a simpler way to query?
</A </A
></DT ></DT
><DT ><DT
>A.10.2. <A >A.10.2. <A
HREF="faq.html#AEN2107" HREF="faq.html#AEN2219"
> I'm confused by the behavior of the "accept" button in the Show Bug form. > I'm confused by the behavior of the "accept" button in the Show Bug form.
Why doesn't it assign the bug to me when I accept it? Why doesn't it assign the bug to me when I accept it?
</A </A
></DT ></DT
><DT ><DT
>A.10.3. <A >A.10.3. <A
HREF="faq.html#AEN2117" HREF="faq.html#AEN2229"
> I can't upload anything into the database via the "Create Attachment" > I can't upload anything into the database via the "Create Attachment"
link. What am I doing wrong? link. What am I doing wrong?
</A </A
></DT ></DT
><DT ><DT
>A.10.4. <A >A.10.4. <A
HREF="faq.html#AEN2122" HREF="faq.html#AEN2234"
> Email submissions to Bugzilla that have attachments end up asking me to > Email submissions to Bugzilla that have attachments end up asking me to
save it as a "cgi" file. save it as a "cgi" file.
</A </A
></DT ></DT
><DT ><DT
>A.10.5. <A >A.10.5. <A
HREF="faq.html#AEN2127" HREF="faq.html#AEN2239"
> How do I change a keyword in Bugzilla, once some bugs are using it? > How do I change a keyword in Bugzilla, once some bugs are using it?
</A </A
></DT ></DT
...@@ -658,20 +650,20 @@ HREF="faq.html#FAQ_HACKING" ...@@ -658,20 +650,20 @@ HREF="faq.html#FAQ_HACKING"
><DL ><DL
><DT ><DT
>A.11.1. <A >A.11.1. <A
HREF="faq.html#AEN2134" HREF="faq.html#AEN2246"
> What bugs are in Bugzilla right now? > What bugs are in Bugzilla right now?
</A </A
></DT ></DT
><DT ><DT
>A.11.2. <A >A.11.2. <A
HREF="faq.html#AEN2143" HREF="faq.html#AEN2255"
> How can I change the default priority to a null value? For instance, have the default > How can I change the default priority to a null value? For instance, have the default
priority be "---" instead of "P2"? priority be "---" instead of "P2"?
</A </A
></DT ></DT
><DT ><DT
>A.11.3. <A >A.11.3. <A
HREF="faq.html#AEN2149" HREF="faq.html#AEN2261"
> What's the best way to submit patches? What guidelines should I follow? > What's the best way to submit patches? What guidelines should I follow?
</A </A
></DT ></DT
...@@ -691,7 +683,7 @@ CLASS="QANDAENTRY" ...@@ -691,7 +683,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1620" NAME="AEN1713"
></A ></A
><B ><B
>A.1.1. </B >A.1.1. </B
...@@ -717,7 +709,7 @@ CLASS="QANDAENTRY" ...@@ -717,7 +709,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1626" NAME="AEN1719"
></A ></A
><B ><B
>A.1.2. </B >A.1.2. </B
...@@ -744,7 +736,7 @@ CLASS="QANDAENTRY" ...@@ -744,7 +736,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1632" NAME="AEN1725"
></A ></A
><B ><B
>A.1.3. </B >A.1.3. </B
...@@ -779,7 +771,7 @@ CLASS="QANDAENTRY" ...@@ -779,7 +771,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1639" NAME="AEN1732"
></A ></A
><B ><B
>A.1.4. </B >A.1.4. </B
...@@ -887,7 +879,7 @@ CLASS="QANDAENTRY" ...@@ -887,7 +879,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1664" NAME="AEN1757"
></A ></A
><B ><B
>A.1.5. </B >A.1.5. </B
...@@ -914,7 +906,7 @@ CLASS="QANDAENTRY" ...@@ -914,7 +906,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1670" NAME="AEN1763"
></A ></A
><B ><B
>A.1.6. </B >A.1.6. </B
...@@ -953,7 +945,7 @@ CLASS="QANDAENTRY" ...@@ -953,7 +945,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1677" NAME="AEN1770"
></A ></A
><B ><B
>A.1.7. </B >A.1.7. </B
...@@ -976,7 +968,7 @@ CLASS="QANDAENTRY" ...@@ -976,7 +968,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1682" NAME="AEN1775"
></A ></A
><B ><B
>A.1.8. </B >A.1.8. </B
...@@ -1014,7 +1006,7 @@ CLASS="QANDAENTRY" ...@@ -1014,7 +1006,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1689" NAME="AEN1782"
></A ></A
><B ><B
>A.1.9. </B >A.1.9. </B
...@@ -1029,7 +1021,7 @@ CLASS="ANSWER" ...@@ -1029,7 +1021,7 @@ CLASS="ANSWER"
> </B > </B
>Terry Weissman answers, >Terry Weissman answers,
<A <A
NAME="AEN1693" NAME="AEN1786"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -1105,7 +1097,7 @@ CLASS="QANDAENTRY" ...@@ -1105,7 +1097,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1707" NAME="AEN1800"
></A ></A
><B ><B
>A.1.10. </B >A.1.10. </B
...@@ -1125,7 +1117,7 @@ CLASS="ANSWER" ...@@ -1125,7 +1117,7 @@ CLASS="ANSWER"
><P ><P
> Here's Terry Weissman's comment, for some historical context: > Here's Terry Weissman's comment, for some historical context:
<A <A
NAME="AEN1712" NAME="AEN1805"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -1222,7 +1214,7 @@ CLASS="QANDAENTRY" ...@@ -1222,7 +1214,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1724" NAME="AEN1817"
></A ></A
><B ><B
>A.2.1. </B >A.2.1. </B
...@@ -1246,7 +1238,7 @@ CLASS="ANSWER" ...@@ -1246,7 +1238,7 @@ CLASS="ANSWER"
><P ><P
> Dave Lawrence, the original Red Hat Bugzilla maintainer, mentions: > Dave Lawrence, the original Red Hat Bugzilla maintainer, mentions:
<A <A
NAME="AEN1729" NAME="AEN1822"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -1269,7 +1261,7 @@ CLASS="QANDAENTRY" ...@@ -1269,7 +1261,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1732" NAME="AEN1825"
></A ></A
><B ><B
>A.2.2. </B >A.2.2. </B
...@@ -1285,7 +1277,7 @@ CLASS="ANSWER" ...@@ -1285,7 +1277,7 @@ CLASS="ANSWER"
>Dave Lawrence</EM >Dave Lawrence</EM
>: >:
<A <A
NAME="AEN1737" NAME="AEN1830"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -1401,7 +1393,7 @@ CLASS="QANDAENTRY" ...@@ -1401,7 +1393,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1760" NAME="AEN1853"
></A ></A
><B ><B
>A.2.3. </B >A.2.3. </B
...@@ -1447,7 +1439,7 @@ VALIGN="TOP" ...@@ -1447,7 +1439,7 @@ VALIGN="TOP"
>Dave Lawrence</EM >Dave Lawrence</EM
>: >:
<A <A
NAME="AEN1767" NAME="AEN1860"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -1516,7 +1508,7 @@ CLASS="QANDAENTRY" ...@@ -1516,7 +1508,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1773" NAME="AEN1866"
></A ></A
><B ><B
>A.3.1. </B >A.3.1. </B
...@@ -1582,7 +1574,7 @@ CLASS="QANDAENTRY" ...@@ -1582,7 +1574,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1784" NAME="AEN1877"
></A ></A
><B ><B
>A.4.1. </B >A.4.1. </B
...@@ -1606,7 +1598,7 @@ CLASS="QANDAENTRY" ...@@ -1606,7 +1598,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1789" NAME="AEN1882"
></A ></A
><B ><B
>A.4.2. </B >A.4.2. </B
...@@ -1630,7 +1622,7 @@ CLASS="QANDAENTRY" ...@@ -1630,7 +1622,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1794" NAME="AEN1887"
></A ></A
><B ><B
>A.4.3. </B >A.4.3. </B
...@@ -1656,7 +1648,7 @@ CLASS="QANDAENTRY" ...@@ -1656,7 +1648,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1799" NAME="AEN1892"
></A ></A
><B ><B
>A.4.4. </B >A.4.4. </B
...@@ -1679,7 +1671,7 @@ CLASS="QANDAENTRY" ...@@ -1679,7 +1671,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1804" NAME="AEN1897"
></A ></A
><B ><B
>A.4.5. </B >A.4.5. </B
...@@ -1707,7 +1699,7 @@ CLASS="QANDAENTRY" ...@@ -1707,7 +1699,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1809" NAME="AEN1902"
></A ></A
><B ><B
>A.4.6. </B >A.4.6. </B
...@@ -1725,6 +1717,15 @@ CLASS="ANSWER" ...@@ -1725,6 +1717,15 @@ CLASS="ANSWER"
progression states, also require adjusting the program logic to progression states, also require adjusting the program logic to
compensate for the change. compensate for the change.
</P </P
><P
> There is no GUI for adding fields to Bugzilla at this
time. You can follow development of this feature at
<A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=91037"
TARGET="_top"
>http://bugzilla.mozilla.org/show_bug.cgi?id=91037</A
>
</P
></DIV ></DIV
></DIV ></DIV
><DIV ><DIV
...@@ -1733,7 +1734,7 @@ CLASS="QANDAENTRY" ...@@ -1733,7 +1734,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1814" NAME="AEN1909"
></A ></A
><B ><B
>A.4.7. </B >A.4.7. </B
...@@ -1747,41 +1748,160 @@ CLASS="ANSWER" ...@@ -1747,41 +1748,160 @@ CLASS="ANSWER"
><P ><P
><B ><B
> </B > </B
> This was a late-breaking question for the Guide, so I just have to > It's possible to get the footer on the static index page using
quote the relevant newsgroup thread on it. Server Side Includes (SSI). The trick to doing this is making
</P sure that your web server is set up to allow SSI and specifically,
the #exec directive. You should also rename <TT
CLASS="FILENAME"
>index.html</TT
>
to <TT
CLASS="FILENAME"
>index.shtml</TT
>.
</P
><P ><P
CLASS="LITERALLAYOUT" > After you've done all that, you can add the following line to
>&#62;&nbsp;AFAIK,&nbsp;most&nbsp;sites&nbsp;(even&nbsp;if&nbsp;they&nbsp;have&nbsp;SSI&nbsp;enabled)&nbsp;won't&nbsp;have&nbsp;#exec&nbsp;cmd<br> <TT
&#62;&nbsp;enabled.&nbsp;&nbsp;Perhaps&nbsp;what&nbsp;would&nbsp;be&nbsp;better&nbsp;is&nbsp;a&nbsp;#include&nbsp;virtual&nbsp;and&nbsp;a<br> CLASS="FILENAME"
&#62;&nbsp;footer.cgi&nbsp;the&nbsp;basically&nbsp;has&nbsp;the&nbsp;"require&nbsp;'CGI.pl'&nbsp;and&nbsp;PutFooter&nbsp;command.<br> >index.shtml</TT
&#62;<br> >:
&#62;&nbsp;Please&nbsp;note&nbsp;that&nbsp;under&nbsp;most&nbsp;configurations,&nbsp;this&nbsp;also&nbsp;requires&nbsp;naming<br> <TABLE
&#62;&nbsp;the&nbsp;file&nbsp;from&nbsp;index.html&nbsp;to&nbsp;index.shtml&nbsp;(and&nbsp;making&nbsp;sure&nbsp;that&nbsp;it&nbsp;will<br> BORDER="0"
&#62;&nbsp;still&nbsp;be&nbsp;reconized&nbsp;as&nbsp;an&nbsp;index).&nbsp;&nbsp;Personally,&nbsp;I&nbsp;think&nbsp;this&nbsp;is&nbsp;better&nbsp;on<br> BGCOLOR="#E0E0E0"
&#62;&nbsp;a&nbsp;per-installation&nbsp;basis&nbsp;(perhaps&nbsp;add&nbsp;something&nbsp;to&nbsp;the&nbsp;FAQ&nbsp;that&nbsp;says&nbsp;how<br> WIDTH="100%"
&#62;&nbsp;to&nbsp;do&nbsp;this).<br> ><TR
<br> ><TD
Good&nbsp;point.&nbsp;&nbsp;Yeah,&nbsp;easy&nbsp;enough&nbsp;to&nbsp;do,&nbsp;that&nbsp;it&nbsp;shouldn't&nbsp;be&nbsp;a&nbsp;big&nbsp;deal&nbsp;for<br> ><FONT
someone&nbsp;to&nbsp;take&nbsp;it&nbsp;on&nbsp;if&nbsp;they&nbsp;want&nbsp;it.&nbsp;&nbsp;FAQ&nbsp;is&nbsp;a&nbsp;good&nbsp;place&nbsp;for&nbsp;it.<br> COLOR="#000000"
<br> ><PRE
&#62;&nbsp;Dave&nbsp;Miller&nbsp;wrote:<br> CLASS="PROGRAMLISTING"
&#62;<br> >&#60;!--#exec cmd="/usr/bin/perl -e &#38;quot;require 'CGI.pl'; PutFooter();&#38;quot;" --&#62;</PRE
&#62;&#62;&nbsp;I&nbsp;did&nbsp;a&nbsp;little&nbsp;experimenting&nbsp;with&nbsp;getting&nbsp;the&nbsp;command&nbsp;menu&nbsp;and&nbsp;footer&nbsp;on<br> ></FONT
&#62;&#62;&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;index&nbsp;page&nbsp;while&nbsp;leaving&nbsp;it&nbsp;as&nbsp;an&nbsp;HTML&nbsp;file...<br> ></TD
&#62;&#62;<br> ></TR
&#62;&#62;&nbsp;I&nbsp;was&nbsp;successful.&nbsp;:)<br> ></TABLE
&#62;&#62;<br> >
&#62;&#62;&nbsp;I&nbsp;added&nbsp;this&nbsp;line:<br> </P
&#62;&#62;<br> ><P
&#62;&#62;&nbsp;<br> ><DIV
&#62;&#62;<br> CLASS="NOTE"
&#62;&#62;&nbsp;Just&nbsp;before&nbsp;the&nbsp;&#60;/BODY&#62;&nbsp;&#60;/HTML&#62;&nbsp;at&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;file.&nbsp;&nbsp;And&nbsp;it&nbsp;worked.<br> ><P
&#62;&#62;<br> ></P
&#62;&#62;&nbsp;Thought&nbsp;I'd&nbsp;toss&nbsp;that&nbsp;out&nbsp;there.&nbsp;&nbsp;Should&nbsp;I&nbsp;check&nbsp;this&nbsp;in?&nbsp;&nbsp;For&nbsp;those&nbsp;that<br> ><TABLE
&#62;&#62;&nbsp;have&nbsp;SSI&nbsp;disabled,&nbsp;it'll&nbsp;act&nbsp;like&nbsp;a&nbsp;comment,&nbsp;so&nbsp;I&nbsp;wouldn't&nbsp;think&nbsp;it&nbsp;would<br> CLASS="NOTE"
&#62;&#62;&nbsp;break&nbsp;anything.<br> WIDTH="100%"
&nbsp;&nbsp;</P 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
> 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.
</P
></TD
></TR
></TABLE
></DIV
></P
><P
> 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 <TT
CLASS="FILENAME"
>api.cgi</TT
>)
that basically looks like:
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="PROGRAMLISTING"
>#!/usr/bonsaitools/bin/perl -w
require 'globals.pl';
if ($::FORM{sub} eq 'PutFooter') {
PutFooter();
} else {
die 'api.cgi was incorrectly called';
}</PRE
></FONT
></TD
></TR
></TABLE
>
and then put this line in <TT
CLASS="FILENAME"
>index.shtml</TT
>.
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="PROGRAMLISTING"
>&#60;!--#include virtual="api.cgi?sub=PutFooter"--&#62;</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><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
> This still requires being able to use Server Side Includes, if
this simply will not work for you, see <A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=80183"
TARGET="_top"
>bug 80183</A
>
for a third option.
</P
></TD
></TR
></TABLE
></DIV
></P
></DIV ></DIV
></DIV ></DIV
><DIV ><DIV
...@@ -1790,7 +1910,7 @@ CLASS="QANDAENTRY" ...@@ -1790,7 +1910,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1820" NAME="AEN1931"
></A ></A
><B ><B
>A.4.8. </B >A.4.8. </B
...@@ -1829,7 +1949,7 @@ CLASS="QANDAENTRY" ...@@ -1829,7 +1949,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1828" NAME="AEN1939"
></A ></A
><B ><B
>A.4.9. </B >A.4.9. </B
...@@ -1854,7 +1974,7 @@ CLASS="QANDAENTRY" ...@@ -1854,7 +1974,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1833" NAME="AEN1944"
></A ></A
><B ><B
>A.4.10. </B >A.4.10. </B
...@@ -1877,7 +1997,7 @@ CLASS="QANDAENTRY" ...@@ -1877,7 +1997,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1838" NAME="AEN1949"
></A ></A
><B ><B
>A.4.11. </B >A.4.11. </B
...@@ -1934,7 +2054,7 @@ CLASS="QANDAENTRY" ...@@ -1934,7 +2054,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1845" NAME="AEN1956"
></A ></A
><B ><B
>A.4.12. </B >A.4.12. </B
...@@ -1961,7 +2081,7 @@ CLASS="QANDAENTRY" ...@@ -1961,7 +2081,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1850" NAME="AEN1961"
></A ></A
><B ><B
>A.4.13. </B >A.4.13. </B
...@@ -2006,34 +2126,10 @@ CLASS="QANDAENTRY" ...@@ -2006,34 +2126,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1858" NAME="AEN1969"
></A ></A
><B ><B
>A.4.14. </B >A.4.14. </B
> 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?
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> Yes.
</P
></DIV
></DIV
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN1863"
></A
><B
>A.4.15. </B
> Has anyone converted Bugzilla to another language to be used in other > Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable? countries? Is it localizable?
</P </P
...@@ -2056,10 +2152,10 @@ CLASS="QANDAENTRY" ...@@ -2056,10 +2152,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1868" NAME="AEN1974"
></A ></A
><B ><B
>A.4.16. </B >A.4.15. </B
> Can a user create and save reports? Can they do this in Word format? > Can a user create and save reports? Can they do this in Word format?
Excel format? Excel format?
</P </P
...@@ -2079,10 +2175,10 @@ CLASS="QANDAENTRY" ...@@ -2079,10 +2175,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1873" NAME="AEN1979"
></A ></A
><B ><B
>A.4.17. </B >A.4.16. </B
> Can a user re-run a report with a new project, same query? > Can a user re-run a report with a new project, same query?
</P </P
></DIV ></DIV
...@@ -2101,10 +2197,10 @@ CLASS="QANDAENTRY" ...@@ -2101,10 +2197,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1878" NAME="AEN1984"
></A ></A
><B ><B
>A.4.18. </B >A.4.17. </B
> Can a user modify an existing report and then save it into another name? > Can a user modify an existing report and then save it into another name?
</P </P
></DIV ></DIV
...@@ -2124,10 +2220,10 @@ CLASS="QANDAENTRY" ...@@ -2124,10 +2220,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1883" NAME="AEN1989"
></A ></A
><B ><B
>A.4.19. </B >A.4.18. </B
> Does Bugzilla have the ability to search by word, phrase, compound > Does Bugzilla have the ability to search by word, phrase, compound
search? search?
</P </P
...@@ -2148,10 +2244,10 @@ CLASS="QANDAENTRY" ...@@ -2148,10 +2244,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1888" NAME="AEN1994"
></A ></A
><B ><B
>A.4.20. </B >A.4.19. </B
> Can the admin person establish separate group and individual user > Can the admin person establish separate group and individual user
privileges? privileges?
</P </P
...@@ -2171,10 +2267,10 @@ CLASS="QANDAENTRY" ...@@ -2171,10 +2267,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1893" NAME="AEN1999"
></A ></A
><B ><B
>A.4.21. </B >A.4.20. </B
> Does Bugzilla provide record locking when there is simultaneous access > Does Bugzilla provide record locking when there is simultaneous access
to the same bug? Does the second person get a notice that the bug is in use to the same bug? Does the second person get a notice that the bug is in use
or how are they notified? or how are they notified?
...@@ -2196,10 +2292,10 @@ CLASS="QANDAENTRY" ...@@ -2196,10 +2292,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1898" NAME="AEN2004"
></A ></A
><B ><B
>A.4.22. </B >A.4.21. </B
> Are there any backup features provided? > Are there any backup features provided?
</P </P
></DIV ></DIV
...@@ -2224,10 +2320,10 @@ CLASS="QANDAENTRY" ...@@ -2224,10 +2320,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1904" NAME="AEN2010"
></A ></A
><B ><B
>A.4.23. </B >A.4.22. </B
> Can users be on the system while a backup is in progress? > Can users be on the system while a backup is in progress?
</P </P
></DIV ></DIV
...@@ -2248,10 +2344,10 @@ CLASS="QANDAENTRY" ...@@ -2248,10 +2344,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1909" NAME="AEN2015"
></A ></A
><B ><B
>A.4.24. </B >A.4.23. </B
> What type of human resources are needed to be on staff to install and > What type of human resources are needed to be on staff to install and
maintain Bugzilla? Specifically, what type of skills does the person need to maintain Bugzilla? Specifically, what type of skills does the person need to
have? I need to find out if we were to go with Bugzilla, what types of have? I need to find out if we were to go with Bugzilla, what types of
...@@ -2287,10 +2383,10 @@ CLASS="QANDAENTRY" ...@@ -2287,10 +2383,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1916" NAME="AEN2022"
></A ></A
><B ><B
>A.4.25. </B >A.4.24. </B
> What time frame are we looking at if we decide to hire people to install > What time frame are we looking at if we decide to hire people to install
and maintain the Bugzilla? Is this something that takes hours or weeks to and maintain the Bugzilla? Is this something that takes hours or weeks to
install and a couple of hours per week to maintain and customize or is this install and a couple of hours per week to maintain and customize or is this
...@@ -2318,10 +2414,10 @@ CLASS="QANDAENTRY" ...@@ -2318,10 +2414,10 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1921" NAME="AEN2027"
></A ></A
><B ><B
>A.4.26. </B >A.4.25. </B
> Is there any licensing fee or other fees for using Bugzilla? Any > Is there any licensing fee or other fees for using Bugzilla? Any
out-of-pocket cost other than the bodies needed as identified above? out-of-pocket cost other than the bodies needed as identified above?
</P </P
...@@ -2350,7 +2446,7 @@ CLASS="QANDAENTRY" ...@@ -2350,7 +2446,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1928" NAME="AEN2034"
></A ></A
><B ><B
>A.5.1. </B >A.5.1. </B
...@@ -2377,7 +2473,7 @@ CLASS="QANDAENTRY" ...@@ -2377,7 +2473,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1934" NAME="AEN2040"
></A ></A
><B ><B
>A.5.2. </B >A.5.2. </B
...@@ -2400,7 +2496,7 @@ CLASS="QANDAENTRY" ...@@ -2400,7 +2496,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1939" NAME="AEN2045"
></A ></A
><B ><B
>A.5.3. </B >A.5.3. </B
...@@ -2430,7 +2526,7 @@ CLASS="QANDAENTRY" ...@@ -2430,7 +2526,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1946" NAME="AEN2052"
></A ></A
><B ><B
>A.6.1. </B >A.6.1. </B
...@@ -2458,7 +2554,7 @@ CLASS="QANDAENTRY" ...@@ -2458,7 +2554,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1952" NAME="AEN2058"
></A ></A
><B ><B
>A.6.2. </B >A.6.2. </B
...@@ -2483,7 +2579,7 @@ CLASS="QANDAENTRY" ...@@ -2483,7 +2579,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1957" NAME="AEN2063"
></A ></A
><B ><B
>A.6.3. </B >A.6.3. </B
...@@ -2517,7 +2613,7 @@ CLASS="QANDAENTRY" ...@@ -2517,7 +2613,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1964" NAME="AEN2070"
></A ></A
><B ><B
>A.7.1. </B >A.7.1. </B
...@@ -2541,7 +2637,7 @@ CLASS="QANDAENTRY" ...@@ -2541,7 +2637,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1969" NAME="AEN2075"
></A ></A
><B ><B
>A.7.2. </B >A.7.2. </B
...@@ -2565,7 +2661,7 @@ CLASS="QANDAENTRY" ...@@ -2565,7 +2661,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1974" NAME="AEN2080"
></A ></A
><B ><B
>A.7.3. </B >A.7.3. </B
...@@ -2595,7 +2691,7 @@ CLASS="QANDAENTRY" ...@@ -2595,7 +2691,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1980" NAME="AEN2086"
></A ></A
><B ><B
>A.7.4. </B >A.7.4. </B
...@@ -2611,7 +2707,7 @@ CLASS="ANSWER" ...@@ -2611,7 +2707,7 @@ CLASS="ANSWER"
> You can call bug_email.pl directly from your aliases file, with > You can call bug_email.pl directly from your aliases file, with
an entry like this: an entry like this:
<A <A
NAME="AEN1984" NAME="AEN2090"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -2632,7 +2728,7 @@ CLASS="QANDAENTRY" ...@@ -2632,7 +2728,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1987" NAME="AEN2093"
></A ></A
><B ><B
>A.7.5. </B >A.7.5. </B
...@@ -2655,7 +2751,7 @@ CLASS="QANDAENTRY" ...@@ -2655,7 +2751,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1992" NAME="AEN2098"
></A ></A
><B ><B
>A.7.6. </B >A.7.6. </B
...@@ -2670,20 +2766,14 @@ CLASS="ANSWER" ...@@ -2670,20 +2766,14 @@ CLASS="ANSWER"
> </B > </B
> If you are using an alternate Mail Transport Agent (MTA other than > If you are using an alternate Mail Transport Agent (MTA other than
sendmail), make sure the options given in the "processmail" script for all 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, instances of "sendmail" are correct for your MTA.
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!)
</P
><P
> 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.
</P </P
><P ><P
> This is now a configurable parameter called "sendmailnow", available > If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi.
from editparams.cgi. If you are using Postfix, you will also need to enable <SPAN
CLASS="QUOTE"
>"sendmailnow"</SPAN
>.
</P </P
></DIV ></DIV
></DIV ></DIV
...@@ -2693,7 +2783,7 @@ CLASS="QANDAENTRY" ...@@ -2693,7 +2783,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN1999" NAME="AEN2105"
></A ></A
><B ><B
>A.7.7. </B >A.7.7. </B
...@@ -2731,7 +2821,7 @@ CLASS="QANDAENTRY" ...@@ -2731,7 +2821,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2007" NAME="AEN2113"
></A ></A
><B ><B
>A.8.1. </B >A.8.1. </B
...@@ -2756,7 +2846,7 @@ CLASS="QANDAENTRY" ...@@ -2756,7 +2846,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2012" NAME="AEN2118"
></A ></A
><B ><B
>A.8.2. </B >A.8.2. </B
...@@ -2791,7 +2881,7 @@ CLASS="QANDAENTRY" ...@@ -2791,7 +2881,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2017" NAME="AEN2123"
></A ></A
><B ><B
>A.8.3. </B >A.8.3. </B
...@@ -2804,12 +2894,29 @@ CLASS="ANSWER" ...@@ -2804,12 +2894,29 @@ CLASS="ANSWER"
><P ><P
><B ><B
> </B > </B
> Run the "sanity check" utility (./sanitycheck.cgi in the bugzilla_home > Run the <SPAN
directory) to see! If it all comes back, you're OK. If it doesn't come back CLASS="QUOTE"
OK (i.e. any red letters), there are certain things Bugzilla can recover >"sanity check"</SPAN
from and certain things it can't. If it can't auto-recover, I hope you're > utility
familiar with mysqladmin commands or have installed another way to manage (<TT
your database... CLASS="FILENAME"
>./sanitycheck.cgi</TT
> in the
Bugzilla_home directory) from your web browser to see! If
it finishes without errors, you're
<EM
>probably</EM
> 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.
</P </P
></DIV ></DIV
></DIV ></DIV
...@@ -2819,7 +2926,7 @@ CLASS="QANDAENTRY" ...@@ -2819,7 +2926,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2022" NAME="AEN2131"
></A ></A
><B ><B
>A.8.4. </B >A.8.4. </B
...@@ -2846,7 +2953,7 @@ CLASS="QANDAENTRY" ...@@ -2846,7 +2953,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2027" NAME="AEN2136"
></A ></A
><B ><B
>A.8.5. </B >A.8.5. </B
...@@ -2870,7 +2977,7 @@ CLASS="QANDAENTRY" ...@@ -2870,7 +2977,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2032" NAME="AEN2141"
></A ></A
><B ><B
>A.8.6. </B >A.8.6. </B
...@@ -2897,7 +3004,7 @@ CLASS="QANDAENTRY" ...@@ -2897,7 +3004,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2037" NAME="AEN2146"
></A ></A
><B ><B
>A.8.7. </B >A.8.7. </B
...@@ -2933,7 +3040,7 @@ CLASS="QANDAENTRY" ...@@ -2933,7 +3040,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2044" NAME="AEN2153"
></A ></A
><B ><B
>A.8.8. </B >A.8.8. </B
...@@ -2959,7 +3066,7 @@ CLASS="QANDAENTRY" ...@@ -2959,7 +3066,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2049" NAME="AEN2158"
></A ></A
><B ><B
>A.8.9. </B >A.8.9. </B
...@@ -2971,10 +3078,21 @@ CLASS="ANSWER" ...@@ -2971,10 +3078,21 @@ CLASS="ANSWER"
><P ><P
><B ><B
> </B > </B
> Delete everything from $BUZILLA_HOME/shadow. Bugzilla creates shadow > This should only happen with Bugzilla 2.14 if you are
files there, with each filename corresponding to a using the <SPAN
bug number. Also be sure to run syncshadowdb to make sure, if you are using CLASS="QUOTE"
a shadow database, that the shadow database is current. >"shadow database"</SPAN
> feature, and your
shadow database is out of sync. Try running
<TT
CLASS="FILENAME"
>syncshadowdb</TT
>
<TT
CLASS="OPTION"
>-syncall</TT
> to make sure your shadow
database is in synch with your primary database.
</P </P
></DIV ></DIV
></DIV ></DIV
...@@ -2992,7 +3110,7 @@ CLASS="QANDAENTRY" ...@@ -2992,7 +3110,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2056" NAME="AEN2168"
></A ></A
><B ><B
>A.9.1. </B >A.9.1. </B
...@@ -3015,7 +3133,7 @@ CLASS="QANDAENTRY" ...@@ -3015,7 +3133,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2061" NAME="AEN2173"
></A ></A
><B ><B
>A.9.2. </B >A.9.2. </B
...@@ -3039,7 +3157,7 @@ CLASS="QANDAENTRY" ...@@ -3039,7 +3157,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2066" NAME="AEN2178"
></A ></A
><B ><B
>A.9.3. </B >A.9.3. </B
...@@ -3060,7 +3178,7 @@ CLASS="ANSWER" ...@@ -3060,7 +3178,7 @@ CLASS="ANSWER"
><P ><P
> Microsoft has some advice on this matter, as well: > Microsoft has some advice on this matter, as well:
<A <A
NAME="AEN2071" NAME="AEN2183"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -3085,7 +3203,7 @@ CLASS="QANDAENTRY" ...@@ -3085,7 +3203,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2074" NAME="AEN2186"
></A ></A
><B ><B
>A.9.4. </B >A.9.4. </B
...@@ -3196,7 +3314,7 @@ CLASS="QANDAENTRY" ...@@ -3196,7 +3314,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2080" NAME="AEN2192"
></A ></A
><B ><B
>A.9.5. </B >A.9.5. </B
...@@ -3271,7 +3389,7 @@ CLASS="QANDAENTRY" ...@@ -3271,7 +3389,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2101" NAME="AEN2213"
></A ></A
><B ><B
>A.10.1. </B >A.10.1. </B
...@@ -3299,7 +3417,7 @@ CLASS="QANDAENTRY" ...@@ -3299,7 +3417,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2107" NAME="AEN2219"
></A ></A
><B ><B
>A.10.2. </B >A.10.2. </B
...@@ -3352,7 +3470,7 @@ CLASS="QANDAENTRY" ...@@ -3352,7 +3470,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2117" NAME="AEN2229"
></A ></A
><B ><B
>A.10.3. </B >A.10.3. </B
...@@ -3377,7 +3495,7 @@ CLASS="QANDAENTRY" ...@@ -3377,7 +3495,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2122" NAME="AEN2234"
></A ></A
><B ><B
>A.10.4. </B >A.10.4. </B
...@@ -3402,7 +3520,7 @@ CLASS="QANDAENTRY" ...@@ -3402,7 +3520,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2127" NAME="AEN2239"
></A ></A
><B ><B
>A.10.5. </B >A.10.5. </B
...@@ -3434,7 +3552,7 @@ CLASS="QANDAENTRY" ...@@ -3434,7 +3552,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2134" NAME="AEN2246"
></A ></A
><B ><B
>A.11.1. </B >A.11.1. </B
...@@ -3447,20 +3565,20 @@ CLASS="ANSWER" ...@@ -3447,20 +3565,20 @@ CLASS="ANSWER"
><B ><B
> </B > </B
> Try <A > Try <A
HREF="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Webtools&component=Bugzilla" HREF="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Bugzilla"
TARGET="_top" TARGET="_top"
> this link</A > this link</A
> to view current bugs or requests for > to view current bugs or requests for
enhancement for Bugzilla. enhancement for Bugzilla.
</P </P
><P ><P
> You can view bugs marked for 2.14 release > You can view bugs marked for 2.16 release
<A <A
HREF="http://bugzilla.mozilla.org/buglist.cgi?product=Webtools&component=Bugzilla&target_milestone=Bugzilla+2.14" HREF="http://bugzilla.mozilla.org/buglist.cgi?product=Bugzilla&target_milestone=Bugzilla+2.16"
TARGET="_top" TARGET="_top"
>here</A >here</A
>. >.
This list includes bugs for the 2.14 release that have already This list includes bugs for the 2.16 release that have already
been fixed and checked into CVS. Please consult the been fixed and checked into CVS. Please consult the
<A <A
HREF="http://www.mozilla.org/projects/bugzilla/" HREF="http://www.mozilla.org/projects/bugzilla/"
...@@ -3478,7 +3596,7 @@ CLASS="QANDAENTRY" ...@@ -3478,7 +3596,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2143" NAME="AEN2255"
></A ></A
><B ><B
>A.11.2. </B >A.11.2. </B
...@@ -3510,7 +3628,7 @@ CLASS="QANDAENTRY" ...@@ -3510,7 +3628,7 @@ CLASS="QANDAENTRY"
CLASS="QUESTION" CLASS="QUESTION"
><P ><P
><A ><A
NAME="AEN2149" NAME="AEN2261"
></A ></A
><B ><B
>A.11.3. </B >A.11.3. </B
...@@ -3528,8 +3646,15 @@ CLASS="ANSWER" ...@@ -3528,8 +3646,15 @@ CLASS="ANSWER"
TYPE="1" TYPE="1"
><LI ><LI
><P ><P
> Enter a bug into bugzilla.mozilla.org for the "Webtools" product, > Enter a bug into bugzilla.mozilla.org for the <SPAN
"Bugzilla" component. CLASS="QUOTE"
>"<A
HREF="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla"
TARGET="_top"
>Bugzilla</A
>"</SPAN
>
product.
</P </P
></LI ></LI
><LI ><LI
...@@ -3590,7 +3715,7 @@ WIDTH="33%" ...@@ -3590,7 +3715,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="future.html" HREF="variant_sourceforge.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -3615,7 +3740,7 @@ HREF="downloadlinks.html" ...@@ -3615,7 +3740,7 @@ HREF="downloadlinks.html"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>The Future of Bugzilla</TD >SourceForge</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
......
docs/html/future.html
View file @ 58593ba9
...@@ -13,8 +13,8 @@ REL="PREVIOUS" ...@@ -13,8 +13,8 @@ REL="PREVIOUS"
TITLE="Tinderbox/Tinderbox2" TITLE="Tinderbox/Tinderbox2"
HREF="tinderbox.html"><LINK HREF="tinderbox.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="The Bugzilla FAQ" TITLE="Bugzilla Variants and Competitors"
HREF="faq.html"></HEAD HREF="variants.html"></HEAD
><BODY ><BODY
CLASS="CHAPTER" CLASS="CHAPTER"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -54,7 +54,7 @@ WIDTH="10%" ...@@ -54,7 +54,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="faq.html" HREF="variants.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -85,11 +85,600 @@ CLASS="SYNOPSIS" ...@@ -85,11 +85,600 @@ CLASS="SYNOPSIS"
></TR ></TR
></TABLE ></TABLE
><P ><P
> The future of Bugzilla is Bugzilla 3.0. Unfortunately, I do > Bugzilla's future is a constantly-changing thing, as various developers
not have more information about it right now, and most of what <SPAN
went into the "future" section is now present. That stuff was CLASS="QUOTE"
blue-sky a year ago; MattyT should have me a new document >"scratch an itch"</SPAN
sometime... > 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"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Bugzilla&nbsp;Blue&nbsp;Sky<br>
<br>
Customisability<br>
<br>
&nbsp;&nbsp;&nbsp;One&nbsp;of&nbsp;the&nbsp;major&nbsp;stumbling&nbsp;blocks&nbsp;of&nbsp;Bugzilla&nbsp;has&nbsp;been&nbsp;that&nbsp;it&nbsp;is&nbsp;too<br>
&nbsp;&nbsp;&nbsp;rigid&nbsp;and&nbsp;does&nbsp;not&nbsp;adapt&nbsp;itself&nbsp;well&nbsp;enough&nbsp;to&nbsp;the&nbsp;needs&nbsp;of&nbsp;an<br>
&nbsp;&nbsp;&nbsp;organisation.&nbsp;&nbsp;This&nbsp;has&nbsp;led&nbsp;to&nbsp;organisations&nbsp;making&nbsp;changes&nbsp;to&nbsp;the<br>
&nbsp;&nbsp;&nbsp;Bugzilla&nbsp;code&nbsp;that&nbsp;need&nbsp;to&nbsp;be&nbsp;redone&nbsp;each&nbsp;new&nbsp;version&nbsp;of&nbsp;Bugzilla.<br>
&nbsp;&nbsp;&nbsp;Bugzilla&nbsp;should&nbsp;attempt&nbsp;to&nbsp;move&nbsp;away&nbsp;from&nbsp;this&nbsp;to&nbsp;a&nbsp;world&nbsp;where&nbsp;this<br>
&nbsp;&nbsp;&nbsp;doesn't&nbsp;need&nbsp;to&nbsp;occur.<br>
<br>
&nbsp;&nbsp;&nbsp;Most&nbsp;of&nbsp;the&nbsp;subsections&nbsp;in&nbsp;this&nbsp;section&nbsp;are&nbsp;currently&nbsp;explicit&nbsp;design<br>
&nbsp;&nbsp;&nbsp;goals&nbsp;for&nbsp;the&nbsp;"Bugzilla&nbsp;3"&nbsp;rewrite.&nbsp;&nbsp;This&nbsp;does&nbsp;not&nbsp;necessarily&nbsp;mean<br>
&nbsp;&nbsp;&nbsp;that&nbsp;they&nbsp;will&nbsp;not&nbsp;occur&nbsp;before&nbsp;them&nbsp;in&nbsp;Bugzilla&nbsp;2,&nbsp;but&nbsp;most&nbsp;are<br>
&nbsp;&nbsp;&nbsp;significant&nbsp;undertakings.<br>
<br>
&nbsp;&nbsp;Field&nbsp;Customisation<br>
<br>
&nbsp;&nbsp;&nbsp;Many&nbsp;installations&nbsp;wish&nbsp;to&nbsp;customise&nbsp;the&nbsp;fields&nbsp;that&nbsp;appear&nbsp;on&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;reports.&nbsp;&nbsp;&nbsp;Current&nbsp;versions&nbsp;of&nbsp;Bugzilla&nbsp;offer&nbsp;limited<br>
&nbsp;&nbsp;&nbsp;customisability.&nbsp;&nbsp;In&nbsp;particular,&nbsp;some&nbsp;fields&nbsp;can&nbsp;be&nbsp;turned&nbsp;off.<br>
<br>
&nbsp;&nbsp;&nbsp;However,&nbsp;many&nbsp;administrators&nbsp;wish&nbsp;to&nbsp;add&nbsp;their&nbsp;own&nbsp;fields,&nbsp;and&nbsp;rename<br>
&nbsp;&nbsp;&nbsp;or&nbsp;otherwise&nbsp;modify&nbsp;existing&nbsp;fields.&nbsp;&nbsp;An&nbsp;architecture&nbsp;that&nbsp;supports<br>
&nbsp;&nbsp;&nbsp;this&nbsp;would&nbsp;be&nbsp;extraordinarily&nbsp;useful.<br>
<br>
&nbsp;&nbsp;&nbsp;Indeed,&nbsp;many&nbsp;fields&nbsp;work&nbsp;similarly&nbsp;and&nbsp;could&nbsp;be&nbsp;abstracted&nbsp;into&nbsp;"field<br>
&nbsp;&nbsp;&nbsp;types",&nbsp;so&nbsp;that&nbsp;an&nbsp;administrator&nbsp;need&nbsp;write&nbsp;little&nbsp;or&nbsp;no&nbsp;code&nbsp;to<br>
&nbsp;&nbsp;&nbsp;support&nbsp;the&nbsp;new&nbsp;fields&nbsp;they&nbsp;desire.<br>
<br>
&nbsp;&nbsp;&nbsp;Possible&nbsp;field&nbsp;types&nbsp;include&nbsp;text&nbsp;(eg&nbsp;status&nbsp;whiteboard),&nbsp;numbers,<br>
&nbsp;&nbsp;&nbsp;dates&nbsp;(eg&nbsp;report&nbsp;time),&nbsp;accounts&nbsp;(eg&nbsp;reporter,&nbsp;qa,&nbsp;cc),&nbsp;inter-bug<br>
&nbsp;&nbsp;&nbsp;relationships&nbsp;(dependencies,&nbsp;duplicates),&nbsp;option&nbsp;groups&nbsp;(platform,&nbsp;os,<br>
&nbsp;&nbsp;&nbsp;severity,&nbsp;priority,&nbsp;target&nbsp;milestone,&nbsp;version)&nbsp;etc.<br>
<br>
&nbsp;&nbsp;&nbsp;Ideally&nbsp;an&nbsp;administrator&nbsp;could&nbsp;configure&nbsp;their&nbsp;fields&nbsp;through&nbsp;a<br>
&nbsp;&nbsp;&nbsp;Bugzilla&nbsp;interface&nbsp;that&nbsp;requires&nbsp;no&nbsp;code&nbsp;to&nbsp;be&nbsp;added.&nbsp;&nbsp;However,&nbsp;it&nbsp;is<br>
&nbsp;&nbsp;&nbsp;highly&nbsp;unlikely&nbsp;this&nbsp;ideal&nbsp;will&nbsp;never&nbsp;be&nbsp;met,&nbsp;and&nbsp;in&nbsp;a&nbsp;similar&nbsp;way<br>
&nbsp;&nbsp;&nbsp;that&nbsp;office&nbsp;applications&nbsp;have&nbsp;scripting&nbsp;languages,&nbsp;Bugzilla&nbsp;should<br>
&nbsp;&nbsp;&nbsp;allow&nbsp;new&nbsp;field&nbsp;types&nbsp;to&nbsp;be&nbsp;written.<br>
<br>
&nbsp;&nbsp;&nbsp;Similarly,&nbsp;a&nbsp;common&nbsp;desire&nbsp;is&nbsp;for&nbsp;resolutions&nbsp;to&nbsp;be&nbsp;added&nbsp;or&nbsp;removed.<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Allocations<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Option&nbsp;Groups<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Relations<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
&nbsp;&nbsp;Database&nbsp;Integrity<br>
<br>
&nbsp;&nbsp;&nbsp;Furthermore,&nbsp;it&nbsp;is&nbsp;desirable&nbsp;for&nbsp;administrators&nbsp;to&nbsp;be&nbsp;able&nbsp;to&nbsp;specify<br>
&nbsp;&nbsp;&nbsp;rules&nbsp;that&nbsp;must&nbsp;or&nbsp;should&nbsp;apply&nbsp;between&nbsp;the&nbsp;fields&nbsp;on&nbsp;a&nbsp;bug&nbsp;report.<br>
<br>
&nbsp;&nbsp;&nbsp;For&nbsp;example,&nbsp;you&nbsp;might&nbsp;wish&nbsp;to&nbsp;specify&nbsp;that&nbsp;a&nbsp;bug&nbsp;with&nbsp;status&nbsp;ASSIGNED<br>
&nbsp;&nbsp;&nbsp;must&nbsp;have&nbsp;a&nbsp;target&nbsp;milestone&nbsp;field&nbsp;that&nbsp;that&nbsp;is&nbsp;not&nbsp;untargetted.&nbsp;&nbsp;Or<br>
&nbsp;&nbsp;&nbsp;that&nbsp;a&nbsp;bug&nbsp;with&nbsp;a&nbsp;certain&nbsp;number&nbsp;of&nbsp;votes&nbsp;should&nbsp;get&nbsp;ASSIGNED.&nbsp;&nbsp;Or<br>
&nbsp;&nbsp;&nbsp;that&nbsp;the&nbsp;QA&nbsp;contact&nbsp;must&nbsp;be&nbsp;different&nbsp;from&nbsp;the&nbsp;assignee.<br>
<br>
&nbsp;&nbsp;&nbsp;"Must"&nbsp;relationships&nbsp;could&nbsp;be&nbsp;implemented&nbsp;by&nbsp;refusing&nbsp;to&nbsp;make&nbsp;changes<br>
&nbsp;&nbsp;&nbsp;that&nbsp;violate&nbsp;the&nbsp;relationships,&nbsp;or&nbsp;alternatively,&nbsp;automatically<br>
&nbsp;&nbsp;&nbsp;updating&nbsp;certain&nbsp;fields&nbsp;in&nbsp;order&nbsp;to&nbsp;satisfy&nbsp;the&nbsp;criteria.&nbsp;&nbsp;Which<br>
&nbsp;&nbsp;&nbsp;occurs&nbsp;should&nbsp;be&nbsp;up&nbsp;to&nbsp;the&nbsp;administrator.<br>
<br>
&nbsp;&nbsp;&nbsp;"Should"&nbsp;relationships&nbsp;could&nbsp;be&nbsp;implemented&nbsp;by&nbsp;a&nbsp;combination&nbsp;of<br>
&nbsp;&nbsp;&nbsp;emitting&nbsp;warnings&nbsp;on&nbsp;the&nbsp;process&nbsp;bug&nbsp;page,&nbsp;the&nbsp;same&nbsp;on&nbsp;notification<br>
&nbsp;&nbsp;&nbsp;mails,&nbsp;or&nbsp;emitting&nbsp;periodic&nbsp;whine&nbsp;mails&nbsp;about&nbsp;the&nbsp;situation.&nbsp;&nbsp;Again,<br>
&nbsp;&nbsp;&nbsp;which&nbsp;occurs&nbsp;should&nbsp;be&nbsp;up&nbsp;to&nbsp;the&nbsp;administrator.<br>
<br>
&nbsp;&nbsp;&nbsp;It&nbsp;should&nbsp;also&nbsp;be&nbsp;possible&nbsp;for&nbsp;whine&nbsp;mails&nbsp;to&nbsp;be&nbsp;emitted&nbsp;for&nbsp;"must"<br>
&nbsp;&nbsp;&nbsp;relationships,&nbsp;as&nbsp;they&nbsp;might&nbsp;become&nbsp;violated&nbsp;through&nbsp;direct&nbsp;database<br>
&nbsp;&nbsp;&nbsp;access,&nbsp;Bugzilla&nbsp;bugs,&nbsp;or&nbsp;because&nbsp;they&nbsp;were&nbsp;there&nbsp;before&nbsp;the<br>
&nbsp;&nbsp;&nbsp;relationship&nbsp;was&nbsp;enforced.<br>
<br>
&nbsp;&nbsp;&nbsp;As&nbsp;well&nbsp;as&nbsp;implementing&nbsp;intra-bug&nbsp;constraints,&nbsp;it&nbsp;would&nbsp;be&nbsp;useful&nbsp;to<br>
&nbsp;&nbsp;&nbsp;create&nbsp;inter-bug&nbsp;constraints.&nbsp;&nbsp;For&nbsp;example,&nbsp;a&nbsp;bug&nbsp;that&nbsp;is&nbsp;dependent&nbsp;on<br>
&nbsp;&nbsp;&nbsp;another&nbsp;bug&nbsp;should&nbsp;not&nbsp;have&nbsp;an&nbsp;earlier&nbsp;milestone&nbsp;or&nbsp;greater&nbsp;priority<br>
&nbsp;&nbsp;&nbsp;than&nbsp;that&nbsp;bug.<br>
<br>
&nbsp;&nbsp;Database&nbsp;Adaptability<br>
<br>
&nbsp;&nbsp;&nbsp;Often&nbsp;an&nbsp;administrator&nbsp;desires&nbsp;that&nbsp;fields&nbsp;adapt&nbsp;to&nbsp;the&nbsp;values&nbsp;of<br>
&nbsp;&nbsp;&nbsp;other&nbsp;fields.&nbsp;&nbsp;For&nbsp;example,&nbsp;the&nbsp;value&nbsp;of&nbsp;a&nbsp;field&nbsp;might&nbsp;determine&nbsp;the<br>
&nbsp;&nbsp;&nbsp;possible&nbsp;values&nbsp;of&nbsp;another&nbsp;field&nbsp;or&nbsp;even&nbsp;whether&nbsp;it&nbsp;appears&nbsp;(whether<br>
&nbsp;&nbsp;&nbsp;it&nbsp;is&nbsp;"applicable").<br>
<br>
&nbsp;&nbsp;&nbsp;Limited&nbsp;adaptability&nbsp;is&nbsp;present&nbsp;in&nbsp;Bugzilla&nbsp;2,&nbsp;and&nbsp;only&nbsp;on&nbsp;the<br>
&nbsp;&nbsp;&nbsp;"Product"&nbsp;field:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;The&nbsp;possible&nbsp;values&nbsp;of&nbsp;the&nbsp;target&nbsp;milestone,&nbsp;version&nbsp;and&nbsp;component<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fields&nbsp;depend&nbsp;on&nbsp;the&nbsp;product.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;UNCONFIRMED&nbsp;can&nbsp;be&nbsp;turned&nbsp;off&nbsp;for&nbsp;specific&nbsp;products.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Voting&nbsp;can&nbsp;be&nbsp;configured&nbsp;differently&nbsp;or&nbsp;turned&nbsp;off&nbsp;for&nbsp;different<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;products,&nbsp;and&nbsp;there&nbsp;is&nbsp;a&nbsp;separate&nbsp;user&nbsp;vote&nbsp;limits&nbsp;for&nbsp;each<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;product.<br>
<br>
&nbsp;&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;good&nbsp;if&nbsp;more&nbsp;adaptability&nbsp;was&nbsp;present,&nbsp;both&nbsp;in&nbsp;terms&nbsp;of<br>
&nbsp;&nbsp;&nbsp;all&nbsp;fields&nbsp;relying&nbsp;on&nbsp;the&nbsp;product,&nbsp;as&nbsp;well&nbsp;as&nbsp;the&nbsp;ability&nbsp;to&nbsp;adapt<br>
&nbsp;&nbsp;&nbsp;based&nbsp;on&nbsp;the&nbsp;value&nbsp;of&nbsp;all&nbsp;fields.<br>
<br>
&nbsp;&nbsp;&nbsp;Example&nbsp;???<br>
<br>
&nbsp;&nbsp;&nbsp;General&nbsp;adaptability&nbsp;raises&nbsp;the&nbsp;issue&nbsp;of&nbsp;circular&nbsp;references&nbsp;between<br>
&nbsp;&nbsp;&nbsp;fields&nbsp;causing&nbsp;problems.&nbsp;&nbsp;One&nbsp;possible&nbsp;solution&nbsp;to&nbsp;this&nbsp;is&nbsp;to&nbsp;place<br>
&nbsp;&nbsp;&nbsp;the&nbsp;fields&nbsp;in&nbsp;a&nbsp;total&nbsp;ordering&nbsp;and&nbsp;require&nbsp;a&nbsp;field&nbsp;refer&nbsp;only&nbsp;to&nbsp;the<br>
&nbsp;&nbsp;&nbsp;previous&nbsp;fields.<br>
<br>
&nbsp;&nbsp;&nbsp;In&nbsp;Bugzilla&nbsp;2,&nbsp;changing&nbsp;the&nbsp;product&nbsp;of&nbsp;a&nbsp;bug&nbsp;meant&nbsp;a&nbsp;second&nbsp;page&nbsp;would<br>
&nbsp;&nbsp;&nbsp;appear&nbsp;that&nbsp;allowed&nbsp;you&nbsp;to&nbsp;choose&nbsp;a&nbsp;new&nbsp;milestone,&nbsp;component&nbsp;and<br>
&nbsp;&nbsp;&nbsp;version,&nbsp;as&nbsp;those&nbsp;fields&nbsp;adapted&nbsp;themselves&nbsp;to&nbsp;the&nbsp;new&nbsp;product.&nbsp;&nbsp;This<br>
&nbsp;&nbsp;&nbsp;page&nbsp;could&nbsp;be&nbsp;generalised&nbsp;to&nbsp;support&nbsp;all&nbsp;instances&nbsp;where:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;a&nbsp;field&nbsp;value&nbsp;must&nbsp;or&nbsp;might&nbsp;be&nbsp;changed&nbsp;because&nbsp;the&nbsp;possible&nbsp;values<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;have&nbsp;changed<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;is&nbsp;going&nbsp;to&nbsp;drop&nbsp;off&nbsp;because&nbsp;it&nbsp;it&nbsp;is&nbsp;no&nbsp;longer&nbsp;applicable,&nbsp;and<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;this&nbsp;should&nbsp;be&nbsp;confirmed<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;must&nbsp;be&nbsp;specified&nbsp;because&nbsp;it&nbsp;is&nbsp;suddenly&nbsp;applicable,&nbsp;and&nbsp;the<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;default&nbsp;value,&nbsp;if&nbsp;one&nbsp;exists,&nbsp;might&nbsp;not&nbsp;be&nbsp;acceptable<br>
<br>
&nbsp;&nbsp;Database&nbsp;Independence<br>
<br>
&nbsp;&nbsp;&nbsp;Currently&nbsp;Bugzilla&nbsp;only&nbsp;runs&nbsp;on&nbsp;the&nbsp;MySQL&nbsp;database.&nbsp;&nbsp;It&nbsp;would&nbsp;be<br>
&nbsp;&nbsp;&nbsp;desirable&nbsp;for&nbsp;Bugzilla&nbsp;to&nbsp;run&nbsp;on&nbsp;other&nbsp;databases,&nbsp;because:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Organisations&nbsp;may&nbsp;have&nbsp;existing&nbsp;database&nbsp;products&nbsp;they&nbsp;use&nbsp;and<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;would&nbsp;prefer&nbsp;to&nbsp;run&nbsp;a&nbsp;homogenous&nbsp;environment.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Databases&nbsp;each&nbsp;have&nbsp;their&nbsp;own&nbsp;shortcomings,&nbsp;including&nbsp;MySQL.&nbsp;&nbsp;An<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;administrator&nbsp;might&nbsp;choose&nbsp;a&nbsp;database&nbsp;that&nbsp;would&nbsp;work&nbsp;better&nbsp;with<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;their&nbsp;Bugzilla.<br>
<br>
&nbsp;&nbsp;&nbsp;This&nbsp;raises&nbsp;the&nbsp;possibility&nbsp;that&nbsp;we&nbsp;could&nbsp;use&nbsp;features&nbsp;that&nbsp;are&nbsp;only<br>
&nbsp;&nbsp;&nbsp;present&nbsp;in&nbsp;some&nbsp;databases,&nbsp;by&nbsp;appropriately&nbsp;falling&nbsp;back.&nbsp;&nbsp;For<br>
&nbsp;&nbsp;&nbsp;example,&nbsp;in&nbsp;the&nbsp;MySQL&nbsp;world,&nbsp;we&nbsp;live&nbsp;without:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;record-level&nbsp;locking,&nbsp;instead&nbsp;we&nbsp;use&nbsp;table-level&nbsp;locking<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;referential&nbsp;and&nbsp;record&nbsp;constraints,&nbsp;instead&nbsp;we&nbsp;checking&nbsp;code<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;subselects,&nbsp;instead&nbsp;we&nbsp;use&nbsp;multiple&nbsp;queries&nbsp;and&nbsp;redundant&nbsp;"caches"<br>
<br>
&nbsp;&nbsp;Multiple&nbsp;Front&nbsp;Ends<br>
<br>
&nbsp;&nbsp;&nbsp;Currently&nbsp;Bugzilla&nbsp;is&nbsp;manipulated&nbsp;via&nbsp;the&nbsp;Web,&nbsp;and&nbsp;notifies&nbsp;via<br>
&nbsp;&nbsp;&nbsp;E-Mail.&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;desirable&nbsp;for&nbsp;Bugzilla&nbsp;to&nbsp;easily&nbsp;support&nbsp;various<br>
&nbsp;&nbsp;&nbsp;front&nbsp;ends.<br>
<br>
&nbsp;&nbsp;&nbsp;There&nbsp;is&nbsp;no&nbsp;reason&nbsp;that&nbsp;Bugzilla&nbsp;could&nbsp;not&nbsp;be&nbsp;controlled&nbsp;via&nbsp;a&nbsp;whole<br>
&nbsp;&nbsp;&nbsp;range&nbsp;of&nbsp;front&nbsp;ends,&nbsp;including&nbsp;Web,&nbsp;E-Mail,&nbsp;IRC,&nbsp;ICQ,&nbsp;etc,&nbsp;and<br>
&nbsp;&nbsp;&nbsp;similarly&nbsp;for&nbsp;how&nbsp;it&nbsp;notifies.&nbsp;&nbsp;It's&nbsp;also&nbsp;possible&nbsp;that&nbsp;we&nbsp;could<br>
&nbsp;&nbsp;&nbsp;introduce&nbsp;a&nbsp;special&nbsp;Bugzilla&nbsp;client&nbsp;that&nbsp;uses&nbsp;its&nbsp;own&nbsp;protocol,&nbsp;for<br>
&nbsp;&nbsp;&nbsp;maximum&nbsp;user&nbsp;productivity.<br>
<br>
&nbsp;&nbsp;&nbsp;Indeed&nbsp;a&nbsp;request&nbsp;reply&nbsp;might&nbsp;be&nbsp;returned&nbsp;via&nbsp;a&nbsp;totally&nbsp;different<br>
&nbsp;&nbsp;&nbsp;transport&nbsp;method&nbsp;than&nbsp;was&nbsp;use&nbsp;to&nbsp;submit&nbsp;the&nbsp;request.<br>
<br>
Internationalisation<br>
<br>
&nbsp;&nbsp;&nbsp;Bugzilla&nbsp;currently&nbsp;supports&nbsp;only&nbsp;English.&nbsp;&nbsp;All&nbsp;of&nbsp;the&nbsp;field&nbsp;names,<br>
&nbsp;&nbsp;&nbsp;user&nbsp;instructions,&nbsp;etc&nbsp;are&nbsp;written&nbsp;in&nbsp;English.&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;desirable<br>
&nbsp;&nbsp;&nbsp;to&nbsp;allow&nbsp;"language&nbsp;packs"&nbsp;so&nbsp;Bugzilla&nbsp;can&nbsp;be&nbsp;easily&nbsp;used&nbsp;in<br>
&nbsp;&nbsp;&nbsp;non-English&nbsp;speaking&nbsp;locales.<br>
<br>
&nbsp;&nbsp;&nbsp;To&nbsp;a&nbsp;degree&nbsp;field&nbsp;customisation&nbsp;supports&nbsp;this,&nbsp;because&nbsp;administrators<br>
&nbsp;&nbsp;&nbsp;could&nbsp;specify&nbsp;their&nbsp;own&nbsp;fields&nbsp;names&nbsp;anyway.&nbsp;&nbsp;However,&nbsp;there&nbsp;will<br>
&nbsp;&nbsp;&nbsp;always&nbsp;be&nbsp;some&nbsp;basic&nbsp;facilities&nbsp;not&nbsp;covered&nbsp;by&nbsp;this,&nbsp;and&nbsp;it&nbsp;is<br>
&nbsp;&nbsp;&nbsp;desirable&nbsp;that&nbsp;the&nbsp;administrator's&nbsp;interface&nbsp;also&nbsp;is<br>
&nbsp;&nbsp;&nbsp;internationalisable.<br>
<br>
Better&nbsp;Searching<br>
<br>
&nbsp;&nbsp;General&nbsp;Summary&nbsp;Reports<br>
<br>
&nbsp;&nbsp;&nbsp;Sometimes,&nbsp;the&nbsp;normal&nbsp;querying&nbsp;page&nbsp;leaves&nbsp;a&nbsp;lot&nbsp;to&nbsp;be&nbsp;desired.&nbsp;&nbsp;There<br>
&nbsp;&nbsp;&nbsp;are&nbsp;other&nbsp;facilities&nbsp;already&nbsp;in&nbsp;place&nbsp;or&nbsp;which&nbsp;people&nbsp;have&nbsp;asked&nbsp;for:<br>
<br>
&nbsp;&nbsp;&nbsp;Most&nbsp;Doomed&nbsp;Reports&nbsp;-&nbsp;All&nbsp;Bugs&nbsp;or&nbsp;All&nbsp;Bugs&nbsp;In&nbsp;A&nbsp;Product,&nbsp;Categorised<br>
&nbsp;&nbsp;&nbsp;On&nbsp;Assignee,&nbsp;Shows&nbsp;and&nbsp;Counts&nbsp;Number&nbsp;of&nbsp;Bugs&nbsp;For&nbsp;Each&nbsp;Assignee<br>
&nbsp;&nbsp;&nbsp;Most&nbsp;Voted&nbsp;For&nbsp;Bugs&nbsp;-&nbsp;All&nbsp;Bugs,&nbsp;Categorised&nbsp;On&nbsp;Product,&nbsp;Shows&nbsp;Top&nbsp;Ten<br>
&nbsp;&nbsp;&nbsp;Bugs&nbsp;Voters&nbsp;Most&nbsp;Want&nbsp;Fixed<br>
&nbsp;&nbsp;&nbsp;Number&nbsp;of&nbsp;Open&nbsp;Bugs&nbsp;For&nbsp;An&nbsp;Assignee&nbsp;-&nbsp;Bug&nbsp;List,&nbsp;Categorised&nbsp;On<br>
&nbsp;&nbsp;&nbsp;Developers,&nbsp;Counts&nbsp;Number&nbsp;of&nbsp;Bugs&nbsp;In&nbsp;Category<br>
<br>
&nbsp;&nbsp;&nbsp;The&nbsp;important&nbsp;thing&nbsp;to&nbsp;realise&nbsp;is&nbsp;that&nbsp;people&nbsp;want&nbsp;categorised&nbsp;reports<br>
&nbsp;&nbsp;&nbsp;on&nbsp;all&nbsp;sorts&nbsp;of&nbsp;things&nbsp;-&nbsp;a&nbsp;general&nbsp;summary&nbsp;report.<br>
<br>
&nbsp;&nbsp;&nbsp;In&nbsp;a&nbsp;categorised&nbsp;report,&nbsp;you&nbsp;choose&nbsp;the&nbsp;subset&nbsp;of&nbsp;bugs&nbsp;you&nbsp;wish&nbsp;to<br>
&nbsp;&nbsp;&nbsp;operate&nbsp;on&nbsp;(similar&nbsp;to&nbsp;how&nbsp;you&nbsp;would&nbsp;specify&nbsp;a&nbsp;query),&nbsp;and&nbsp;then<br>
&nbsp;&nbsp;&nbsp;categorise&nbsp;them&nbsp;on&nbsp;one&nbsp;or&nbsp;more&nbsp;fields.<br>
<br>
&nbsp;&nbsp;&nbsp;For&nbsp;each&nbsp;category&nbsp;you&nbsp;display&nbsp;the&nbsp;count&nbsp;of&nbsp;the&nbsp;number&nbsp;of&nbsp;things&nbsp;in<br>
&nbsp;&nbsp;&nbsp;that&nbsp;category.&nbsp;&nbsp;You&nbsp;can&nbsp;optionally&nbsp;display&nbsp;the&nbsp;bugs&nbsp;themselves,&nbsp;or<br>
&nbsp;&nbsp;&nbsp;leave&nbsp;them&nbsp;out,&nbsp;just&nbsp;showing&nbsp;the&nbsp;counts.&nbsp;&nbsp;And&nbsp;you&nbsp;can&nbsp;optionally&nbsp;limit<br>
&nbsp;&nbsp;&nbsp;the&nbsp;number&nbsp;of&nbsp;things&nbsp;(bugs&nbsp;or&nbsp;subcategories)&nbsp;that&nbsp;display&nbsp;in&nbsp;each<br>
&nbsp;&nbsp;&nbsp;category.<br>
<br>
&nbsp;&nbsp;&nbsp;Such&nbsp;a&nbsp;mechanism&nbsp;would&nbsp;let&nbsp;you&nbsp;do&nbsp;all&nbsp;of&nbsp;the&nbsp;above&nbsp;and&nbsp;more.<br>
&nbsp;&nbsp;&nbsp;Applications&nbsp;of&nbsp;this&nbsp;mechanism&nbsp;would&nbsp;only&nbsp;be&nbsp;recognised&nbsp;once&nbsp;it&nbsp;was<br>
&nbsp;&nbsp;&nbsp;implemented.<br>
<br>
&nbsp;&nbsp;Related&nbsp;Bugs<br>
<br>
&nbsp;&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;nice&nbsp;to&nbsp;have&nbsp;a&nbsp;field&nbsp;where&nbsp;you&nbsp;could&nbsp;enter&nbsp;other&nbsp;bugs<br>
&nbsp;&nbsp;&nbsp;related&nbsp;to&nbsp;the&nbsp;current&nbsp;bug.&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;handy&nbsp;for&nbsp;navigation&nbsp;and<br>
&nbsp;&nbsp;&nbsp;possibly&nbsp;even&nbsp;finding&nbsp;duplicates.<br>
<br>
&nbsp;&nbsp;Column&nbsp;Specification&nbsp;Support<br>
<br>
&nbsp;&nbsp;&nbsp;Currently&nbsp;bug&nbsp;lists&nbsp;use&nbsp;the&nbsp;columns&nbsp;that&nbsp;you&nbsp;last&nbsp;used.&nbsp;&nbsp;This&nbsp;doesn't<br>
&nbsp;&nbsp;&nbsp;work&nbsp;well&nbsp;for&nbsp;"prepackaged&nbsp;queries",&nbsp;where&nbsp;you&nbsp;followed&nbsp;a&nbsp;link.&nbsp;&nbsp;You<br>
&nbsp;&nbsp;&nbsp;can&nbsp;probably&nbsp;add&nbsp;a&nbsp;column&nbsp;by&nbsp;specifying&nbsp;a&nbsp;sort&nbsp;column,&nbsp;but&nbsp;this&nbsp;is<br>
&nbsp;&nbsp;&nbsp;difficult&nbsp;and&nbsp;suboptimal.<br>
<br>
&nbsp;&nbsp;&nbsp;Furthermore,&nbsp;I&nbsp;find&nbsp;that&nbsp;when&nbsp;I&nbsp;want&nbsp;to&nbsp;add&nbsp;a&nbsp;column&nbsp;to&nbsp;a&nbsp;bug&nbsp;list,<br>
&nbsp;&nbsp;&nbsp;it's&nbsp;usually&nbsp;a&nbsp;one&nbsp;off&nbsp;and&nbsp;I&nbsp;would&nbsp;prefer&nbsp;it&nbsp;to&nbsp;go&nbsp;away&nbsp;for&nbsp;the&nbsp;next<br>
&nbsp;&nbsp;&nbsp;query.&nbsp;&nbsp;Hence,&nbsp;it&nbsp;would&nbsp;be&nbsp;nice&nbsp;to&nbsp;specify&nbsp;the&nbsp;columns&nbsp;that&nbsp;appear&nbsp;on<br>
&nbsp;&nbsp;&nbsp;the&nbsp;bug&nbsp;list&nbsp;(and&nbsp;general&nbsp;summary&nbsp;report)&nbsp;pages.&nbsp;&nbsp;The&nbsp;default&nbsp;query<br>
&nbsp;&nbsp;&nbsp;mechanism&nbsp;should&nbsp;be&nbsp;able&nbsp;to&nbsp;let&nbsp;you&nbsp;specify&nbsp;your&nbsp;default&nbsp;columns.<br>
<br>
&nbsp;&nbsp;Advanced&nbsp;Querying&nbsp;Redesign<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
Keywords<br>
<br>
&nbsp;&nbsp;&nbsp;People&nbsp;have&nbsp;a&nbsp;need&nbsp;to&nbsp;apply&nbsp;tags&nbsp;to&nbsp;bugs.&nbsp;&nbsp;In&nbsp;the&nbsp;beginning,&nbsp;people<br>
&nbsp;&nbsp;&nbsp;placed&nbsp;designators&nbsp;in&nbsp;the&nbsp;summary&nbsp;and&nbsp;status&nbsp;whiteboard.&nbsp;&nbsp;However,<br>
&nbsp;&nbsp;&nbsp;these&nbsp;fields&nbsp;were&nbsp;not&nbsp;designed&nbsp;for&nbsp;that,&nbsp;and&nbsp;so&nbsp;there&nbsp;were&nbsp;many&nbsp;flaws<br>
&nbsp;&nbsp;&nbsp;with&nbsp;this&nbsp;system:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;They&nbsp;pollute&nbsp;the&nbsp;field&nbsp;with&nbsp;information&nbsp;that&nbsp;was&nbsp;never&nbsp;intended&nbsp;to<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;be&nbsp;present.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Removing&nbsp;them&nbsp;with&nbsp;a&nbsp;bulk&nbsp;change&nbsp;is&nbsp;a&nbsp;difficult&nbsp;problem&nbsp;that&nbsp;has<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;too&nbsp;many&nbsp;pitfalls&nbsp;to&nbsp;implement.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;You&nbsp;can&nbsp;easily&nbsp;get&nbsp;the&nbsp;capitalisation&nbsp;wrong.<br>
<br>
&nbsp;&nbsp;&nbsp;Then&nbsp;dependencies&nbsp;were&nbsp;introduced&nbsp;(when?),&nbsp;and&nbsp;people&nbsp;realised&nbsp;that<br>
&nbsp;&nbsp;&nbsp;they&nbsp;could&nbsp;use&nbsp;them&nbsp;for&nbsp;"tracking&nbsp;bugs".&nbsp;&nbsp;Again,&nbsp;dependencies&nbsp;were&nbsp;not<br>
&nbsp;&nbsp;&nbsp;designed&nbsp;for&nbsp;that,&nbsp;and&nbsp;so&nbsp;there&nbsp;were&nbsp;more&nbsp;flaws,&nbsp;albeit&nbsp;different<br>
&nbsp;&nbsp;&nbsp;ones,&nbsp;including:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;They&nbsp;aren't&nbsp;really&nbsp;bugs,&nbsp;so&nbsp;it's&nbsp;difficult&nbsp;to&nbsp;distinguish&nbsp;issues<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;from&nbsp;bugs.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;They&nbsp;can&nbsp;pollute&nbsp;bugs&nbsp;counts,&nbsp;and&nbsp;you&nbsp;must&nbsp;somehow&nbsp;exclude&nbsp;them<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;from&nbsp;queries.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;There&nbsp;is&nbsp;a&nbsp;whole&nbsp;lot&nbsp;of&nbsp;useless&nbsp;information&nbsp;on&nbsp;them.&nbsp;&nbsp;They&nbsp;have&nbsp;an<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assignee&nbsp;but&nbsp;there&nbsp;is&nbsp;nothing&nbsp;to&nbsp;fix,&nbsp;and&nbsp;that&nbsp;person&nbsp;can&nbsp;get<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;whined&nbsp;at&nbsp;by&nbsp;Bugzilla.&nbsp;&nbsp;They&nbsp;have&nbsp;target&nbsp;milestones&nbsp;which&nbsp;must&nbsp;be<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;manually&nbsp;maintained.&nbsp;&nbsp;And&nbsp;so&nbsp;on.<br>
<br>
&nbsp;&nbsp;&nbsp;Finally,&nbsp;keywords&nbsp;were&nbsp;introduced&nbsp;(when?)&nbsp;for&nbsp;this&nbsp;purpose&nbsp;to&nbsp;remove<br>
&nbsp;&nbsp;&nbsp;the&nbsp;need&nbsp;for&nbsp;these&nbsp;two&nbsp;systems.&nbsp;&nbsp;Unfortunately,&nbsp;the&nbsp;simple&nbsp;keywords<br>
&nbsp;&nbsp;&nbsp;implementation&nbsp;was&nbsp;itself&nbsp;lacking&nbsp;in&nbsp;certain&nbsp;features&nbsp;provided&nbsp;by&nbsp;the<br>
&nbsp;&nbsp;&nbsp;two&nbsp;previous&nbsp;systems,&nbsp;and&nbsp;has&nbsp;remained&nbsp;almost&nbsp;unchanged&nbsp;since&nbsp;its<br>
&nbsp;&nbsp;&nbsp;inception.&nbsp;&nbsp;Furthermore,&nbsp;it&nbsp;could&nbsp;not&nbsp;be&nbsp;forseen&nbsp;that&nbsp;in&nbsp;large<br>
&nbsp;&nbsp;&nbsp;installations,&nbsp;the&nbsp;sheer&nbsp;number&nbsp;of&nbsp;keywords&nbsp;could&nbsp;become&nbsp;unwieldly&nbsp;and<br>
&nbsp;&nbsp;&nbsp;could&nbsp;lead&nbsp;to&nbsp;a&nbsp;movement&nbsp;back&nbsp;to&nbsp;the&nbsp;other&nbsp;systems.<br>
<br>
&nbsp;&nbsp;&nbsp;The&nbsp;keywords&nbsp;system&nbsp;was&nbsp;the&nbsp;right&nbsp;idea,&nbsp;however,&nbsp;and&nbsp;it&nbsp;remains&nbsp;so.<br>
&nbsp;&nbsp;&nbsp;Fixing&nbsp;the&nbsp;keywords&nbsp;system&nbsp;is&nbsp;one&nbsp;of&nbsp;the&nbsp;most&nbsp;important&nbsp;Bugzilla<br>
&nbsp;&nbsp;&nbsp;issues.<br>
<br>
&nbsp;&nbsp;Bringing&nbsp;Keywords&nbsp;Up&nbsp;To&nbsp;Par<br>
<br>
&nbsp;&nbsp;&nbsp;For&nbsp;the&nbsp;most&nbsp;part,&nbsp;keywords&nbsp;are&nbsp;very&nbsp;good&nbsp;at&nbsp;what&nbsp;they&nbsp;do.&nbsp;&nbsp;It&nbsp;is&nbsp;easy<br>
&nbsp;&nbsp;&nbsp;to&nbsp;add&nbsp;and&nbsp;remove&nbsp;them&nbsp;(unlike&nbsp;summary/whiteboard&nbsp;designators),&nbsp;we&nbsp;can<br>
&nbsp;&nbsp;&nbsp;simply&nbsp;see&nbsp;what&nbsp;issues&nbsp;are&nbsp;present&nbsp;on&nbsp;a&nbsp;bug&nbsp;(unlike&nbsp;tracking&nbsp;bugs),<br>
&nbsp;&nbsp;&nbsp;and&nbsp;we&nbsp;do&nbsp;not&nbsp;confuse&nbsp;bugs&nbsp;with&nbsp;issues&nbsp;(unlike&nbsp;tracking&nbsp;bugs).<br>
<br>
&nbsp;&nbsp;&nbsp;However,&nbsp;there&nbsp;are&nbsp;still&nbsp;some&nbsp;"regressions"&nbsp;in&nbsp;the&nbsp;keyword&nbsp;system&nbsp;over<br>
&nbsp;&nbsp;&nbsp;previous&nbsp;systems:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Users&nbsp;wish&nbsp;to&nbsp;view&nbsp;the&nbsp;"dependency&nbsp;forest"&nbsp;of&nbsp;a&nbsp;keyword.&nbsp;&nbsp;While&nbsp;a<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dependency&nbsp;tree&nbsp;is&nbsp;of&nbsp;one&nbsp;bug,&nbsp;a&nbsp;dependency&nbsp;forest&nbsp;is&nbsp;of&nbsp;a&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;list,&nbsp;and&nbsp;consists&nbsp;of&nbsp;a&nbsp;dependency&nbsp;tree&nbsp;for&nbsp;each&nbsp;member&nbsp;of&nbsp;the&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;list.&nbsp;&nbsp;Users&nbsp;can&nbsp;work&nbsp;around&nbsp;this&nbsp;with&nbsp;tracking&nbsp;bugs&nbsp;by&nbsp;creating&nbsp;a<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tracking&nbsp;bug&nbsp;and&nbsp;viewing&nbsp;the&nbsp;dependency&nbsp;tree&nbsp;of&nbsp;that&nbsp;tracking&nbsp;bug.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Users&nbsp;wish&nbsp;to&nbsp;specify&nbsp;the&nbsp;keywords&nbsp;that&nbsp;initially&nbsp;apply&nbsp;to&nbsp;a&nbsp;bug,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;but&nbsp;instead&nbsp;they&nbsp;must&nbsp;edit&nbsp;the&nbsp;bug&nbsp;once&nbsp;it&nbsp;has&nbsp;already&nbsp;been<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;submitted.&nbsp;&nbsp;They&nbsp;can&nbsp;work&nbsp;around&nbsp;this&nbsp;with&nbsp;summary&nbsp;designators,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;since&nbsp;they&nbsp;specify&nbsp;the&nbsp;summary&nbsp;at&nbsp;reporting&nbsp;time.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Users&nbsp;wish&nbsp;to&nbsp;store&nbsp;or&nbsp;share&nbsp;a&nbsp;bug&nbsp;list&nbsp;that&nbsp;contains&nbsp;a&nbsp;keywords<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;column.&nbsp;&nbsp;Hence&nbsp;they&nbsp;wish&nbsp;to&nbsp;be&nbsp;able&nbsp;to&nbsp;specify&nbsp;what&nbsp;columns&nbsp;appear<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;in&nbsp;the&nbsp;bug&nbsp;list&nbsp;URL,&nbsp;as&nbsp;mentioned&nbsp;earlier.&nbsp;&nbsp;They&nbsp;can&nbsp;work&nbsp;around<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;this&nbsp;using&nbsp;summary&nbsp;designators,&nbsp;since&nbsp;almost&nbsp;all&nbsp;bug&nbsp;lists&nbsp;have&nbsp;a<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;summary&nbsp;column.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Users&nbsp;wish&nbsp;to&nbsp;be&nbsp;able&nbsp;to&nbsp;view&nbsp;keywords&nbsp;on&nbsp;a&nbsp;bug&nbsp;list.&nbsp;&nbsp;However<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;often&nbsp;they&nbsp;are&nbsp;only&nbsp;interested&nbsp;in&nbsp;a&nbsp;small&nbsp;number&nbsp;of&nbsp;keywords.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Having&nbsp;a&nbsp;bug&nbsp;list&nbsp;with&nbsp;a&nbsp;keywords&nbsp;column&nbsp;means&nbsp;that&nbsp;all&nbsp;keywords<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;will&nbsp;appear&nbsp;on&nbsp;a&nbsp;bug&nbsp;list.&nbsp;&nbsp;This&nbsp;can&nbsp;take&nbsp;a&nbsp;substantial&nbsp;amount&nbsp;of<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;space&nbsp;where&nbsp;a&nbsp;bug&nbsp;has&nbsp;a&nbsp;lot&nbsp;of&nbsp;keywords,&nbsp;since&nbsp;the&nbsp;table&nbsp;columns<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;in&nbsp;Bugzilla&nbsp;adjust&nbsp;to&nbsp;the&nbsp;largest&nbsp;cell&nbsp;in&nbsp;that&nbsp;column.&nbsp;&nbsp;Hence<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;users&nbsp;wish&nbsp;to&nbsp;be&nbsp;able&nbsp;to&nbsp;specify&nbsp;which&nbsp;keywords&nbsp;should&nbsp;appear&nbsp;in<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;the&nbsp;bug&nbsp;list.&nbsp;&nbsp;In&nbsp;a&nbsp;very&nbsp;real&nbsp;sense,&nbsp;each&nbsp;keyword&nbsp;is&nbsp;a&nbsp;field&nbsp;unto<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;itself.&nbsp;&nbsp;Users&nbsp;can&nbsp;work&nbsp;around&nbsp;this&nbsp;by&nbsp;using&nbsp;summary&nbsp;designators,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;since&nbsp;they&nbsp;keywords&nbsp;will&nbsp;share&nbsp;the&nbsp;space&nbsp;in&nbsp;the&nbsp;summary&nbsp;column.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Users&nbsp;wish&nbsp;to&nbsp;know&nbsp;when&nbsp;bugs&nbsp;with&nbsp;a&nbsp;specific&nbsp;issue&nbsp;are&nbsp;resolved.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Hence&nbsp;they&nbsp;wish&nbsp;to&nbsp;be&nbsp;able&nbsp;to&nbsp;receive&nbsp;notifications&nbsp;on&nbsp;all&nbsp;the<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;bugs&nbsp;with&nbsp;a&nbsp;specific&nbsp;keyword.&nbsp;&nbsp;The&nbsp;introduction&nbsp;a&nbsp;generic&nbsp;watching<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;facility&nbsp;(also&nbsp;for&nbsp;things&nbsp;like&nbsp;watching&nbsp;all&nbsp;bugs&nbsp;in&nbsp;a&nbsp;component)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;would&nbsp;achieve&nbsp;this.&nbsp;&nbsp;Users&nbsp;can&nbsp;work&nbsp;around&nbsp;this&nbsp;by&nbsp;using&nbsp;tracking<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;bugs,&nbsp;as&nbsp;dependencies&nbsp;have&nbsp;an&nbsp;existing&nbsp;way&nbsp;of&nbsp;detecting&nbsp;fixes&nbsp;to<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;bug&nbsp;a&nbsp;bug&nbsp;was&nbsp;blocked&nbsp;by.<br>
<br>
&nbsp;&nbsp;Dealing&nbsp;With&nbsp;The&nbsp;Keyword&nbsp;Overload<br>
<br>
&nbsp;&nbsp;&nbsp;At&nbsp;the&nbsp;time&nbsp;of&nbsp;writing,&nbsp;the&nbsp;mozilla.org&nbsp;installation&nbsp;has&nbsp;approximately<br>
&nbsp;&nbsp;&nbsp;100&nbsp;keywords,&nbsp;and&nbsp;many&nbsp;more&nbsp;would&nbsp;be&nbsp;in&nbsp;use&nbsp;if&nbsp;the&nbsp;keywords&nbsp;system<br>
&nbsp;&nbsp;&nbsp;didn't&nbsp;have&nbsp;the&nbsp;problems&nbsp;it&nbsp;does.<br>
<br>
&nbsp;&nbsp;&nbsp;Such&nbsp;a&nbsp;large&nbsp;number&nbsp;of&nbsp;keywords&nbsp;introduces&nbsp;logistical&nbsp;problems:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;It&nbsp;must&nbsp;be&nbsp;easy&nbsp;for&nbsp;someone&nbsp;to&nbsp;learn&nbsp;what&nbsp;a&nbsp;keyword&nbsp;means.&nbsp;&nbsp;If&nbsp;a<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;keyword&nbsp;is&nbsp;buried&nbsp;within&nbsp;a&nbsp;lot&nbsp;of&nbsp;other&nbsp;keywords,&nbsp;it&nbsp;can&nbsp;be<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;difficult&nbsp;to&nbsp;find.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;It&nbsp;must&nbsp;be&nbsp;easy&nbsp;to&nbsp;see&nbsp;what&nbsp;keywords&nbsp;are&nbsp;on&nbsp;a&nbsp;bug.&nbsp;&nbsp;If&nbsp;the&nbsp;number<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;of&nbsp;keywords&nbsp;is&nbsp;large,&nbsp;then&nbsp;this&nbsp;can&nbsp;be&nbsp;difficult.<br>
<br>
&nbsp;&nbsp;&nbsp;These&nbsp;lead&nbsp;some&nbsp;people&nbsp;to&nbsp;feel&nbsp;that&nbsp;there&nbsp;are&nbsp;"too&nbsp;many&nbsp;keywords".<br>
<br>
&nbsp;&nbsp;&nbsp;These&nbsp;problems&nbsp;are&nbsp;not&nbsp;without&nbsp;solutions&nbsp;however.&nbsp;&nbsp;It&nbsp;is&nbsp;harder&nbsp;to<br>
&nbsp;&nbsp;&nbsp;find&nbsp;a&nbsp;list&nbsp;of&nbsp;designators&nbsp;or&nbsp;tracking&nbsp;bugs&nbsp;than&nbsp;it&nbsp;is&nbsp;a&nbsp;list&nbsp;of<br>
&nbsp;&nbsp;&nbsp;keywords.<br>
<br>
&nbsp;&nbsp;&nbsp;The&nbsp;essential&nbsp;problem&nbsp;is&nbsp;it&nbsp;needs&nbsp;to&nbsp;be&nbsp;easy&nbsp;to&nbsp;find&nbsp;the&nbsp;keywords<br>
&nbsp;&nbsp;&nbsp;we're&nbsp;interested&nbsp;in&nbsp;through&nbsp;the&nbsp;mass&nbsp;of&nbsp;keywords.<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Keyword&nbsp;Applicability<br>
<br>
&nbsp;&nbsp;&nbsp;As&nbsp;has&nbsp;been&nbsp;previously&nbsp;mentioned,&nbsp;it&nbsp;is&nbsp;desirable&nbsp;for&nbsp;fields&nbsp;to&nbsp;be<br>
&nbsp;&nbsp;&nbsp;able&nbsp;to&nbsp;adapt&nbsp;to&nbsp;the&nbsp;values&nbsp;of&nbsp;other&nbsp;fields.&nbsp;&nbsp;This&nbsp;is&nbsp;certainly&nbsp;true<br>
&nbsp;&nbsp;&nbsp;for&nbsp;keywords.&nbsp;&nbsp;Many&nbsp;keywords&nbsp;are&nbsp;simply&nbsp;not&nbsp;relevant&nbsp;because&nbsp;of&nbsp;the<br>
&nbsp;&nbsp;&nbsp;bugs&nbsp;product,&nbsp;component,&nbsp;etc.<br>
<br>
&nbsp;&nbsp;&nbsp;Hence,&nbsp;by&nbsp;introducing&nbsp;keyword&nbsp;applicability,&nbsp;and&nbsp;not&nbsp;displaying<br>
&nbsp;&nbsp;&nbsp;keywords&nbsp;that&nbsp;are&nbsp;not&nbsp;relevant&nbsp;to&nbsp;the&nbsp;current&nbsp;bug,&nbsp;or&nbsp;clearly<br>
&nbsp;&nbsp;&nbsp;separating&nbsp;them,&nbsp;we&nbsp;can&nbsp;make&nbsp;the&nbsp;keyword&nbsp;overload&nbsp;problem&nbsp;less<br>
&nbsp;&nbsp;&nbsp;significant.<br>
<br>
&nbsp;&nbsp;&nbsp;Currently&nbsp;when&nbsp;you&nbsp;click&nbsp;on&nbsp;"keywords"&nbsp;on&nbsp;a&nbsp;bug,&nbsp;you&nbsp;get&nbsp;a&nbsp;list&nbsp;of&nbsp;all<br>
&nbsp;&nbsp;&nbsp;bugs.&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;desirable&nbsp;to&nbsp;introduce&nbsp;a&nbsp;list&nbsp;of&nbsp;keywords&nbsp;tailored<br>
&nbsp;&nbsp;&nbsp;to&nbsp;a&nbsp;specific&nbsp;bug,&nbsp;that&nbsp;reports,&nbsp;in&nbsp;order:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;the&nbsp;keywords&nbsp;currently&nbsp;on&nbsp;the&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;the&nbsp;keywords&nbsp;not&nbsp;currently&nbsp;on&nbsp;the&nbsp;bug,&nbsp;but&nbsp;applicable&nbsp;to&nbsp;the&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;optionally,&nbsp;the&nbsp;keywords&nbsp;not&nbsp;applicable&nbsp;to&nbsp;the&nbsp;bug<br>
<br>
&nbsp;&nbsp;&nbsp;This&nbsp;essentially&nbsp;orders&nbsp;the&nbsp;keywords&nbsp;into&nbsp;three&nbsp;groups,&nbsp;where&nbsp;each<br>
&nbsp;&nbsp;&nbsp;group&nbsp;is&nbsp;more&nbsp;important&nbsp;than&nbsp;the&nbsp;previous,&nbsp;and&nbsp;therefore&nbsp;appears<br>
&nbsp;&nbsp;&nbsp;closer&nbsp;to&nbsp;the&nbsp;top.<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Keyword&nbsp;Grouping&nbsp;&#38;&nbsp;Ordering<br>
<br>
&nbsp;&nbsp;&nbsp;We&nbsp;could&nbsp;further&nbsp;enhance&nbsp;both&nbsp;the&nbsp;global&nbsp;and&nbsp;bug&nbsp;specific&nbsp;keyword&nbsp;list<br>
&nbsp;&nbsp;&nbsp;by&nbsp;grouping&nbsp;keywords.&nbsp;&nbsp;We&nbsp;should&nbsp;always&nbsp;have&nbsp;a&nbsp;"flat"&nbsp;view&nbsp;of<br>
&nbsp;&nbsp;&nbsp;keywords,&nbsp;but&nbsp;other&nbsp;ways&nbsp;of&nbsp;viewing&nbsp;the&nbsp;keywords&nbsp;would&nbsp;be&nbsp;useful&nbsp;too.<br>
<br>
&nbsp;&nbsp;&nbsp;If&nbsp;keyword&nbsp;applicability&nbsp;was&nbsp;implemented,&nbsp;we&nbsp;could&nbsp;group&nbsp;keywords<br>
&nbsp;&nbsp;&nbsp;based&nbsp;on&nbsp;their&nbsp;"applicability&nbsp;condition".&nbsp;&nbsp;Keywords&nbsp;that&nbsp;apply&nbsp;to&nbsp;all<br>
&nbsp;&nbsp;&nbsp;bugs&nbsp;could&nbsp;be&nbsp;separated&nbsp;from&nbsp;keywords&nbsp;that&nbsp;apply&nbsp;to&nbsp;a&nbsp;specific<br>
&nbsp;&nbsp;&nbsp;product,&nbsp;both&nbsp;on&nbsp;the&nbsp;global&nbsp;keyword&nbsp;list&nbsp;and&nbsp;the&nbsp;keyword&nbsp;list&nbsp;of&nbsp;a&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;that&nbsp;is&nbsp;in&nbsp;that&nbsp;product.<br>
<br>
&nbsp;&nbsp;&nbsp;We&nbsp;could&nbsp;specify&nbsp;groups&nbsp;of&nbsp;our&nbsp;own.&nbsp;&nbsp;For&nbsp;example,&nbsp;many&nbsp;keywords&nbsp;are&nbsp;in<br>
&nbsp;&nbsp;&nbsp;a&nbsp;mutually&nbsp;exclusive&nbsp;group,&nbsp;essentially&nbsp;like&nbsp;radio&nbsp;buttons&nbsp;in&nbsp;a&nbsp;user<br>
&nbsp;&nbsp;&nbsp;interface.&nbsp;&nbsp;This&nbsp;creates&nbsp;a&nbsp;natural&nbsp;grouping,&nbsp;although&nbsp;other&nbsp;groupings<br>
&nbsp;&nbsp;&nbsp;occur&nbsp;(which&nbsp;depends&nbsp;on&nbsp;your&nbsp;keywords).<br>
<br>
&nbsp;&nbsp;&nbsp;It&nbsp;is&nbsp;possible&nbsp;that&nbsp;we&nbsp;could&nbsp;use&nbsp;collapsing/expanding&nbsp;operations&nbsp;on<br>
&nbsp;&nbsp;&nbsp;"twisties"&nbsp;to&nbsp;only&nbsp;should&nbsp;the&nbsp;groups&nbsp;we&nbsp;are&nbsp;interested&nbsp;in.<br>
<br>
&nbsp;&nbsp;&nbsp;And&nbsp;instead&nbsp;of&nbsp;grouping&nbsp;keywords,&nbsp;we&nbsp;could&nbsp;order&nbsp;them&nbsp;on&nbsp;some&nbsp;metric<br>
&nbsp;&nbsp;&nbsp;of&nbsp;usefulness,&nbsp;such&nbsp;as:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;when&nbsp;the&nbsp;keyword&nbsp;was&nbsp;last&nbsp;added&nbsp;to&nbsp;a&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;how&nbsp;many&nbsp;bugs&nbsp;the&nbsp;keyword&nbsp;is&nbsp;on<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;how&nbsp;many&nbsp;open&nbsp;bugs&nbsp;the&nbsp;keyword&nbsp;is&nbsp;on<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;Opting&nbsp;Out&nbsp;Of&nbsp;Keywords<br>
<br>
&nbsp;&nbsp;&nbsp;Not&nbsp;all&nbsp;people&nbsp;are&nbsp;going&nbsp;to&nbsp;care&nbsp;about&nbsp;all&nbsp;keywords.&nbsp;&nbsp;Therefore&nbsp;it<br>
&nbsp;&nbsp;&nbsp;makes&nbsp;sense&nbsp;that&nbsp;you&nbsp;may&nbsp;wish&nbsp;to&nbsp;specify&nbsp;which&nbsp;keywords&nbsp;you&nbsp;are<br>
&nbsp;&nbsp;&nbsp;interested&nbsp;in,&nbsp;either&nbsp;on&nbsp;the&nbsp;bug&nbsp;page,&nbsp;or&nbsp;on&nbsp;notifications.<br>
<br>
&nbsp;&nbsp;&nbsp;Other&nbsp;keywords&nbsp;will&nbsp;therefore&nbsp;not&nbsp;bother&nbsp;users&nbsp;who&nbsp;are&nbsp;not&nbsp;interested<br>
&nbsp;&nbsp;&nbsp;in&nbsp;them.<br>
<br>
&nbsp;&nbsp;Keyword&nbsp;Security<br>
<br>
&nbsp;&nbsp;&nbsp;Currently&nbsp;all&nbsp;keywords&nbsp;are&nbsp;available&nbsp;and&nbsp;editable&nbsp;to&nbsp;all&nbsp;people&nbsp;with<br>
&nbsp;&nbsp;&nbsp;edit&nbsp;bugs&nbsp;access.&nbsp;&nbsp;This&nbsp;situation&nbsp;is&nbsp;clearly&nbsp;suboptimal.<br>
<br>
&nbsp;&nbsp;&nbsp;Although&nbsp;relying&nbsp;on&nbsp;good&nbsp;behaviour&nbsp;for&nbsp;people&nbsp;to&nbsp;not&nbsp;do&nbsp;what&nbsp;they<br>
&nbsp;&nbsp;&nbsp;shouldn't&nbsp;works&nbsp;reasonably&nbsp;well&nbsp;on&nbsp;the&nbsp;mozilla.org,&nbsp;it&nbsp;is&nbsp;better&nbsp;to<br>
&nbsp;&nbsp;&nbsp;enforce&nbsp;that&nbsp;behaviour&nbsp;-&nbsp;it&nbsp;can&nbsp;be&nbsp;breached&nbsp;through&nbsp;malice,&nbsp;accident<br>
&nbsp;&nbsp;&nbsp;or&nbsp;ignorance.<br>
<br>
&nbsp;&nbsp;&nbsp;And&nbsp;in&nbsp;the&nbsp;situation&nbsp;where&nbsp;it&nbsp;is&nbsp;desirable&nbsp;for&nbsp;the&nbsp;presence&nbsp;or&nbsp;absence<br>
&nbsp;&nbsp;&nbsp;of&nbsp;a&nbsp;keyword&nbsp;not&nbsp;to&nbsp;be&nbsp;revealed,&nbsp;organisations&nbsp;either&nbsp;need&nbsp;to&nbsp;be<br>
&nbsp;&nbsp;&nbsp;content&nbsp;with&nbsp;the&nbsp;divulgence,&nbsp;or&nbsp;not&nbsp;use&nbsp;keywords&nbsp;at&nbsp;all.<br>
<br>
&nbsp;&nbsp;&nbsp;In&nbsp;the&nbsp;situation&nbsp;where&nbsp;they&nbsp;choose&nbsp;to&nbsp;divulge,&nbsp;introducing&nbsp;the&nbsp;ability<br>
&nbsp;&nbsp;&nbsp;to&nbsp;restrict&nbsp;who&nbsp;can&nbsp;see&nbsp;the&nbsp;keyword&nbsp;would&nbsp;also&nbsp;reduce&nbsp;keyword<br>
&nbsp;&nbsp;&nbsp;overload.<br>
<br>
&nbsp;&nbsp;Personal&nbsp;Keywords<br>
<br>
&nbsp;&nbsp;&nbsp;Keywords&nbsp;join&nbsp;together&nbsp;a&nbsp;set&nbsp;of&nbsp;bugs&nbsp;which&nbsp;would&nbsp;otherwise&nbsp;be<br>
&nbsp;&nbsp;&nbsp;unrelated&nbsp;in&nbsp;the&nbsp;bug&nbsp;system.<br>
<br>
&nbsp;&nbsp;&nbsp;We&nbsp;allow&nbsp;users&nbsp;to&nbsp;store&nbsp;their&nbsp;own&nbsp;queries.&nbsp;&nbsp;However&nbsp;we&nbsp;don't&nbsp;allow<br>
&nbsp;&nbsp;&nbsp;them&nbsp;to&nbsp;store&nbsp;their&nbsp;own&nbsp;keywords&nbsp;on&nbsp;a&nbsp;bug.&nbsp;&nbsp;This&nbsp;reduces&nbsp;the<br>
&nbsp;&nbsp;&nbsp;usefulness&nbsp;of&nbsp;personal&nbsp;queries,&nbsp;since&nbsp;you&nbsp;cannot&nbsp;join&nbsp;a&nbsp;set&nbsp;of<br>
&nbsp;&nbsp;&nbsp;unrelated&nbsp;bugs&nbsp;together&nbsp;in&nbsp;a&nbsp;way&nbsp;that&nbsp;you&nbsp;wish.&nbsp;&nbsp;Lists&nbsp;of&nbsp;bug&nbsp;numbers<br>
&nbsp;&nbsp;&nbsp;can&nbsp;work,&nbsp;by&nbsp;they&nbsp;can&nbsp;only&nbsp;be&nbsp;used&nbsp;for&nbsp;small&nbsp;lists,&nbsp;and&nbsp;it&nbsp;is<br>
&nbsp;&nbsp;&nbsp;impossible&nbsp;to&nbsp;share&nbsp;a&nbsp;list&nbsp;between&nbsp;multiple&nbsp;queries.<br>
<br>
&nbsp;&nbsp;&nbsp;Personal&nbsp;keywords&nbsp;are&nbsp;necessary&nbsp;to&nbsp;replace&nbsp;personal&nbsp;tracking&nbsp;bugs,&nbsp;as<br>
&nbsp;&nbsp;&nbsp;they&nbsp;would&nbsp;not&nbsp;pollute&nbsp;the&nbsp;keyword&nbsp;space.&nbsp;&nbsp;Indeed,&nbsp;on&nbsp;many<br>
&nbsp;&nbsp;&nbsp;installations&nbsp;this&nbsp;could&nbsp;remove&nbsp;some&nbsp;keywords&nbsp;out&nbsp;of&nbsp;the&nbsp;global<br>
&nbsp;&nbsp;&nbsp;keyword&nbsp;space.<br>
<br>
&nbsp;&nbsp;&nbsp;In&nbsp;a&nbsp;similar&nbsp;vein&nbsp;and&nbsp;with&nbsp;similar&nbsp;effects,&nbsp;group&nbsp;keywords&nbsp;could&nbsp;be<br>
&nbsp;&nbsp;&nbsp;introduced&nbsp;that&nbsp;are&nbsp;only&nbsp;available&nbsp;to&nbsp;members&nbsp;of&nbsp;a&nbsp;specific&nbsp;group.<br>
<br>
&nbsp;&nbsp;Keyword&nbsp;Restrictions<br>
<br>
&nbsp;&nbsp;&nbsp;Keywords&nbsp;are&nbsp;not&nbsp;islands&nbsp;unto&nbsp;themselves.&nbsp;&nbsp;Along&nbsp;with&nbsp;their&nbsp;potential<br>
&nbsp;&nbsp;&nbsp;to&nbsp;be&nbsp;involved&nbsp;in&nbsp;the&nbsp;inter-field&nbsp;relationships&nbsp;mentioned&nbsp;earlier,<br>
&nbsp;&nbsp;&nbsp;keywords&nbsp;can&nbsp;also&nbsp;be&nbsp;related&nbsp;to&nbsp;other&nbsp;keywords.<br>
<br>
&nbsp;&nbsp;&nbsp;Essentially,&nbsp;there&nbsp;are&nbsp;two&nbsp;possibilities:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;a&nbsp;set&nbsp;of&nbsp;keywords&nbsp;are&nbsp;mutually&nbsp;exclusive<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;the&nbsp;presence&nbsp;of&nbsp;a&nbsp;keyword&nbsp;implies&nbsp;another&nbsp;keyword&nbsp;must&nbsp;be&nbsp;present<br>
<br>
&nbsp;&nbsp;&nbsp;Introduction&nbsp;of&nbsp;the&nbsp;ability&nbsp;to&nbsp;specify&nbsp;these&nbsp;restrictions&nbsp;would&nbsp;have<br>
&nbsp;&nbsp;&nbsp;benefits.<br>
<br>
&nbsp;&nbsp;&nbsp;If&nbsp;mutually&nbsp;exclusive&nbsp;keywords&nbsp;were&nbsp;present&nbsp;on&nbsp;a&nbsp;bug,&nbsp;their&nbsp;removal<br>
&nbsp;&nbsp;&nbsp;would&nbsp;fix&nbsp;up&nbsp;the&nbsp;database,&nbsp;as&nbsp;well&nbsp;as&nbsp;reducing&nbsp;the&nbsp;number&nbsp;of&nbsp;keywords<br>
&nbsp;&nbsp;&nbsp;on&nbsp;that&nbsp;bug.<br>
<br>
&nbsp;&nbsp;&nbsp;In&nbsp;the&nbsp;situation&nbsp;where&nbsp;a&nbsp;keyword&nbsp;implies&nbsp;another&nbsp;keyword,&nbsp;there&nbsp;are<br>
&nbsp;&nbsp;&nbsp;two&nbsp;possiblities&nbsp;as&nbsp;to&nbsp;how&nbsp;to&nbsp;handle&nbsp;the&nbsp;situation.<br>
<br>
&nbsp;&nbsp;&nbsp;The&nbsp;first&nbsp;is&nbsp;automatically&nbsp;add&nbsp;the&nbsp;keyword.&nbsp;&nbsp;This&nbsp;would&nbsp;fix&nbsp;up&nbsp;the<br>
&nbsp;&nbsp;&nbsp;database,&nbsp;but&nbsp;it&nbsp;would&nbsp;increase&nbsp;the&nbsp;number&nbsp;of&nbsp;keywords&nbsp;on&nbsp;a&nbsp;bug.<br>
<br>
&nbsp;&nbsp;&nbsp;The&nbsp;second&nbsp;is&nbsp;to&nbsp;automatically&nbsp;remove&nbsp;the&nbsp;keyword,&nbsp;and&nbsp;alter&nbsp;queries<br>
&nbsp;&nbsp;&nbsp;so&nbsp;they&nbsp;pick&nbsp;up&nbsp;the&nbsp;first&nbsp;keyword&nbsp;as&nbsp;well&nbsp;as&nbsp;the&nbsp;removed&nbsp;keyword.<br>
&nbsp;&nbsp;&nbsp;This&nbsp;would&nbsp;fix&nbsp;up&nbsp;the&nbsp;database&nbsp;and&nbsp;reduce&nbsp;the&nbsp;number&nbsp;of&nbsp;keywords&nbsp;on&nbsp;a<br>
&nbsp;&nbsp;&nbsp;bug,&nbsp;but&nbsp;it&nbsp;might&nbsp;confuse&nbsp;users&nbsp;who&nbsp;don't&nbsp;see&nbsp;the&nbsp;keyword.<br>
&nbsp;&nbsp;&nbsp;Alternatively,&nbsp;the&nbsp;implied&nbsp;keywords&nbsp;could&nbsp;be&nbsp;listed&nbsp;separately.<br>
<br>
Notifications<br>
<br>
&nbsp;&nbsp;&nbsp;Every&nbsp;time&nbsp;a&nbsp;bug&nbsp;gets&nbsp;changed&nbsp;notifications&nbsp;get&nbsp;sent&nbsp;out&nbsp;to&nbsp;people<br>
&nbsp;&nbsp;&nbsp;letting&nbsp;them&nbsp;know&nbsp;about&nbsp;what&nbsp;changes&nbsp;have&nbsp;been&nbsp;made.&nbsp;&nbsp;This&nbsp;is&nbsp;a<br>
&nbsp;&nbsp;&nbsp;significant&nbsp;feature,&nbsp;and&nbsp;all&nbsp;sorts&nbsp;of&nbsp;questions&nbsp;can&nbsp;be&nbsp;raised,&nbsp;but<br>
&nbsp;&nbsp;&nbsp;they&nbsp;mainly&nbsp;boil&nbsp;down&nbsp;to&nbsp;when&nbsp;they&nbsp;should&nbsp;be&nbsp;sent&nbsp;and&nbsp;what&nbsp;they&nbsp;should<br>
&nbsp;&nbsp;&nbsp;look&nbsp;like.<br>
<br>
&nbsp;&nbsp;Changes&nbsp;You're&nbsp;Interested&nbsp;In<br>
<br>
&nbsp;&nbsp;&nbsp;As&nbsp;of&nbsp;version&nbsp;2.12&nbsp;users&nbsp;can&nbsp;specify&nbsp;what&nbsp;sort&nbsp;of&nbsp;changes&nbsp;they&nbsp;are<br>
&nbsp;&nbsp;&nbsp;interested&nbsp;in&nbsp;receiving&nbsp;notifications&nbsp;for.&nbsp;&nbsp;However,&nbsp;this&nbsp;is&nbsp;still<br>
&nbsp;&nbsp;&nbsp;limited.&nbsp;&nbsp;As&nbsp;yet&nbsp;there&nbsp;is&nbsp;no&nbsp;facility&nbsp;to&nbsp;specify&nbsp;which&nbsp;keywords&nbsp;you<br>
&nbsp;&nbsp;&nbsp;care&nbsp;about,&nbsp;and&nbsp;whether&nbsp;you&nbsp;care&nbsp;about&nbsp;changes&nbsp;to&nbsp;fields&nbsp;such&nbsp;as&nbsp;the<br>
&nbsp;&nbsp;&nbsp;QA&nbsp;contact&nbsp;changes.<br>
&nbsp;&nbsp;&nbsp;Furthermore,&nbsp;often&nbsp;an&nbsp;unnecessary&nbsp;comment&nbsp;will&nbsp;go&nbsp;along&nbsp;with&nbsp;a&nbsp;change,<br>
&nbsp;&nbsp;&nbsp;either&nbsp;because&nbsp;it&nbsp;is&nbsp;required,&nbsp;or&nbsp;the&nbsp;commenter&nbsp;is&nbsp;ignorant&nbsp;of&nbsp;how&nbsp;the<br>
&nbsp;&nbsp;&nbsp;new&nbsp;system&nbsp;works.&nbsp;&nbsp;While&nbsp;explaining&nbsp;why&nbsp;you&nbsp;did&nbsp;something&nbsp;is&nbsp;useful,<br>
&nbsp;&nbsp;&nbsp;merely&nbsp;commenting&nbsp;on&nbsp;what&nbsp;you&nbsp;did&nbsp;is&nbsp;not&nbsp;because&nbsp;that&nbsp;information&nbsp;is<br>
&nbsp;&nbsp;&nbsp;already&nbsp;accessible&nbsp;view&nbsp;"Bug&nbsp;Activity".<br>
<br>
&nbsp;&nbsp;&nbsp;Because&nbsp;of&nbsp;this&nbsp;unnecessary&nbsp;comment,&nbsp;a&nbsp;lot&nbsp;of&nbsp;changes&nbsp;that&nbsp;would<br>
&nbsp;&nbsp;&nbsp;otherwise&nbsp;not&nbsp;generate&nbsp;notifications&nbsp;for&nbsp;certain&nbsp;people&nbsp;do&nbsp;so,&nbsp;because<br>
&nbsp;&nbsp;&nbsp;few&nbsp;people&nbsp;are&nbsp;willing&nbsp;to&nbsp;turn&nbsp;off&nbsp;comments.&nbsp;&nbsp;One&nbsp;way&nbsp;to&nbsp;deal&nbsp;with<br>
&nbsp;&nbsp;&nbsp;this&nbsp;problem&nbsp;is&nbsp;to&nbsp;allow&nbsp;people&nbsp;to&nbsp;specify&nbsp;that&nbsp;their&nbsp;comments&nbsp;are<br>
&nbsp;&nbsp;&nbsp;purely&nbsp;explanatory,&nbsp;and&nbsp;that&nbsp;anyone&nbsp;who&nbsp;is&nbsp;not&nbsp;interested&nbsp;in&nbsp;the<br>
&nbsp;&nbsp;&nbsp;change&nbsp;will&nbsp;not&nbsp;be&nbsp;interested&nbsp;in&nbsp;the&nbsp;comment.<br>
<br>
&nbsp;&nbsp;&nbsp;Furthermore,&nbsp;one&nbsp;possible&nbsp;rationale&nbsp;for&nbsp;unnecessary&nbsp;comments&nbsp;is&nbsp;that<br>
&nbsp;&nbsp;&nbsp;the&nbsp;bug&nbsp;activity&nbsp;does&nbsp;not&nbsp;display&nbsp;on&nbsp;the&nbsp;normal&nbsp;page&nbsp;and&nbsp;hence&nbsp;it&nbsp;is<br>
&nbsp;&nbsp;&nbsp;difficult&nbsp;to&nbsp;cross&nbsp;reference&nbsp;comments&nbsp;and&nbsp;actions.&nbsp;&nbsp;Hence,&nbsp;it&nbsp;would&nbsp;be<br>
&nbsp;&nbsp;&nbsp;beneficial&nbsp;to&nbsp;be&nbsp;able&nbsp;to&nbsp;do&nbsp;this.<br>
<br>
&nbsp;&nbsp;Bugs&nbsp;You're&nbsp;Watching<br>
<br>
&nbsp;&nbsp;&nbsp;Currently&nbsp;to&nbsp;receive&nbsp;a&nbsp;notification&nbsp;about&nbsp;a&nbsp;bug&nbsp;you&nbsp;need&nbsp;to&nbsp;have&nbsp;your<br>
&nbsp;&nbsp;&nbsp;name&nbsp;on&nbsp;it.&nbsp;&nbsp;This&nbsp;is&nbsp;suboptimal&nbsp;because&nbsp;you&nbsp;need&nbsp;to&nbsp;know&nbsp;about&nbsp;a&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;before&nbsp;you&nbsp;can&nbsp;receive&nbsp;notifications&nbsp;on&nbsp;it.&nbsp;&nbsp;Often&nbsp;you&nbsp;are&nbsp;interested<br>
&nbsp;&nbsp;&nbsp;in&nbsp;any&nbsp;bug&nbsp;with&nbsp;a&nbsp;field&nbsp;set&nbsp;to&nbsp;a&nbsp;specific&nbsp;value.&nbsp;&nbsp;For&nbsp;example,&nbsp;you<br>
&nbsp;&nbsp;&nbsp;might&nbsp;be&nbsp;interested&nbsp;in&nbsp;all&nbsp;bugs&nbsp;with&nbsp;a&nbsp;specific&nbsp;product,&nbsp;component&nbsp;or<br>
&nbsp;&nbsp;&nbsp;keyword.<br>
<br>
&nbsp;&nbsp;&nbsp;If&nbsp;someone&nbsp;could&nbsp;automatically&nbsp;receive&nbsp;notifications&nbsp;about&nbsp;these&nbsp;bugs,<br>
&nbsp;&nbsp;&nbsp;it&nbsp;would&nbsp;make&nbsp;everyone's&nbsp;lives&nbsp;easier.&nbsp;&nbsp;Currently&nbsp;the&nbsp;default&nbsp;assignee<br>
&nbsp;&nbsp;&nbsp;and&nbsp;QA&nbsp;contact&nbsp;for&nbsp;a&nbsp;component&nbsp;will&nbsp;automatically&nbsp;receive<br>
&nbsp;&nbsp;&nbsp;notifications&nbsp;for<br>
<br>
&nbsp;&nbsp;&nbsp;Question:&nbsp;&nbsp;This&nbsp;moves&nbsp;half&nbsp;way&nbsp;to&nbsp;a&nbsp;BCC.<br>
<br>
&nbsp;&nbsp;Bulk&nbsp;Changes<br>
<br>
&nbsp;&nbsp;&nbsp;A&nbsp;very&nbsp;useful&nbsp;feature&nbsp;of&nbsp;Bugzilla&nbsp;is&nbsp;the&nbsp;ability&nbsp;to&nbsp;perform&nbsp;an&nbsp;action<br>
&nbsp;&nbsp;&nbsp;on&nbsp;multiple&nbsp;bugs&nbsp;at&nbsp;once.&nbsp;&nbsp;However,&nbsp;this&nbsp;means&nbsp;that&nbsp;similar<br>
&nbsp;&nbsp;&nbsp;notifications&nbsp;are&nbsp;currently&nbsp;generated&nbsp;for&nbsp;each&nbsp;bug&nbsp;modified.<br>
<br>
&nbsp;&nbsp;&nbsp;This&nbsp;can&nbsp;result&nbsp;in&nbsp;a&nbsp;torrent&nbsp;of&nbsp;notifications&nbsp;that&nbsp;can&nbsp;annoy.<br>
<br>
&nbsp;&nbsp;&nbsp;Furthermore,&nbsp;since&nbsp;the&nbsp;bugs&nbsp;are&nbsp;all&nbsp;changed&nbsp;close&nbsp;to&nbsp;each&nbsp;other&nbsp;in<br>
&nbsp;&nbsp;&nbsp;time,&nbsp;it&nbsp;is&nbsp;easy&nbsp;for&nbsp;someone&nbsp;to&nbsp;mass&nbsp;delete&nbsp;all&nbsp;the&nbsp;notifications<br>
&nbsp;&nbsp;&nbsp;generated&nbsp;by&nbsp;a&nbsp;bulk&nbsp;change&nbsp;and&nbsp;miss&nbsp;an&nbsp;unrelated&nbsp;notification&nbsp;in&nbsp;the<br>
&nbsp;&nbsp;&nbsp;middle.<br>
<br>
&nbsp;&nbsp;&nbsp;These&nbsp;factors&nbsp;can&nbsp;lead&nbsp;to&nbsp;a&nbsp;tendency&nbsp;for&nbsp;people&nbsp;to&nbsp;delay&nbsp;bulk&nbsp;changes,<br>
&nbsp;&nbsp;&nbsp;or&nbsp;avoid&nbsp;them&nbsp;entirely.&nbsp;&nbsp;This&nbsp;is&nbsp;suboptimal.<br>
<br>
&nbsp;&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;better&nbsp;if&nbsp;a&nbsp;bulk&nbsp;change&nbsp;generated&nbsp;only&nbsp;one&nbsp;notification<br>
&nbsp;&nbsp;&nbsp;mail.&nbsp;&nbsp;This&nbsp;would&nbsp;vastly&nbsp;reduce&nbsp;the&nbsp;annoyance&nbsp;factor,&nbsp;and&nbsp;prevent<br>
&nbsp;&nbsp;&nbsp;accidental&nbsp;deletion&nbsp;of&nbsp;notifications.<br>
<br>
&nbsp;&nbsp;&nbsp;One&nbsp;problem&nbsp;with&nbsp;this&nbsp;change&nbsp;is&nbsp;that&nbsp;some&nbsp;people&nbsp;separate&nbsp;out<br>
&nbsp;&nbsp;&nbsp;notifications&nbsp;using&nbsp;filtering.&nbsp;&nbsp;This&nbsp;means&nbsp;that&nbsp;they&nbsp;would&nbsp;no&nbsp;longer<br>
&nbsp;&nbsp;&nbsp;be&nbsp;match&nbsp;parts&nbsp;of&nbsp;a&nbsp;bulk&nbsp;change&nbsp;under&nbsp;different&nbsp;filtering&nbsp;rules.<br>
<br>
&nbsp;&nbsp;&nbsp;One&nbsp;possibility&nbsp;to&nbsp;resolve&nbsp;this&nbsp;is&nbsp;to&nbsp;allow&nbsp;people&nbsp;to&nbsp;specify&nbsp;groups<br>
&nbsp;&nbsp;&nbsp;of&nbsp;bugs.&nbsp;&nbsp;All&nbsp;bugs&nbsp;within&nbsp;a&nbsp;group&nbsp;would&nbsp;go&nbsp;into&nbsp;the&nbsp;same<br>
&nbsp;&nbsp;&nbsp;notification.&nbsp;&nbsp;The&nbsp;filters&nbsp;could&nbsp;then&nbsp;distinguish&nbsp;the&nbsp;different&nbsp;bug<br>
&nbsp;&nbsp;&nbsp;groups.<br>
<br>
&nbsp;&nbsp;&nbsp;In&nbsp;any&nbsp;case,&nbsp;it&nbsp;is&nbsp;likely&nbsp;there&nbsp;would&nbsp;need&nbsp;to&nbsp;be&nbsp;a&nbsp;transition&nbsp;period<br>
&nbsp;&nbsp;&nbsp;to&nbsp;allow&nbsp;people&nbsp;to&nbsp;alter&nbsp;their&nbsp;filters.<br>
<br>
Nominations<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
Linking&nbsp;Bugzilla&nbsp;Installations<br>
<br>
&nbsp;&nbsp;&nbsp;The&nbsp;first&nbsp;example&nbsp;of&nbsp;linking&nbsp;Bugzilla&nbsp;installations&nbsp;together&nbsp;has&nbsp;is<br>
&nbsp;&nbsp;&nbsp;the&nbsp;introduction&nbsp;of&nbsp;bug&nbsp;moving&nbsp;in&nbsp;version&nbsp;2.12.&nbsp;&nbsp;However,&nbsp;it&nbsp;would&nbsp;be<br>
&nbsp;&nbsp;&nbsp;useful&nbsp;to&nbsp;be&nbsp;able&nbsp;to&nbsp;link&nbsp;installations&nbsp;in&nbsp;more&nbsp;ways.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Dependencies&nbsp;and&nbsp;other&nbsp;relationships&nbsp;between&nbsp;bugs&nbsp;in&nbsp;other<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;installations.&nbsp;&nbsp;This&nbsp;is&nbsp;difficult&nbsp;because&nbsp;dependencies&nbsp;are<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;synchronised&nbsp;on&nbsp;both&nbsp;bugs,&nbsp;so&nbsp;the&nbsp;installation&nbsp;that&nbsp;changes<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dependencies&nbsp;would&nbsp;need&nbsp;to&nbsp;communicate&nbsp;the&nbsp;new&nbsp;state&nbsp;to&nbsp;the&nbsp;other<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;installation.&nbsp;&nbsp;It&nbsp;would&nbsp;also&nbsp;mean&nbsp;that&nbsp;relationships&nbsp;and<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;notifications&nbsp;that&nbsp;refer&nbsp;to&nbsp;other&nbsp;bugs&nbsp;would&nbsp;need&nbsp;to&nbsp;communicate<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;with&nbsp;the&nbsp;other&nbsp;installation.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;References&nbsp;to&nbsp;bugs&nbsp;in&nbsp;other&nbsp;installations.&nbsp;&nbsp;Currently&nbsp;if&nbsp;you&nbsp;type<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"bug&nbsp;XXX"&nbsp;or&nbsp;"bug&nbsp;#XXX"&nbsp;where&nbsp;XXX&nbsp;is&nbsp;a&nbsp;number,&nbsp;you&nbsp;get&nbsp;an<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;automatic&nbsp;hyperlink&nbsp;to&nbsp;that&nbsp;bug.&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;useful&nbsp;if&nbsp;you&nbsp;could<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;say&nbsp;"YYY&nbsp;bug&nbsp;#XXX"&nbsp;where&nbsp;YYY&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;another&nbsp;installation.<br>
<br>
Retirement<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
Whiny&nbsp;Reports<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
&nbsp;&nbsp;Group&nbsp;Redesign<br>
<br>
&nbsp;&nbsp;&nbsp;?<br>
<br>
&nbsp;&nbsp;Hard&nbsp;Wrapping&nbsp;Comments<br>
<br>
&nbsp;&nbsp;&nbsp;Currently&nbsp;Bugzilla&nbsp;"hard&nbsp;wraps"&nbsp;its&nbsp;comments&nbsp;to&nbsp;a&nbsp;specific&nbsp;line&nbsp;size,<br>
&nbsp;&nbsp;&nbsp;similar&nbsp;to&nbsp;E-Mail.&nbsp;&nbsp;This&nbsp;has&nbsp;various&nbsp;problems:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;The&nbsp;way&nbsp;it&nbsp;currently&nbsp;works,&nbsp;wrapping&nbsp;is&nbsp;done&nbsp;in&nbsp;the&nbsp;browser&nbsp;at<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;submission&nbsp;time&nbsp;using&nbsp;a&nbsp;non-standard&nbsp;HTML&nbsp;extension&nbsp;not&nbsp;supported<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;by&nbsp;some&nbsp;(uncommon)&nbsp;browsers.&nbsp;&nbsp;These&nbsp;browsers&nbsp;generate&nbsp;comments<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;that&nbsp;scroll&nbsp;off&nbsp;the&nbsp;right&nbsp;side&nbsp;of&nbsp;the&nbsp;screen.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;Because&nbsp;comments&nbsp;are&nbsp;of&nbsp;fixed&nbsp;width,&nbsp;when&nbsp;you&nbsp;expand&nbsp;your&nbsp;browser<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;window,&nbsp;the&nbsp;comments&nbsp;do&nbsp;not&nbsp;expand&nbsp;to&nbsp;fit&nbsp;available&nbsp;space.<br>
<br>
&nbsp;&nbsp;&nbsp;It&nbsp;would&nbsp;be&nbsp;much&nbsp;better&nbsp;to&nbsp;move&nbsp;to&nbsp;a&nbsp;world&nbsp;of&nbsp;soft&nbsp;wrapping,&nbsp;where&nbsp;the<br>
&nbsp;&nbsp;&nbsp;browser&nbsp;wraps&nbsp;the&nbsp;text&nbsp;at&nbsp;display&nbsp;time,&nbsp;similar&nbsp;to&nbsp;a&nbsp;world&nbsp;processor.<br>
&nbsp;&nbsp;&nbsp;&nbsp;And&nbsp;as&nbsp;in&nbsp;a&nbsp;word&nbsp;processor,&nbsp;soft&nbsp;wrapping&nbsp;does&nbsp;not&nbsp;preclude&nbsp;the<br>
&nbsp;&nbsp;&nbsp;insertion&nbsp;of&nbsp;newlines.<br>
<br>
&nbsp;&nbsp;&nbsp;Hard&nbsp;wrapping&nbsp;is&nbsp;too&nbsp;entrenched&nbsp;into&nbsp;text&nbsp;E-Mail&nbsp;to&nbsp;fix,&nbsp;but&nbsp;we&nbsp;can<br>
&nbsp;&nbsp;&nbsp;fix&nbsp;Bugzilla&nbsp;without&nbsp;causing&nbsp;any&nbsp;problems.&nbsp;&nbsp;The&nbsp;old&nbsp;content&nbsp;will&nbsp;still<br>
&nbsp;&nbsp;&nbsp;be&nbsp;wrapped&nbsp;too&nbsp;early,&nbsp;but&nbsp;at&nbsp;least&nbsp;new&nbsp;content&nbsp;will&nbsp;work.<br>
&nbsp;&nbsp;&nbsp;</P
>
</P </P
></DIV ></DIV
><DIV ><DIV
...@@ -123,7 +712,7 @@ WIDTH="33%" ...@@ -123,7 +712,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="faq.html" HREF="variants.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -142,7 +731,7 @@ VALIGN="top" ...@@ -142,7 +731,7 @@ VALIGN="top"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>The Bugzilla FAQ</TD >Bugzilla Variants and Competitors</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
docs/html/geninstall.html
View file @ 58593ba9
...@@ -78,7 +78,7 @@ CLASS="SECTION" ...@@ -78,7 +78,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN916" NAME="AEN941"
>3.5.1. Modifying Your Running System</A >3.5.1. Modifying Your Running System</A
></H2 ></H2
><P ><P
...@@ -111,7 +111,7 @@ CLASS="SECTION" ...@@ -111,7 +111,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN923" NAME="AEN948"
>3.5.2. Upgrading From Previous Versions</A >3.5.2. Upgrading From Previous Versions</A
></H2 ></H2
><P ><P
...@@ -323,7 +323,7 @@ CLASS="SECTION" ...@@ -323,7 +323,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN964" NAME="UNIXHISTORY"
>3.5.6. UNIX Installation Instructions History</A >3.5.6. UNIX Installation Instructions History</A
></H2 ></H2
><P ><P
...@@ -335,9 +335,11 @@ NAME="AEN964" ...@@ -335,9 +335,11 @@ NAME="AEN964"
> The February 25, 1999 re-write of this page was done by Ry4an > The February 25, 1999 re-write of this page was done by Ry4an
Brase &#60;ry4an@ry4an.org&#62;, with some edits by Terry Brase &#60;ry4an@ry4an.org&#62;, with some edits by Terry
Weissman, Bryce Nesbitt, Martin Pool, &#38; Dan Mosedale (But Weissman, Bryce Nesbitt, Martin Pool, &#38; Dan Mosedale (But
don't send bug reports to them; report them using bugzilla, at don't send bug reports to them; report them using bugzilla, at <A
http://bugzilla.mozilla.org/enter_bug.cgi , project Webtools, HREF="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla"
component Bugzilla). TARGET="_top"
>http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla</A
> ).
</P </P
><P ><P
> This document was heavily modified again Wednesday, March 07 > This document was heavily modified again Wednesday, March 07
......
docs/html/gfdl.html
View file @ 58593ba9
...@@ -10,8 +10,8 @@ REL="HOME" ...@@ -10,8 +10,8 @@ REL="HOME"
TITLE="The Bugzilla Guide" TITLE="The Bugzilla Guide"
HREF="index.html"><LINK HREF="index.html"><LINK
REL="PREVIOUS" REL="PREVIOUS"
TITLE="The Quicksearch Utility" TITLE="Hacking Bugzilla"
HREF="quicksearch.html"><LINK HREF="bzhacking.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="PREAMBLE" TITLE="PREAMBLE"
HREF="gfdl_0.html"></HEAD HREF="gfdl_0.html"></HEAD
...@@ -41,7 +41,7 @@ WIDTH="10%" ...@@ -41,7 +41,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="quicksearch.html" HREF="bzhacking.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -141,7 +141,7 @@ HREF="gfdl_howto.html" ...@@ -141,7 +141,7 @@ HREF="gfdl_howto.html"
><P ><P
>Version 1.1, March 2000</P >Version 1.1, March 2000</P
><A ><A
NAME="AEN2416" NAME="AEN2499"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -167,7 +167,7 @@ WIDTH="33%" ...@@ -167,7 +167,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="quicksearch.html" HREF="bzhacking.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -192,7 +192,7 @@ HREF="gfdl_0.html" ...@@ -192,7 +192,7 @@ HREF="gfdl_0.html"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>The Quicksearch Utility</TD >Hacking Bugzilla</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
......
docs/html/gfdl_howto.html
View file @ 58593ba9
...@@ -78,7 +78,7 @@ NAME="GFDL_HOWTO" ...@@ -78,7 +78,7 @@ NAME="GFDL_HOWTO"
a copy of the License in the document and put the following a copy of the License in the document and put the following
copyright and license notices just after the title page:</P copyright and license notices just after the title page:</P
><A ><A
NAME="AEN2506" NAME="AEN2589"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
......
docs/html/glossary.html
View file @ 58593ba9
...@@ -68,7 +68,7 @@ CLASS="GLOSSDIV" ...@@ -68,7 +68,7 @@ CLASS="GLOSSDIV"
><H1 ><H1
CLASS="GLOSSDIV" CLASS="GLOSSDIV"
><A ><A
NAME="AEN2511" NAME="AEN2594"
>0-9, high ascii</A >0-9, high ascii</A
></H1 ></H1
><DL ><DL
...@@ -402,7 +402,7 @@ NAME="GLOSS_P" ...@@ -402,7 +402,7 @@ NAME="GLOSS_P"
><DIV ><DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN2602" NAME="AEN2685"
></A ></A
><P ><P
><B ><B
......
docs/html/granttables.html
View file @ 58593ba9
...@@ -16,8 +16,8 @@ REL="PREVIOUS" ...@@ -16,8 +16,8 @@ REL="PREVIOUS"
TITLE="MySQL Bugzilla Database Introduction" TITLE="MySQL Bugzilla Database Introduction"
HREF="dbdoc.html"><LINK HREF="dbdoc.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Bugzilla Variants and Competitors" TITLE="Useful Patches and Utilities for Bugzilla"
HREF="variants.html"></HEAD HREF="patches.html"></HEAD
><BODY ><BODY
CLASS="SECTION" CLASS="SECTION"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -57,7 +57,7 @@ WIDTH="10%" ...@@ -57,7 +57,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="variants.html" HREF="patches.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -313,7 +313,7 @@ WIDTH="33%" ...@@ -313,7 +313,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="variants.html" HREF="patches.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -335,7 +335,7 @@ HREF="database.html" ...@@ -335,7 +335,7 @@ HREF="database.html"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>Bugzilla Variants and Competitors</TD >Useful Patches and Utilities for Bugzilla</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
docs/html/how.html
View file @ 58593ba9
...@@ -438,13 +438,13 @@ CLASS="QUOTE" ...@@ -438,13 +438,13 @@ CLASS="QUOTE"
>scrollbox</EM >scrollbox</EM
>. Using the down arrow on >. Using the down arrow on
the scrollbox, scroll down until you can see an entry the scrollbox, scroll down until you can see an entry
called "Webtools". Select this entry. called "Bugzilla". Select this entry.
</P </P
></LI ></LI
><LI ><LI
><P ><P
> Did you notice that some of the boxes to the right changed > 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 has different Versions, Components, and Target Milestones
associated with it. A "Version" is the number of a associated with it. A "Version" is the number of a
software program. software program.
...@@ -519,7 +519,7 @@ NAME="AEN317" ...@@ -519,7 +519,7 @@ NAME="AEN317"
></A ></A
><P ><P
><B ><B
>Example 2-2. Mozilla Webtools Components</B >Example 2-2. Mozilla's Bugzilla Components</B
></P ></P
><DIV ><DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
...@@ -529,7 +529,7 @@ NAME="AEN319" ...@@ -529,7 +529,7 @@ NAME="AEN319"
><P ><P
></P ></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
></P ></P
><TABLE ><TABLE
...@@ -538,60 +538,166 @@ BORDER="0" ...@@ -538,60 +538,166 @@ BORDER="0"
><TR ><TR
><TD ><TD
><EM ><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
><TR ><TR
><TD ><TD
><EM ><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
><TR ><TR
><TD ><TD
><EM ><EM
>Build</EM >Creating/Changing Bugs</EM
>,
Creating, changing, and viewing bugs.
<TT
CLASS="FILENAME"
>enter_bug.cgi</TT
>,
<TT
CLASS="FILENAME"
>post_bug.cgi</TT
>, >,
a tool to automatically compile source code <TT
into machine-readable form</TD CLASS="FILENAME"
>show_bug.cgi</TT
> and
<TT
CLASS="FILENAME"
>process_bug.cgi</TT
>.
</TD
></TR ></TR
><TR ><TR
><TD ><TD
><EM ><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
><TR ><TR
><TD ><TD
><EM ><EM
>LXR</EM >Email</EM
>, >,
a utility that automatically marks up text files Anything to do with email sent by Bugzilla.
to make them more readable</TD <TT
CLASS="FILENAME"
>processmail</TT
>
</TD
></TR ></TR
><TR ><TR
><TD ><TD
><EM ><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
><TR ><TR
><TD ><TD
><EM ><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
><TR ><TR
><TD ><TD
><EM ><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 ></TR
></TBODY ></TBODY
></TABLE ></TABLE
...@@ -600,11 +706,6 @@ BORDER="0" ...@@ -600,11 +706,6 @@ BORDER="0"
> >
</P </P
><P ><P
> A different person is responsible for each of these Components.
Tara Hernandez keeps
the "Bugzilla" component up-to-date.
</P
><P
></P ></P
></DIV ></DIV
></DIV ></DIV
......
docs/html/index.html
View file @ 58593ba9
...@@ -59,7 +59,7 @@ CLASS="AFFILIATION" ...@@ -59,7 +59,7 @@ CLASS="AFFILIATION"
CLASS="ADDRESS" CLASS="ADDRESS"
><P ><P
CLASS="ADDRESS" CLASS="ADDRESS"
>barnboy@NOSPAM.trilobyte.net</P >barnboy@trilobyte.net</P
></DIV ></DIV
></DIV ></DIV
><SPAN ><SPAN
...@@ -73,7 +73,7 @@ CLASS="AFFILIATION" ...@@ -73,7 +73,7 @@ CLASS="AFFILIATION"
CLASS="ADDRESS" CLASS="ADDRESS"
><P ><P
CLASS="ADDRESS" CLASS="ADDRESS"
>zach@NOSPAM.zachlipton.com</P >zach AT zachlipton DOT com</P
></DIV ></DIV
></DIV ></DIV
><BR></SPAN ><BR></SPAN
...@@ -409,12 +409,12 @@ HREF="stepbystep.html" ...@@ -409,12 +409,12 @@ HREF="stepbystep.html"
><DL ><DL
><DT ><DT
>3.2.1. <A >3.2.1. <A
HREF="stepbystep.html#AEN486" HREF="stepbystep.html#AEN509"
>Introduction</A >Introduction</A
></DT ></DT
><DT ><DT
>3.2.2. <A >3.2.2. <A
HREF="stepbystep.html#AEN492" HREF="stepbystep.html#AEN515"
>Installing the Prerequisites</A >Installing the Prerequisites</A
></DT ></DT
><DT ><DT
...@@ -429,57 +429,57 @@ HREF="stepbystep.html#INSTALL-PERL" ...@@ -429,57 +429,57 @@ HREF="stepbystep.html#INSTALL-PERL"
></DT ></DT
><DT ><DT
>3.2.5. <A >3.2.5. <A
HREF="stepbystep.html#AEN579" HREF="stepbystep.html#AEN602"
>DBI Perl Module</A >DBI Perl Module</A
></DT ></DT
><DT ><DT
>3.2.6. <A >3.2.6. <A
HREF="stepbystep.html#AEN617" HREF="stepbystep.html#AEN640"
>Data::Dumper Perl Module</A >Data::Dumper Perl Module</A
></DT ></DT
><DT ><DT
>3.2.7. <A >3.2.7. <A
HREF="stepbystep.html#AEN622" HREF="stepbystep.html#AEN645"
>MySQL related Perl Module Collection</A >MySQL related Perl Module Collection</A
></DT ></DT
><DT ><DT
>3.2.8. <A >3.2.8. <A
HREF="stepbystep.html#AEN631" HREF="stepbystep.html#AEN654"
>TimeDate Perl Module Collection</A >TimeDate Perl Module Collection</A
></DT ></DT
><DT ><DT
>3.2.9. <A >3.2.9. <A
HREF="stepbystep.html#AEN635" HREF="stepbystep.html#AEN658"
>GD Perl Module (1.8.3)</A >GD Perl Module (1.8.3)</A
></DT ></DT
><DT ><DT
>3.2.10. <A >3.2.10. <A
HREF="stepbystep.html#AEN644" HREF="stepbystep.html#AEN667"
>Chart::Base Perl Module (0.99c)</A >Chart::Base Perl Module (0.99c)</A
></DT ></DT
><DT ><DT
>3.2.11. <A >3.2.11. <A
HREF="stepbystep.html#AEN648" HREF="stepbystep.html#AEN671"
>DB_File Perl Module</A >DB_File Perl Module</A
></DT ></DT
><DT ><DT
>3.2.12. <A >3.2.12. <A
HREF="stepbystep.html#AEN651" HREF="stepbystep.html#AEN674"
>HTTP Server</A >HTTP Server</A
></DT ></DT
><DT ><DT
>3.2.13. <A >3.2.13. <A
HREF="stepbystep.html#AEN669" HREF="stepbystep.html#AEN692"
>Installing the Bugzilla Files</A >Installing the Bugzilla Files</A
></DT ></DT
><DT ><DT
>3.2.14. <A >3.2.14. <A
HREF="stepbystep.html#AEN696" HREF="stepbystep.html#AEN721"
>Setting Up the MySQL Database</A >Setting Up the MySQL Database</A
></DT ></DT
><DT ><DT
>3.2.15. <A >3.2.15. <A
HREF="stepbystep.html#AEN743" HREF="stepbystep.html#AEN768"
>Tweaking <TT >Tweaking <TT
CLASS="FILENAME" CLASS="FILENAME"
>localconfig</TT >localconfig</TT
...@@ -487,22 +487,22 @@ CLASS="FILENAME" ...@@ -487,22 +487,22 @@ CLASS="FILENAME"
></DT ></DT
><DT ><DT
>3.2.16. <A >3.2.16. <A
HREF="stepbystep.html#AEN781" HREF="stepbystep.html#AEN806"
>Setting Up Maintainers Manually (Optional)</A >Setting Up Maintainers Manually (Optional)</A
></DT ></DT
><DT ><DT
>3.2.17. <A >3.2.17. <A
HREF="stepbystep.html#AEN792" HREF="stepbystep.html#AEN817"
>The Whining Cron (Optional)</A >The Whining Cron (Optional)</A
></DT ></DT
><DT ><DT
>3.2.18. <A >3.2.18. <A
HREF="stepbystep.html#AEN802" HREF="stepbystep.html#AEN827"
>Bug Graphs (Optional)</A >Bug Graphs (Optional)</A
></DT ></DT
><DT ><DT
>3.2.19. <A >3.2.19. <A
HREF="stepbystep.html#AEN814" HREF="stepbystep.html#AEN839"
>Securing MySQL</A >Securing MySQL</A
></DT ></DT
></DL ></DL
...@@ -526,12 +526,12 @@ HREF="geninstall.html" ...@@ -526,12 +526,12 @@ HREF="geninstall.html"
><DL ><DL
><DT ><DT
>3.5.1. <A >3.5.1. <A
HREF="geninstall.html#AEN916" HREF="geninstall.html#AEN941"
>Modifying Your Running System</A >Modifying Your Running System</A
></DT ></DT
><DT ><DT
>3.5.2. <A >3.5.2. <A
HREF="geninstall.html#AEN923" HREF="geninstall.html#AEN948"
>Upgrading From Previous Versions</A >Upgrading From Previous Versions</A
></DT ></DT
><DT ><DT
...@@ -557,7 +557,7 @@ HREF="geninstall.html#CONTENT_TYPE" ...@@ -557,7 +557,7 @@ HREF="geninstall.html#CONTENT_TYPE"
></DT ></DT
><DT ><DT
>3.5.6. <A >3.5.6. <A
HREF="geninstall.html#AEN964" HREF="geninstall.html#UNIXHISTORY"
>UNIX Installation Instructions History</A >UNIX Installation Instructions History</A
></DT ></DT
></DL ></DL
...@@ -579,6 +579,11 @@ HREF="win32.html#WININSTALL" ...@@ -579,6 +579,11 @@ HREF="win32.html#WININSTALL"
HREF="win32.html#ADDLWINTIPS" HREF="win32.html#ADDLWINTIPS"
>Additional Windows Tips</A >Additional Windows Tips</A
></DT ></DT
><DT
>3.6.3. <A
HREF="win32.html#BZLDAP"
>Bugzilla LDAP Integration</A
></DT
></DL ></DL
></DD ></DD
></DL ></DL
...@@ -720,6 +725,45 @@ HREF="future.html" ...@@ -720,6 +725,45 @@ HREF="future.html"
>The Future of Bugzilla</A >The Future of Bugzilla</A
></DT ></DT
><DT ><DT
>7. <A
HREF="variants.html"
>Bugzilla Variants and Competitors</A
></DT
><DD
><DL
><DT
>7.1. <A
HREF="rhbugzilla.html"
>Red Hat Bugzilla</A
></DT
><DT
>7.2. <A
HREF="variant_fenris.html"
>Loki Bugzilla (Fenris)</A
></DT
><DT
>7.3. <A
HREF="variant_issuezilla.html"
>Issuezilla</A
></DT
><DT
>7.4. <A
HREF="variant_scarab.html"
>Scarab</A
></DT
><DT
>7.5. <A
HREF="variant_perforce.html"
>Perforce SCM</A
></DT
><DT
>7.6. <A
HREF="variant_sourceforge.html"
>SourceForge</A
></DT
></DL
></DD
><DT
>A. <A >A. <A
HREF="faq.html" HREF="faq.html"
>The Bugzilla FAQ</A >The Bugzilla FAQ</A
...@@ -750,14 +794,14 @@ HREF="dbdoc.html" ...@@ -750,14 +794,14 @@ HREF="dbdoc.html"
><DL ><DL
><DT ><DT
>C.2.1. <A >C.2.1. <A
HREF="dbdoc.html#AEN2217" HREF="dbdoc.html#AEN2331"
>Bugzilla Database Basics</A >Bugzilla Database Basics</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>C.2.1.1. <A >C.2.1.1. <A
HREF="dbdoc.html#AEN2246" HREF="dbdoc.html#AEN2360"
>Bugzilla Database Tables</A >Bugzilla Database Tables</A
></DT ></DT
></DL ></DL
...@@ -772,45 +816,6 @@ HREF="granttables.html" ...@@ -772,45 +816,6 @@ HREF="granttables.html"
></DL ></DL
></DD ></DD
><DT ><DT
>7. <A
HREF="variants.html"
>Bugzilla Variants and Competitors</A
></DT
><DD
><DL
><DT
>7.1. <A
HREF="rhbugzilla.html"
>Red Hat Bugzilla</A
></DT
><DT
>7.2. <A
HREF="variant_fenris.html"
>Loki Bugzilla (Fenris)</A
></DT
><DT
>7.3. <A
HREF="variant_issuezilla.html"
>Issuezilla</A
></DT
><DT
>7.4. <A
HREF="variant_scarab.html"
>Scarab</A
></DT
><DT
>7.5. <A
HREF="variant_perforce.html"
>Perforce SCM</A
></DT
><DT
>7.6. <A
HREF="variant_sourceforge.html"
>SourceForge</A
></DT
></DL
></DD
><DT
>D. <A >D. <A
HREF="patches.html" HREF="patches.html"
>Useful Patches and Utilities for Bugzilla</A >Useful Patches and Utilities for Bugzilla</A
...@@ -840,6 +845,11 @@ HREF="cmdline.html" ...@@ -840,6 +845,11 @@ HREF="cmdline.html"
HREF="quicksearch.html" HREF="quicksearch.html"
>The Quicksearch Utility</A >The Quicksearch Utility</A
></DT ></DT
><DT
>D.5. <A
HREF="bzhacking.html"
>Hacking Bugzilla</A
></DT
></DL ></DL
></DD ></DD
><DT ><DT
...@@ -934,67 +944,72 @@ HREF="how.html#AEN307" ...@@ -934,67 +944,72 @@ HREF="how.html#AEN307"
><DT ><DT
>2-2. <A >2-2. <A
HREF="how.html#AEN317" HREF="how.html#AEN317"
>Mozilla Webtools Components</A >Mozilla's Bugzilla Components</A
></DT ></DT
><DT ><DT
>3-1. <A >3-1. <A
HREF="stepbystep.html#AEN685" HREF="stepbystep.html#AEN708"
>Setting up bonsaitools symlink</A >Setting up bonsaitools symlink</A
></DT ></DT
><DT ><DT
>3-2. <A >3-2. <A
HREF="stepbystep.html#AEN774" HREF="stepbystep.html#AEN799"
>Running checksetup.pl as the web user</A >Running checksetup.pl as the web user</A
></DT ></DT
><DT ><DT
>3-3. <A >3-3. <A
HREF="win32.html#AEN1012" HREF="win32.html#AEN1038"
>Installing ActivePerl ppd Modules on Microsoft Windows</A >Installing ActivePerl ppd Modules on Microsoft Windows</A
></DT ></DT
><DT ><DT
>3-4. <A >3-4. <A
HREF="win32.html#AEN1180" HREF="win32.html#AEN1224"
>Removing encrypt() for Windows NT Bugzilla version >Removing encrypt() for Windows NT Bugzilla version
2.12 or earlier</A 2.12 or earlier</A
></DT ></DT
><DT ><DT
>4-1. <A >4-1. <A
HREF="programadmin.html#AEN1413" HREF="programadmin.html#AEN1461"
>Creating some Components</A >Creating some Components</A
></DT ></DT
><DT ><DT
>4-2. <A >4-2. <A
HREF="programadmin.html#AEN1442" HREF="programadmin.html#AEN1490"
>Common Use of Versions</A >Common Use of Versions</A
></DT ></DT
><DT ><DT
>4-3. <A >4-3. <A
HREF="programadmin.html#AEN1446" HREF="programadmin.html#AEN1494"
>A Different Use of Versions</A >A Different Use of Versions</A
></DT ></DT
><DT ><DT
>4-4. <A >4-4. <A
HREF="programadmin.html#AEN1474" HREF="programadmin.html#AEN1522"
>Using SortKey with Target Milestone</A >Using SortKey with Target Milestone</A
></DT ></DT
><DT ><DT
>4-5. <A >4-5. <A
HREF="programadmin.html#AEN1510" HREF="programadmin.html#AEN1558"
>When to Use Group Security</A >When to Use Group Security</A
></DT ></DT
><DT ><DT
>4-6. <A >4-6. <A
HREF="programadmin.html#AEN1527" HREF="programadmin.html#AEN1575"
>Creating a New Group</A >Creating a New Group</A
></DT ></DT
><DT ><DT
>4-7. <A
HREF="programadmin.html#AEN1592"
>Bugzilla Groups</A
></DT
><DT
>D-1. <A >D-1. <A
HREF="setperl.html#AEN2360" HREF="setperl.html#AEN2439"
>Using Setperl to set your perl path</A >Using Setperl to set your perl path</A
></DT ></DT
><DT ><DT
>1. <A >1. <A
HREF="glossary.html#AEN2602" HREF="glossary.html#AEN2685"
>A Sample Product</A >A Sample Product</A
></DT ></DT
></DL ></DL
......
docs/html/installation.html
View file @ 58593ba9
...@@ -90,12 +90,12 @@ HREF="stepbystep.html" ...@@ -90,12 +90,12 @@ HREF="stepbystep.html"
><DL ><DL
><DT ><DT
>3.2.1. <A >3.2.1. <A
HREF="stepbystep.html#AEN486" HREF="stepbystep.html#AEN509"
>Introduction</A >Introduction</A
></DT ></DT
><DT ><DT
>3.2.2. <A >3.2.2. <A
HREF="stepbystep.html#AEN492" HREF="stepbystep.html#AEN515"
>Installing the Prerequisites</A >Installing the Prerequisites</A
></DT ></DT
><DT ><DT
...@@ -110,57 +110,57 @@ HREF="stepbystep.html#INSTALL-PERL" ...@@ -110,57 +110,57 @@ HREF="stepbystep.html#INSTALL-PERL"
></DT ></DT
><DT ><DT
>3.2.5. <A >3.2.5. <A
HREF="stepbystep.html#AEN579" HREF="stepbystep.html#AEN602"
>DBI Perl Module</A >DBI Perl Module</A
></DT ></DT
><DT ><DT
>3.2.6. <A >3.2.6. <A
HREF="stepbystep.html#AEN617" HREF="stepbystep.html#AEN640"
>Data::Dumper Perl Module</A >Data::Dumper Perl Module</A
></DT ></DT
><DT ><DT
>3.2.7. <A >3.2.7. <A
HREF="stepbystep.html#AEN622" HREF="stepbystep.html#AEN645"
>MySQL related Perl Module Collection</A >MySQL related Perl Module Collection</A
></DT ></DT
><DT ><DT
>3.2.8. <A >3.2.8. <A
HREF="stepbystep.html#AEN631" HREF="stepbystep.html#AEN654"
>TimeDate Perl Module Collection</A >TimeDate Perl Module Collection</A
></DT ></DT
><DT ><DT
>3.2.9. <A >3.2.9. <A
HREF="stepbystep.html#AEN635" HREF="stepbystep.html#AEN658"
>GD Perl Module (1.8.3)</A >GD Perl Module (1.8.3)</A
></DT ></DT
><DT ><DT
>3.2.10. <A >3.2.10. <A
HREF="stepbystep.html#AEN644" HREF="stepbystep.html#AEN667"
>Chart::Base Perl Module (0.99c)</A >Chart::Base Perl Module (0.99c)</A
></DT ></DT
><DT ><DT
>3.2.11. <A >3.2.11. <A
HREF="stepbystep.html#AEN648" HREF="stepbystep.html#AEN671"
>DB_File Perl Module</A >DB_File Perl Module</A
></DT ></DT
><DT ><DT
>3.2.12. <A >3.2.12. <A
HREF="stepbystep.html#AEN651" HREF="stepbystep.html#AEN674"
>HTTP Server</A >HTTP Server</A
></DT ></DT
><DT ><DT
>3.2.13. <A >3.2.13. <A
HREF="stepbystep.html#AEN669" HREF="stepbystep.html#AEN692"
>Installing the Bugzilla Files</A >Installing the Bugzilla Files</A
></DT ></DT
><DT ><DT
>3.2.14. <A >3.2.14. <A
HREF="stepbystep.html#AEN696" HREF="stepbystep.html#AEN721"
>Setting Up the MySQL Database</A >Setting Up the MySQL Database</A
></DT ></DT
><DT ><DT
>3.2.15. <A >3.2.15. <A
HREF="stepbystep.html#AEN743" HREF="stepbystep.html#AEN768"
>Tweaking <TT >Tweaking <TT
CLASS="FILENAME" CLASS="FILENAME"
>localconfig</TT >localconfig</TT
...@@ -168,22 +168,22 @@ CLASS="FILENAME" ...@@ -168,22 +168,22 @@ CLASS="FILENAME"
></DT ></DT
><DT ><DT
>3.2.16. <A >3.2.16. <A
HREF="stepbystep.html#AEN781" HREF="stepbystep.html#AEN806"
>Setting Up Maintainers Manually (Optional)</A >Setting Up Maintainers Manually (Optional)</A
></DT ></DT
><DT ><DT
>3.2.17. <A >3.2.17. <A
HREF="stepbystep.html#AEN792" HREF="stepbystep.html#AEN817"
>The Whining Cron (Optional)</A >The Whining Cron (Optional)</A
></DT ></DT
><DT ><DT
>3.2.18. <A >3.2.18. <A
HREF="stepbystep.html#AEN802" HREF="stepbystep.html#AEN827"
>Bug Graphs (Optional)</A >Bug Graphs (Optional)</A
></DT ></DT
><DT ><DT
>3.2.19. <A >3.2.19. <A
HREF="stepbystep.html#AEN814" HREF="stepbystep.html#AEN839"
>Securing MySQL</A >Securing MySQL</A
></DT ></DT
></DL ></DL
...@@ -207,12 +207,12 @@ HREF="geninstall.html" ...@@ -207,12 +207,12 @@ HREF="geninstall.html"
><DL ><DL
><DT ><DT
>3.5.1. <A >3.5.1. <A
HREF="geninstall.html#AEN916" HREF="geninstall.html#AEN941"
>Modifying Your Running System</A >Modifying Your Running System</A
></DT ></DT
><DT ><DT
>3.5.2. <A >3.5.2. <A
HREF="geninstall.html#AEN923" HREF="geninstall.html#AEN948"
>Upgrading From Previous Versions</A >Upgrading From Previous Versions</A
></DT ></DT
><DT ><DT
...@@ -238,7 +238,7 @@ HREF="geninstall.html#CONTENT_TYPE" ...@@ -238,7 +238,7 @@ HREF="geninstall.html#CONTENT_TYPE"
></DT ></DT
><DT ><DT
>3.5.6. <A >3.5.6. <A
HREF="geninstall.html#AEN964" HREF="geninstall.html#UNIXHISTORY"
>UNIX Installation Instructions History</A >UNIX Installation Instructions History</A
></DT ></DT
></DL ></DL
...@@ -260,6 +260,11 @@ HREF="win32.html#WININSTALL" ...@@ -260,6 +260,11 @@ HREF="win32.html#WININSTALL"
HREF="win32.html#ADDLWINTIPS" HREF="win32.html#ADDLWINTIPS"
>Additional Windows Tips</A >Additional Windows Tips</A
></DT ></DT
><DT
>3.6.3. <A
HREF="win32.html#BZLDAP"
>Bugzilla LDAP Integration</A
></DT
></DL ></DL
></DD ></DD
></DL ></DL
......
docs/html/patches.html
View file @ 58593ba9
...@@ -10,8 +10,8 @@ REL="HOME" ...@@ -10,8 +10,8 @@ REL="HOME"
TITLE="The Bugzilla Guide" TITLE="The Bugzilla Guide"
HREF="index.html"><LINK HREF="index.html"><LINK
REL="PREVIOUS" REL="PREVIOUS"
TITLE="SourceForge" TITLE="MySQL Permissions & Grant Tables"
HREF="variant_sourceforge.html"><LINK HREF="granttables.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Apache mod_rewrite magic" TITLE="Apache mod_rewrite magic"
HREF="rewrite.html"></HEAD HREF="rewrite.html"></HEAD
...@@ -41,7 +41,7 @@ WIDTH="10%" ...@@ -41,7 +41,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="variant_sourceforge.html" HREF="granttables.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -99,6 +99,11 @@ HREF="cmdline.html" ...@@ -99,6 +99,11 @@ HREF="cmdline.html"
HREF="quicksearch.html" HREF="quicksearch.html"
>The Quicksearch Utility</A >The Quicksearch Utility</A
></DT ></DT
><DT
>D.5. <A
HREF="bzhacking.html"
>Hacking Bugzilla</A
></DT
></DL ></DL
></DIV ></DIV
><P ><P
...@@ -119,7 +124,7 @@ WIDTH="33%" ...@@ -119,7 +124,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="variant_sourceforge.html" HREF="granttables.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -144,7 +149,7 @@ HREF="rewrite.html" ...@@ -144,7 +149,7 @@ HREF="rewrite.html"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>SourceForge</TD >MySQL Permissions &#38; Grant Tables</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
......
docs/html/programadmin.html
View file @ 58593ba9
...@@ -232,7 +232,7 @@ NAME="COMPONENTS" ...@@ -232,7 +232,7 @@ NAME="COMPONENTS"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1413" NAME="AEN1461"
></A ></A
><P ><P
><B ><B
...@@ -241,7 +241,7 @@ NAME="AEN1413" ...@@ -241,7 +241,7 @@ NAME="AEN1413"
><DIV ><DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN1415" NAME="AEN1463"
></A ></A
><P ><P
></P ></P
...@@ -387,7 +387,7 @@ NAME="VERSIONS" ...@@ -387,7 +387,7 @@ NAME="VERSIONS"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1442" NAME="AEN1490"
></A ></A
><P ><P
><B ><B
...@@ -396,7 +396,7 @@ NAME="AEN1442" ...@@ -396,7 +396,7 @@ NAME="AEN1442"
><DIV ><DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN1444" NAME="AEN1492"
></A ></A
><P ><P
></P ></P
...@@ -418,7 +418,7 @@ NAME="AEN1444" ...@@ -418,7 +418,7 @@ NAME="AEN1444"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1446" NAME="AEN1494"
></A ></A
><P ><P
><B ><B
...@@ -427,7 +427,7 @@ NAME="AEN1446" ...@@ -427,7 +427,7 @@ NAME="AEN1446"
><DIV ><DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN1448" NAME="AEN1496"
></A ></A
><P ><P
></P ></P
...@@ -564,7 +564,7 @@ TYPE="1" ...@@ -564,7 +564,7 @@ TYPE="1"
><DIV ><DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1474" NAME="AEN1522"
></A ></A
><P ><P
><B ><B
...@@ -573,7 +573,7 @@ NAME="AEN1474" ...@@ -573,7 +573,7 @@ NAME="AEN1474"
><DIV ><DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN1476" NAME="AEN1524"
></A ></A
><P ><P
></P ></P
...@@ -787,7 +787,7 @@ NAME="GROUPS" ...@@ -787,7 +787,7 @@ NAME="GROUPS"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1510" NAME="AEN1558"
></A ></A
><P ><P
><B ><B
...@@ -796,7 +796,7 @@ NAME="AEN1510" ...@@ -796,7 +796,7 @@ NAME="AEN1510"
><DIV ><DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN1512" NAME="AEN1560"
></A ></A
><P ><P
></P ></P
...@@ -913,7 +913,7 @@ TYPE="1" ...@@ -913,7 +913,7 @@ TYPE="1"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1527" NAME="AEN1575"
></A ></A
><P ><P
><B ><B
...@@ -922,7 +922,7 @@ NAME="AEN1527" ...@@ -922,7 +922,7 @@ NAME="AEN1527"
><DIV ><DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN1529" NAME="AEN1577"
></A ></A
><P ><P
></P ></P
...@@ -1043,6 +1043,112 @@ VALIGN="TOP" ...@@ -1043,6 +1043,112 @@ VALIGN="TOP"
</P </P
></LI ></LI
></OL ></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&nbsp;Groups&nbsp;example<br>
-----------------------<br>
<br>
For&nbsp;this&nbsp;example,&nbsp;let&nbsp;us&nbsp;suppose&nbsp;we&nbsp;have&nbsp;four&nbsp;groups,&nbsp;call&nbsp;them<br>
Group1,&nbsp;Group2,&nbsp;Group3,&nbsp;and&nbsp;Group4.<br>
<br>
We&nbsp;have&nbsp;5&nbsp;users,&nbsp;User1,&nbsp;User2,&nbsp;User3,&nbsp;User4,&nbsp;User5.<br>
<br>
We&nbsp;have&nbsp;8&nbsp;bugs,&nbsp;Bug1,&nbsp;...,&nbsp;Bug8.<br>
<br>
Group&nbsp;membership&nbsp;is&nbsp;defined&nbsp;by&nbsp;this&nbsp;chart:<br>
(X&nbsp;denotes&nbsp;that&nbsp;user&nbsp;is&nbsp;in&nbsp;that&nbsp;group.)<br>
(I&nbsp;apologize&nbsp;for&nbsp;the&nbsp;nasty&nbsp;formatting&nbsp;of&nbsp;this&nbsp;table.&nbsp;&nbsp;Try&nbsp;viewing<br>
it&nbsp;in&nbsp;a&nbsp;text-based&nbsp;browser&nbsp;or&nbsp;something&nbsp;for&nbsp;now.&nbsp;-MPB)<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;G&nbsp;G&nbsp;G&nbsp;G<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;r&nbsp;r&nbsp;r&nbsp;r<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;o&nbsp;o&nbsp;o&nbsp;o<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;u&nbsp;u&nbsp;u&nbsp;u<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;p&nbsp;p&nbsp;p&nbsp;p<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1&nbsp;2&nbsp;3&nbsp;4<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
User1|X|&nbsp;|&nbsp;|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
User2|&nbsp;|X|&nbsp;|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
User3|X|&nbsp;|X|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
User4|X|X|X|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
User5|&nbsp;|&nbsp;|&nbsp;|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
<br>
Bug&nbsp;restrictions&nbsp;are&nbsp;defined&nbsp;by&nbsp;this&nbsp;chart:<br>
(X&nbsp;denotes&nbsp;that&nbsp;bug&nbsp;is&nbsp;restricted&nbsp;to&nbsp;that&nbsp;group.)<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;G&nbsp;G&nbsp;G&nbsp;G<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;r&nbsp;r&nbsp;r&nbsp;r<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;o&nbsp;o&nbsp;o&nbsp;o<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;u&nbsp;u&nbsp;u&nbsp;u<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;p&nbsp;p&nbsp;p&nbsp;p<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1&nbsp;2&nbsp;3&nbsp;4<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug1|&nbsp;|&nbsp;|&nbsp;|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug2|&nbsp;|X|&nbsp;|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug3|&nbsp;|&nbsp;|X|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug4|&nbsp;|&nbsp;|&nbsp;|X|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug5|X|X|&nbsp;|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug6|X|&nbsp;|X|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug7|X|X|X|&nbsp;|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
Bug8|X|X|X|X|<br>
&nbsp;&nbsp;&nbsp;&nbsp;+-+-+-+-+<br>
<br>
Who&nbsp;can&nbsp;see&nbsp;each&nbsp;bug?<br>
<br>
Bug1&nbsp;has&nbsp;no&nbsp;group&nbsp;restrictions.&nbsp;&nbsp;Therefore,&nbsp;Bug1&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;any<br>
user,&nbsp;whatever&nbsp;their&nbsp;group&nbsp;membership.&nbsp;&nbsp;This&nbsp;is&nbsp;going&nbsp;to&nbsp;be&nbsp;the&nbsp;only<br>
bug&nbsp;that&nbsp;User5&nbsp;can&nbsp;see,&nbsp;because&nbsp;User5&nbsp;isn't&nbsp;in&nbsp;any&nbsp;groups.<br>
<br>
Bug2&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;anyone&nbsp;in&nbsp;Group2,&nbsp;that&nbsp;is&nbsp;User2&nbsp;and&nbsp;User4.<br>
<br>
Bug3&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;anyone&nbsp;in&nbsp;Group3,&nbsp;that&nbsp;is&nbsp;User3&nbsp;and&nbsp;User4.<br>
<br>
Bug4&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;anyone&nbsp;in&nbsp;Group4.&nbsp;&nbsp;Nobody&nbsp;is&nbsp;in&nbsp;Group4,&nbsp;so&nbsp;none&nbsp;of<br>
these&nbsp;users&nbsp;can&nbsp;see&nbsp;Bug4.<br>
<br>
Bug5&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;anyone&nbsp;who&nbsp;is&nbsp;in&nbsp;_both_&nbsp;Group1&nbsp;and&nbsp;Group2.&nbsp;&nbsp;This<br>
is&nbsp;only&nbsp;User4.&nbsp;&nbsp;User1&nbsp;cannot&nbsp;see&nbsp;it&nbsp;because&nbsp;he&nbsp;is&nbsp;not&nbsp;in&nbsp;Group2,&nbsp;and<br>
User2&nbsp;cannot&nbsp;see&nbsp;it&nbsp;because&nbsp;she&nbsp;is&nbsp;not&nbsp;in&nbsp;Group1.<br>
<br>
Bug6&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;anyone&nbsp;who&nbsp;is&nbsp;in&nbsp;both&nbsp;Group1&nbsp;and&nbsp;Group3.&nbsp;&nbsp;This<br>
would&nbsp;include&nbsp;User3&nbsp;and&nbsp;User4.&nbsp;&nbsp;Similar&nbsp;to&nbsp;Bug5,&nbsp;User1&nbsp;cannot&nbsp;see&nbsp;Bug6<br>
because&nbsp;he&nbsp;is&nbsp;not&nbsp;in&nbsp;Group3.<br>
<br>
Bug7&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;anyone&nbsp;who&nbsp;is&nbsp;in&nbsp;Group1,&nbsp;Group2,&nbsp;and&nbsp;Group3.&nbsp;&nbsp;This<br>
is&nbsp;only&nbsp;User4.&nbsp;&nbsp;All&nbsp;of&nbsp;the&nbsp;others&nbsp;are&nbsp;missing&nbsp;at&nbsp;least&nbsp;one&nbsp;of&nbsp;those<br>
group&nbsp;priveleges,&nbsp;and&nbsp;thus&nbsp;cannot&nbsp;see&nbsp;the&nbsp;bug.<br>
<br>
Bug8&nbsp;can&nbsp;be&nbsp;seen&nbsp;by&nbsp;anyone&nbsp;who&nbsp;is&nbsp;in&nbsp;Group1,&nbsp;Group2,&nbsp;Group3,&nbsp;and<br>
Group4.&nbsp;&nbsp;There&nbsp;is&nbsp;nobody&nbsp;in&nbsp;all&nbsp;four&nbsp;of&nbsp;these&nbsp;groups,&nbsp;so&nbsp;nobody&nbsp;can<br>
see&nbsp;Bug8.&nbsp;&nbsp;It&nbsp;doesn't&nbsp;matter&nbsp;that&nbsp;User4&nbsp;is&nbsp;in&nbsp;Group1,&nbsp;Group2,&nbsp;and<br>
Group3,&nbsp;since&nbsp;he&nbsp;isn't&nbsp;in&nbsp;Group4.<br>
&nbsp;&nbsp;</P
></DIV
>
</P
></DIV ></DIV
></DIV ></DIV
><DIV ><DIV
......
docs/html/quicksearch.html
View file @ 58593ba9
...@@ -16,8 +16,8 @@ REL="PREVIOUS" ...@@ -16,8 +16,8 @@ REL="PREVIOUS"
TITLE="Command-line Bugzilla Queries" TITLE="Command-line Bugzilla Queries"
HREF="cmdline.html"><LINK HREF="cmdline.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="GNU Free Documentation License" TITLE="Hacking Bugzilla"
HREF="gfdl.html"></HEAD HREF="bzhacking.html"></HEAD
><BODY ><BODY
CLASS="SECTION" CLASS="SECTION"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -57,7 +57,7 @@ WIDTH="10%" ...@@ -57,7 +57,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="gfdl.html" HREF="bzhacking.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -160,7 +160,7 @@ WIDTH="33%" ...@@ -160,7 +160,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="gfdl.html" HREF="bzhacking.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -182,7 +182,7 @@ HREF="patches.html" ...@@ -182,7 +182,7 @@ HREF="patches.html"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>GNU Free Documentation License</TD >Hacking Bugzilla</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
docs/html/setperl.html
View file @ 58593ba9
...@@ -216,7 +216,7 @@ CLASS="COMMAND" ...@@ -216,7 +216,7 @@ CLASS="COMMAND"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN2360" NAME="AEN2439"
></A ></A
><P ><P
><B ><B
......
docs/html/stepbystep.html
View file @ 58593ba9
...@@ -78,7 +78,7 @@ CLASS="SECTION" ...@@ -78,7 +78,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN486" NAME="AEN509"
>3.2.1. Introduction</A >3.2.1. Introduction</A
></H2 ></H2
><P ><P
...@@ -109,7 +109,7 @@ CLASS="SECTION" ...@@ -109,7 +109,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN492" NAME="AEN515"
>3.2.2. Installing the Prerequisites</A >3.2.2. Installing the Prerequisites</A
></H2 ></H2
><DIV ><DIV
...@@ -613,7 +613,7 @@ CLASS="SECTION" ...@@ -613,7 +613,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN579" NAME="AEN602"
>3.2.5. DBI Perl Module</A >3.2.5. DBI Perl Module</A
></H2 ></H2
><P ><P
...@@ -642,7 +642,7 @@ HREF="downloadlinks.html" ...@@ -642,7 +642,7 @@ HREF="downloadlinks.html"
<DIV <DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN586" NAME="AEN609"
></A ></A
><P ><P
></P ></P
...@@ -696,7 +696,7 @@ VALIGN="TOP" ...@@ -696,7 +696,7 @@ VALIGN="TOP"
<DIV <DIV
CLASS="INFORMALEXAMPLE" CLASS="INFORMALEXAMPLE"
><A ><A
NAME="AEN593" NAME="AEN616"
></A ></A
><P ><P
></P ></P
...@@ -789,7 +789,7 @@ CLASS="SECTION" ...@@ -789,7 +789,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN617" NAME="AEN640"
>3.2.6. Data::Dumper Perl Module</A >3.2.6. Data::Dumper Perl Module</A
></H2 ></H2
><P ><P
...@@ -814,7 +814,7 @@ CLASS="SECTION" ...@@ -814,7 +814,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN622" NAME="AEN645"
>3.2.7. MySQL related Perl Module Collection</A >3.2.7. MySQL related Perl Module Collection</A
></H2 ></H2
><P ><P
...@@ -860,7 +860,7 @@ CLASS="SECTION" ...@@ -860,7 +860,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN631" NAME="AEN654"
>3.2.8. TimeDate Perl Module Collection</A >3.2.8. TimeDate Perl Module Collection</A
></H2 ></H2
><P ><P
...@@ -882,7 +882,7 @@ CLASS="SECTION" ...@@ -882,7 +882,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN635" NAME="AEN658"
>3.2.9. GD Perl Module (1.8.3)</A >3.2.9. GD Perl Module (1.8.3)</A
></H2 ></H2
><P ><P
...@@ -948,7 +948,7 @@ CLASS="SECTION" ...@@ -948,7 +948,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN644" NAME="AEN667"
>3.2.10. Chart::Base Perl Module (0.99c)</A >3.2.10. Chart::Base Perl Module (0.99c)</A
></H2 ></H2
><P ><P
...@@ -969,7 +969,7 @@ CLASS="SECTION" ...@@ -969,7 +969,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN648" NAME="AEN671"
>3.2.11. DB_File Perl Module</A >3.2.11. DB_File Perl Module</A
></H2 ></H2
><P ><P
...@@ -985,7 +985,7 @@ CLASS="SECTION" ...@@ -985,7 +985,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN651" NAME="AEN674"
>3.2.12. HTTP Server</A >3.2.12. HTTP Server</A
></H2 ></H2
><P ><P
...@@ -1156,7 +1156,7 @@ CLASS="SECTION" ...@@ -1156,7 +1156,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN669" NAME="AEN692"
>3.2.13. Installing the Bugzilla Files</A >3.2.13. Installing the Bugzilla Files</A
></H2 ></H2
><P ><P
...@@ -1247,7 +1247,7 @@ HREF="patches.html" ...@@ -1247,7 +1247,7 @@ HREF="patches.html"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN685" NAME="AEN708"
></A ></A
><P ><P
><B ><B
...@@ -1290,6 +1290,29 @@ bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl ...@@ -1290,6 +1290,29 @@ bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
></TABLE ></TABLE
> >
</P </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
> >
<DIV <DIV
...@@ -1335,7 +1358,7 @@ CLASS="SECTION" ...@@ -1335,7 +1358,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN696" NAME="AEN721"
>3.2.14. Setting Up the MySQL Database</A >3.2.14. Setting Up the MySQL Database</A
></H2 ></H2
><P ><P
...@@ -1573,7 +1596,7 @@ CLASS="SECTION" ...@@ -1573,7 +1596,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN743" NAME="AEN768"
>3.2.15. Tweaking <TT >3.2.15. Tweaking <TT
CLASS="FILENAME" CLASS="FILENAME"
>localconfig</TT >localconfig</TT
...@@ -1699,7 +1722,7 @@ CLASS="QUOTE" ...@@ -1699,7 +1722,7 @@ CLASS="QUOTE"
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN774" NAME="AEN799"
></A ></A
><P ><P
><B ><B
...@@ -1779,7 +1802,7 @@ CLASS="SECTION" ...@@ -1779,7 +1802,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN781" NAME="AEN806"
>3.2.16. Setting Up Maintainers Manually (Optional)</A >3.2.16. Setting Up Maintainers Manually (Optional)</A
></H2 ></H2
><P ><P
...@@ -1829,7 +1852,7 @@ CLASS="SECTION" ...@@ -1829,7 +1852,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN792" NAME="AEN817"
>3.2.17. The Whining Cron (Optional)</A >3.2.17. The Whining Cron (Optional)</A
></H2 ></H2
><P ><P
...@@ -1915,7 +1938,7 @@ CLASS="SECTION" ...@@ -1915,7 +1938,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN802" NAME="AEN827"
>3.2.18. Bug Graphs (Optional)</A >3.2.18. Bug Graphs (Optional)</A
></H2 ></H2
><P ><P
...@@ -1972,7 +1995,7 @@ CLASS="SECTION" ...@@ -1972,7 +1995,7 @@ CLASS="SECTION"
><H2 ><H2
CLASS="SECTION" CLASS="SECTION"
><A ><A
NAME="AEN814" NAME="AEN839"
>3.2.19. Securing MySQL</A >3.2.19. Securing MySQL</A
></H2 ></H2
><P ><P
......
docs/html/variant_sourceforge.html
View file @ 58593ba9
...@@ -16,8 +16,8 @@ REL="PREVIOUS" ...@@ -16,8 +16,8 @@ REL="PREVIOUS"
TITLE="Perforce SCM" TITLE="Perforce SCM"
HREF="variant_perforce.html"><LINK HREF="variant_perforce.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Useful Patches and Utilities for Bugzilla" TITLE="The Bugzilla FAQ"
HREF="patches.html"></HEAD HREF="faq.html"></HEAD
><BODY ><BODY
CLASS="SECTION" CLASS="SECTION"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -57,7 +57,7 @@ WIDTH="10%" ...@@ -57,7 +57,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="patches.html" HREF="faq.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -117,7 +117,7 @@ WIDTH="33%" ...@@ -117,7 +117,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="patches.html" HREF="faq.html"
>Next</A >Next</A
></TD ></TD
></TR ></TR
...@@ -139,7 +139,7 @@ HREF="variants.html" ...@@ -139,7 +139,7 @@ HREF="variants.html"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>Useful Patches and Utilities for Bugzilla</TD >The Bugzilla FAQ</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
docs/html/variants.html
View file @ 58593ba9
...@@ -10,8 +10,8 @@ REL="HOME" ...@@ -10,8 +10,8 @@ REL="HOME"
TITLE="The Bugzilla Guide" TITLE="The Bugzilla Guide"
HREF="index.html"><LINK HREF="index.html"><LINK
REL="PREVIOUS" REL="PREVIOUS"
TITLE="MySQL Permissions & Grant Tables" TITLE="The Future of Bugzilla"
HREF="granttables.html"><LINK HREF="future.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Red Hat Bugzilla" TITLE="Red Hat Bugzilla"
HREF="rhbugzilla.html"></HEAD HREF="rhbugzilla.html"></HEAD
...@@ -41,7 +41,7 @@ WIDTH="10%" ...@@ -41,7 +41,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="granttables.html" HREF="future.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -133,7 +133,7 @@ WIDTH="33%" ...@@ -133,7 +133,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="granttables.html" HREF="future.html"
>Prev</A >Prev</A
></TD ></TD
><TD ><TD
...@@ -158,7 +158,7 @@ HREF="rhbugzilla.html" ...@@ -158,7 +158,7 @@ HREF="rhbugzilla.html"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>MySQL Permissions &#38; Grant Tables</TD >The Future of Bugzilla</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
......
docs/html/win32.html
View file @ 58593ba9
...@@ -301,7 +301,7 @@ CLASS="COMMAND" ...@@ -301,7 +301,7 @@ CLASS="COMMAND"
><DIV ><DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1012" NAME="AEN1038"
></A ></A
><P ><P
><B ><B
...@@ -1130,7 +1130,9 @@ TARGET="_top" ...@@ -1130,7 +1130,9 @@ TARGET="_top"
></LI ></LI
><LI ><LI
><P ><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 <TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
...@@ -1141,14 +1143,14 @@ WIDTH="100%" ...@@ -1141,14 +1143,14 @@ WIDTH="100%"
COLOR="#000000" COLOR="#000000"
><PRE ><PRE
CLASS="PROGRAMLISTING" CLASS="PROGRAMLISTING"
>system ("./processmail.pl",@ARGLIST); >
system ("./processmail.pl",@ARGLIST);
</PRE </PRE
></FONT ></FONT
></TD ></TD
></TR ></TR
></TABLE ></TABLE
> > to
to
<TABLE <TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
...@@ -1159,7 +1161,8 @@ WIDTH="100%" ...@@ -1159,7 +1161,8 @@ WIDTH="100%"
COLOR="#000000" COLOR="#000000"
><PRE ><PRE
CLASS="PROGRAMLISTING" CLASS="PROGRAMLISTING"
>system ("perl processmail.pl",@ARGLIST); >
system ("perl processmail.pl",@ARGLIST);
</PRE </PRE
></FONT ></FONT
></TD ></TD
...@@ -1168,6 +1171,94 @@ CLASS="PROGRAMLISTING" ...@@ -1168,6 +1171,94 @@ CLASS="PROGRAMLISTING"
> >
</P </P
></LI ></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 ></OL
></DIV ></DIV
><DIV ><DIV
...@@ -1195,7 +1286,9 @@ VALIGN="TOP" ...@@ -1195,7 +1286,9 @@ VALIGN="TOP"
relationships to Properties -&#62; Home directory (tab) -&#62; relationships to Properties -&#62; Home directory (tab) -&#62;
Application Settings (section) -&#62; Configuration (button), Application Settings (section) -&#62; Configuration (button),
such as: such as:
<TABLE </P
><P
> <TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
WIDTH="100%" WIDTH="100%"
...@@ -1254,7 +1347,7 @@ VALIGN="TOP" ...@@ -1254,7 +1347,7 @@ VALIGN="TOP"
><P ><P
> From Andrew Pearson: > From Andrew Pearson:
<A <A
NAME="AEN1169" NAME="AEN1212"
></A ></A
><BLOCKQUOTE ><BLOCKQUOTE
CLASS="BLOCKQUOTE" CLASS="BLOCKQUOTE"
...@@ -1272,7 +1365,23 @@ TARGET="_top" ...@@ -1272,7 +1365,23 @@ TARGET="_top"
registry at the following location: registry at the following location:
</P </P
><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
><P ><P
> The keys should be called ".pl" and ".cgi", and both > The keys should be called ".pl" and ".cgi", and both
...@@ -1319,11 +1428,12 @@ VALIGN="TOP" ...@@ -1319,11 +1428,12 @@ VALIGN="TOP"
<EM <EM
>not necessary</EM >not necessary</EM
> for Bugzilla 2.13 and > for Bugzilla 2.13 and
later. later, which includes the current release, Bugzilla
2.14.
<DIV <DIV
CLASS="EXAMPLE" CLASS="EXAMPLE"
><A ><A
NAME="AEN1180" NAME="AEN1224"
></A ></A
><P ><P
><B ><B
...@@ -1331,7 +1441,7 @@ NAME="AEN1180" ...@@ -1331,7 +1441,7 @@ NAME="AEN1180"
2.12 or earlier</B 2.12 or earlier</B
></P ></P
><P ><P
> Replace this: > Replace this:
<TABLE <TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
...@@ -1342,16 +1452,16 @@ WIDTH="100%" ...@@ -1342,16 +1452,16 @@ WIDTH="100%"
COLOR="#000000" COLOR="#000000"
><PRE ><PRE
CLASS="PROGRAMLISTING" CLASS="PROGRAMLISTING"
> >
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($realcryptpwd, 0, 2)) . ")"); SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($realcryptpwd, 0, 2)) . ")");
my $enteredcryptpwd = FetchOneColumn(); my $enteredcryptpwd = FetchOneColumn();
</PRE </PRE
></FONT ></FONT
></TD ></TD
></TR ></TR
></TABLE ></TABLE
> >
with this: with this:
<TABLE <TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
...@@ -1362,14 +1472,14 @@ WIDTH="100%" ...@@ -1362,14 +1472,14 @@ WIDTH="100%"
COLOR="#000000" COLOR="#000000"
><PRE ><PRE
CLASS="PROGRAMLISTING" CLASS="PROGRAMLISTING"
> >
my $enteredcryptpwd = $enteredpwd my $enteredcryptpwd = $enteredpwd
</PRE </PRE
></FONT ></FONT
></TD ></TD
></TR ></TR
></TABLE ></TABLE
> >
in cgi.pl. in cgi.pl.
</P </P
></DIV ></DIV
...@@ -1380,6 +1490,87 @@ my $enteredcryptpwd = $enteredpwd ...@@ -1380,6 +1490,87 @@ my $enteredcryptpwd = $enteredpwd
></TABLE ></TABLE
></DIV ></DIV
></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&nbsp;module<br>
<br>
The&nbsp;Mozilla::LDAP&nbsp;module&nbsp;allows&nbsp;you&nbsp;to&nbsp;use&nbsp;LDAP&nbsp;for&nbsp;authentication&nbsp;to<br>
the&nbsp;Bugzilla&nbsp;system.&nbsp;&nbsp;This&nbsp;module&nbsp;is&nbsp;not&nbsp;required&nbsp;if&nbsp;you&nbsp;are&nbsp;not&nbsp;using<br>
LDAP.<br>
<br>
Mozilla::LDAP&nbsp;(aka&nbsp;PerLDAP)&nbsp;is&nbsp;available&nbsp;for&nbsp;download&nbsp;from<br>
http://www.mozilla.org/directory.<br>
<br>
NOTE:&nbsp;The&nbsp;Mozilla::LDAP&nbsp;module&nbsp;requires&nbsp;Netscape's&nbsp;Directory&nbsp;SDK.<br>
Follow&nbsp;the&nbsp;link&nbsp;for&nbsp;"Directory&nbsp;SDK&nbsp;for&nbsp;C"&nbsp;on&nbsp;that&nbsp;same&nbsp;page&nbsp;to<br>
download&nbsp;the&nbsp;SDK&nbsp;first.&nbsp;&nbsp;After&nbsp;you&nbsp;have&nbsp;installed&nbsp;this&nbsp;SDK,&nbsp;then<br>
install&nbsp;the&nbsp;PerLDAP&nbsp;module.<br>
----------------------------------------------------------------------<br>
<br>
Post-Installation&nbsp;Checklist<br>
----------------------------------------------------------------------<br>
Set&nbsp;useLDAP&nbsp;to&nbsp;"On"&nbsp;**only**&nbsp;if&nbsp;you&nbsp;will&nbsp;be&nbsp;using&nbsp;an&nbsp;LDAP&nbsp;directory<br>
for&nbsp;authentication.&nbsp;&nbsp;Be&nbsp;very&nbsp;careful&nbsp;when&nbsp;setting&nbsp;up&nbsp;this&nbsp;parameter;<br>
if&nbsp;you&nbsp;set&nbsp;LDAP&nbsp;authentication,&nbsp;but&nbsp;do&nbsp;not&nbsp;have&nbsp;a&nbsp;valid&nbsp;LDAP&nbsp;directory<br>
set&nbsp;up,&nbsp;you&nbsp;will&nbsp;not&nbsp;be&nbsp;able&nbsp;to&nbsp;log&nbsp;back&nbsp;in&nbsp;to&nbsp;Bugzilla&nbsp;once&nbsp;you&nbsp;log<br>
out.&nbsp;&nbsp;(If&nbsp;this&nbsp;happens,&nbsp;you&nbsp;can&nbsp;get&nbsp;back&nbsp;in&nbsp;by&nbsp;manually&nbsp;editing&nbsp;the<br>
data/params&nbsp;file,&nbsp;and&nbsp;setting&nbsp;useLDAP&nbsp;back&nbsp;to&nbsp;0.)<br>
<br>
If&nbsp;using&nbsp;LDAP,&nbsp;you&nbsp;must&nbsp;set&nbsp;the&nbsp;three&nbsp;additional&nbsp;parameters:<br>
<br>
Set&nbsp;LDAPserver&nbsp;to&nbsp;the&nbsp;name&nbsp;(and&nbsp;optionally&nbsp;port)&nbsp;of&nbsp;your&nbsp;LDAP&nbsp;server.<br>
If&nbsp;no&nbsp;port&nbsp;is&nbsp;specified,&nbsp;it&nbsp;defaults&nbsp;to&nbsp;the&nbsp;default&nbsp;port&nbsp;of&nbsp;389.&nbsp;&nbsp;(e.g<br>
"ldap.mycompany.com"&nbsp;or&nbsp;"ldap.mycompany.com:1234")<br>
<br>
Set&nbsp;LDAPBaseDN&nbsp;to&nbsp;the&nbsp;base&nbsp;DN&nbsp;for&nbsp;searching&nbsp;for&nbsp;users&nbsp;in&nbsp;your&nbsp;LDAP<br>
directory.&nbsp;&nbsp;(e.g.&nbsp;"ou=People,o=MyCompany")&nbsp;&nbsp;uids&nbsp;must&nbsp;be&nbsp;unique&nbsp;under<br>
the&nbsp;DN&nbsp;specified&nbsp;here.<br>
<br>
Set&nbsp;LDAPmailattribute&nbsp;to&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;attribute&nbsp;in&nbsp;your&nbsp;LDAP<br>
directory&nbsp;which&nbsp;contains&nbsp;the&nbsp;primary&nbsp;email&nbsp;address.&nbsp;&nbsp;On&nbsp;most&nbsp;directory<br>
servers&nbsp;available,&nbsp;this&nbsp;is&nbsp;"mail",&nbsp;but&nbsp;you&nbsp;may&nbsp;need&nbsp;to&nbsp;change&nbsp;this.<br>
----------------------------------------------------------------------<br>
<br>
(Not&nbsp;sure&nbsp;where&nbsp;this&nbsp;bit&nbsp;should&nbsp;go,&nbsp;but&nbsp;it's&nbsp;important&nbsp;that&nbsp;it&nbsp;be&nbsp;in<br>
there&nbsp;somewhere...)<br>
----------------------------------------------------------------------<br>
Using&nbsp;LDAP&nbsp;authentication&nbsp;for&nbsp;Bugzilla:<br>
<br>
The&nbsp;existing&nbsp;authentication&nbsp;scheme&nbsp;for&nbsp;Bugzilla&nbsp;uses&nbsp;email&nbsp;addresses<br>
as&nbsp;the&nbsp;primary&nbsp;user&nbsp;ID,&nbsp;and&nbsp;a&nbsp;password&nbsp;to&nbsp;authenticate&nbsp;that&nbsp;user.&nbsp;&nbsp;All<br>
places&nbsp;within&nbsp;Bugzilla&nbsp;where&nbsp;you&nbsp;need&nbsp;to&nbsp;deal&nbsp;with&nbsp;user&nbsp;ID&nbsp;(e.g<br>
assigning&nbsp;a&nbsp;bug)&nbsp;use&nbsp;the&nbsp;email&nbsp;address.<br>
<br>
The&nbsp;LDAP&nbsp;authentication&nbsp;builds&nbsp;on&nbsp;top&nbsp;of&nbsp;this&nbsp;scheme,&nbsp;rather&nbsp;than<br>
replacing&nbsp;it.&nbsp;&nbsp;The&nbsp;initial&nbsp;log&nbsp;in&nbsp;is&nbsp;done&nbsp;with&nbsp;a&nbsp;username&nbsp;and&nbsp;password<br>
for&nbsp;the&nbsp;LDAP&nbsp;directory.&nbsp;&nbsp;This&nbsp;then&nbsp;fetches&nbsp;the&nbsp;email&nbsp;address&nbsp;from&nbsp;LDAP<br>
and&nbsp;authenticates&nbsp;seamlessly&nbsp;in&nbsp;the&nbsp;standard&nbsp;Bugzilla&nbsp;authentication<br>
scheme&nbsp;using&nbsp;this&nbsp;email&nbsp;address.&nbsp;&nbsp;If&nbsp;an&nbsp;account&nbsp;for&nbsp;this&nbsp;address<br>
already&nbsp;exists&nbsp;in&nbsp;your&nbsp;Bugzilla&nbsp;system,&nbsp;it&nbsp;will&nbsp;log&nbsp;in&nbsp;to&nbsp;that<br>
account.&nbsp;&nbsp;If&nbsp;no&nbsp;account&nbsp;for&nbsp;that&nbsp;email&nbsp;address&nbsp;exists,&nbsp;one&nbsp;is&nbsp;created<br>
at&nbsp;the&nbsp;time&nbsp;of&nbsp;login.&nbsp;&nbsp;(In&nbsp;this&nbsp;case,&nbsp;Bugzilla&nbsp;will&nbsp;attempt&nbsp;to&nbsp;use&nbsp;the<br>
"displayName"&nbsp;or&nbsp;"cn"&nbsp;attribute&nbsp;to&nbsp;determine&nbsp;the&nbsp;user's&nbsp;full&nbsp;name.)<br>
<br>
After&nbsp;authentication,&nbsp;all&nbsp;other&nbsp;user-related&nbsp;tasks&nbsp;are&nbsp;still&nbsp;handled<br>
by&nbsp;email&nbsp;address,&nbsp;not&nbsp;LDAP&nbsp;username.&nbsp;&nbsp;You&nbsp;still&nbsp;assign&nbsp;bugs&nbsp;by&nbsp;email<br>
address,&nbsp;query&nbsp;on&nbsp;users&nbsp;by&nbsp;email&nbsp;address,&nbsp;etc.<br>
----------------------------------------------------------------------<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</P
></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="NAVFOOTER" CLASS="NAVFOOTER"
......
docs/sgml/Bugzilla-Guide.sgml
View file @ 58593ba9
...@@ -26,7 +26,7 @@ ...@@ -26,7 +26,7 @@
<!ENTITY bzg-ver "2.14"> <!ENTITY bzg-ver "2.14">
<!ENTITY bzg-cvs-ver "2.15.0"> <!ENTITY bzg-cvs-ver "2.15.0">
<!ENTITY bzg-auth "Matthew P. Barnson"> <!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 mysql "http://www.mysql.com/">
<!ENTITY perl-ver "5.6.1"> <!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 ...@@ -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> <othername>P.</othername>
<surname>Barnson</surname> <surname>Barnson</surname>
<affiliation> <affiliation>
<address><email>barnboy@NOSPAM.trilobyte.net</email></address> <address><email>barnboy@trilobyte.net</email></address>
</affiliation> </affiliation>
</author> </author>
<collab> <collab>
<collabname>Zach Lipton</collabname> <collabname>Zach Lipton</collabname>
<affiliation> <affiliation>
<address><email>zach@NOSPAM.zachlipton.com</email></address> <address><email>zach AT zachlipton DOT com</email></address>
</affiliation> </affiliation>
</collab> </collab>
...@@ -196,6 +196,9 @@ try to avoid clutter and feel free to waste space in the code to make it more re ...@@ -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 --> <!-- The Future of Bugzilla -->
&future; &future;
<!-- Major Bugzilla Variants -->
&variants;
<!-- Appendix: The Frequently Asked Questions --> <!-- Appendix: The Frequently Asked Questions -->
&faq; &faq;
...@@ -205,9 +208,6 @@ try to avoid clutter and feel free to waste space in the code to make it more re ...@@ -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 --> <!-- Appendix: The Database Schema -->
&database; &database;
<!-- Appendix: Major Bugzilla Variants -->
&variants;
<!-- Appendix: Custom Patches --> <!-- Appendix: Custom Patches -->
&patches; &patches;
......
docs/sgml/about.sgml
View file @ 58593ba9
...@@ -70,8 +70,7 @@ ...@@ -70,8 +70,7 @@
<para> <para>
If you have any questions regarding this document, its If you have any questions regarding this document, its
copyright, or publishing this document in non-electronic form, copyright, or publishing this document in non-electronic form,
please contact &bzg-auth;. Remove "NOSPAM" from email address please contact &bzg-auth;.
to send.
</para> </para>
</section> </section>
...@@ -172,8 +171,8 @@ ...@@ -172,8 +171,8 @@
</para> </para>
<para> <para>
<ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink> <ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink>
for initially converting Bugzilla from BugSplat! and writing the for initially writing Bugzilla and creating the
README upon which this documentation is largely based. README upon which the UNIX installation documentation is largely based.
</para> </para>
<para> <para>
<ulink url="mailto://tara@tequilarista.org">Tara <ulink url="mailto://tara@tequilarista.org">Tara
...@@ -204,7 +203,8 @@ ...@@ -204,7 +203,8 @@
documentation (in no particular order): documentation (in no particular order):
</para> </para>
<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> </para>
</section> </section>
<section id="feedback"> <section id="feedback">
......
docs/sgml/administration.sgml
View file @ 58593ba9
...@@ -1192,6 +1192,103 @@ ...@@ -1192,6 +1192,103 @@
</para> </para>
</listitem> </listitem>
</orderedlist> </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>
</section> </section>
......
docs/sgml/database.sgml
View file @ 58593ba9
...@@ -13,7 +13,7 @@ ...@@ -13,7 +13,7 @@
<para> <para>
<mediaobject> <mediaobject>
<imageobject> <imageobject>
<imagedata fileref="dbschema.jpg" format="jpg"> <imagedata fileref="../images/dbschema.jpg" format="jpg">
</imageobject> </imageobject>
<textobject> <textobject>
......
docs/sgml/faq.sgml
View file @ 58593ba9
...@@ -620,6 +620,12 @@ ...@@ -620,6 +620,12 @@
progression states, also require adjusting the program logic to progression states, also require adjusting the program logic to
compensate for the change. compensate for the change.
</para> </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> </answer>
</qandaentry> </qandaentry>
...@@ -633,42 +639,62 @@ ...@@ -633,42 +639,62 @@
</para> </para>
</question> </question>
<answer> <answer>
<para> <para>
This was a late-breaking question for the Guide, so I just have to It's possible to get the footer on the static index page using
quote the relevant newsgroup thread on it. Server Side Includes (SSI). The trick to doing this is making
</para> sure that your web server is set up to allow SSI and specifically,
<literallayout> the #exec directive. You should also rename <filename>index.html</filename>
> AFAIK, most sites (even if they have SSI enabled) won't have #exec cmd to <filename>index.shtml</filename>.
> enabled. Perhaps what would be better is a #include virtual and a </para>
> footer.cgi the basically has the "require 'CGI.pl' and PutFooter command. <para>
> After you've done all that, you can add the following line to
> Please note that under most configurations, this also requires naming <filename>index.shtml</filename>:
> the file from index.html to index.shtml (and making sure that it will <programlisting>
> still be reconized as an index). Personally, I think this is better on <![CDATA[
> a per-installation basis (perhaps add something to the FAQ that says how <!--#exec cmd="/usr/bin/perl -e &quot;require 'CGI.pl'; PutFooter();&quot;" -->
> to do this). ]]>
</programlisting>
Good point. Yeah, easy enough to do, that it shouldn't be a big deal for </para>
someone to take it on if they want it. FAQ is a good place for it. <para><note>
<para>
> Dave Miller wrote: 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
>> I did a little experimenting with getting the command menu and footer on want the footer to appear.
>> the end of the index page while leaving it as an HTML file... </para>
>> </note></para>
>> I was successful. :) <para>
>> Because this method depends on being able to use a #exec directive,
>> I added this line: 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>)
>> <!--#exec cmd="/usr/bin/perl -e &quot;require 'CGI.pl'; that basically looks like:
>>PutFooter();&quot;" --> <programlisting>
>> <![CDATA[
>> Just before the &lt;/BODY&gt; &lt;/HTML&gt; at the end of the file. And it worked. #!/usr/bonsaitools/bin/perl -w
>>
>> Thought I'd toss that out there. Should I check this in? For those that require 'globals.pl';
>> have SSI disabled, it'll act like a comment, so I wouldn't think it would
>> break anything. if ($::FORM{sub} eq 'PutFooter') {
</literallayout> 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> </answer>
</qandaentry> </qandaentry>
<qandaentry> <qandaentry>
...@@ -807,21 +833,6 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -807,21 +833,6 @@ someone to take it on if they want it. FAQ is a good place for it.
<qandaentry> <qandaentry>
<question> <question>
<para> <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>
Has anyone converted Bugzilla to another language to be used in other Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable? countries? Is it localizable?
</para> </para>
...@@ -1221,20 +1232,11 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -1221,20 +1232,11 @@ someone to take it on if they want it. FAQ is a good place for it.
<para> <para>
If you are using an alternate Mail Transport Agent (MTA other than If you are using an alternate Mail Transport Agent (MTA other than
sendmail), make sure the options given in the "processmail" script for all 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, instances of "sendmail" are correct for your MTA.
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!)
</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>
<para> <para>
This is now a configurable parameter called "sendmailnow", available If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi.
from editparams.cgi. If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>.
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>
...@@ -1315,12 +1317,21 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -1315,12 +1317,21 @@ someone to take it on if they want it. FAQ is a good place for it.
</question> </question>
<answer> <answer>
<para> <para>
Run the "sanity check" utility (./sanitycheck.cgi in the bugzilla_home Run the <quote>sanity check</quote> utility
directory) to see! If it all comes back, you're OK. If it doesn't come back (<filename>./sanitycheck.cgi</filename> in the
OK (i.e. any red letters), there are certain things Bugzilla can recover Bugzilla_home directory) from your web browser to see! If
from and certain things it can't. If it can't auto-recover, I hope you're it finishes without errors, you're
familiar with mysqladmin commands or have installed another way to manage <emphasis>probably</emphasis> OK. If it doesn't come back
your database... 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> </para>
</answer> </answer>
</qandaentry> </qandaentry>
...@@ -1428,10 +1439,12 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -1428,10 +1439,12 @@ someone to take it on if they want it. FAQ is a good place for it.
</question> </question>
<answer> <answer>
<para> <para>
Delete everything from $BUZILLA_HOME/shadow. Bugzilla creates shadow This should only happen with Bugzilla &bz-ver; if you are
files there, with each filename corresponding to a using the <quote>shadow database</quote> feature, and your
bug number. Also be sure to run syncshadowdb to make sure, if you are using shadow database is out of sync. Try running
a shadow database, that the shadow database is current. <filename>syncshadowdb</filename>
<option>-syncall</option> to make sure your shadow
database is in synch with your primary database.
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>
...@@ -1752,14 +1765,14 @@ A: Sure! Here ya go! ...@@ -1752,14 +1765,14 @@ A: Sure! Here ya go!
</question> </question>
<answer> <answer>
<para> <para>
Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;product=Webtools&amp;component=Bugzilla"> Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;product=Bugzilla">
this link</ulink> to view current bugs or requests for this link</ulink> to view current bugs or requests for
enhancement for Bugzilla. enhancement for Bugzilla.
</para> </para>
<para> <para>
You can view bugs marked for 2.14 release You can view bugs marked for 2.16 release
<ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Webtools&amp;component=Bugzilla&amp;target_milestone=Bugzilla+2.14">here</ulink>. <ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Bugzilla&amp;target_milestone=Bugzilla+2.16">here</ulink>.
This list includes bugs for the 2.14 release that have already This list includes bugs for the 2.16 release that have already
been fixed and checked into CVS. Please consult the been fixed and checked into CVS. Please consult the
<ulink url="http://www.mozilla.org/projects/bugzilla/"> <ulink url="http://www.mozilla.org/projects/bugzilla/">
Bugzilla Project Page</ulink> for details on how to Bugzilla Project Page</ulink> for details on how to
...@@ -1800,8 +1813,9 @@ A: Sure! Here ya go! ...@@ -1800,8 +1813,9 @@ A: Sure! Here ya go!
<orderedlist> <orderedlist>
<listitem> <listitem>
<para> <para>
Enter a bug into bugzilla.mozilla.org for the "Webtools" product, Enter a bug into bugzilla.mozilla.org for the <quote><ulink
"Bugzilla" component. url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">Bugzilla</ulink></quote>
product.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
......
docs/sgml/future.sgml
View file @ 58593ba9
...@@ -4,11 +4,595 @@ ...@@ -4,11 +4,595 @@
<title>The Future of Bugzilla</title> <title>The Future of Bugzilla</title>
<synopsis>Bugzilla's Future. Much of this is the present, now.</synopsis> <synopsis>Bugzilla's Future. Much of this is the present, now.</synopsis>
<para> <para>
The future of Bugzilla is Bugzilla 3.0. Unfortunately, I do Bugzilla's future is a constantly-changing thing, as various developers
not have more information about it right now, and most of what <quote>scratch an itch</quote> when it comes to functionality.
went into the "future" section is now present. That stuff was Thus this section is very malleable, subject to change without notice, etc.
blue-sky a year ago; MattyT should have me a new document You'll probably also notice the lack of formatting. I apologize that it's
sometime... 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> </para>
</chapter> </chapter>
...@@ -32,3 +616,4 @@ sgml-shorttag:t ...@@ -32,3 +616,4 @@ sgml-shorttag:t
sgml-tag-region-if-active:t sgml-tag-region-if-active:t
End: End:
--> -->
docs/sgml/installation.sgml
View file @ 58593ba9
...@@ -616,6 +616,15 @@ bash# mkdir /usr/bonsaitools/bin ...@@ -616,6 +616,15 @@ bash# mkdir /usr/bonsaitools/bin
bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
</programlisting> </programlisting>
</para> </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> </example>
<tip> <tip>
<para> <para>
...@@ -1241,7 +1250,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ ...@@ -1241,7 +1250,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \
</section> </section>
<section> <section id="unixhistory">
<title>UNIX Installation Instructions History</title> <title>UNIX Installation Instructions History</title>
<para> <para>
This document was originally adapted from the Bonsai This document was originally adapted from the Bonsai
...@@ -1252,9 +1261,8 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ ...@@ -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 The February 25, 1999 re-write of this page was done by Ry4an
Brase &lt;ry4an@ry4an.org&gt;, with some edits by Terry Brase &lt;ry4an@ry4an.org&gt;, with some edits by Terry
Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But
don't send bug reports to them; report them using bugzilla, at don't send bug reports to them; report them using bugzilla, at <ulink
http://bugzilla.mozilla.org/enter_bug.cgi , project Webtools, url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla</ulink> ).
component Bugzilla).
</para> </para>
<para> <para>
This document was heavily modified again Wednesday, March 07 This document was heavily modified again Wednesday, March 07
...@@ -1696,16 +1704,46 @@ exit; ...@@ -1696,16 +1704,46 @@ exit;
<step> <step>
<para> <para>
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
<programlisting> scripts in your Bugzilla directory. For instance, change
system ("./processmail.pl",@ARGLIST); this line in processmail:
</programlisting> <programlisting>
to system ("./processmail.pl",@ARGLIST);
<programlisting> </programlisting> to
<programlisting>
system ("perl processmail.pl",@ARGLIST); system ("perl processmail.pl",@ARGLIST);
</programlisting> </programlisting>
</para> </para>
</step> </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> </procedure>
<tip> <tip>
...@@ -1714,6 +1752,8 @@ system ("perl processmail.pl",@ARGLIST); ...@@ -1714,6 +1752,8 @@ system ("perl processmail.pl",@ARGLIST);
relationships to Properties -> Home directory (tab) -> relationships to Properties -> Home directory (tab) ->
Application Settings (section) -> Configuration (button), Application Settings (section) -> Configuration (button),
such as: such as:
</para>
<para>
<programlisting> <programlisting>
.cgi to: &lt;perl install directory&gt;\perl.exe %s %s .cgi to: &lt;perl install directory&gt;\perl.exe %s %s
.pl to: &lt;perl install directory&gt;\perl.exe %s %s .pl to: &lt;perl install directory&gt;\perl.exe %s %s
...@@ -1742,7 +1782,9 @@ GET,HEAD,POST ...@@ -1742,7 +1782,9 @@ GET,HEAD,POST
registry at the following location: registry at the following location:
</para> </para>
<para> <para>
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap <programlisting>
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
</programlisting>
</para> </para>
<para> <para>
The keys should be called ".pl" and ".cgi", and both The keys should be called ".pl" and ".cgi", and both
...@@ -1761,26 +1803,102 @@ GET,HEAD,POST ...@@ -1761,26 +1803,102 @@ GET,HEAD,POST
If attempting to run Bugzilla 2.12 or older, you will need If attempting to run Bugzilla 2.12 or older, you will need
to remove encrypt() calls from the Perl source. This is to remove encrypt() calls from the Perl source. This is
<emphasis>not necessary</emphasis> for Bugzilla 2.13 and <emphasis>not necessary</emphasis> for Bugzilla 2.13 and
later. later, which includes the current release, Bugzilla
&bz-ver;.
<example> <example>
<title>Removing encrypt() for Windows NT Bugzilla version <title>Removing encrypt() for Windows NT Bugzilla version
2.12 or earlier</title> 2.12 or earlier</title>
<para> <para>
Replace this: Replace this:
<programlisting> <programlisting>
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($realcryptpwd, 0, 2)) . ")"); SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($realcryptpwd, 0, 2)) . ")");
my $enteredcryptpwd = FetchOneColumn(); my $enteredcryptpwd = FetchOneColumn();
</programlisting> </programlisting>
with this: with this:
<programlisting> <programlisting>
my $enteredcryptpwd = $enteredpwd my $enteredcryptpwd = $enteredpwd
</programlisting> </programlisting>
in cgi.pl. in cgi.pl.
</para> </para>
</example> </example>
</para> </para>
</tip> </tip>
</section> </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> </section>
</chapter> </chapter>
......
docs/sgml/integration.sgml
View file @ 58593ba9
...@@ -35,6 +35,14 @@ ...@@ -35,6 +35,14 @@
an @resolution field, you can even change the Bugzilla bug an @resolution field, you can even change the Bugzilla bug
state. state.
</para> </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>
<section id="scm" xreflabel="Perforce SCM (Fast Software Configuration Management System, a powerful commercial alternative to CVS"> <section id="scm" xreflabel="Perforce SCM (Fast Software Configuration Management System, a powerful commercial alternative to CVS">
......
docs/sgml/patches.sgml
View file @ 58593ba9
...@@ -247,6 +247,104 @@ RewriteRule ^/([0-9]+)$ http://foo.bar.com/show_bug.cgi?id=$1 [L,R] ...@@ -247,6 +247,104 @@ RewriteRule ^/([0-9]+)$ http://foo.bar.com/show_bug.cgi?id=$1 [L,R]
</para> </para>
</section> </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> </appendix>
......
docs/sgml/using.sgml
View file @ 58593ba9
...@@ -399,13 +399,13 @@ system against which all others are measured. ...@@ -399,13 +399,13 @@ system against which all others are measured.
our Bugzilla database. Please notice the box is a our Bugzilla database. Please notice the box is a
<emphasis>scrollbox</emphasis>. Using the down arrow on <emphasis>scrollbox</emphasis>. Using the down arrow on
the scrollbox, scroll down until you can see an entry the scrollbox, scroll down until you can see an entry
called "Webtools". Select this entry. called "Bugzilla". Select this entry.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Did you notice that some of the boxes to the right changed 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 has different Versions, Components, and Target Milestones
associated with it. A "Version" is the number of a associated with it. A "Version" is the number of a
software program. software program.
...@@ -452,36 +452,67 @@ system against which all others are measured. ...@@ -452,36 +452,67 @@ system against which all others are measured.
Normally, a Component has a single Owner, who is responsible Normally, a Component has a single Owner, who is responsible
for overseeing efforts to improve that Component. for overseeing efforts to improve that Component.
<example> <example>
<title>Mozilla Webtools Components</title> <title>Mozilla's Bugzilla Components</title>
<informalexample> <informalexample>
<para> <para>
Mozilla's "Webtools" Product is composed of several pieces (Components): Mozilla's "Bugzilla" Product is composed of several pieces (Components):
<simplelist> <simplelist>
<member><emphasis>Bonsai</emphasis>, <member><emphasis>Administration</emphasis>,
a tool to show recent changes to Mozilla</member> Administration of a bugzilla installation, including
<member><emphasis>Bugzilla</emphasis>, <filename>editcomponents.cgi</filename>,
a defect-tracking tool</member> <filename>editgroups.cgi</filename>,
<member><emphasis>Build</emphasis>, <filename>editkeywords.cgi</filename>,
a tool to automatically compile source code <filename>editparams.cgi</filename>,
into machine-readable form</member> <filename>editproducts.cgi</filename>,
<member><emphasis>Despot</emphasis>, <filename>editusers.cgi</filename>,
a program that controls access to the other Webtools</member> <filename>editversions.cgi,</filename> and
<member><emphasis>LXR</emphasis>, <filename>sanitycheck.cgi</filename>.
a utility that automatically marks up text files </member>
to make them more readable</member> <member><emphasis>Bugzilla-General</emphasis>,
<member><emphasis>MozBot</emphasis>, Anything that doesn't fit in the other components, or spans
a "robot" that announces changes to Mozilla in Chat</member> multiple components.
<member><emphasis>TestManager</emphasis>, </member>
a tool to help find bugs in Mozilla</member> <member><emphasis>Creating/Changing Bugs</emphasis>,
<member><emphasis>Tinderbox</emphasis>, Creating, changing, and viewing bugs.
which displays reports from Build</member> <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> </simplelist>
</para> </para>
<para>
A different person is responsible for each of these Components.
Tara Hernandez keeps
the "Bugzilla" component up-to-date.
</para>
</informalexample> </informalexample>
</example> </example>
</para> </para>
......
docs/txt/Bugzilla-Guide.txt
View file @ 58593ba9
...@@ -3,10 +3,10 @@ The Bugzilla Guide ...@@ -3,10 +3,10 @@ The Bugzilla Guide
Matthew P. Barnson Matthew P. Barnson
barnboy@NOSPAM.trilobyte.net barnboy@trilobyte.net
Zach Lipton Zach Lipton
zach@NOSPAM.zachlipton.com zach AT zachlipton DOT com
Revision History Revision History
Revision v2.11 20 December 2000 Revised by: MPB Revision v2.11 20 December 2000 Revised by: MPB
Converted the README, FAQ, and DATABASE information into SGML docbook Converted the README, FAQ, and DATABASE information into SGML docbook
...@@ -136,6 +136,7 @@ Matthew P. Barnson ...@@ -136,6 +136,7 @@ Matthew P. Barnson
3.6.1. Win32 Installation: Step-by-step 3.6.1. Win32 Installation: Step-by-step
3.6.2. Additional Windows Tips 3.6.2. Additional Windows Tips
3.6.3. Bugzilla LDAP Integration
4. Administering Bugzilla 4. Administering Bugzilla
...@@ -169,6 +170,15 @@ Matthew P. Barnson ...@@ -169,6 +170,15 @@ Matthew P. Barnson
5.4. Tinderbox/Tinderbox2 5.4. Tinderbox/Tinderbox2
6. The Future of Bugzilla 6. The Future of Bugzilla
7. Bugzilla Variants and Competitors
7.1. Red Hat Bugzilla
7.2. Loki Bugzilla (Fenris)
7.3. Issuezilla
7.4. Scarab
7.5. Perforce SCM
7.6. SourceForge
A. The Bugzilla FAQ A. The Bugzilla FAQ
B. Software Download Links B. Software Download Links
C. The Bugzilla Database C. The Bugzilla Database
...@@ -182,21 +192,13 @@ Matthew P. Barnson ...@@ -182,21 +192,13 @@ Matthew P. Barnson
C.3. MySQL Permissions & Grant Tables C.3. MySQL Permissions & Grant Tables
7. Bugzilla Variants and Competitors
7.1. Red Hat Bugzilla
7.2. Loki Bugzilla (Fenris)
7.3. Issuezilla
7.4. Scarab
7.5. Perforce SCM
7.6. SourceForge
D. Useful Patches and Utilities for Bugzilla D. Useful Patches and Utilities for Bugzilla
D.1. Apache mod_rewrite magic D.1. Apache mod_rewrite magic
D.2. The setperl.csh Utility D.2. The setperl.csh Utility
D.3. Command-line Bugzilla Queries D.3. Command-line Bugzilla Queries
D.4. The Quicksearch Utility D.4. The Quicksearch Utility
D.5. Hacking Bugzilla
E. GNU Free Documentation License E. GNU Free Documentation License
...@@ -217,7 +219,7 @@ Matthew P. Barnson ...@@ -217,7 +219,7 @@ Matthew P. Barnson
List of Examples List of Examples
2-1. Some Famous Software Versions 2-1. Some Famous Software Versions
2-2. Mozilla Webtools Components 2-2. Mozilla's Bugzilla Components
3-1. Setting up bonsaitools symlink 3-1. Setting up bonsaitools symlink
3-2. Running checksetup.pl as the web user 3-2. Running checksetup.pl as the web user
3-3. Installing ActivePerl ppd Modules on Microsoft Windows 3-3. Installing ActivePerl ppd Modules on Microsoft Windows
...@@ -230,6 +232,7 @@ Matthew P. Barnson ...@@ -230,6 +232,7 @@ Matthew P. Barnson
4-4. Using SortKey with Target Milestone 4-4. Using SortKey with Target Milestone
4-5. When to Use Group Security 4-5. When to Use Group Security
4-6. Creating a New Group 4-6. Creating a New Group
4-7. Bugzilla Groups
D-1. Using Setperl to set your perl path D-1. Using Setperl to set your perl path
1. A Sample Product 1. A Sample Product
_________________________________________________________________ _________________________________________________________________
...@@ -270,8 +273,8 @@ Chapter 1. About This Guide ...@@ -270,8 +273,8 @@ Chapter 1. About This Guide
documentation. I have incorporated instructions from the Bugzilla documentation. I have incorporated instructions from the Bugzilla
README, Frequently Asked Questions, Database Schema Document, and README, Frequently Asked Questions, Database Schema Document, and
various mailing lists to create it. Chances are, there are glaring various mailing lists to create it. Chances are, there are glaring
errors in this documentation; please contact errors in this documentation; please contact <barnboy@trilobyte.net>
<barnboy@NOSPAM.trilobyte.net> to correct them. to correct them.
_________________________________________________________________ _________________________________________________________________
1.2. Copyright Information 1.2. Copyright Information
...@@ -289,7 +292,7 @@ Chapter 1. About This Guide ...@@ -289,7 +292,7 @@ Chapter 1. About This Guide
If you have any questions regarding this document, its copyright, or If you have any questions regarding this document, its copyright, or
publishing this document in non-electronic form, please contact publishing this document in non-electronic form, please contact
Matthew P. Barnson. Remove "NOSPAM" from email address to send. Matthew P. Barnson.
_________________________________________________________________ _________________________________________________________________
1.3. Disclaimer 1.3. Disclaimer
...@@ -356,8 +359,8 @@ Chapter 1. About This Guide ...@@ -356,8 +359,8 @@ Chapter 1. About This Guide
numerous e-mail and IRC support sessions, and overall excellent numerous e-mail and IRC support sessions, and overall excellent
contribution to the Bugzilla community: contribution to the Bugzilla community:
Terry Weissman for initially converting Bugzilla from BugSplat! and Terry Weissman for initially writing Bugzilla and creating the README
writing the README upon which this documentation is largely based. upon which the UNIX installation documentation is largely based.
Tara Hernandez for keeping Bugzilla development going strong after Tara Hernandez for keeping Bugzilla development going strong after
Terry left Mozilla.org Terry left Mozilla.org
...@@ -380,7 +383,7 @@ Chapter 1. About This Guide ...@@ -380,7 +383,7 @@ Chapter 1. About This Guide
documentation (in no particular order): documentation (in no particular order):
Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron
Teitelbaum Teitelbaum, Jacob Steenhagen, Joe Robins
_________________________________________________________________ _________________________________________________________________
1.7. Feedback 1.7. Feedback
...@@ -686,10 +689,10 @@ Chapter 2. Using Bugzilla ...@@ -686,10 +689,10 @@ Chapter 2. Using Bugzilla
can narrow our search down to only specific products (software can narrow our search down to only specific products (software
programs or product lines) in our Bugzilla database. Please notice programs or product lines) in our Bugzilla database. Please notice
the box is a scrollbox. Using the down arrow on the scrollbox, the box is a scrollbox. Using the down arrow on the scrollbox,
scroll down until you can see an entry called "Webtools". Select scroll down until you can see an entry called "Bugzilla". Select
this entry. this entry.
4. Did you notice that some of the boxes to the right changed when 4. Did you notice that some of the boxes to the right changed when
you selected "Webtools"? Every Program (or Product) has different you selected "Bugzilla"? Every Program (or Product) has different
Versions, Components, and Target Milestones associated with it. A Versions, Components, and Target Milestones associated with it. A
"Version" is the number of a software program. "Version" is the number of a software program.
Example 2-1. Some Famous Software Versions Example 2-1. Some Famous Software Versions
...@@ -715,22 +718,33 @@ Chapter 2. Using Bugzilla ...@@ -715,22 +718,33 @@ Chapter 2. Using Bugzilla
program, or some other logical division of a Product or Program. program, or some other logical division of a Product or Program.
Normally, a Component has a single Owner, who is responsible for Normally, a Component has a single Owner, who is responsible for
overseeing efforts to improve that Component. overseeing efforts to improve that Component.
Example 2-2. Mozilla Webtools Components Example 2-2. Mozilla's Bugzilla Components
Mozilla's "Webtools" Product is composed of several pieces Mozilla's "Bugzilla" Product is composed of several pieces
(Components): (Components):
Bonsai, a tool to show recent changes to Mozilla Administration, Administration of a bugzilla installation, including
Bugzilla, a defect-tracking tool editcomponents.cgi, editgroups.cgi, editkeywords.cgi, editparams.cgi,
Build, a tool to automatically compile source code into editproducts.cgi, editusers.cgi, editversions.cgi, and
machine-readable form sanitycheck.cgi.
Despot, a program that controls access to the other Webtools Bugzilla-General, Anything that doesn't fit in the other components,
LXR, a utility that automatically marks up text files to make them or spans multiple components.
more readable Creating/Changing Bugs, Creating, changing, and viewing bugs.
MozBot, a "robot" that announces changes to Mozilla in Chat enter_bug.cgi, post_bug.cgi, show_bug.cgi and process_bug.cgi.
TestManager, a tool to help find bugs in Mozilla Documentation, The bugzilla documentation, including anything in the
Tinderbox, which displays reports from Build docs/ directory and The Bugzilla Guide (This document :)
A different person is responsible for each of these Components. Email, Anything to do with email sent by Bugzilla. processmail
Tara Hernandez keeps the "Bugzilla" component up-to-date. Installation, The installation process of Bugzilla. This includes
checksetup.pl and whatever else it evolves into.
Query/Buglist, Anything to do with searching for bugs and viewing the
buglists. query.cgi and buglist.cgi
Reporting/Charting, Getting reports from Bugzilla. reports.cgi and
duplicates.cgi
User Accounts, Anything about managing a user account from the user's
perspective. userprefs.cgi, saved queries, creating accounts, changing
passwords, logging in, etc.
User Interface, General issues having to do with the user interface
cosmetics (not functionality) including cosmetic issues, HTML
templates, etc.
A "Milestone", or "Target Milestone" is a often a planned future A "Milestone", or "Target Milestone" is a often a planned future
"Version" of a product. In many cases, though, Milestones simply "Version" of a product. In many cases, though, Milestones simply
represent significant dates for a developer. Having certain represent significant dates for a developer. Having certain
...@@ -1439,6 +1453,12 @@ bash# mkdir /usr/bonsaitools ...@@ -1439,6 +1453,12 @@ bash# mkdir /usr/bonsaitools
bash# mkdir /usr/bonsaitools/bin bash# mkdir /usr/bonsaitools/bin
bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
Alternately, you can simply run this perl one-liner to change your
path to perl in all the files in your Bugzilla installation:
perl -pi -e 's@#!/usr/bonsaitools/bin/perl@/usr/bin/perl@' *cgi *pl Bug.pm
Change the second path to perl to match your installation.
Tip Tip
If you don't have root access to set this symlink up, check out the If you don't have root access to set this symlink up, check out the
...@@ -1853,8 +1873,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ ...@@ -1853,8 +1873,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \
<ry4an@ry4an.org>, with some edits by Terry Weissman, Bryce Nesbitt, <ry4an@ry4an.org>, with some edits by Terry Weissman, Bryce Nesbitt,
Martin Pool, & Dan Mosedale (But don't send bug reports to them; Martin Pool, & Dan Mosedale (But don't send bug reports to them;
report them using bugzilla, at report them using bugzilla, at
http://bugzilla.mozilla.org/enter_bug.cgi , project Webtools, http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla ).
component Bugzilla).
This document was heavily modified again Wednesday, March 07 2001 to This document was heavily modified again Wednesday, March 07 2001 to
reflect changes for Bugzilla 2.12 release by Matthew P. Barnson. The reflect changes for Bugzilla 2.12 release by Matthew P. Barnson. The
...@@ -2104,20 +2123,40 @@ exit; ...@@ -2104,20 +2123,40 @@ exit;
your Bugzilla directory. For instance, change this line in your Bugzilla directory. For instance, change this line in
processmail: processmail:
system ("./processmail.pl",@ARGLIST); system ("./processmail.pl",@ARGLIST);
to to
system ("perl processmail.pl",@ARGLIST); system ("perl processmail.pl",@ARGLIST);
14. Add binmode() calls so attachments will work (bug 62000).
Because Microsoft Windows based systems handle binary files
different than Unix based systems, you need to add the following
lines to createattachment.cgi and showattachment.cgi before the
require 'CGI.pl'; line.
binmode(STDIN);
binmode(STDOUT);
Note
According to bug 62000, the perl documentation says that you should
always use binmode() when dealing with binary files, but never when
dealing with text files. That seems to suggest that rather than
aribtrarily putting binmode() at the begining of the attachment files,
there should be logic to determine if binmode() is needed or not.
Tip Tip
If you are using IIS or Personal Web Server, you must add cgi If you are using IIS or Personal Web Server, you must add cgi
relationships to Properties -> Home directory (tab) -> Application relationships to Properties -> Home directory (tab) -> Application
Settings (section) -> Configuration (button), such as: Settings (section) -> Configuration (button), such as:
.cgi to: <perl install directory>\perl.exe %s %s .cgi to: <perl install directory>\perl.exe %s %s
.pl to: <perl install directory>\perl.exe %s %s .pl to: <perl install directory>\perl.exe %s %s
GET,HEAD,POST GET,HEAD,POST
...@@ -2139,8 +2178,7 @@ GET,HEAD,POST ...@@ -2139,8 +2178,7 @@ GET,HEAD,POST
Basically you need to add two String Keys in the registry at the Basically you need to add two String Keys in the registry at the
following location: following location:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Paramete HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
rs\ScriptMap
The keys should be called ".pl" and ".cgi", and both should have a The keys should be called ".pl" and ".cgi", and both should have a
value something like: c:/perl/bin/perl.exe "%s" "%s" value something like: c:/perl/bin/perl.exe "%s" "%s"
...@@ -2152,14 +2190,15 @@ GET,HEAD,POST ...@@ -2152,14 +2190,15 @@ GET,HEAD,POST
If attempting to run Bugzilla 2.12 or older, you will need to remove If attempting to run Bugzilla 2.12 or older, you will need to remove
encrypt() calls from the Perl source. This is not necessary for encrypt() calls from the Perl source. This is not necessary for
Bugzilla 2.13 and later. Bugzilla 2.13 and later, which includes the current release, Bugzilla
2.14.
Example 3-4. Removing encrypt() for Windows NT Bugzilla version 2.12 Example 3-4. Removing encrypt() for Windows NT Bugzilla version 2.12
or earlier or earlier
Replace this: Replace this:
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($rea SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($rea
lcryptpwd, 0, 2)) . ")"); lcryptpwd, 0, 2)) . ")");
my $enteredcryptpwd = FetchOneColumn(); my $enteredcryptpwd = FetchOneColumn();
...@@ -2170,6 +2209,66 @@ my $enteredcryptpwd = $enteredpwd ...@@ -2170,6 +2209,66 @@ my $enteredcryptpwd = $enteredpwd
in cgi.pl. in cgi.pl.
_________________________________________________________________ _________________________________________________________________
3.6.3. Bugzilla LDAP Integration
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.
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.
----------------------------------------------------------------------
_________________________________________________________________
Chapter 4. Administering Bugzilla Chapter 4. Administering Bugzilla
Or, I just got this cool thing installed. Now what the heck do I do Or, I just got this cool thing installed. Now what the heck do I do
...@@ -2880,6 +2979,84 @@ Chapter 4. Administering Bugzilla ...@@ -2880,6 +2979,84 @@ Chapter 4. Administering Bugzilla
instructions for creating a new Product. If you need to add users instructions for creating a new Product. If you need to add users
to these new groups as you create them, you will find the option to these new groups as you create them, you will find the option
to add them to the group available under the "Edit User" screens. to add them to the group available under the "Edit User" screens.
You may find this example illustrative for how bug groups work.
Example 4-7. Bugzilla Groups
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.
_________________________________________________________________ _________________________________________________________________
4.4. Bugzilla Security 4.4. Bugzilla Security
...@@ -3012,6 +3189,10 @@ Chapter 5. Integrating Bugzilla with Third-Party Tools ...@@ -3012,6 +3189,10 @@ Chapter 5. Integrating Bugzilla with Third-Party Tools
have CVS check-in comments append to your Bugzilla bug. If you have have CVS check-in comments append to your Bugzilla bug. If you have
your check-in script include an @resolution field, you can even change your check-in script include an @resolution field, you can even change
the Bugzilla bug state. the Bugzilla bug state.
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: http://homepages.kcbbs.gen.nz/~tonyg/, under the "cvszilla" link.
_________________________________________________________________ _________________________________________________________________
5.3. Perforce SCM 5.3. Perforce SCM
...@@ -3039,10 +3220,665 @@ Chapter 6. The Future of Bugzilla ...@@ -3039,10 +3220,665 @@ Chapter 6. The Future of Bugzilla
Bugzilla's Future. Much of this is the present, now. Bugzilla's Future. Much of this is the present, now.
The future of Bugzilla is Bugzilla 3.0. Unfortunately, I do not have Bugzilla's future is a constantly-changing thing, as various
more information about it right now, and most of what went into the developers "scratch an itch" when it comes to functionality. Thus this
"future" section is now present. That stuff was blue-sky a year ago; section is very malleable, subject to change without notice, etc.
MattyT should have me a new document sometime... You'll probably also notice the lack of formatting. I apologize that
it's not quite as readable as the rest of the Guide.
Bugzilla Blue Sky
Customisability
One of the major stumbling blocks of Bugzilla has been that it is t
oo
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 thi
s
doesn't need to occur.
Most of the subsections in this section are currently explicit desi
gn
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 rena
me
or otherwise modify existing fields. An architecture that supports
this would be extraordinarily useful.
Indeed, many fields work similarly and could be abstracted into "fi
eld
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 remove
d.
Allocations
?
Option Groups
?
Relations
?
Database Integrity
Furthermore, it is desirable for administrators to be able to speci
fy
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 ASSIG
NED
must have a target milestone field that that is not untargetted. O
r
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 chang
es
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 databas
e
access, Bugzilla bugs, or because they were there before the
relationship was enforced.
As well as implementing intra-bug constraints, it would be useful t
o
create inter-bug constraints. For example, a bug that is dependent
on
another bug should not have an earlier milestone or greater priorit
y
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 th
e
possible values of another field or even whether it appears (whethe
r
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 compon
ent
fields depend on the product.
* UNCONFIRMED can be turned off for specific products.
* Voting can be configured differently or turned off for differen
t
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 betwee
n
fields causing problems. One possible solution to this is to place
the fields in a total ordering and require a field refer only to th
e
previous fields.
In Bugzilla 2, changing the product of a bug meant a second page wo
uld
appear that allowed you to choose a new milestone, component and
version, as those fields adapted themselves to the new product. Th
is
page could be generalised to support all instances where:
* a field value must or might be changed because the possible val
ues
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. A
n
administrator might choose a database that would work better wi
th
their Bugzilla.
This raises the possibility that we could use features that are onl
y
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 "cach
es"
Multiple Front Ends
Currently Bugzilla is manipulated via the Web, and notifies via
E-Mail. It would be desirable for Bugzilla to easily support vario
us
front ends.
There is no reason that Bugzilla could not be controlled via a whol
e
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 desirab
le
to allow "language packs" so Bugzilla can be easily used in
non-English speaking locales.
To a degree field customisation supports this, because administrato
rs
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. Th
ere
are other facilities already in place or which people have asked fo
r:
Most Doomed Reports - All Bugs or All Bugs In A Product, Categorise
d
On Assignee, Shows and Counts Number of Bugs For Each Assignee
Most Voted For Bugs - All Bugs, Categorised On Product, Shows Top T
en
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 repo
rts
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 li
mit
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. Yo
u
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 nex
t
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 fla
ws
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 ha
s
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 issue
s
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 remov
e
the need for these two systems. Unfortunately, the simple keywords
implementation was itself lacking in certain features provided by t
he
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 e
asy
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 o
ver
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 creatin
g a
tracking bug and viewing the dependency tree of that tracking b
ug.
* Users wish to specify the keywords that initially apply to a bu
g,
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 keyword
s
column. Hence they wish to be able to specify what columns app
ear
in the bug list URL, as mentioned earlier. They can work aroun
d
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 keyword
s
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 column
s
in Bugzilla adjust to the largest cell in that column. Hence
users wish to be able to specify which keywords should appear i
n
the bug list. In a very real sense, each keyword is a field un
to
itself. Users can work around this by using summary designator
s,
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 watch
ing
facility (also for things like watching all bugs in a component
)
would achieve this. Users can work around this by using tracki
ng
bugs, as dependencies have an existing way of detecting fixes t
o
bug a bug was blocked by.
Dealing With The Keyword Overload
At the time of writing, the mozilla.org installation has approximat
ely
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 numb
er
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 tru
e
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 tailor
ed
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 bu
g
* 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 l
ist
by grouping keywords. We should always have a "flat" view of
keywords, but other ways of viewing the keywords would be useful to
o.
If keyword applicability was implemented, we could group keywords
based on their "applicability condition". Keywords that apply to a
ll
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 use
r
interface. This creates a natural grouping, although other groupin
gs
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 metri
c
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 interest
ed
in them.
Keyword Security
Currently all keywords are available and editable to all people wit
h
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, acciden
t
or ignorance.
And in the situation where it is desirable for the presence or abse
nce
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 abil
ity
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 numbe
rs
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 potenti
al
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 prese
nt
Introduction of the ability to specify these restrictions would hav
e
benefits.
If mutually exclusive keywords were present on a bug, their removal
would fix up the database, as well as reducing the number of keywor
ds
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 querie
s
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 sho
uld
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 th
e
QA contact changes.
Furthermore, often an unnecessary comment will go along with a chan
ge,
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 i
s
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, beca
use
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 tha
t
the bug activity does not display on the normal page and hence it i
s
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 yo
ur
name on it. This is suboptimal because you need to know about a bu
g
before you can receive notifications on it. Often you are interest
ed
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 bu
gs,
it would make everyone's lives easier. Currently the default assig
nee
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 acti
on
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 th
e
middle.
These factors can lead to a tendency for people to delay bulk chang
es,
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 longe
r
be match parts of a bulk change under different filtering rules.
One possibility to resolve this is to allow people to specify group
s
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 perio
d
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 oth
er
installation. It would also mean that relationships and
notifications that refer to other bugs would need to communicat
e
with the other installation.
* References to bugs in other installations. Currently if you ty
pe
"bug XXX" or "bug #XXX" where XXX is a number, you get an
automatic hyperlink to that bug. It would be useful if you cou
ld
say "YYY bug #XXX" where YYY is the name of another installatio
n.
Retirement
?
Whiny Reports
?
Group Redesign
?
Hard Wrapping Comments
Currently Bugzilla "hard wraps" its comments to a specific line siz
e,
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 support
ed
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 brows
er
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 processo
r.
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 st
ill
be wrapped too early, but at least new content will work.
_________________________________________________________________
Chapter 7. Bugzilla Variants and Competitors
I created this section to answer questions about Bugzilla competitors
and variants, then found a wonderful site which covers an awful lot of
what I wanted to discuss. Rather than quote it in its entirety, I'll
simply refer you here: http://linas.org/linux/pm.html
_________________________________________________________________
7.1. Red Hat Bugzilla
Red Hat Bugzilla is probably the most popular Bugzilla variant on the
planet. One of the major benefits of Red Hat Bugzilla is the ability
to work with Oracle, MySQL, and PostGreSQL databases serving as the
back-end, instead of just MySQL. Dave Lawrence has worked very hard to
keep Red Hat Bugzilla up-to-date, and many people prefer the
snappier-looking page layout of Red Hat Bugzilla to the default
Mozilla-standard formatting.
URL: http://bugzilla.redhat.com/bugzilla/
_________________________________________________________________
7.2. Loki Bugzilla (Fenris)
Fenris can be found at http://fenris.lokigames.com. It is a fork from
Bugzilla.
_________________________________________________________________
7.3. Issuezilla
Issuezilla is another fork from Bugzilla, and seems nearly as popular
as the Red Hat Bugzilla fork. Some Issuezilla team members are regular
contributors to the Bugzilla mailing list/newsgroup. Issuezilla is not
the primary focus of bug-tracking at tigris.org, however. Their
Java-based bug-tracker, Scarab, a newfangled Java-based issue tracker,
is under heavy development and looks promising!
URL: http://issuezilla.tigris.org/servlets/ProjectHome
_________________________________________________________________
7.4. Scarab
Scarab is a promising new bug-tracking system built using Java Serlet
technology. As of this writing, no source code has been released as a
package, but you can obtain the code from CVS.
URL: http://scarab.tigris.org
_________________________________________________________________
7.5. Perforce SCM
Although Perforce isn't really a bug tracker, it can be used as such
through the "jobs" functionality.
http://www.perforce.com/perforce/technotes/note052.htmlhttp://www.perf
orce.com/perforce/technotes/note052.html
_________________________________________________________________
7.6. SourceForge
SourceForge is more of a way of coordinating geographically
distributed free software and open source projects over the Internet
than strictly a bug tracker, but if you're hunting for bug-tracking
for your open project, it may be just what the software engineer
ordered!
URL: http://www.sourceforge.net
_________________________________________________________________ _________________________________________________________________
Appendix A. The Bugzilla FAQ Appendix A. The Bugzilla FAQ
...@@ -3130,51 +3966,47 @@ Appendix A. The Bugzilla FAQ ...@@ -3130,51 +3966,47 @@ Appendix A. The Bugzilla FAQ
fields? If I wanted to take the results of a query and fields? If I wanted to take the results of a query and
export that data to MS Excel, could I do that? export that data to MS Excel, could I do that?
A.4.14. Does Bugzilla allow fields to be added, changed or A.4.14. Has anyone converted Bugzilla to another language to be
deleted? If I want to customize the bug submission form
to meet our needs, can I do that using our terminology?
A.4.15. Has anyone converted Bugzilla to another language to be
used in other countries? Is it localizable? used in other countries? Is it localizable?
A.4.16. Can a user create and save reports? Can they do this in A.4.15. Can a user create and save reports? Can they do this in
Word format? Excel format? Word format? Excel format?
A.4.17. Can a user re-run a report with a new project, same A.4.16. Can a user re-run a report with a new project, same
query? query?
A.4.18. Can a user modify an existing report and then save it A.4.17. Can a user modify an existing report and then save it
into another name? into another name?
A.4.19. Does Bugzilla have the ability to search by word, phrase, A.4.18. Does Bugzilla have the ability to search by word, phrase,
compound search? compound search?
A.4.20. Can the admin person establish separate group and A.4.19. Can the admin person establish separate group and
individual user privileges? individual user privileges?
A.4.21. Does Bugzilla provide record locking when there is A.4.20. Does Bugzilla provide record locking when there is
simultaneous access to the same bug? Does the second simultaneous access to the same bug? Does the second
person get a notice that the bug is in use or how are person get a notice that the bug is in use or how are
they notified? they notified?
A.4.22. Are there any backup features provided? A.4.21. Are there any backup features provided?
A.4.23. Can users be on the system while a backup is in progress? A.4.22. Can users be on the system while a backup is in progress?
A.4.24. What type of human resources are needed to be on staff to A.4.23. What type of human resources are needed to be on staff to
install and maintain Bugzilla? Specifically, what type of install and maintain Bugzilla? Specifically, what type of
skills does the person need to have? I need to find out skills does the person need to have? I need to find out
if we were to go with Bugzilla, what types of individuals if we were to go with Bugzilla, what types of individuals
would we need to hire and how much would that cost vs would we need to hire and how much would that cost vs
buying an "Out-of-the-Box" solution. buying an "Out-of-the-Box" solution.
A.4.25. What time frame are we looking at if we decide to hire A.4.24. What time frame are we looking at if we decide to hire
people to install and maintain the Bugzilla? Is this people to install and maintain the Bugzilla? Is this
something that takes hours or weeks to install and a something that takes hours or weeks to install and a
couple of hours per week to maintain and customize or is couple of hours per week to maintain and customize or is
this a multi-week install process, plus a full time job this a multi-week install process, plus a full time job
for 1 person, 2 people, etc? for 1 person, 2 people, etc?
A.4.26. Is there any licensing fee or other fees for using A.4.25. Is there any licensing fee or other fees for using
Bugzilla? Any out-of-pocket cost other than the bodies Bugzilla? Any out-of-pocket cost other than the bodies
needed as identified above? needed as identified above?
...@@ -3645,51 +4477,50 @@ Appendix A. The Bugzilla FAQ ...@@ -3645,51 +4477,50 @@ Appendix A. The Bugzilla FAQ
progression states, also require adjusting the program logic to progression states, also require adjusting the program logic to
compensate for the change. compensate for the change.
There is no GUI for adding fields to Bugzilla at this time. You can
follow development of this feature at
http://bugzilla.mozilla.org/show_bug.cgi?id=91037
A.4.7. The index.html page doesn't show the footer. It's really A.4.7. The index.html page doesn't show the footer. It's really
annoying to have to go to the querypage just to check my "my bugs" annoying to have to go to the querypage just to check my "my bugs"
link. How do I get a footer on static HTML pages? link. How do I get a footer on static HTML pages?
This was a late-breaking question for the Guide, so I just have to It's possible to get the footer on the static index page using Server
quote the relevant newsgroup thread on it. 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 index.html to index.shtml.
> AFAIK, most sites (even if they have SSI enabled) won't have #exec c After you've done all that, you can add the following line to
md index.shtml:
> enabled. Perhaps what would be better is a #include virtual and a <!--#exec cmd="/usr/bin/perl -e &quot;require 'CGI.pl'; PutFooter();&quot;" -->
> footer.cgi the basically has the "require 'CGI.pl' and PutFooter com
mand. Note
>
> Please note that under most configurations, this also requires namin This line will be replaced with the actual HTML for the footer when
g the page is requested, so you should put this line where you want the
> the file from index.html to index.shtml (and making sure that it wil footer to appear.
l
> still be reconized as an index). Personally, I think this is better Because this method depends on being able to use a #exec directive,
on and most ISP's will not allow that, there is an alternative method.
> a per-installation basis (perhaps add something to the FAQ that says You could have a small script (such as api.cgi) that basically looks
how like:
> to do this). #!/usr/bonsaitools/bin/perl -w
Good point. Yeah, easy enough to do, that it shouldn't be a big deal
for require 'globals.pl';
someone to take it on if they want it. FAQ is a good place for it.
> Dave Miller wrote: if ($::FORM{sub} eq 'PutFooter') {
> PutFooter();
>> I did a little experimenting with getting the command menu and foot } else {
er on die 'api.cgi was incorrectly called';
>> the end of the index page while leaving it as an HTML file... }
>>
>> I was successful. :) and then put this line in index.shtml.
>> <!--#include virtual="api.cgi?sub=PutFooter"-->
>> I added this line:
>> Note
>>
>> This still requires being able to use Server Side Includes, if this
>> Just before the </BODY> </HTML> at the end of the file. And it wor simply will not work for you, see bug 80183 for a third option.
ked.
>>
>> Thought I'd toss that out there. Should I check this in? For thos
e that
>> have SSI disabled, it'll act like a comment, so I wouldn't think it
would
>> break anything.
A.4.8. Does Bugzilla provide any reporting features, metrics, graphs, A.4.8. Does Bugzilla provide any reporting features, metrics, graphs,
etc? You know, the type of stuff that management likes to see. :) etc? You know, the type of stuff that management likes to see. :)
...@@ -3765,46 +4596,40 @@ Appendix A. The Bugzilla FAQ ...@@ -3765,46 +4596,40 @@ Appendix A. The Bugzilla FAQ
find an excellent example at find an excellent example at
http://www.mozilla.org/quality/help/bugzilla-helper.html http://www.mozilla.org/quality/help/bugzilla-helper.html
A.4.14. Does Bugzilla allow fields to be added, changed or deleted? If A.4.14. Has anyone converted Bugzilla to another language to be used
I want to customize the bug submission form to meet our needs, can I
do that using our terminology?
Yes.
A.4.15. Has anyone converted Bugzilla to another language to be used
in other countries? Is it localizable? in other countries? Is it localizable?
Currently, no. Internationalization support for Perl did not exist in Currently, no. Internationalization support for Perl did not exist in
a robust fashion until the recent release of version 5.6.0; Bugzilla a robust fashion until the recent release of version 5.6.0; Bugzilla
is, and likely will remain (until 3.X) completely non-localized. is, and likely will remain (until 3.X) completely non-localized.
A.4.16. Can a user create and save reports? Can they do this in Word A.4.15. Can a user create and save reports? Can they do this in Word
format? Excel format? format? Excel format?
Yes. No. No. Yes. No. No.
A.4.17. Can a user re-run a report with a new project, same query? A.4.16. Can a user re-run a report with a new project, same query?
Yes. Yes.
A.4.18. Can a user modify an existing report and then save it into A.4.17. Can a user modify an existing report and then save it into
another name? another name?
You can save an unlimited number of queries in Bugzilla. You are free You can save an unlimited number of queries in Bugzilla. You are free
to modify them and rename them to your heart's desire. to modify them and rename them to your heart's desire.
A.4.19. Does Bugzilla have the ability to search by word, phrase, A.4.18. Does Bugzilla have the ability to search by word, phrase,
compound search? compound search?
You have no idea. Bugzilla's query interface, particularly with the You have no idea. Bugzilla's query interface, particularly with the
advanced Boolean operators, is incredibly versatile. advanced Boolean operators, is incredibly versatile.
A.4.20. Can the admin person establish separate group and individual A.4.19. Can the admin person establish separate group and individual
user privileges? user privileges?
Yes. Yes.
A.4.21. Does Bugzilla provide record locking when there is A.4.20. Does Bugzilla provide record locking when there is
simultaneous access to the same bug? Does the second person get a simultaneous access to the same bug? Does the second person get a
notice that the bug is in use or how are they notified? notice that the bug is in use or how are they notified?
...@@ -3812,19 +4637,19 @@ Appendix A. The Bugzilla FAQ ...@@ -3812,19 +4637,19 @@ Appendix A. The Bugzilla FAQ
detection, and offers the offending user a choice of options to deal detection, and offers the offending user a choice of options to deal
with the conflict. with the conflict.
A.4.22. Are there any backup features provided? A.4.21. Are there any backup features provided?
MySQL, the database back-end for Bugzilla, allows hot-backup of data. MySQL, the database back-end for Bugzilla, allows hot-backup of data.
You can find strategies for dealing with backup considerations at You can find strategies for dealing with backup considerations at
http://www.mysql.com/doc/B/a/Backup.html http://www.mysql.com/doc/B/a/Backup.html
A.4.23. Can users be on the system while a backup is in progress? A.4.22. Can users be on the system while a backup is in progress?
Yes. However, commits to the database must wait until the tables are Yes. However, commits to the database must wait until the tables are
unlocked. Bugzilla databases are typically very small, and backups unlocked. Bugzilla databases are typically very small, and backups
routinely take less than a minute. routinely take less than a minute.
A.4.24. What type of human resources are needed to be on staff to A.4.23. What type of human resources are needed to be on staff to
install and maintain Bugzilla? Specifically, what type of skills does install and maintain Bugzilla? Specifically, what type of skills does
the person need to have? I need to find out if we were to go with the person need to have? I need to find out if we were to go with
Bugzilla, what types of individuals would we need to hire and how much Bugzilla, what types of individuals would we need to hire and how much
...@@ -3843,7 +4668,7 @@ Appendix A. The Bugzilla FAQ ...@@ -3843,7 +4668,7 @@ Appendix A. The Bugzilla FAQ
me three to five hours to make Bugzilla happy on a Development me three to five hours to make Bugzilla happy on a Development
installation of Linux-Mandrake. installation of Linux-Mandrake.
A.4.25. What time frame are we looking at if we decide to hire people A.4.24. What time frame are we looking at if we decide to hire people
to install and maintain the Bugzilla? Is this something that takes to install and maintain the Bugzilla? Is this something that takes
hours or weeks to install and a couple of hours per week to maintain hours or weeks to install and a couple of hours per week to maintain
and customize or is this a multi-week install process, plus a full and customize or is this a multi-week install process, plus a full
...@@ -3856,7 +4681,7 @@ Appendix A. The Bugzilla FAQ ...@@ -3856,7 +4681,7 @@ Appendix A. The Bugzilla FAQ
UNIX or Perl skills to handle your process management and bug-tracking UNIX or Perl skills to handle your process management and bug-tracking
maintenance & customization. maintenance & customization.
A.4.26. Is there any licensing fee or other fees for using Bugzilla? A.4.25. Is there any licensing fee or other fees for using Bugzilla?
Any out-of-pocket cost other than the bodies needed as identified Any out-of-pocket cost other than the bodies needed as identified
above? above?
...@@ -3950,18 +4775,11 @@ Appendix A. The Bugzilla FAQ ...@@ -3950,18 +4775,11 @@ Appendix A. The Bugzilla FAQ
If you are using an alternate Mail Transport Agent (MTA other than If you are using an alternate Mail Transport Agent (MTA other than
sendmail), make sure the options given in the "processmail" script for sendmail), make sure the options given in the "processmail" script for
all instances of "sendmail" are correct for your MTA. If you are using all instances of "sendmail" are correct for your MTA.
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!)
A better alternative is to change the "-O" option to If you are using Sendmail, try enabling "sendmailnow" in
"-ODeliveryMode=background". This prevents Sendmail from hanging your editparams.cgi. If you are using Postfix, you will also need to enable
Bugzilla Perl processes if the domain to which it must send mail is "sendmailnow".
unavailable.
This is now a configurable parameter called "sendmailnow", available
from editparams.cgi.
A.7.7. How come email never reaches me from bugzilla changes? A.7.7. How come email never reaches me from bugzilla changes?
...@@ -4004,12 +4822,17 @@ Appendix A. The Bugzilla FAQ ...@@ -4004,12 +4822,17 @@ Appendix A. The Bugzilla FAQ
A.8.3. I think my database might be corrupted, or contain invalid A.8.3. I think my database might be corrupted, or contain invalid
entries. What do I do? entries. What do I do?
Run the "sanity check" utility (./sanitycheck.cgi in the bugzilla_home 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 directory) from your web browser to see! If it finishes without
back OK (i.e. any red letters), there are certain things Bugzilla can errors, you're probably OK. If it doesn't come back OK (i.e. any red
recover from and certain things it can't. If it can't auto-recover, I letters), there are certain things Bugzilla can recover from and
hope you're familiar with mysqladmin commands or have installed certain things it can't. If it can't auto-recover, I hope you're
another way to manage your database... 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.
A.8.4. I want to manually edit some entries in my database. How? A.8.4. I want to manually edit some entries in my database. How?
...@@ -4065,10 +4888,10 @@ Appendix A. The Bugzilla FAQ ...@@ -4065,10 +4888,10 @@ Appendix A. The Bugzilla FAQ
A.8.9. How come even after I delete bugs, the long descriptions show A.8.9. How come even after I delete bugs, the long descriptions show
up? up?
Delete everything from $BUZILLA_HOME/shadow. Bugzilla creates shadow This should only happen with Bugzilla 2.14 if you are using the
files there, with each filename corresponding to a bug number. Also be "shadow database" feature, and your shadow database is out of sync.
sure to run syncshadowdb to make sure, if you are using a shadow Try running syncshadowdb -syncall to make sure your shadow database is
database, that the shadow database is current. in synch with your primary database.
9. Bugzilla and Win32 9. Bugzilla and Win32
...@@ -4279,8 +5102,8 @@ Appendix A. The Bugzilla FAQ ...@@ -4279,8 +5102,8 @@ Appendix A. The Bugzilla FAQ
Try this link to view current bugs or requests for enhancement for Try this link to view current bugs or requests for enhancement for
Bugzilla. Bugzilla.
You can view bugs marked for 2.14 release here. This list includes You can view bugs marked for 2.16 release here. This list includes
bugs for the 2.14 release that have already been fixed and checked bugs for the 2.16 release that have already been fixed and checked
into CVS. Please consult the Bugzilla Project Page for details on how into CVS. Please consult the Bugzilla Project Page for details on how
to check current sources out of CVS so you can have these bug fixes to check current sources out of CVS so you can have these bug fixes
early! early!
...@@ -4300,8 +5123,7 @@ Appendix A. The Bugzilla FAQ ...@@ -4300,8 +5123,7 @@ Appendix A. The Bugzilla FAQ
A.11.3. What's the best way to submit patches? What guidelines should A.11.3. What's the best way to submit patches? What guidelines should
I follow? I follow?
1. Enter a bug into bugzilla.mozilla.org for the "Webtools" product, 1. Enter a bug into bugzilla.mozilla.org for the "Bugzilla" product.
"Bugzilla" component.
2. Upload your patch as a unified DIFF (having used "diff -u" against 2. Upload your patch as a unified DIFF (having used "diff -u" against
the current sources checked out of CVS), or new source file by the current sources checked out of CVS), or new source file by
clicking "Create a new attachment" link on the bug page you've clicking "Create a new attachment" link on the bug page you've
...@@ -4904,74 +5726,6 @@ C.3. MySQL Permissions & Grant Tables ...@@ -4904,74 +5726,6 @@ C.3. MySQL Permissions & Grant Tables
http://www.mysql.com/Manual/manual.html. http://www.mysql.com/Manual/manual.html.
_________________________________________________________________ _________________________________________________________________
Chapter 7. Bugzilla Variants and Competitors
I created this section to answer questions about Bugzilla competitors
and variants, then found a wonderful site which covers an awful lot of
what I wanted to discuss. Rather than quote it in its entirety, I'll
simply refer you here: http://linas.org/linux/pm.html
_________________________________________________________________
7.1. Red Hat Bugzilla
Red Hat Bugzilla is probably the most popular Bugzilla variant on the
planet. One of the major benefits of Red Hat Bugzilla is the ability
to work with Oracle, MySQL, and PostGreSQL databases serving as the
back-end, instead of just MySQL. Dave Lawrence has worked very hard to
keep Red Hat Bugzilla up-to-date, and many people prefer the
snappier-looking page layout of Red Hat Bugzilla to the default
Mozilla-standard formatting.
URL: http://bugzilla.redhat.com/bugzilla/
_________________________________________________________________
7.2. Loki Bugzilla (Fenris)
Fenris can be found at http://fenris.lokigames.com. It is a fork from
Bugzilla.
_________________________________________________________________
7.3. Issuezilla
Issuezilla is another fork from Bugzilla, and seems nearly as popular
as the Red Hat Bugzilla fork. Some Issuezilla team members are regular
contributors to the Bugzilla mailing list/newsgroup. Issuezilla is not
the primary focus of bug-tracking at tigris.org, however. Their
Java-based bug-tracker, Scarab, a newfangled Java-based issue tracker,
is under heavy development and looks promising!
URL: http://issuezilla.tigris.org/servlets/ProjectHome
_________________________________________________________________
7.4. Scarab
Scarab is a promising new bug-tracking system built using Java Serlet
technology. As of this writing, no source code has been released as a
package, but you can obtain the code from CVS.
URL: http://scarab.tigris.org
_________________________________________________________________
7.5. Perforce SCM
Although Perforce isn't really a bug tracker, it can be used as such
through the "jobs" functionality.
http://www.perforce.com/perforce/technotes/note052.htmlhttp://www.perf
orce.com/perforce/technotes/note052.html
_________________________________________________________________
7.6. SourceForge
SourceForge is more of a way of coordinating geographically
distributed free software and open source projects over the Internet
than strictly a bug tracker, but if you're hunting for bug-tracking
for your open project, it may be just what the software engineer
ordered!
URL: http://www.sourceforge.net
_________________________________________________________________
Appendix D. Useful Patches and Utilities for Bugzilla Appendix D. Useful Patches and Utilities for Bugzilla
Are you looking for a way to put your Bugzilla into overdrive? Catch Are you looking for a way to put your Bugzilla into overdrive? Catch
...@@ -5095,6 +5849,109 @@ D.4. The Quicksearch Utility ...@@ -5095,6 +5849,109 @@ D.4. The Quicksearch Utility
has details. has details.
_________________________________________________________________ _________________________________________________________________
D.5. Hacking Bugzilla
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.
The following is a guide for reviewers when checking code into Bugzill
a's
CVS repostory at mozilla.org. If you wish to submit patches to Bugzil
la,
you should follow the rules and style conventions below. Any code tha
t
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 expressi
on.
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 expressi
on, 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. Therefo
re,
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 sta
tement
that is causing the block and the closing brace should be at the s
ame
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 leg
al across
multiple platforms. \ / : * ? " < > and | are all illegal charact
ers 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 util
ities.
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, p
rovided the
context makes their content obvious. For example, $ret could be u
sed 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 t
ook advantage
of some of its features that aren't contained in other RDBMS softw
are. 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 U
nix/Linux is
still the only officially supported platform) there are many who d
esire/need to
run Bugzilla on Microsoft Windows boxes. Whenever possible, we sh
ould strive
not to make the lives of these people any more complicated and avo
id doing things
that break Bugzilla's ability to run on multiple operating systems
.
_________________________________________________________________
Appendix E. GNU Free Documentation License Appendix E. GNU Free Documentation License
Version 1.1, March 2000 Version 1.1, March 2000
......
docs/xml/Bugzilla-Guide.xml
View file @ 58593ba9
...@@ -26,7 +26,7 @@ ...@@ -26,7 +26,7 @@
<!ENTITY bzg-ver "2.14"> <!ENTITY bzg-ver "2.14">
<!ENTITY bzg-cvs-ver "2.15.0"> <!ENTITY bzg-cvs-ver "2.15.0">
<!ENTITY bzg-auth "Matthew P. Barnson"> <!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 mysql "http://www.mysql.com/">
<!ENTITY perl-ver "5.6.1"> <!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 ...@@ -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> <othername>P.</othername>
<surname>Barnson</surname> <surname>Barnson</surname>
<affiliation> <affiliation>
<address><email>barnboy@NOSPAM.trilobyte.net</email></address> <address><email>barnboy@trilobyte.net</email></address>
</affiliation> </affiliation>
</author> </author>
<collab> <collab>
<collabname>Zach Lipton</collabname> <collabname>Zach Lipton</collabname>
<affiliation> <affiliation>
<address><email>zach@NOSPAM.zachlipton.com</email></address> <address><email>zach AT zachlipton DOT com</email></address>
</affiliation> </affiliation>
</collab> </collab>
...@@ -196,6 +196,9 @@ try to avoid clutter and feel free to waste space in the code to make it more re ...@@ -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 --> <!-- The Future of Bugzilla -->
&future; &future;
<!-- Major Bugzilla Variants -->
&variants;
<!-- Appendix: The Frequently Asked Questions --> <!-- Appendix: The Frequently Asked Questions -->
&faq; &faq;
...@@ -205,9 +208,6 @@ try to avoid clutter and feel free to waste space in the code to make it more re ...@@ -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 --> <!-- Appendix: The Database Schema -->
&database; &database;
<!-- Appendix: Major Bugzilla Variants -->
&variants;
<!-- Appendix: Custom Patches --> <!-- Appendix: Custom Patches -->
&patches; &patches;
......
docs/xml/about.xml
View file @ 58593ba9
...@@ -70,8 +70,7 @@ ...@@ -70,8 +70,7 @@
<para> <para>
If you have any questions regarding this document, its If you have any questions regarding this document, its
copyright, or publishing this document in non-electronic form, copyright, or publishing this document in non-electronic form,
please contact &bzg-auth;. Remove "NOSPAM" from email address please contact &bzg-auth;.
to send.
</para> </para>
</section> </section>
...@@ -172,8 +171,8 @@ ...@@ -172,8 +171,8 @@
</para> </para>
<para> <para>
<ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink> <ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink>
for initially converting Bugzilla from BugSplat! and writing the for initially writing Bugzilla and creating the
README upon which this documentation is largely based. README upon which the UNIX installation documentation is largely based.
</para> </para>
<para> <para>
<ulink url="mailto://tara@tequilarista.org">Tara <ulink url="mailto://tara@tequilarista.org">Tara
...@@ -204,7 +203,8 @@ ...@@ -204,7 +203,8 @@
documentation (in no particular order): documentation (in no particular order):
</para> </para>
<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> </para>
</section> </section>
<section id="feedback"> <section id="feedback">
......
docs/xml/administration.xml
View file @ 58593ba9
...@@ -1192,6 +1192,103 @@ ...@@ -1192,6 +1192,103 @@
</para> </para>
</listitem> </listitem>
</orderedlist> </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>
</section> </section>
......
docs/xml/database.xml
View file @ 58593ba9
...@@ -13,7 +13,7 @@ ...@@ -13,7 +13,7 @@
<para> <para>
<mediaobject> <mediaobject>
<imageobject> <imageobject>
<imagedata fileref="dbschema.jpg" format="jpg"> <imagedata fileref="../images/dbschema.jpg" format="jpg">
</imageobject> </imageobject>
<textobject> <textobject>
......
docs/xml/faq.xml
View file @ 58593ba9
...@@ -620,6 +620,12 @@ ...@@ -620,6 +620,12 @@
progression states, also require adjusting the program logic to progression states, also require adjusting the program logic to
compensate for the change. compensate for the change.
</para> </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> </answer>
</qandaentry> </qandaentry>
...@@ -633,42 +639,62 @@ ...@@ -633,42 +639,62 @@
</para> </para>
</question> </question>
<answer> <answer>
<para> <para>
This was a late-breaking question for the Guide, so I just have to It's possible to get the footer on the static index page using
quote the relevant newsgroup thread on it. Server Side Includes (SSI). The trick to doing this is making
</para> sure that your web server is set up to allow SSI and specifically,
<literallayout> the #exec directive. You should also rename <filename>index.html</filename>
> AFAIK, most sites (even if they have SSI enabled) won't have #exec cmd to <filename>index.shtml</filename>.
> enabled. Perhaps what would be better is a #include virtual and a </para>
> footer.cgi the basically has the "require 'CGI.pl' and PutFooter command. <para>
> After you've done all that, you can add the following line to
> Please note that under most configurations, this also requires naming <filename>index.shtml</filename>:
> the file from index.html to index.shtml (and making sure that it will <programlisting>
> still be reconized as an index). Personally, I think this is better on <![CDATA[
> a per-installation basis (perhaps add something to the FAQ that says how <!--#exec cmd="/usr/bin/perl -e &quot;require 'CGI.pl'; PutFooter();&quot;" -->
> to do this). ]]>
</programlisting>
Good point. Yeah, easy enough to do, that it shouldn't be a big deal for </para>
someone to take it on if they want it. FAQ is a good place for it. <para><note>
<para>
> Dave Miller wrote: 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
>> I did a little experimenting with getting the command menu and footer on want the footer to appear.
>> the end of the index page while leaving it as an HTML file... </para>
>> </note></para>
>> I was successful. :) <para>
>> Because this method depends on being able to use a #exec directive,
>> I added this line: 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>)
>> <!--#exec cmd="/usr/bin/perl -e &quot;require 'CGI.pl'; that basically looks like:
>>PutFooter();&quot;" --> <programlisting>
>> <![CDATA[
>> Just before the &lt;/BODY&gt; &lt;/HTML&gt; at the end of the file. And it worked. #!/usr/bonsaitools/bin/perl -w
>>
>> Thought I'd toss that out there. Should I check this in? For those that require 'globals.pl';
>> have SSI disabled, it'll act like a comment, so I wouldn't think it would
>> break anything. if ($::FORM{sub} eq 'PutFooter') {
</literallayout> 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> </answer>
</qandaentry> </qandaentry>
<qandaentry> <qandaentry>
...@@ -807,21 +833,6 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -807,21 +833,6 @@ someone to take it on if they want it. FAQ is a good place for it.
<qandaentry> <qandaentry>
<question> <question>
<para> <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>
Has anyone converted Bugzilla to another language to be used in other Has anyone converted Bugzilla to another language to be used in other
countries? Is it localizable? countries? Is it localizable?
</para> </para>
...@@ -1221,20 +1232,11 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -1221,20 +1232,11 @@ someone to take it on if they want it. FAQ is a good place for it.
<para> <para>
If you are using an alternate Mail Transport Agent (MTA other than If you are using an alternate Mail Transport Agent (MTA other than
sendmail), make sure the options given in the "processmail" script for all 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, instances of "sendmail" are correct for your MTA.
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!)
</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>
<para> <para>
This is now a configurable parameter called "sendmailnow", available If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi.
from editparams.cgi. If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>.
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>
...@@ -1315,12 +1317,21 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -1315,12 +1317,21 @@ someone to take it on if they want it. FAQ is a good place for it.
</question> </question>
<answer> <answer>
<para> <para>
Run the "sanity check" utility (./sanitycheck.cgi in the bugzilla_home Run the <quote>sanity check</quote> utility
directory) to see! If it all comes back, you're OK. If it doesn't come back (<filename>./sanitycheck.cgi</filename> in the
OK (i.e. any red letters), there are certain things Bugzilla can recover Bugzilla_home directory) from your web browser to see! If
from and certain things it can't. If it can't auto-recover, I hope you're it finishes without errors, you're
familiar with mysqladmin commands or have installed another way to manage <emphasis>probably</emphasis> OK. If it doesn't come back
your database... 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> </para>
</answer> </answer>
</qandaentry> </qandaentry>
...@@ -1428,10 +1439,12 @@ someone to take it on if they want it. FAQ is a good place for it. ...@@ -1428,10 +1439,12 @@ someone to take it on if they want it. FAQ is a good place for it.
</question> </question>
<answer> <answer>
<para> <para>
Delete everything from $BUZILLA_HOME/shadow. Bugzilla creates shadow This should only happen with Bugzilla &bz-ver; if you are
files there, with each filename corresponding to a using the <quote>shadow database</quote> feature, and your
bug number. Also be sure to run syncshadowdb to make sure, if you are using shadow database is out of sync. Try running
a shadow database, that the shadow database is current. <filename>syncshadowdb</filename>
<option>-syncall</option> to make sure your shadow
database is in synch with your primary database.
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>
...@@ -1752,14 +1765,14 @@ A: Sure! Here ya go! ...@@ -1752,14 +1765,14 @@ A: Sure! Here ya go!
</question> </question>
<answer> <answer>
<para> <para>
Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;product=Webtools&amp;component=Bugzilla"> Try <ulink url="http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;product=Bugzilla">
this link</ulink> to view current bugs or requests for this link</ulink> to view current bugs or requests for
enhancement for Bugzilla. enhancement for Bugzilla.
</para> </para>
<para> <para>
You can view bugs marked for 2.14 release You can view bugs marked for 2.16 release
<ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Webtools&amp;component=Bugzilla&amp;target_milestone=Bugzilla+2.14">here</ulink>. <ulink url="http://bugzilla.mozilla.org/buglist.cgi?product=Bugzilla&amp;target_milestone=Bugzilla+2.16">here</ulink>.
This list includes bugs for the 2.14 release that have already This list includes bugs for the 2.16 release that have already
been fixed and checked into CVS. Please consult the been fixed and checked into CVS. Please consult the
<ulink url="http://www.mozilla.org/projects/bugzilla/"> <ulink url="http://www.mozilla.org/projects/bugzilla/">
Bugzilla Project Page</ulink> for details on how to Bugzilla Project Page</ulink> for details on how to
...@@ -1800,8 +1813,9 @@ A: Sure! Here ya go! ...@@ -1800,8 +1813,9 @@ A: Sure! Here ya go!
<orderedlist> <orderedlist>
<listitem> <listitem>
<para> <para>
Enter a bug into bugzilla.mozilla.org for the "Webtools" product, Enter a bug into bugzilla.mozilla.org for the <quote><ulink
"Bugzilla" component. url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">Bugzilla</ulink></quote>
product.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
......
docs/xml/installation.xml
View file @ 58593ba9
...@@ -616,6 +616,15 @@ bash# mkdir /usr/bonsaitools/bin ...@@ -616,6 +616,15 @@ bash# mkdir /usr/bonsaitools/bin
bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl bash# ln -s /usr/bin/perl /usr/bosaitools/bin/perl
</programlisting> </programlisting>
</para> </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> </example>
<tip> <tip>
<para> <para>
...@@ -1241,7 +1250,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ ...@@ -1241,7 +1250,7 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \
</section> </section>
<section> <section id="unixhistory">
<title>UNIX Installation Instructions History</title> <title>UNIX Installation Instructions History</title>
<para> <para>
This document was originally adapted from the Bonsai This document was originally adapted from the Bonsai
...@@ -1252,9 +1261,8 @@ bash# cd $BUGZILLA_HOME; for i in `ls *.cgi`; \ ...@@ -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 The February 25, 1999 re-write of this page was done by Ry4an
Brase &lt;ry4an@ry4an.org&gt;, with some edits by Terry Brase &lt;ry4an@ry4an.org&gt;, with some edits by Terry
Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But Weissman, Bryce Nesbitt, Martin Pool, & Dan Mosedale (But
don't send bug reports to them; report them using bugzilla, at don't send bug reports to them; report them using bugzilla, at <ulink
http://bugzilla.mozilla.org/enter_bug.cgi , project Webtools, url="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla">http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla</ulink> ).
component Bugzilla).
</para> </para>
<para> <para>
This document was heavily modified again Wednesday, March 07 This document was heavily modified again Wednesday, March 07
...@@ -1696,16 +1704,46 @@ exit; ...@@ -1696,16 +1704,46 @@ exit;
<step> <step>
<para> <para>
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
<programlisting> scripts in your Bugzilla directory. For instance, change
system ("./processmail.pl",@ARGLIST); this line in processmail:
</programlisting> <programlisting>
to system ("./processmail.pl",@ARGLIST);
<programlisting> </programlisting> to
<programlisting>
system ("perl processmail.pl",@ARGLIST); system ("perl processmail.pl",@ARGLIST);
</programlisting> </programlisting>
</para> </para>
</step> </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> </procedure>
<tip> <tip>
...@@ -1714,6 +1752,8 @@ system ("perl processmail.pl",@ARGLIST); ...@@ -1714,6 +1752,8 @@ system ("perl processmail.pl",@ARGLIST);
relationships to Properties -> Home directory (tab) -> relationships to Properties -> Home directory (tab) ->
Application Settings (section) -> Configuration (button), Application Settings (section) -> Configuration (button),
such as: such as:
</para>
<para>
<programlisting> <programlisting>
.cgi to: &lt;perl install directory&gt;\perl.exe %s %s .cgi to: &lt;perl install directory&gt;\perl.exe %s %s
.pl to: &lt;perl install directory&gt;\perl.exe %s %s .pl to: &lt;perl install directory&gt;\perl.exe %s %s
...@@ -1742,7 +1782,9 @@ GET,HEAD,POST ...@@ -1742,7 +1782,9 @@ GET,HEAD,POST
registry at the following location: registry at the following location:
</para> </para>
<para> <para>
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap <programlisting>
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
</programlisting>
</para> </para>
<para> <para>
The keys should be called ".pl" and ".cgi", and both The keys should be called ".pl" and ".cgi", and both
...@@ -1761,26 +1803,102 @@ GET,HEAD,POST ...@@ -1761,26 +1803,102 @@ GET,HEAD,POST
If attempting to run Bugzilla 2.12 or older, you will need If attempting to run Bugzilla 2.12 or older, you will need
to remove encrypt() calls from the Perl source. This is to remove encrypt() calls from the Perl source. This is
<emphasis>not necessary</emphasis> for Bugzilla 2.13 and <emphasis>not necessary</emphasis> for Bugzilla 2.13 and
later. later, which includes the current release, Bugzilla
&bz-ver;.
<example> <example>
<title>Removing encrypt() for Windows NT Bugzilla version <title>Removing encrypt() for Windows NT Bugzilla version
2.12 or earlier</title> 2.12 or earlier</title>
<para> <para>
Replace this: Replace this:
<programlisting> <programlisting>
SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SqlQuote(substr($realcryptpwd, 0, 2)) . ")"); SendSQL("SELECT encrypt(" . SqlQuote($enteredpwd) . ", " . SQLQuote(substr($realcryptpwd, 0, 2)) . ")");
my $enteredcryptpwd = FetchOneColumn(); my $enteredcryptpwd = FetchOneColumn();
</programlisting> </programlisting>
with this: with this:
<programlisting> <programlisting>
my $enteredcryptpwd = $enteredpwd my $enteredcryptpwd = $enteredpwd
</programlisting> </programlisting>
in cgi.pl. in cgi.pl.
</para> </para>
</example> </example>
</para> </para>
</tip> </tip>
</section> </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> </section>
</chapter> </chapter>
......
docs/xml/integration.xml
View file @ 58593ba9
...@@ -35,6 +35,14 @@ ...@@ -35,6 +35,14 @@
an @resolution field, you can even change the Bugzilla bug an @resolution field, you can even change the Bugzilla bug
state. state.
</para> </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>
<section id="scm" xreflabel="Perforce SCM (Fast Software Configuration Management System, a powerful commercial alternative to CVS"> <section id="scm" xreflabel="Perforce SCM (Fast Software Configuration Management System, a powerful commercial alternative to CVS">
......
docs/xml/patches.xml
View file @ 58593ba9
...@@ -247,6 +247,104 @@ RewriteRule ^/([0-9]+)$ http://foo.bar.com/show_bug.cgi?id=$1 [L,R] ...@@ -247,6 +247,104 @@ RewriteRule ^/([0-9]+)$ http://foo.bar.com/show_bug.cgi?id=$1 [L,R]
</para> </para>
</section> </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> </appendix>
......
docs/xml/using.xml
View file @ 58593ba9
...@@ -399,13 +399,13 @@ system against which all others are measured. ...@@ -399,13 +399,13 @@ system against which all others are measured.
our Bugzilla database. Please notice the box is a our Bugzilla database. Please notice the box is a
<emphasis>scrollbox</emphasis>. Using the down arrow on <emphasis>scrollbox</emphasis>. Using the down arrow on
the scrollbox, scroll down until you can see an entry the scrollbox, scroll down until you can see an entry
called "Webtools". Select this entry. called "Bugzilla". Select this entry.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Did you notice that some of the boxes to the right changed 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 has different Versions, Components, and Target Milestones
associated with it. A "Version" is the number of a associated with it. A "Version" is the number of a
software program. software program.
...@@ -452,36 +452,67 @@ system against which all others are measured. ...@@ -452,36 +452,67 @@ system against which all others are measured.
Normally, a Component has a single Owner, who is responsible Normally, a Component has a single Owner, who is responsible
for overseeing efforts to improve that Component. for overseeing efforts to improve that Component.
<example> <example>
<title>Mozilla Webtools Components</title> <title>Mozilla's Bugzilla Components</title>
<informalexample> <informalexample>
<para> <para>
Mozilla's "Webtools" Product is composed of several pieces (Components): Mozilla's "Bugzilla" Product is composed of several pieces (Components):
<simplelist> <simplelist>
<member><emphasis>Bonsai</emphasis>, <member><emphasis>Administration</emphasis>,
a tool to show recent changes to Mozilla</member> Administration of a bugzilla installation, including
<member><emphasis>Bugzilla</emphasis>, <filename>editcomponents.cgi</filename>,
a defect-tracking tool</member> <filename>editgroups.cgi</filename>,
<member><emphasis>Build</emphasis>, <filename>editkeywords.cgi</filename>,
a tool to automatically compile source code <filename>editparams.cgi</filename>,
into machine-readable form</member> <filename>editproducts.cgi</filename>,
<member><emphasis>Despot</emphasis>, <filename>editusers.cgi</filename>,
a program that controls access to the other Webtools</member> <filename>editversions.cgi,</filename> and
<member><emphasis>LXR</emphasis>, <filename>sanitycheck.cgi</filename>.
a utility that automatically marks up text files </member>
to make them more readable</member> <member><emphasis>Bugzilla-General</emphasis>,
<member><emphasis>MozBot</emphasis>, Anything that doesn't fit in the other components, or spans
a "robot" that announces changes to Mozilla in Chat</member> multiple components.
<member><emphasis>TestManager</emphasis>, </member>
a tool to help find bugs in Mozilla</member> <member><emphasis>Creating/Changing Bugs</emphasis>,
<member><emphasis>Tinderbox</emphasis>, Creating, changing, and viewing bugs.
which displays reports from Build</member> <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> </simplelist>
</para> </para>
<para>
A different person is responsible for each of these Components.
Tara Hernandez keeps
the "Bugzilla" component up-to-date.
</para>
</informalexample> </informalexample>
</example> </example>
</para> </para>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment