Commit d8caf604 authored by gerv%gerv.net's avatar gerv%gerv.net

Merging new docs from 2.16 branch.

parent a9bb1874
This source diff could not be displayed because it is too large. You can view the blob instead.
...@@ -13,8 +13,8 @@ REL="PREVIOUS" ...@@ -13,8 +13,8 @@ REL="PREVIOUS"
TITLE="The Bugzilla Guide" TITLE="The Bugzilla Guide"
HREF="index.html"><LINK HREF="index.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Purpose and Scope of this Guide" TITLE="Copyright Information"
HREF="aboutthisguide.html"></HEAD HREF="copyright.html"></HEAD
><BODY ><BODY
CLASS="chapter" CLASS="chapter"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -56,7 +56,7 @@ WIDTH="10%" ...@@ -56,7 +56,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="aboutthisguide.html" HREF="copyright.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -79,36 +79,26 @@ CLASS="TOC" ...@@ -79,36 +79,26 @@ CLASS="TOC"
></DT ></DT
><DT ><DT
>1.1. <A >1.1. <A
HREF="aboutthisguide.html"
>Purpose and Scope of this Guide</A
></DT
><DT
>1.2. <A
HREF="copyright.html" HREF="copyright.html"
>Copyright Information</A >Copyright Information</A
></DT ></DT
><DT ><DT
>1.3. <A >1.2. <A
HREF="disclaimer.html" HREF="disclaimer.html"
>Disclaimer</A >Disclaimer</A
></DT ></DT
><DT ><DT
>1.4. <A >1.3. <A
HREF="newversions.html" HREF="newversions.html"
>New Versions</A >New Versions</A
></DT ></DT
><DT ><DT
>1.5. <A >1.4. <A
HREF="credits.html" HREF="credits.html"
>Credits</A >Credits</A
></DT ></DT
><DT ><DT
>1.6. <A >1.5. <A
HREF="translations.html"
>Translations</A
></DT
><DT
>1.7. <A
HREF="conventions.html" HREF="conventions.html"
>Document Conventions</A >Document Conventions</A
></DT ></DT
...@@ -149,7 +139,7 @@ WIDTH="33%" ...@@ -149,7 +139,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="aboutthisguide.html" HREF="copyright.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -169,7 +159,7 @@ VALIGN="top" ...@@ -169,7 +159,7 @@ VALIGN="top"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>Purpose and Scope of this Guide</TD >Copyright Information</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
<HTML
><HEAD
><TITLE
>Purpose and Scope of this Guide</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="About This Guide"
HREF="about.html"><LINK
REL="PREVIOUS"
TITLE="About This Guide"
HREF="about.html"><LINK
REL="NEXT"
TITLE="Copyright Information"
HREF="copyright.html"></HEAD
><BODY
CLASS="section"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="about.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 1. About This Guide</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="copyright.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="aboutthisguide">1.1. Purpose and Scope of this Guide</H1
><P
>&#13; Bugzilla is simply the best piece of bug-tracking software the
world has ever seen. This document is intended to be the
comprehensive guide to the installation, administration,
maintenance, and use of the Bugzilla bug-tracking system.
</P
><P
>&#13; This release of the Bugzilla Guide is the
<EM
>2.16</EM
> release. It is so named that it
may match the current version of Bugzilla. The numbering
tradition stems from that used for many free software projects,
in which <EM
>even-numbered</EM
> point releases (1.2,
1.14, etc.) are considered "stable releases", intended for
public consumption; on the other hand,
<EM
>odd-numbered</EM
> point releases (1.3, 2.09,
etc.) are considered unstable <EM
>development</EM
>
releases intended for advanced users, systems administrators,
developers, and those who enjoy a lot of pain.
</P
><P
>&#13; Newer revisions of the Bugzilla Guide follow the numbering
conventions of the main-tree Bugzilla releases, available at
<A
HREF="http://www.bugzilla.org/"
TARGET="_top"
>http://www.bugzilla.org/</A
>. Intermediate releases will have
a minor revision number following a period. The current version
of Bugzilla, as of this writing (April 2nd, 2002) is 2.16; if
something were seriously wrong with that edition of the Guide,
subsequent releases would receive an additional dotted-decimal
digit to indicate the update (2.16.1, 2.16.2, etc.).
Got it? Good.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="about.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="copyright.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>About This Guide</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="about.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Copyright Information</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
...@@ -10,11 +10,11 @@ REL="HOME" ...@@ -10,11 +10,11 @@ REL="HOME"
TITLE="The Bugzilla Guide" TITLE="The Bugzilla Guide"
HREF="index.html"><LINK HREF="index.html"><LINK
REL="PREVIOUS" REL="PREVIOUS"
TITLE="Win32 Installation Notes" TITLE="Troubleshooting"
HREF="win32.html"><LINK HREF="troubleshooting.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Post-Installation Checklist" TITLE="Bugzilla Configuration"
HREF="postinstall-check.html"></HEAD HREF="parameters.html"></HEAD
><BODY ><BODY
CLASS="chapter" CLASS="chapter"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -42,7 +42,7 @@ WIDTH="10%" ...@@ -42,7 +42,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="win32.html" HREF="troubleshooting.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -56,7 +56,7 @@ WIDTH="10%" ...@@ -56,7 +56,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="postinstall-check.html" HREF="parameters.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -69,7 +69,7 @@ WIDTH="100%"></DIV ...@@ -69,7 +69,7 @@ WIDTH="100%"></DIV
CLASS="chapter" CLASS="chapter"
><H1 ><H1
><A ><A
NAME="administration">Chapter 4. Administering Bugzilla</H1 NAME="administration">Chapter 5. Administering Bugzilla</H1
><DIV ><DIV
CLASS="TOC" CLASS="TOC"
><DL ><DL
...@@ -78,97 +78,138 @@ CLASS="TOC" ...@@ -78,97 +78,138 @@ CLASS="TOC"
>Table of Contents</B >Table of Contents</B
></DT ></DT
><DT ><DT
>4.1. <A >5.1. <A
HREF="postinstall-check.html" HREF="parameters.html"
>Post-Installation Checklist</A >Bugzilla Configuration</A
></DT ></DT
><DT ><DT
>4.2. <A >5.2. <A
HREF="useradmin.html" HREF="useradmin.html"
>User Administration</A >User Administration</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>4.2.1. <A >5.2.1. <A
HREF="useradmin.html#defaultuser" HREF="useradmin.html#defaultuser"
>Creating the Default User</A >Creating the Default User</A
></DT ></DT
><DT ><DT
>4.2.2. <A >5.2.2. <A
HREF="useradmin.html#manageusers" HREF="useradmin.html#manageusers"
>Managing Other Users</A >Managing Other Users</A
></DT ></DT
></DL ></DL
></DD ></DD
><DT ><DT
>4.3. <A >5.3. <A
HREF="programadmin.html" HREF="programadmin.html"
>Product, Component, Milestone, and Version >Product, Component, Milestone, and Version Administration</A
Administration</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>4.3.1. <A >5.3.1. <A
HREF="programadmin.html#products" HREF="programadmin.html#products"
>Products</A >Products</A
></DT ></DT
><DT ><DT
>4.3.2. <A >5.3.2. <A
HREF="programadmin.html#components" HREF="programadmin.html#components"
>Components</A >Components</A
></DT ></DT
><DT ><DT
>4.3.3. <A >5.3.3. <A
HREF="programadmin.html#versions" HREF="programadmin.html#versions"
>Versions</A >Versions</A
></DT ></DT
><DT ><DT
>4.3.4. <A >5.3.4. <A
HREF="programadmin.html#milestones" HREF="programadmin.html#milestones"
>Milestones</A >Milestones</A
></DT ></DT
></DL
></DD
><DT ><DT
>4.3.5. <A >5.4. <A
HREF="programadmin.html#voting" HREF="voting.html"
>Voting</A >Voting</A
></DT ></DT
><DT ><DT
>4.3.6. <A >5.5. <A
HREF="programadmin.html#groups" HREF="groups.html"
>Groups and Group Security</A >Groups and Group Security</A
></DT ></DT
></DL
></DD
><DT ><DT
>4.4. <A >5.6. <A
HREF="security.html" HREF="security.html"
>Bugzilla Security</A >Bugzilla Security</A
></DT ></DT
><DT
>5.7. <A
HREF="cust-templates.html"
>Template Customisation</A
></DT
><DD
><DL
><DT
>5.7.1. <A
HREF="cust-templates.html#AEN1539"
>What to Edit</A
></DT
><DT
>5.7.2. <A
HREF="cust-templates.html#AEN1558"
>How To Edit Templates</A
></DT
><DT
>5.7.3. <A
HREF="cust-templates.html#AEN1568"
>Template Formats</A
></DT
><DT
>5.7.4. <A
HREF="cust-templates.html#AEN1581"
>Particular Templates</A
></DT
></DL
></DD
><DT
>5.8. <A
HREF="upgrading.html"
>Upgrading to New Releases</A
></DT
><DT
>5.9. <A
HREF="integration.html"
>Integrating Bugzilla with Third-Party Tools</A
></DT
><DD
><DL
><DT
>5.9.1. <A
HREF="integration.html#bonsai"
>Bonsai</A
></DT
><DT
>5.9.2. <A
HREF="integration.html#cvs"
>CVS</A
></DT
><DT
>5.9.3. <A
HREF="integration.html#scm"
>Perforce SCM</A
></DT
><DT
>5.9.4. <A
HREF="integration.html#tinderbox"
>Tinderbox/Tinderbox2</A
></DT
></DL
></DD
></DL ></DL
></DIV ></DIV
><FONT
COLOR="RED"
>&#13; Or, I just got this cool thing installed. Now what the heck do I
do with it?
</FONT
><P
>&#13; So you followed <SPAN
CLASS="QUOTE"
>"<A
HREF="installation.html"
>Bugzilla Installation</A
>"</SPAN
> to the
letter, and logged into Bugzilla for the very first time with your
super-duper god account. You sit, contentedly staring at the
Bugzilla Query Screen, the worst of the whole mad business of
installing this terrific program behind you. It seems, though, you
have nothing yet to query! Your first act of business should be to
setup the operating parameters for Bugzilla so you can get busy
getting data into your bug tracker.
</P
></DIV ></DIV
><DIV ><DIV
CLASS="NAVFOOTER" CLASS="NAVFOOTER"
...@@ -186,7 +227,7 @@ WIDTH="33%" ...@@ -186,7 +227,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="win32.html" HREF="troubleshooting.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -204,7 +245,7 @@ WIDTH="33%" ...@@ -204,7 +245,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="postinstall-check.html" HREF="parameters.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -214,7 +255,7 @@ ACCESSKEY="N" ...@@ -214,7 +255,7 @@ ACCESSKEY="N"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>Win32 Installation Notes</TD >Troubleshooting</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
...@@ -224,7 +265,7 @@ VALIGN="top" ...@@ -224,7 +265,7 @@ VALIGN="top"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>Post-Installation Checklist</TD >Bugzilla Configuration</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
<HTML
><HEAD
><TITLE
>BSD Installation Notes</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="Installation"
HREF="installation.html"><LINK
REL="PREVIOUS"
TITLE="Mac OS X Installation Notes"
HREF="osx.html"><LINK
REL="NEXT"
TITLE="Installation General Notes"
HREF="geninstall.html"></HEAD
><BODY
CLASS="section"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="osx.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 3. Installation</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="geninstall.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="bsdinstall">3.4. BSD Installation Notes</H1
><P
>&#13; For instructions on how to set up Bugzilla on FreeBSD, NetBSD, OpenBSD, BSDi, etc. please
consult <A
HREF="osx.html"
>Section 3.3</A
>.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="osx.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="geninstall.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Mac OS X Installation Notes</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="installation.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Installation General Notes</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>Hacking Bugzilla</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><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
SUMMARY="Header navigation 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"
ACCESSKEY="P"
>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"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="bzhacking">D.5. Hacking Bugzilla</H1
><P
>&#13; 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.
</P
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="AEN2436">D.5.1. Things that have caused problems and should be avoided</H2
><P
></P
><OL
TYPE="1"
><LI
><P
>&#13; Usage of variables in Regular Expressions
</P
><P
>&#13; 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:
</P
><P
>&#13; <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="programlisting"
>&#13;grep ($_ eq $value, @array);
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
>&#13; -- NOT THIS --
</P
><P
>&#13; <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="programlisting"
>&#13;grep (/$value/, @array);
</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
>&#13; If you need to use a non-expression variable inside of an expression, be
sure to quote it properly (using <TT
CLASS="function"
>\Q..\E</TT
>).
</P
></TD
></TR
></TABLE
></DIV
></LI
></OL
></DIV
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="AEN2450">D.5.2. Coding Style for Bugzilla</H2
><P
>&#13; While it's true that not all of the code currently in Bugzilla adheres to
this (or any) 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 :).
</P
><P
>&#13; The Bugzilla development team has decided to adopt the perl style guide as
published by Larry Wall. This giude can be found in <SPAN
CLASS="QUOTE"
>"Programming
Perl"</SPAN
> (the camel book) or by typing <B
CLASS="command"
>man perlstyle</B
> at
your favorite shell prompt.
</P
><P
>&#13; What appears below if a brief summary, please refer to the perl style
guide if you don't see your question covered here. It is much better to submit
a patch which fails these criteria than no patch at all, but please try to meet
these minimum standards when submitting code to Bugzilla.
</P
><P
></P
><UL
><LI
><P
>&#13; Whitespace
</P
><P
>&#13; Bugzilla's preferred indentation is 4 spaces (no tabs, please).
</P
></LI
><LI
><P
>&#13; Curly braces.
</P
><P
>&#13; 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:
</P
><P
>&#13; <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="programlisting"
>&#13;if ($var) {
print "The variable is true";
}
else {
print "Try again";
}
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
><P
>&#13; -- NOT THIS --
</P
><P
>&#13; <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="programlisting"
>&#13;if ($var)
{
print "The variable is true";
}
else
{
print "Try again";
}
</PRE
></FONT
></TD
></TR
></TABLE
>
</P
></LI
><LI
><P
>&#13; Cookies
</P
><P
>&#13; Bugzilla uses cookies to ease the user experience, but no new patches
should <EM
>require</EM
> user-side cookies.
</P
></LI
><LI
><P
>&#13; File Names
</P
><P
>&#13; File names for bugzilla code and support documention should be legal across
multiple platforms. <TT
CLASS="computeroutput"
>\ / : * ? " &#60; &#62;</TT
>
and <TT
CLASS="computeroutput"
>|</TT
> 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.
</P
></LI
><LI
><P
>&#13; Javascript dependencies
</P
><P
>&#13; While Bugzilla uses Javascript to make the user experience easier, no patch
to Bugzilla should <EM
>require</EM
> Javascript.
</P
></LI
><LI
><P
>&#13; Patch Format
</P
><P
>&#13; All patches submitted for inclusion into Bugzilla should be in the form of a
<SPAN
CLASS="QUOTE"
>"unified diff"</SPAN
>. This comes from using <SPAN
CLASS="QUOTE"
>"diff -u"</SPAN
>
instead of simply <SPAN
CLASS="QUOTE"
>"diff"</SPAN
> when creating your patch. This will
result in quicker acceptance of the patch.
</P
></LI
><LI
><P
>&#13; Schema Changes
</P
><P
>&#13; If you make schema changes, you should modify <TT
CLASS="filename"
>sanitycheck.cgi</TT
>
to support the new schema. All referential columns should be checked.
</P
></LI
><LI
><P
>&#13; Taint Mode
</P
><P
>&#13; All new cgis must run in Taint mode (Perl taint and DBI taint), and existing cgi's
which run in taint mode must not have taint mode turned off.
</P
></LI
><LI
><P
>&#13; Templatization
</P
><P
>&#13; Patches to Bugzilla need to support templates so they do not force user interface choices
on Bugzilla administrators.
</P
></LI
><LI
><P
>&#13; Variable Names
</P
><P
>&#13; If a variable is scoped globally (<TT
CLASS="computeroutput"
>$::variable</TT
>)
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,
<TT
CLASS="computeroutput"
>$ret</TT
> could be used as a staging variable for a
routine's return value as the line <TT
CLASS="computeroutput"
>return $ret;</TT
>
will make it blatantly obvious what the variable holds and most likely be shown
on the same screen as <TT
CLASS="computeroutput"
>my $ret = "";</TT
>.
</P
></LI
><LI
><P
>&#13; Cross Database Compatability
</P
><P
>&#13; 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
<TT
CLASS="function"
>encrypt()</TT
>.
</P
></LI
><LI
><P
>&#13; Cross Platform Compatability
</P
><P
>&#13; 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.
</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="quicksearch.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="N"
>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"
ACCESSKEY="U"
>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
...@@ -13,11 +13,14 @@ REL="UP" ...@@ -13,11 +13,14 @@ REL="UP"
TITLE="Useful Patches and Utilities for Bugzilla" TITLE="Useful Patches and Utilities for Bugzilla"
HREF="patches.html"><LINK HREF="patches.html"><LINK
REL="PREVIOUS" REL="PREVIOUS"
TITLE="The setperl.csh Utility" TITLE="Apache
HREF="setperl.html"><LINK mod_rewrite
magic"
HREF="rewrite.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="The Quicksearch Utility" TITLE="Bugzilla Variants and Competitors"
HREF="quicksearch.html"></HEAD HREF="variants.html"></HEAD
><BODY ><BODY
CLASS="section" CLASS="section"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -45,7 +48,7 @@ WIDTH="10%" ...@@ -45,7 +48,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="setperl.html" HREF="rewrite.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -53,13 +56,13 @@ ACCESSKEY="P" ...@@ -53,13 +56,13 @@ ACCESSKEY="P"
WIDTH="80%" WIDTH="80%"
ALIGN="center" ALIGN="center"
VALIGN="bottom" VALIGN="bottom"
>Appendix D. Useful Patches and Utilities for Bugzilla</TD >Appendix C. Useful Patches and Utilities for Bugzilla</TD
><TD ><TD
WIDTH="10%" WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="quicksearch.html" HREF="variants.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -73,134 +76,80 @@ CLASS="section" ...@@ -73,134 +76,80 @@ CLASS="section"
><H1 ><H1
CLASS="section" CLASS="section"
><A ><A
NAME="cmdline">D.3. Command-line Bugzilla Queries</H1 NAME="cmdline">C.2. Command-line Bugzilla Queries</H1
><P ><P
>&#13; Users can query Bugzilla from the command line using this suite >There are a suite of Unix utilities for querying Bugzilla from the
of utilities. command line. They live in the
</P <TT
CLASS="filename"
>contrib/cmdline</TT
>
directory. However, they
have not yet been updated to work with 2.16 (post-templatisation.).
There are three files - <TT
CLASS="filename"
>query.conf</TT
>,
<TT
CLASS="filename"
>buglist</TT
> and <TT
CLASS="filename"
>bugs</TT
>.</P
><P ><P
>&#13; The query.conf file contains the mapping from options to field ><TT
names and comparison types. Quoted option names are "grepped" CLASS="filename"
for, so it should be easy to edit this file. Comments (#) have >query.conf</TT
no effect; you must make sure these lines do not contain any >
quoted "option" contains the mapping from options to field
</P names and comparison types. Quoted option names are "grepped" for, so it
should be easy to edit this file. Comments (#) have no effect; you must
make sure these lines do not contain any quoted "option".</P
><P ><P
>&#13; buglist is a shell script which submits a Bugzilla query and ><TT
writes the resulting HTML page to stdout. It supports both CLASS="filename"
short options, (such as "-Afoo" or "-Rbar") and long options >buglist</TT
(such as "--assignedto=foo" or "--reporter=bar"). If the first >
character of an option is not "-", it is treated as if it were is a shell script which submits a Bugzilla query and writes
prefixed with "--default=". the resulting HTML page to stdout. It supports both short options, (such
</P as "-Afoo" or "-Rbar") and long options (such as "--assignedto=foo" or
"--reporter=bar"). If the first character of an option is not "-", it is
treated as if it were prefixed with "--default=".</P
><P ><P
>&#13; The columlist is taken from the COLUMNLIST environment variable. >The column list is taken from the COLUMNLIST environment variable.
This is equivalent to the "Change Columns" option when you list This is equivalent to the "Change Columns" option when you list bugs in
bugs in buglist.cgi. If you have already used Bugzilla, use buglist.cgi. If you have already used Bugzilla, grep for COLUMNLIST
<B in your cookies file to see your current COLUMNLIST setting.</P
CLASS="command"
>grep COLUMLIST ~/.netscape/cookies</B
> to see
your current COLUMNLIST setting.
</P
><P ><P
>&#13; bugs is a simple shell script which calls buglist and extracts ><TT
the bug numbers from the output. Adding the prefix CLASS="filename"
"http://bugzilla.mozilla.org/buglist.cgi?bug_id=" turns the bug >bugs</TT
list into a working link if any bugs are found. Counting bugs is > is a simple shell script which calls
easy. Pipe the results through <B <TT
CLASS="filename"
>buglist</TT
> and extracts the
bug numbers from the output. Adding the prefix
"http://bugzilla.mozilla.org/buglist.cgi?bug_id=" turns the bug list into
a working link if any bugs are found. Counting bugs is easy. Pipe the
results through
<B
CLASS="command" CLASS="command"
>sed -e 's/,/ /g' | wc | >sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}'</B
awk '{printf $2 "\n"}'</B
> >
</P </P
><P ><P
>&#13; Akkana says she has good results piping buglist output through >Akkana Peck says she has good results piping
<B <TT
CLASS="filename"
>buglist</TT
> output through
<B
CLASS="command" CLASS="command"
>w3m -T text/html -dump</B >w3m -T text/html -dump</B
> >
</P </P
><DIV
CLASS="procedure"
><OL
TYPE="1"
><LI
><P
>&#13; Download three files:
</P
><OL
CLASS="SUBSTEPS"
TYPE="a"
><LI
><P
>&#13; <TT
CLASS="computeroutput"
> <TT
CLASS="prompt"
>bash$</TT
> <B
CLASS="command"
>wget -O
query.conf
'http://bugzilla.mozilla.org/showattachment.cgi?attach_id=26157'</B
> </TT
>
</P
></LI
><LI
><P
>&#13; <TT
CLASS="computeroutput"
> <TT
CLASS="prompt"
>bash$</TT
> <B
CLASS="command"
>wget -O
buglist
'http://bugzilla.mozilla.org/showattachment.cgi?attach_id=26944'</B
> </TT
>
</P
></LI
><LI
><P
>&#13; <TT
CLASS="computeroutput"
> <TT
CLASS="prompt"
>bash#</TT
> <B
CLASS="command"
>wget -O
bugs
'http://bugzilla.mozilla.org/showattachment.cgi?attach_id=26215'</B
> </TT
>
</P
></LI
></OL
></LI
><LI
><P
>&#13; Make your utilities executable:
<TT
CLASS="computeroutput"
>&#13; <TT
CLASS="prompt"
>bash$</TT
>
<B
CLASS="command"
>chmod u+x buglist bugs</B
>
</TT
>
</P
></LI
></OL
></DIV
></DIV ></DIV
><DIV ><DIV
CLASS="NAVFOOTER" CLASS="NAVFOOTER"
...@@ -218,7 +167,7 @@ WIDTH="33%" ...@@ -218,7 +167,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="setperl.html" HREF="rewrite.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -236,7 +185,7 @@ WIDTH="33%" ...@@ -236,7 +185,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="quicksearch.html" HREF="variants.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -246,7 +195,13 @@ ACCESSKEY="N" ...@@ -246,7 +195,13 @@ ACCESSKEY="N"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>The setperl.csh Utility</TD >Apache
<TT
CLASS="filename"
>mod_rewrite</TT
>
magic</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
...@@ -260,7 +215,7 @@ ACCESSKEY="U" ...@@ -260,7 +215,7 @@ ACCESSKEY="U"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>The Quicksearch Utility</TD >Bugzilla Variants and Competitors</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
<HTML
><HEAD
><TITLE
>Contributors</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="About This Guide"
HREF="about.html"><LINK
REL="PREVIOUS"
TITLE="Credits"
HREF="credits.html"><LINK
REL="NEXT"
TITLE="Feedback"
HREF="feedback.html"></HEAD
><BODY
CLASS="section"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="credits.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 1. About This Guide</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="feedback.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="contributors">1.6. Contributors</H1
><P
>&#13; Thanks go to these people for significant contributions to this
documentation (in no particular order):
</P
><P
>&#13; Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, Ron
Teitelbaum, Jacob Steenhagen, Joe Robins
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="credits.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="feedback.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Credits</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="about.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Feedback</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
...@@ -13,11 +13,11 @@ REL="UP" ...@@ -13,11 +13,11 @@ REL="UP"
TITLE="About This Guide" TITLE="About This Guide"
HREF="about.html"><LINK HREF="about.html"><LINK
REL="PREVIOUS" REL="PREVIOUS"
TITLE="Translations" TITLE="Credits"
HREF="translations.html"><LINK HREF="credits.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Using Bugzilla" TITLE="Introduction"
HREF="using.html"></HEAD HREF="introduction.html"></HEAD
><BODY ><BODY
CLASS="section" CLASS="section"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -45,7 +45,7 @@ WIDTH="10%" ...@@ -45,7 +45,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="translations.html" HREF="credits.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -59,7 +59,7 @@ WIDTH="10%" ...@@ -59,7 +59,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="using.html" HREF="introduction.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -73,14 +73,13 @@ CLASS="section" ...@@ -73,14 +73,13 @@ CLASS="section"
><H1 ><H1
CLASS="section" CLASS="section"
><A ><A
NAME="conventions">1.7. Document Conventions</H1 NAME="conventions">1.5. Document Conventions</H1
><P ><P
>&#13; This document uses the following conventions >This document uses the following conventions:</P
</P
><DIV ><DIV
CLASS="informaltable" CLASS="informaltable"
><A ><A
NAME="AEN91"><P NAME="AEN178"><P
></P ></P
><TABLE ><TABLE
BORDER="0" BORDER="0"
...@@ -106,7 +105,7 @@ VALIGN="MIDDLE" ...@@ -106,7 +105,7 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><DIV >&#13; <DIV
CLASS="caution" CLASS="caution"
><P ><P
></P ></P
...@@ -132,7 +131,8 @@ VALIGN="TOP" ...@@ -132,7 +131,8 @@ VALIGN="TOP"
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -142,7 +142,7 @@ VALIGN="MIDDLE" ...@@ -142,7 +142,7 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><DIV >&#13; <DIV
CLASS="tip" CLASS="tip"
><P ><P
></P ></P
...@@ -163,12 +163,13 @@ ALT="Tip"></TD ...@@ -163,12 +163,13 @@ ALT="Tip"></TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="TOP" VALIGN="TOP"
><P ><P
>Warm jar lids under the hot tap to loosen them.</P >Would you like a breath mint?</P
></TD ></TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -178,7 +179,7 @@ VALIGN="MIDDLE" ...@@ -178,7 +179,7 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><DIV >&#13; <DIV
CLASS="note" CLASS="note"
><P ><P
></P ></P
...@@ -204,7 +205,8 @@ VALIGN="TOP" ...@@ -204,7 +205,8 @@ VALIGN="TOP"
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -214,7 +216,7 @@ VALIGN="MIDDLE" ...@@ -214,7 +216,7 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><DIV >&#13; <DIV
CLASS="warning" CLASS="warning"
><P ><P
></P ></P
...@@ -240,7 +242,8 @@ VALIGN="TOP" ...@@ -240,7 +242,8 @@ VALIGN="TOP"
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -250,10 +253,11 @@ VALIGN="MIDDLE" ...@@ -250,10 +253,11 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><TT >&#13; <TT
CLASS="filename" CLASS="filename"
>file.extension</TT >filename</TT
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -263,10 +267,11 @@ VALIGN="MIDDLE" ...@@ -263,10 +267,11 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><TT >&#13; <TT
CLASS="filename" CLASS="filename"
>directory</TT >directory</TT
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -276,10 +281,11 @@ VALIGN="MIDDLE" ...@@ -276,10 +281,11 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><B >&#13; <B
CLASS="command" CLASS="command"
>command</B >command</B
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -289,19 +295,22 @@ VALIGN="MIDDLE" ...@@ -289,19 +295,22 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><SPAN >&#13; <SPAN
CLASS="application" CLASS="application"
>application</SPAN >application</SPAN
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><I >&#13; <I
CLASS="foreignphrase" CLASS="foreignphrase"
>Prompt</I >Prompt</I
> of users command under bash shell</TD >
of users command under bash shell</TD
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
...@@ -311,10 +320,12 @@ VALIGN="MIDDLE" ...@@ -311,10 +320,12 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><I >&#13; <I
CLASS="foreignphrase" CLASS="foreignphrase"
>Prompt</I >Prompt</I
> of root users command under bash shell</TD >
of root users command under bash shell</TD
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
...@@ -324,10 +335,12 @@ VALIGN="MIDDLE" ...@@ -324,10 +335,12 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><I >&#13; <I
CLASS="foreignphrase" CLASS="foreignphrase"
>Prompt</I >Prompt</I
> of user command under tcsh shell</TD >
of user command under tcsh shell</TD
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
...@@ -341,10 +354,11 @@ VALIGN="MIDDLE" ...@@ -341,10 +354,11 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><TT >&#13; <TT
CLASS="envar" CLASS="envar"
>VARIABLE</TT >VARIABLE</TT
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -354,9 +368,10 @@ VALIGN="MIDDLE" ...@@ -354,9 +368,10 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><EM >&#13; <EM
>word</EM >word</EM
></TD >
</TD
></TR ></TR
><TR ><TR
><TD ><TD
...@@ -366,7 +381,7 @@ VALIGN="MIDDLE" ...@@ -366,7 +381,7 @@ VALIGN="MIDDLE"
><TD ><TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="MIDDLE" VALIGN="MIDDLE"
><TABLE >&#13; <TABLE
BORDER="0" BORDER="0"
BGCOLOR="#E0E0E0" BGCOLOR="#E0E0E0"
WIDTH="100%" WIDTH="100%"
...@@ -379,7 +394,9 @@ CLASS="programlisting" ...@@ -379,7 +394,9 @@ CLASS="programlisting"
><TT ><TT
CLASS="sgmltag" CLASS="sgmltag"
>&#60;para&#62;</TT >&#60;para&#62;</TT
>Beginning and end of paragraph<TT >
Beginning and end of paragraph
<TT
CLASS="sgmltag" CLASS="sgmltag"
>&#60;/para&#62;</TT >&#60;/para&#62;</TT
></PRE ></PRE
...@@ -387,7 +404,8 @@ CLASS="sgmltag" ...@@ -387,7 +404,8 @@ CLASS="sgmltag"
></TD ></TD
></TR ></TR
></TABLE ></TABLE
></TD >
</TD
></TR ></TR
></TBODY ></TBODY
></TABLE ></TABLE
...@@ -411,7 +429,7 @@ WIDTH="33%" ...@@ -411,7 +429,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="translations.html" HREF="credits.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -429,7 +447,7 @@ WIDTH="33%" ...@@ -429,7 +447,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="using.html" HREF="introduction.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -439,7 +457,7 @@ ACCESSKEY="N" ...@@ -439,7 +457,7 @@ ACCESSKEY="N"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>Translations</TD >Credits</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
...@@ -453,7 +471,7 @@ ACCESSKEY="U" ...@@ -453,7 +471,7 @@ ACCESSKEY="U"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>Using Bugzilla</TD >Introduction</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
...@@ -16,8 +16,8 @@ REL="PREVIOUS" ...@@ -16,8 +16,8 @@ REL="PREVIOUS"
TITLE="New Versions" TITLE="New Versions"
HREF="newversions.html"><LINK HREF="newversions.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Translations" TITLE="Document Conventions"
HREF="translations.html"></HEAD HREF="conventions.html"></HEAD
><BODY ><BODY
CLASS="section" CLASS="section"
BGCOLOR="#FFFFFF" BGCOLOR="#FFFFFF"
...@@ -59,7 +59,7 @@ WIDTH="10%" ...@@ -59,7 +59,7 @@ WIDTH="10%"
ALIGN="right" ALIGN="right"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="translations.html" HREF="conventions.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -73,10 +73,10 @@ CLASS="section" ...@@ -73,10 +73,10 @@ CLASS="section"
><H1 ><H1
CLASS="section" CLASS="section"
><A ><A
NAME="credits">1.5. Credits</H1 NAME="credits">1.4. Credits</H1
><P ><P
>&#13; The people listed below have made enormous contributions to the >&#13; The people listed below have made enormous contributions to the
creation of this Guide, through their dedicated hacking efforts, creation of this Guide, through their writing, dedicated hacking efforts,
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:
</P </P
...@@ -86,7 +86,8 @@ HREF="mailto://mbarnson@sisna.com" ...@@ -86,7 +86,8 @@ HREF="mailto://mbarnson@sisna.com"
TARGET="_top" TARGET="_top"
>Matthew P. Barnson</A >Matthew P. Barnson</A
> >
for pulling together the Bugzilla Guide and shepherding it to 2.14. for the Herculaean task of pulling together the Bugzilla Guide and
shepherding it to 2.14.
</P </P
><P ><P
>&#13; <A >&#13; <A
...@@ -101,18 +102,18 @@ TARGET="_top" ...@@ -101,18 +102,18 @@ TARGET="_top"
>&#13; <A >&#13; <A
HREF="mailto://tara@tequilarista.org" HREF="mailto://tara@tequilarista.org"
TARGET="_top" TARGET="_top"
>Tara >Tara Hernandez</A
Hernandez</A >
> for keeping Bugzilla development going for keeping Bugzilla development going
strong after Terry left Mozilla.org strong after Terry left mozilla.org
</P </P
><P ><P
>&#13; <A >&#13; <A
HREF="mailto://dkl@redhat.com" HREF="mailto://dkl@redhat.com"
TARGET="_top" TARGET="_top"
>Dave Lawrence</A >Dave Lawrence</A
> for >
providing insight into the key differences between Red Hat's for providing insight into the key differences between Red Hat's
customized Bugzilla, and being largely responsible for the "Red customized Bugzilla, and being largely responsible for the "Red
Hat Bugzilla" appendix Hat Bugzilla" appendix
</P </P
...@@ -126,7 +127,8 @@ TARGET="_top" ...@@ -126,7 +127,8 @@ TARGET="_top"
questions and arguments on irc.mozilla.org in #mozwebtools questions and arguments on irc.mozilla.org in #mozwebtools
</P </P
><P ><P
>&#13; Last but not least, all the members of the <A >&#13; Last but not least, all the members of the
<A
HREF="news://news.mozilla.org/netscape/public/mozilla/webtools" HREF="news://news.mozilla.org/netscape/public/mozilla/webtools"
TARGET="_top" TARGET="_top"
> netscape.public.mozilla.webtools</A > netscape.public.mozilla.webtools</A
...@@ -138,7 +140,7 @@ TARGET="_top" ...@@ -138,7 +140,7 @@ TARGET="_top"
</P </P
><P ><P
>&#13; Zach Liption, Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, >&#13; Zach Liption, Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen,
Ron Teitelbaum, Jacob Steenhagen, Joe Robins. Ron Teitelbaum, Jacob Steenhagen, Joe Robins, Gervase Markham.
</P </P
></DIV ></DIV
><DIV ><DIV
...@@ -175,7 +177,7 @@ WIDTH="33%" ...@@ -175,7 +177,7 @@ WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
><A ><A
HREF="translations.html" HREF="conventions.html"
ACCESSKEY="N" ACCESSKEY="N"
>Next</A >Next</A
></TD ></TD
...@@ -199,7 +201,7 @@ ACCESSKEY="U" ...@@ -199,7 +201,7 @@ ACCESSKEY="U"
WIDTH="33%" WIDTH="33%"
ALIGN="right" ALIGN="right"
VALIGN="top" VALIGN="top"
>Translations</TD >Document Conventions</TD
></TR ></TR
></TABLE ></TABLE
></DIV ></DIV
......
<HTML
><HEAD
><TITLE
>CVS</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="Integrating Bugzilla with Third-Party Tools"
HREF="integration.html"><LINK
REL="PREVIOUS"
TITLE="Bonsai"
HREF="bonsai.html"><LINK
REL="NEXT"
TITLE="Perforce SCM"
HREF="scm.html"></HEAD
><BODY
CLASS="section"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="bonsai.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 5. Integrating Bugzilla with Third-Party Tools</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="scm.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="cvs">5.2. CVS</H1
><P
>CVS integration is best accomplished, at this point, using
the Bugzilla Email Gateway. There have been some files
submitted to allow greater CVS integration, but we need to make
certain that Bugzilla is not tied into one particular software
management package.</P
><P
>&#13; Follow the instructions in the FAQ for enabling Bugzilla e-mail
integration. Ensure that your check-in script sends an email to
your Bugzilla e-mail gateway with the subject of <SPAN
CLASS="QUOTE"
>"[Bug
XXXX]"</SPAN
>, and you can 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 the Bugzilla bug
state.
</P
><P
>&#13; 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"
>&#13; http://homepages.kcbbs.gen.nz/~tonyg/</A
>, under the
<SPAN
CLASS="QUOTE"
>"cvszilla"</SPAN
> link.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="bonsai.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="scm.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Bonsai</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="integration.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Perforce SCM</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
...@@ -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="Software Download Links" TITLE="The Bugzilla FAQ"
HREF="downloadlinks.html"><LINK HREF="faq.html"><LINK
REL="NEXT" REL="NEXT"
TITLE="Database Schema Chart" TITLE="Database Schema Chart"
HREF="dbschema.html"></HEAD HREF="dbschema.html"></HEAD
...@@ -42,7 +42,7 @@ WIDTH="10%" ...@@ -42,7 +42,7 @@ WIDTH="10%"
ALIGN="left" ALIGN="left"
VALIGN="bottom" VALIGN="bottom"
><A ><A
HREF="downloadlinks.html" HREF="faq.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -69,7 +69,7 @@ WIDTH="100%"></DIV ...@@ -69,7 +69,7 @@ WIDTH="100%"></DIV
CLASS="appendix" CLASS="appendix"
><H1 ><H1
><A ><A
NAME="database">Appendix C. The Bugzilla Database</H1 NAME="database">Appendix B. The Bugzilla Database</H1
><DIV ><DIV
CLASS="TOC" CLASS="TOC"
><DL ><DL
...@@ -78,20 +78,15 @@ CLASS="TOC" ...@@ -78,20 +78,15 @@ CLASS="TOC"
>Table of Contents</B >Table of Contents</B
></DT ></DT
><DT ><DT
>C.1. <A >B.1. <A
HREF="dbschema.html" HREF="dbschema.html"
>Database Schema Chart</A >Database Schema Chart</A
></DT ></DT
><DT ><DT
>C.2. <A >B.2. <A
HREF="dbdoc.html" HREF="dbdoc.html"
>MySQL Bugzilla Database Introduction</A >MySQL Bugzilla Database Introduction</A
></DT ></DT
><DT
>C.3. <A
HREF="granttables.html"
>MySQL Permissions &#38; Grant Tables</A
></DT
></DL ></DL
></DIV ></DIV
><DIV ><DIV
...@@ -115,8 +110,9 @@ ALT="Note"></TD ...@@ -115,8 +110,9 @@ ALT="Note"></TD
ALIGN="LEFT" ALIGN="LEFT"
VALIGN="TOP" VALIGN="TOP"
><P ><P
>&#13; This document really needs to be updated with more fleshed out information about primary keys, interrelationships, and maybe some nifty tables to document dependencies. Any takers? >This document really needs to be updated with more fleshed out
</P information about primary keys, interrelationships, and maybe some nifty
tables to document dependencies. Any takers?</P
></TD ></TD
></TR ></TR
></TABLE ></TABLE
...@@ -138,7 +134,7 @@ WIDTH="33%" ...@@ -138,7 +134,7 @@ WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
><A ><A
HREF="downloadlinks.html" HREF="faq.html"
ACCESSKEY="P" ACCESSKEY="P"
>Prev</A >Prev</A
></TD ></TD
...@@ -166,7 +162,7 @@ ACCESSKEY="N" ...@@ -166,7 +162,7 @@ ACCESSKEY="N"
WIDTH="33%" WIDTH="33%"
ALIGN="left" ALIGN="left"
VALIGN="top" VALIGN="top"
>Software Download Links</TD >The Bugzilla FAQ</TD
><TD ><TD
WIDTH="34%" WIDTH="34%"
ALIGN="center" ALIGN="center"
......
...@@ -53,7 +53,7 @@ ACCESSKEY="P" ...@@ -53,7 +53,7 @@ ACCESSKEY="P"
WIDTH="80%" WIDTH="80%"
ALIGN="center" ALIGN="center"
VALIGN="bottom" VALIGN="bottom"
>Appendix C. The Bugzilla Database</TD >Appendix B. The Bugzilla Database</TD
><TD ><TD
WIDTH="10%" WIDTH="10%"
ALIGN="right" ALIGN="right"
...@@ -73,7 +73,7 @@ CLASS="section" ...@@ -73,7 +73,7 @@ CLASS="section"
><H1 ><H1
CLASS="section" CLASS="section"
><A ><A
NAME="dbschema">C.1. Database Schema Chart</H1 NAME="dbschema">B.1. Database Schema Chart</H1
><P ><P
>&#13; <DIV >&#13; <DIV
CLASS="mediaobject" CLASS="mediaobject"
......
...@@ -73,16 +73,15 @@ CLASS="section" ...@@ -73,16 +73,15 @@ CLASS="section"
><H1 ><H1
CLASS="section" CLASS="section"
><A ><A
NAME="disclaimer">1.3. Disclaimer</H1 NAME="disclaimer">1.2. Disclaimer</H1
><P ><P
>&#13; No liability for the contents of this document can be accepted. >&#13; No liability for the contents of this document can be accepted.
Use the concepts, examples, and other content at your own risk. Use the concepts, examples, and other content at your own risk.
As this is a new edition of this document, there may be errors This document may contain errors
and inaccuracies that may damage your system. Use of this and inaccuracies that may damage your system, cause your partner
document may cause your girlfriend to leave you, your cats to to leave you, your boss to fire you, your cats to
pee on your furniture and clothing, your computer to cease pee on your furniture and clothing, and global thermonuclear
functioning, your boss to fire you, and global thermonuclear war. Proceed with caution.
war. Proceed with caution.
</P </P
><P ><P
>&#13; All copyrights are held by their respective owners, unless >&#13; All copyrights are held by their respective owners, unless
...@@ -113,7 +112,7 @@ NAME="disclaimer">1.3. Disclaimer</H1 ...@@ -113,7 +112,7 @@ NAME="disclaimer">1.3. Disclaimer</H1
team members, Netscape Communications, America Online Inc., and team members, Netscape Communications, America Online Inc., and
any affiliated developers or sponsors assume no liability for any affiliated developers or sponsors assume no liability for
your use of this product. You have the source code to this your use of this product. You have the source code to this
product, and are responsible for auditing it yourself to insure product, and are responsible for auditing it yourself to ensure
your security needs are met. your security needs are met.
</P </P
></DIV ></DIV
......
<HTML
><HEAD
><TITLE
>Software Download Links</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="The Bugzilla FAQ"
HREF="faq.html"><LINK
REL="NEXT"
TITLE="The Bugzilla Database"
HREF="database.html"></HEAD
><BODY
CLASS="appendix"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="faq.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="database.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="appendix"
><H1
><A
NAME="downloadlinks">Appendix B. Software Download Links</H1
><P
>&#13; All of these sites are current as of April, 2001. Hopefully
they'll stay current for a while.
</P
><P
>&#13; Apache Web Server: <A
HREF="http://www.apache.org/"
TARGET="_top"
>http://www.apache.org</A
>
Optional web server for Bugzilla, but recommended because of broad user base and support.
</P
><P
>&#13; Bugzilla: <A
HREF="http://www.mozilla.org/projects/bugzilla/"
TARGET="_top"
>&#13; http://www.mozilla.org/projects/bugzilla/</A
>
</P
><P
>&#13; MySQL: <A
HREF="http://www.mysql.com/"
TARGET="_top"
>http://www.mysql.com/</A
>
</P
><P
>&#13; Perl: <A
HREF="http://www.perl.org"
TARGET="_top"
>http://www.perl.org/</A
>
</P
><P
>&#13; CPAN: <A
HREF="http://www.cpan.org/"
TARGET="_top"
>http://www.cpan.org/</A
>
</P
><P
>&#13; DBI Perl module:
<A
HREF="http://www.cpan.org/modules/by-module/DBI/"
TARGET="_top"
>&#13; http://www.cpan.org/modules/by-module/DBI/</A
>
</P
><P
>&#13; Data::Dumper module:
<A
HREF="http://www.cpan.org/modules/by-module/Data/"
TARGET="_top"
>&#13; http://www.cpan.org/modules/by-module/Data/</A
>
</P
><P
>&#13; MySQL related Perl modules:
<A
HREF="http://www.cpan.org/modules/by-module/Mysql/"
TARGET="_top"
>&#13; http://www.cpan.org/modules/by-module/Mysql/</A
>
</P
><P
>&#13; TimeDate Perl module collection:
<A
HREF="http://www.cpan.org/modules/by-module/Date/"
TARGET="_top"
>&#13; http://www.cpan.org/modules/by-module/Date/</A
>
</P
><P
>&#13; GD Perl module:
<A
HREF="http://www.cpan.org/modules/by-module/GD/"
TARGET="_top"
>&#13; http://www.cpan.org/modules/by-module/GD/</A
>
Alternately, you should be able to find the latest version of
GD at <A
HREF="http://www.boutell.com/gd/"
TARGET="_top"
>http://www.boutell.com/gd/</A
>
</P
><P
>&#13; Chart::Base module:
<A
HREF="http://www.cpan.org/modules/by-module/Chart/"
TARGET="_top"
>&#13; http://www.cpan.org/modules/by-module/Chart/</A
>
</P
><P
>&#13; LinuxDoc Software:
<A
HREF="http://www.linuxdoc.org/"
TARGET="_top"
>http://www.linuxdoc.org/</A
>
(for documentation maintenance)
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="faq.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="database.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>The Bugzilla FAQ</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>The Bugzilla Database</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>Feedback</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="About This Guide"
HREF="about.html"><LINK
REL="PREVIOUS"
TITLE="Contributors"
HREF="contributors.html"><LINK
REL="NEXT"
TITLE="Translations"
HREF="translations.html"></HEAD
><BODY
CLASS="section"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="contributors.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 1. About This Guide</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="translations.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="feedback">1.7. Feedback</H1
><P
>&#13; I welcome feedback on this document. Without your submissions
and input, this Guide cannot continue to exist. Please mail
additions, comments, criticisms, etc. to
<TT
CLASS="email"
>&#60;<A
HREF="mailto:barnboy@trilobyte.net"
>barnboy@trilobyte.net</A
>&#62;</TT
>. Please send flames to
<TT
CLASS="email"
>&#60;<A
HREF="mailto:devnull@localhost"
>devnull@localhost</A
>&#62;</TT
>
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="contributors.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="translations.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Contributors</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="about.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Translations</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>PREAMBLE</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="NEXT"
TITLE="APPLICABILITY AND DEFINITIONS"
HREF="gfdl-1.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-1.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-0">0. PREAMBLE</H1
><P
>The purpose of this License is to make a manual, textbook,
or other written document "free" in the sense of freedom: to
assure everyone the effective freedom to copy and redistribute it,
with or without modifying it, either commercially or
noncommercially. Secondarily, this License preserves for the
author and publisher a way to get credit for their work, while not
being considered responsible for modifications made by
others.</P
><P
>This License is a kind of "copyleft", which means that
derivative works of the document must themselves be free in the
same sense. It complements the GNU General Public License, which
is a copyleft license designed for free software.</P
><P
>We have designed this License in order to use it for manuals
for free software, because free software needs free documentation:
a free program should come with manuals providing the same
freedoms that the software does. But this License is not limited
to software manuals; it can be used for any textual work,
regardless of subject matter or whether it is published as a
printed book. We recommend this License principally for works
whose purpose is instruction or reference.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-1.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>GNU Free Documentation License</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>APPLICABILITY AND DEFINITIONS</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>APPLICABILITY AND DEFINITIONS</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="PREAMBLE"
HREF="gfdl-0.html"><LINK
REL="NEXT"
TITLE="VERBATIM COPYING"
HREF="gfdl-2.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-0.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-2.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-1">1. APPLICABILITY AND DEFINITIONS</H1
><P
>This License applies to any manual or other work that
contains a notice placed by the copyright holder saying it can be
distributed under the terms of this License. The "Document",
below, refers to any such manual or work. Any member of the
public is a licensee, and is addressed as "you".</P
><P
>A "Modified Version" of the Document means any work
containing the Document or a portion of it, either copied
verbatim, or with modifications and/or translated into another
language.</P
><P
>A "Secondary Section" is a named appendix or a front-matter
section of the Document that deals exclusively with the
relationship of the publishers or authors of the Document to the
Document's overall subject (or to related matters) and contains
nothing that could fall directly within that overall subject.
(For example, if the Document is in part a textbook of
mathematics, a Secondary Section may not explain any mathematics.)
The relationship could be a matter of historical connection with
the subject or with related matters, or of legal, commercial,
philosophical, ethical or political position regarding
them.</P
><P
>The "Invariant Sections" are certain Secondary Sections
whose titles are designated, as being those of Invariant Sections,
in the notice that says that the Document is released under this
License.</P
><P
>The "Cover Texts" are certain short passages of text that
are listed, as Front-Cover Texts or Back-Cover Texts, in the
notice that says that the Document is released under this
License.</P
><P
>A "Transparent" copy of the Document means a
machine-readable copy, represented in a format whose specification
is available to the general public, whose contents can be viewed
and edited directly and straightforwardly with generic text
editors or (for images composed of pixels) generic paint programs
or (for drawings) some widely available drawing editor, and that
is suitable for input to text formatters or for automatic
translation to a variety of formats suitable for input to text
formatters. A copy made in an otherwise Transparent file format
whose markup has been designed to thwart or discourage subsequent
modification by readers is not Transparent. A copy that is not
"Transparent" is called "Opaque".</P
><P
>Examples of suitable formats for Transparent copies include
plain ASCII without markup, Texinfo input format, LaTeX input
format, SGML or XML using a publicly available DTD, and
standard-conforming simple HTML designed for human modification.
Opaque formats include PostScript, PDF, proprietary formats that
can be read and edited only by proprietary word processors, SGML
or XML for which the DTD and/or processing tools are not generally
available, and the machine-generated HTML produced by some word
processors for output purposes only.</P
><P
>The "Title Page" means, for a printed book, the title page
itself, plus such following pages as are needed to hold, legibly,
the material this License requires to appear in the title page.
For works in formats which do not have any title page as such,
"Title Page" means the text near the most prominent appearance of
the work's title, preceding the beginning of the body of the
text.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-0.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-2.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>PREAMBLE</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>VERBATIM COPYING</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>FUTURE REVISIONS OF THIS LICENSE</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="TERMINATION"
HREF="gfdl-9.html"><LINK
REL="NEXT"
TITLE="How to use this License for your documents"
HREF="gfdl-howto.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-9.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-howto.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-10">10. FUTURE REVISIONS OF THIS LICENSE</H1
><P
>The Free Software Foundation may publish new, revised
versions of the GNU Free Documentation License from time to time.
Such new versions will be similar in spirit to the present
version, but may differ in detail to address new problems or
concerns. See <A
HREF="http://www.gnu.org/copyleft/"
TARGET="_top"
>http://www.gnu.org/copyleft/</A
>.</P
><P
>Each version of the License is given a distinguishing
version number. If the Document specifies that a particular
numbered version of this License "or any later version" applies to
it, you have the option of following the terms and conditions
either of that specified version or of any later version that has
been published (not as a draft) by the Free Software Foundation.
If the Document does not specify a version number of this License,
you may choose any version ever published (not as a draft) by the
Free Software Foundation.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-9.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-howto.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>TERMINATION</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>How to use this License for your documents</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>VERBATIM COPYING</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="APPLICABILITY AND DEFINITIONS"
HREF="gfdl-1.html"><LINK
REL="NEXT"
TITLE="COPYING IN QUANTITY"
HREF="gfdl-3.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-1.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-3.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-2">2. VERBATIM COPYING</H1
><P
>You may copy and distribute the Document in any medium,
either commercially or noncommercially, provided that this
License, the copyright notices, and the license notice saying this
License applies to the Document are reproduced in all copies, and
that you add no other conditions whatsoever to those of this
License. You may not use technical measures to obstruct or
control the reading or further copying of the copies you make or
distribute. However, you may accept compensation in exchange for
copies. If you distribute a large enough number of copies you
must also follow the conditions in section 3.</P
><P
>You may also lend copies, under the same conditions stated
above, and you may publicly display copies.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-1.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-3.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>APPLICABILITY AND DEFINITIONS</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>COPYING IN QUANTITY</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>COPYING IN QUANTITY</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="VERBATIM COPYING"
HREF="gfdl-2.html"><LINK
REL="NEXT"
TITLE="MODIFICATIONS"
HREF="gfdl-4.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-2.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-4.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-3">3. COPYING IN QUANTITY</H1
><P
>If you publish printed copies of the Document numbering more
than 100, and the Document's license notice requires Cover Texts,
you must enclose the copies in covers that carry, clearly and
legibly, all these Cover Texts: Front-Cover Texts on the front
cover, and Back-Cover Texts on the back cover. Both covers must
also clearly and legibly identify you as the publisher of these
copies. The front cover must present the full title with all
words of the title equally prominent and visible. You may add
other material on the covers in addition. Copying with changes
limited to the covers, as long as they preserve the title of the
Document and satisfy these conditions, can be treated as verbatim
copying in other respects.</P
><P
>If the required texts for either cover are too voluminous to
fit legibly, you should put the first ones listed (as many as fit
reasonably) on the actual cover, and continue the rest onto
adjacent pages.</P
><P
>If you publish or distribute Opaque copies of the Document
numbering more than 100, you must either include a
machine-readable Transparent copy along with each Opaque copy, or
state in or with each Opaque copy a publicly-accessible
computer-network location containing a complete Transparent copy
of the Document, free of added material, which the general
network-using public has access to download anonymously at no
charge using public-standard network protocols. If you use the
latter option, you must take reasonably prudent steps, when you
begin distribution of Opaque copies in quantity, to ensure that
this Transparent copy will remain thus accessible at the stated
location until at least one year after the last time you
distribute an Opaque copy (directly or through your agents or
retailers) of that edition to the public.</P
><P
>It is requested, but not required, that you contact the
authors of the Document well before redistributing any large
number of copies, to give them a chance to provide you with an
updated version of the Document.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-2.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-4.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>VERBATIM COPYING</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>MODIFICATIONS</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>COMBINING DOCUMENTS</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="MODIFICATIONS"
HREF="gfdl-4.html"><LINK
REL="NEXT"
TITLE="COLLECTIONS OF DOCUMENTS"
HREF="gfdl-6.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-4.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-6.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-5">5. COMBINING DOCUMENTS</H1
><P
>You may combine the Document with other documents released
under this License, under the terms defined in section 4 above for
modified versions, provided that you include in the combination
all of the Invariant Sections of all of the original documents,
unmodified, and list them all as Invariant Sections of your
combined work in its license notice.</P
><P
>The combined work need only contain one copy of this
License, and multiple identical Invariant Sections may be replaced
with a single copy. If there are multiple Invariant Sections with
the same name but different contents, make the title of each such
section unique by adding at the end of it, in parentheses, the
name of the original author or publisher of that section if known,
or else a unique number. Make the same adjustment to the section
titles in the list of Invariant Sections in the license notice of
the combined work.</P
><P
>In the combination, you must combine any sections entitled
"History" in the various original documents, forming one section
entitled "History"; likewise combine any sections entitled
"Acknowledgements", and any sections entitled "Dedications". You
must delete all sections entitled "Endorsements."</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-4.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-6.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>MODIFICATIONS</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>COLLECTIONS OF DOCUMENTS</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>COLLECTIONS OF DOCUMENTS</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="COMBINING DOCUMENTS"
HREF="gfdl-5.html"><LINK
REL="NEXT"
TITLE="AGGREGATION WITH INDEPENDENT WORKS"
HREF="gfdl-7.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-5.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-7.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-6">6. COLLECTIONS OF DOCUMENTS</H1
><P
>You may make a collection consisting of the Document and
other documents released under this License, and replace the
individual copies of this License in the various documents with a
single copy that is included in the collection, provided that you
follow the rules of this License for verbatim copying of each of
the documents in all other respects.</P
><P
>You may extract a single document from such a collection,
and distribute it individually under this License, provided you
insert a copy of this License into the extracted document, and
follow this License in all other respects regarding verbatim
copying of that document.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-5.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-7.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>COMBINING DOCUMENTS</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>AGGREGATION WITH INDEPENDENT WORKS</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>AGGREGATION WITH INDEPENDENT WORKS</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="COLLECTIONS OF DOCUMENTS"
HREF="gfdl-6.html"><LINK
REL="NEXT"
TITLE="TRANSLATION"
HREF="gfdl-8.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-6.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-8.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-7">7. AGGREGATION WITH INDEPENDENT WORKS</H1
><P
>A compilation of the Document or its derivatives with other
separate and independent documents or works, in or on a volume of
a storage or distribution medium, does not as a whole count as a
Modified Version of the Document, provided no compilation
copyright is claimed for the compilation. Such a compilation is
called an "aggregate", and this License does not apply to the
other self-contained works thus compiled with the Document, on
account of their being thus compiled, if they are not themselves
derivative works of the Document.</P
><P
>If the Cover Text requirement of section 3 is applicable to
these copies of the Document, then if the Document is less than
one quarter of the entire aggregate, the Document's Cover Texts
may be placed on covers that surround only the Document within the
aggregate. Otherwise they must appear on covers around the whole
aggregate.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-6.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-8.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>COLLECTIONS OF DOCUMENTS</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>TRANSLATION</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>TRANSLATION</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="AGGREGATION WITH INDEPENDENT WORKS"
HREF="gfdl-7.html"><LINK
REL="NEXT"
TITLE="TERMINATION"
HREF="gfdl-9.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-7.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-9.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-8">8. TRANSLATION</H1
><P
>Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section
4. Replacing Invariant Sections with translations requires
special permission from their copyright holders, but you may
include translations of some or all Invariant Sections in addition
to the original versions of these Invariant Sections. You may
include a translation of this License provided that you also
include the original English version of this License. In case of
a disagreement between the translation and the original English
version of this License, the original English version will
prevail.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-7.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-9.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>AGGREGATION WITH INDEPENDENT WORKS</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>TERMINATION</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>TERMINATION</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="TRANSLATION"
HREF="gfdl-8.html"><LINK
REL="NEXT"
TITLE="FUTURE REVISIONS OF THIS LICENSE"
HREF="gfdl-10.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-8.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-10.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-9">9. TERMINATION</H1
><P
>You may not copy, modify, sublicense, or distribute the
Document except as expressly provided for under this License. Any
other attempt to copy, modify, sublicense or distribute the
Document is void, and will automatically terminate your rights
under this License. However, parties who have received copies, or
rights, from you under this License will not have their licenses
terminated so long as such parties remain in full
compliance.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-8.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-10.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>TRANSLATION</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>FUTURE REVISIONS OF THIS LICENSE</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>How to use this License for your documents</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNU Free Documentation License"
HREF="gfdl.html"><LINK
REL="PREVIOUS"
TITLE="FUTURE REVISIONS OF THIS LICENSE"
HREF="gfdl-10.html"><LINK
REL="NEXT"
TITLE="Glossary"
HREF="glossary.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="gfdl-10.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Appendix E. GNU Free Documentation License</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="glossary.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="gfdl-howto">How to use this License for your documents</H1
><P
>To use this License in a document you have written, include
a copy of the License in the document and put the following
copyright and license notices just after the title page:</P
><A
NAME="AEN2605"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>&#13; Copyright (c) YEAR YOUR NAME.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation;
with the Invariant Sections being LIST THEIR TITLES, with the
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
A copy of the license is included in the section entitled "GNU
Free Documentation License".
</P
></BLOCKQUOTE
><P
>If you have no Invariant Sections, write "with no Invariant
Sections" instead of saying which ones are invariant. If you have
no Front-Cover Texts, write "no Front-Cover Texts" instead of
"Front-Cover Texts being LIST"; likewise for Back-Cover
Texts.</P
><P
>If your document contains nontrivial examples of program
code, we recommend releasing these examples in parallel under your
choice of free software license, such as the GNU General Public
License, to permit their use in free software.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gfdl-10.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="glossary.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>FUTURE REVISIONS OF THIS LICENSE</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gfdl.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Glossary</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
<HTML
><HEAD
><TITLE
>GNU Free Documentation License</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Hacking Bugzilla"
HREF="bzhacking.html"><LINK
REL="NEXT"
TITLE="PREAMBLE"
HREF="gfdl-0.html"></HEAD
><BODY
CLASS="appendix"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation 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="bzhacking.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gfdl-0.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="appendix"
><H1
><A
NAME="gfdl">Appendix E. GNU Free Documentation License</H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
>0. <A
HREF="gfdl-0.html"
>PREAMBLE</A
></DT
><DT
>1. <A
HREF="gfdl-1.html"
>APPLICABILITY AND DEFINITIONS</A
></DT
><DT
>2. <A
HREF="gfdl-2.html"
>VERBATIM COPYING</A
></DT
><DT
>3. <A
HREF="gfdl-3.html"
>COPYING IN QUANTITY</A
></DT
><DT
>4. <A
HREF="gfdl-4.html"
>MODIFICATIONS</A
></DT
><DT
>5. <A
HREF="gfdl-5.html"
>COMBINING DOCUMENTS</A
></DT
><DT
>6. <A
HREF="gfdl-6.html"
>COLLECTIONS OF DOCUMENTS</A
></DT
><DT
>7. <A
HREF="gfdl-7.html"
>AGGREGATION WITH INDEPENDENT WORKS</A
></DT
><DT
>8. <A
HREF="gfdl-8.html"
>TRANSLATION</A
></DT
><DT
>9. <A
HREF="gfdl-9.html"
>TERMINATION</A
></DT
><DT
>10. <A
HREF="gfdl-10.html"
>FUTURE REVISIONS OF THIS LICENSE</A
></DT
><DT
><A
HREF="gfdl-howto.html"
>How to use this License for your documents</A
></DT
></DL
></DIV
><P
>Version 1.1, March 2000</P
><A
NAME="AEN2515"><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
>Copyright (C) 2000 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="bzhacking.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gfdl-0.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Hacking Bugzilla</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>PREAMBLE</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
\ No newline at end of file
...@@ -47,32 +47,33 @@ NAME="AEN2">The Bugzilla Guide</H1 ...@@ -47,32 +47,33 @@ NAME="AEN2">The Bugzilla Guide</H1
CLASS="author" CLASS="author"
><A ><A
NAME="AEN5">Matthew P. Barnson</H3 NAME="AEN5">Matthew P. Barnson</H3
><DIV ><H3
CLASS="affiliation" CLASS="author"
><DIV ><A
CLASS="address" NAME="AEN9">The Bugzilla Team</H3
><P
CLASS="address"
>mbarnson@sisna.com</P
></DIV
></DIV
><DIV ><DIV
><DIV ><DIV
CLASS="abstract" CLASS="abstract"
><A ><A
NAME="AEN12"><P NAME="AEN13"><P
></P ></P
><P ><P
>&#13; This is the documentation for Bugzilla, the mozilla.org >&#13; This is the documentation for Bugzilla, the mozilla.org
bug-tracking system. bug-tracking system.
Bugzilla is an enterprise-class piece of software Bugzilla is an enterprise-class piece of software
that powers issue-tracking for hundreds of that powers issue-tracking for hundreds of
organizations around the world, tracking millions of bugs. organizations around the world, tracking millions of bugs.
</P </P
><P ><P
>&#13; This documentation is maintained in DocBook 4.1.2 XML format. >
Changes are best submitted as plain text or SGML diffs, attached This documentation is maintained in DocBook 4.1.2 XML format.
to a Bugzilla bug. Changes are best submitted as plain text or SGML diffs, attached
to a bug filed in
<A
HREF="http://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation"
TARGET="_top"
>mozilla.org's Bugzilla</A
>.
</P </P
><P ><P
></P ></P
...@@ -95,36 +96,26 @@ HREF="about.html" ...@@ -95,36 +96,26 @@ HREF="about.html"
><DL ><DL
><DT ><DT
>1.1. <A >1.1. <A
HREF="aboutthisguide.html"
>Purpose and Scope of this Guide</A
></DT
><DT
>1.2. <A
HREF="copyright.html" HREF="copyright.html"
>Copyright Information</A >Copyright Information</A
></DT ></DT
><DT ><DT
>1.3. <A >1.2. <A
HREF="disclaimer.html" HREF="disclaimer.html"
>Disclaimer</A >Disclaimer</A
></DT ></DT
><DT ><DT
>1.4. <A >1.3. <A
HREF="newversions.html" HREF="newversions.html"
>New Versions</A >New Versions</A
></DT ></DT
><DT ><DT
>1.5. <A >1.4. <A
HREF="credits.html" HREF="credits.html"
>Credits</A >Credits</A
></DT ></DT
><DT ><DT
>1.6. <A >1.5. <A
HREF="translations.html"
>Translations</A
></DT
><DT
>1.7. <A
HREF="conventions.html" HREF="conventions.html"
>Document Conventions</A >Document Conventions</A
></DT ></DT
...@@ -132,8 +123,8 @@ HREF="conventions.html" ...@@ -132,8 +123,8 @@ HREF="conventions.html"
></DD ></DD
><DT ><DT
>2. <A >2. <A
HREF="using.html" HREF="introduction.html"
>Using Bugzilla</A >Introduction</A
></DT ></DT
><DD ><DD
><DL ><DL
...@@ -147,157 +138,117 @@ HREF="whatis.html" ...@@ -147,157 +138,117 @@ HREF="whatis.html"
HREF="why.html" HREF="why.html"
>Why Should We Use Bugzilla?</A >Why Should We Use Bugzilla?</A
></DT ></DT
><DT
>2.3. <A
HREF="how.html"
>How do I use Bugzilla?</A
></DT
><DT
>2.4. <A
HREF="init4me.html"
>Where can I find my user preferences?</A
></DT
><DT
>2.5. <A
HREF="usingbz-conc.html"
>Using Bugzilla-Conclusion</A
></DT
></DL ></DL
></DD ></DD
><DT ><DT
>3. <A >3. <A
HREF="installation.html" HREF="using.html"
>Installation</A >Using Bugzilla</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>3.1. <A >3.1. <A
HREF="errata.html" HREF="how.html"
>ERRATA</A >How do I use Bugzilla?</A
></DT ></DT
><DT ><DT
>3.2. <A >3.2. <A
HREF="stepbystep.html" HREF="hintsandtips.html"
>Step-by-step Install</A >Hints and Tips</A
></DT ></DT
><DT ><DT
>3.3. <A >3.3. <A
HREF="osx.html" HREF="userpreferences.html"
>Mac OS X Installation Notes</A >User Preferences</A
></DT
><DT
>3.4. <A
HREF="bsdinstall.html"
>BSD Installation Notes</A
></DT
><DT
>3.5. <A
HREF="geninstall.html"
>Installation General Notes</A
></DT
><DT
>3.6. <A
HREF="win32.html"
>Win32 Installation Notes</A
></DT ></DT
></DL ></DL
></DD ></DD
><DT ><DT
>4. <A >4. <A
HREF="administration.html" HREF="installation.html"
>Administering Bugzilla</A >Installation</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>4.1. <A >4.1. <A
HREF="postinstall-check.html" HREF="stepbystep.html"
>Post-Installation Checklist</A >Step-by-step Install</A
></DT ></DT
><DT ><DT
>4.2. <A >4.2. <A
HREF="useradmin.html" HREF="extraconfig.html"
>User Administration</A >Optional Additional Configuration</A
></DT ></DT
><DT ><DT
>4.3. <A >4.3. <A
HREF="programadmin.html" HREF="win32.html"
>Product, Component, Milestone, and Version >Win32 Installation Notes</A
Administration</A
></DT ></DT
><DT ><DT
>4.4. <A >4.4. <A
HREF="security.html" HREF="osx.html"
>Bugzilla Security</A >Mac OS X Installation Notes</A
></DT
><DT
>4.5. <A
HREF="troubleshooting.html"
>Troubleshooting</A
></DT ></DT
></DL ></DL
></DD ></DD
><DT ><DT
>5. <A >5. <A
HREF="integration.html" HREF="administration.html"
>Integrating Bugzilla with Third-Party Tools</A >Administering Bugzilla</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>5.1. <A >5.1. <A
HREF="bonsai.html" HREF="parameters.html"
>Bonsai</A >Bugzilla Configuration</A
></DT ></DT
><DT ><DT
>5.2. <A >5.2. <A
HREF="cvs.html" HREF="useradmin.html"
>CVS</A >User Administration</A
></DT ></DT
><DT ><DT
>5.3. <A >5.3. <A
HREF="scm.html" HREF="programadmin.html"
>Perforce SCM</A >Product, Component, Milestone, and Version Administration</A
></DT ></DT
><DT ><DT
>5.4. <A >5.4. <A
HREF="tinderbox.html" HREF="voting.html"
>Tinderbox/Tinderbox2</A >Voting</A
></DT ></DT
></DL
></DD
><DT ><DT
>6. <A >5.5. <A
HREF="variants.html" HREF="groups.html"
>Bugzilla Variants and Competitors</A >Groups and Group Security</A
></DT ></DT
><DD
><DL
><DT ><DT
>6.1. <A >5.6. <A
HREF="rhbugzilla.html" HREF="security.html"
>Red Hat Bugzilla</A >Bugzilla Security</A
></DT
><DT
>6.2. <A
HREF="variant-fenris.html"
>Loki Bugzilla (Fenris)</A
></DT
><DT
>6.3. <A
HREF="variant-issuezilla.html"
>Issuezilla</A
></DT ></DT
><DT ><DT
>6.4. <A >5.7. <A
HREF="variant-scarab.html" HREF="cust-templates.html"
>Scarab</A >Template Customisation</A
></DT ></DT
><DT ><DT
>6.5. <A >5.8. <A
HREF="variant-perforce.html" HREF="upgrading.html"
>Perforce SCM</A >Upgrading to New Releases</A
></DT ></DT
><DT ><DT
>6.6. <A >5.9. <A
HREF="variant-sourceforge.html" HREF="integration.html"
>SourceForge</A >Integrating Bugzilla with Third-Party Tools</A
></DT ></DT
></DL ></DL
></DD ></DD
...@@ -308,136 +259,84 @@ HREF="faq.html" ...@@ -308,136 +259,84 @@ HREF="faq.html"
></DT ></DT
><DT ><DT
>B. <A >B. <A
HREF="downloadlinks.html"
>Software Download Links</A
></DT
><DT
>C. <A
HREF="database.html" HREF="database.html"
>The Bugzilla Database</A >The Bugzilla Database</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>C.1. <A >B.1. <A
HREF="dbschema.html" HREF="dbschema.html"
>Database Schema Chart</A >Database Schema Chart</A
></DT ></DT
><DT ><DT
>C.2. <A >B.2. <A
HREF="dbdoc.html" HREF="dbdoc.html"
>MySQL Bugzilla Database Introduction</A >MySQL Bugzilla Database Introduction</A
></DT ></DT
><DT
>C.3. <A
HREF="granttables.html"
>MySQL Permissions &#38; Grant Tables</A
></DT
></DL ></DL
></DD ></DD
><DT ><DT
>D. <A >C. <A
HREF="patches.html" HREF="patches.html"
>Useful Patches and Utilities for Bugzilla</A >Useful Patches and Utilities for Bugzilla</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>D.1. <A >C.1. <A
HREF="rewrite.html" HREF="rewrite.html"
>Apache <TT >Apache
<TT
CLASS="filename" CLASS="filename"
>mod_rewrite</TT >mod_rewrite</TT
> magic</A >
magic</A
></DT ></DT
><DT ><DT
>D.2. <A >C.2. <A
HREF="setperl.html"
>The setperl.csh Utility</A
></DT
><DT
>D.3. <A
HREF="cmdline.html" HREF="cmdline.html"
>Command-line Bugzilla Queries</A >Command-line Bugzilla Queries</A
></DT ></DT
><DT
>D.4. <A
HREF="quicksearch.html"
>The Quicksearch Utility</A
></DT
><DT
>D.5. <A
HREF="bzhacking.html"
>Hacking Bugzilla</A
></DT
></DL ></DL
></DD ></DD
><DT ><DT
>E. <A >D. <A
HREF="gfdl.html" HREF="variants.html"
>GNU Free Documentation License</A >Bugzilla Variants and Competitors</A
></DT ></DT
><DD ><DD
><DL ><DL
><DT ><DT
>0. <A >D.1. <A
HREF="gfdl-0.html" HREF="rhbugzilla.html"
>PREAMBLE</A >Red Hat Bugzilla</A
></DT
><DT
>1. <A
HREF="gfdl-1.html"
>APPLICABILITY AND DEFINITIONS</A
></DT
><DT
>2. <A
HREF="gfdl-2.html"
>VERBATIM COPYING</A
></DT
><DT
>3. <A
HREF="gfdl-3.html"
>COPYING IN QUANTITY</A
></DT
><DT
>4. <A
HREF="gfdl-4.html"
>MODIFICATIONS</A
></DT
><DT
>5. <A
HREF="gfdl-5.html"
>COMBINING DOCUMENTS</A
></DT
><DT
>6. <A
HREF="gfdl-6.html"
>COLLECTIONS OF DOCUMENTS</A
></DT ></DT
><DT ><DT
>7. <A >D.2. <A
HREF="gfdl-7.html" HREF="variant-fenris.html"
>AGGREGATION WITH INDEPENDENT WORKS</A >Loki Bugzilla (Fenris)</A
></DT ></DT
><DT ><DT
>8. <A >D.3. <A
HREF="gfdl-8.html" HREF="variant-issuezilla.html"
>TRANSLATION</A >Issuezilla</A
></DT ></DT
><DT ><DT
>9. <A >D.4. <A
HREF="gfdl-9.html" HREF="variant-scarab.html"
>TERMINATION</A >Scarab</A
></DT ></DT
><DT ><DT
>10. <A >D.5. <A
HREF="gfdl-10.html" HREF="variant-perforce.html"
>FUTURE REVISIONS OF THIS LICENSE</A >Perforce SCM</A
></DT ></DT
><DT ><DT
><A >D.6. <A
HREF="gfdl-howto.html" HREF="variant-sourceforge.html"
>How to use this License for your documents</A >SourceForge</A
></DT ></DT
></DL ></DL
></DD ></DD
...@@ -457,76 +356,22 @@ CLASS="LOT" ...@@ -457,76 +356,22 @@ CLASS="LOT"
>List of Examples</B >List of Examples</B
></DT ></DT
><DT ><DT
>3-1. <A
HREF="stepbystep.html#AEN641"
>Setting up bonsaitools symlink</A
></DT
><DT
>3-2. <A
HREF="stepbystep.html#AEN732"
>Running checksetup.pl as the web user</A
></DT
><DT
>3-3. <A
HREF="win32.html#AEN985"
>Installing ActivePerl ppd Modules on Microsoft Windows</A
></DT
><DT
>3-4. <A
HREF="win32.html#AEN998"
>Installing OpenInteract ppd Modules manually on Microsoft
Windows</A
></DT
><DT
>3-5. <A
HREF="win32.html#AEN1180"
>Removing encrypt() for Windows NT Bugzilla version
2.12 or earlier</A
></DT
><DT
>4-1. <A >4-1. <A
HREF="programadmin.html#AEN1405" HREF="win32.html#AEN989"
>Creating some Components</A >Installing ActivePerl ppd Modules on Microsoft
Windows</A
></DT ></DT
><DT ><DT
>4-2. <A >4-2. <A
HREF="programadmin.html#AEN1434" HREF="win32.html#AEN1002"
>Common Use of Versions</A >Installing OpenInteract ppd Modules manually on Microsoft
Windows</A
></DT ></DT
><DT ><DT
>4-3. <A >4-3. <A
HREF="programadmin.html#AEN1438" HREF="win32.html#AEN1184"
>A Different Use of Versions</A >Removing encrypt() for Windows NT Bugzilla version 2.12 or
></DT earlier</A
><DT
>4-4. <A
HREF="programadmin.html#AEN1466"
>Using SortKey with Target Milestone</A
></DT
><DT
>4-5. <A
HREF="programadmin.html#AEN1502"
>When to Use Group Security</A
></DT
><DT
>4-6. <A
HREF="programadmin.html#AEN1519"
>Creating a New Group</A
></DT
><DT
>4-7. <A
HREF="programadmin.html#AEN1536"
>Bugzilla Groups</A
></DT
><DT
>D-1. <A
HREF="setperl.html#AEN2380"
>Using Setperl to set your perl path</A
></DT
><DT
>1. <A
HREF="glossary.html#AEN2701"
>A Sample Product</A
></DT ></DT
></DL ></DL
></DIV ></DIV
......
This source diff could not be displayed because it is too large. You can view the blob instead.
This source diff could not be displayed because it is too large. You can view the blob instead.
This source diff could not be displayed because it is too large. You can view the blob instead.
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