From 81d43fa41c61fc801863c9aabeae137c122e5e46 Mon Sep 17 00:00:00 2001 From: "justdave%syndicomm.com" <> Date: Wed, 1 May 2002 16:28:45 +0000 Subject: Full recompile of the docs so everyone can see what the current SGML docs actually look like in HTML. --- docs/html/Bugzilla-Guide.html | 1757 +++++++---------------- docs/html/about.html | 13 +- docs/html/aboutthisguide.html | 18 +- docs/html/administration.html | 37 +- docs/html/bonsai.html | 14 +- docs/html/bsdinstall.html | 14 +- docs/html/bzhacking.html | 22 +- docs/html/cmdline.html | 14 +- docs/html/contributors.html | 14 +- docs/html/conventions.html | 18 +- docs/html/copyright.html | 18 +- docs/html/credits.html | 14 +- docs/html/cvs.html | 14 +- docs/html/database.html | 13 +- docs/html/dbdoc.html | 22 +- docs/html/dbschema.html | 19 +- docs/html/disclaimer.html | 14 +- docs/html/downloadlinks.html | 13 +- docs/html/errata.html | 14 +- docs/html/faq.html | 529 +++---- docs/html/feedback.html | 14 +- docs/html/future.html | 13 +- docs/html/geninstall.html | 42 +- docs/html/gfdl-0.html | 14 +- docs/html/gfdl-1.html | 14 +- docs/html/gfdl-10.html | 14 +- docs/html/gfdl-2.html | 14 +- docs/html/gfdl-3.html | 14 +- docs/html/gfdl-4.html | 14 +- docs/html/gfdl-5.html | 14 +- docs/html/gfdl-6.html | 14 +- docs/html/gfdl-7.html | 14 +- docs/html/gfdl-8.html | 14 +- docs/html/gfdl-9.html | 14 +- docs/html/gfdl-howto.html | 18 +- docs/html/gfdl.html | 17 +- docs/html/glossary.html | 95 +- docs/html/granttables.html | 16 +- docs/html/how.html | 50 +- docs/html/index.html | 396 +----- docs/html/init4me.html | 42 +- docs/html/installation.html | 31 +- docs/html/integration.html | 13 +- docs/html/newversions.html | 14 +- docs/html/osx.html | 14 +- docs/html/patches.html | 17 +- docs/html/postinstall-check.html | 16 +- docs/html/programadmin.html | 94 +- docs/html/quicksearch.html | 14 +- docs/html/rewrite.html | 16 +- docs/html/rhbugzilla.html | 14 +- docs/html/scm.html | 14 +- docs/html/security.html | 14 +- docs/html/setperl.html | 18 +- docs/html/stepbystep.html | 117 +- docs/html/tinderbox.html | 14 +- docs/html/translations.html | 14 +- docs/html/useradmin.html | 40 +- docs/html/using.html | 46 +- docs/html/usingbz-conc.html | 14 +- docs/html/variant-fenris.html | 14 +- docs/html/variant-issuezilla.html | 14 +- docs/html/variant-perforce.html | 14 +- docs/html/variant-scarab.html | 14 +- docs/html/variant-sourceforge.html | 14 +- docs/html/variants.html | 13 +- docs/html/whatis.html | 14 +- docs/html/why.html | 14 +- docs/html/win32.html | 133 +- docs/sgml/Bugzilla-Guide.sgml | 2 +- docs/txt/Bugzilla-Guide.txt | 2729 +++++++++++++++++------------------- docs/xml/Bugzilla-Guide.xml | 2 +- 72 files changed, 2846 insertions(+), 4113 deletions(-) (limited to 'docs') diff --git a/docs/html/Bugzilla-Guide.html b/docs/html/Bugzilla-Guide.html index 769ecce55..fe393753a 100644 --- a/docs/html/Bugzilla-Guide.html +++ b/docs/html/Bugzilla-Guide.html @@ -4,7 +4,7 @@ >The Bugzilla Guide

The Bugzilla Guide

The Bugzilla Guide

Matthew P. Barnson

Matthew P. Barnson

2001-04-25

This is the documentation for Bugzilla, the Mozilla @@ -297,87 +292,11 @@ HREF="#why" HREF="#how" >How do I use Bugzilla?

2.3.1. Create a Bugzilla Account
2.3.2. The Bugzilla Query Page
2.3.3. Creating and Managing Bug Reports
2.3.3.1. Writing a Great Bug Report
2.3.3.2. Managing your Bug Reports
2.4. Where can I find my user preferences?
2.4.1. Account Settings
2.4.2. Email Settings
2.4.2.1. Email Notification
2.4.2.2. New Email Technology
2.4.2.3. "Watching" Users
2.4.3. Page Footer
2.4.4. Permissions
2.5. Step-by-step Install
3.2.1. Introduction
3.2.2. Installing the Prerequisites
3.2.3. Installing MySQL Database
3.2.4. Perl (5.004 or greater)
3.2.5. DBI Perl Module
3.2.6. Data::Dumper Perl Module
3.2.7. MySQL related Perl Module Collection
3.2.8. TimeDate Perl Module Collection
3.2.9. GD Perl Module (1.8.3)
3.2.10. Chart::Base Perl Module (0.99c)
3.2.11. DB_File Perl Module
3.2.12. HTTP Server
3.2.13. Installing the Bugzilla Files
3.2.14. Setting Up the MySQL Database
3.2.15. Tweaking localconfig
3.2.16. Setting Up Maintainers Manually (Optional)
3.2.17. The Whining Cron (Optional)
3.2.18. Bug Graphs (Optional)
3.2.19. Securing MySQL
3.3. Installation General Notes
3.5.1. Modifying Your Running System
3.5.2. Upgrading From Previous Versions
3.5.3. .htaccess files and security
3.5.4. mod_throttle and Security
3.5.5. Preventing untrusted Bugzilla content from executing malicious Javascript code
3.5.6. UNIX Installation Instructions History
3.6. Win32 Installation Notes
3.6.1. Win32 Installation: Step-by-step
3.6.2. Additional Windows Tips
3.6.3. Bugzilla LDAP Integration
User Administration
4.2.1. Creating the Default User
4.2.2. Managing Other Users
4.2.2.1. Logging In
4.2.2.2. Creating new users
4.2.2.3. Disabling Users
4.2.2.4. Modifying Users
4.3. Product, Component, Milestone, and Version Administration
4.3.1. Products
4.3.2. Components
4.3.3. Versions
4.3.4. Milestones
4.3.5. Voting
4.3.6. Groups and Group Security
4.4. MySQL Bugzilla Database Introduction
C.2.1. Bugzilla Database Basics
C.2.1.1. Bugzilla Database Tables
C.3. Hacking Bugzilla
D.5.1. Things that have caused problems and should be avoided
D.5.2. Coding Style for Bugzilla
3-1. Setting up bonsaitools symlink
3-2. Running checksetup.pl as the web user
3-3. Installing ActivePerl ppd Modules on Microsoft Windows
3-4. Installing OpenInteract ppd Modules manually on Microsoft + Windows
3-5. Removing encrypt() for Windows NT Bugzilla version 2.12 or earlier
4-1. Creating some Components
4-2. Common Use of Versions
4-3. A Different Use of Versions
4-4. Using SortKey with Target Milestone
4-5. When to Use Group Security
4-6. Creating a New Group
4-7. Bugzilla Groups
D-1. Using Setperl to set your perl path
1. A Sample Product

Chapter 1. About This Guide

Chapter 1. About This Guide

1.1. Purpose and Scope of this Guide

1.1. Purpose and Scope of this Guide

This document was started on September 17, 2000 by Matthew P. Barnson after a great deal of procrastination updating the @@ -1078,9 +734,9 @@ NAME="aboutthisguide" > Newer revisions of the Bugzilla Guide follow the numbering conventions of the main-tree Bugzilla releases, available at http://www.mozilla.org/projects/bugzillahttp://www.bugzilla.org/. Intermediate releases will have a minor revision number following a period. The current version of Bugzilla, as of this writing (August 10, 2001) is 2.14; if @@ -1109,13 +765,9 @@ CLASS="section" >


1.2. Copyright Information

1.2. Copyright Information

1.3. Disclaimer

1.3. Disclaimer

No liability for the contents of this document can be accepted. Use the concepts, examples, and other content at your own risk. @@ -1221,9 +871,7 @@ CLASS="section" >


1.4. New Versions

1.4. New Versions

This is the 2.14 version of The Bugzilla Guide. If you are reading this from any source other than those below, please @@ -1282,9 +930,7 @@ CLASS="section" >


1.5. Credits

1.5. Credits

The people listed below have made enormous contributions to the creation of this Guide, through their dedicated hacking efforts, @@ -1341,9 +987,7 @@ CLASS="section" >


1.6. Contributors

1.6. Contributors

Thanks go to these people for significant contributions to this documentation (in no particular order): @@ -1358,9 +1002,7 @@ CLASS="section" >


1.7. Feedback

1.7. Feedback

I welcome feedback on this document. Without your submissions and input, this Guide cannot continue to exist. Please mail @@ -1386,9 +1028,7 @@ CLASS="section" >


1.8. Translations

1.8. Translations

The Bugzilla Guide needs translators! Please volunteer your translation into the language of your choice. If you will @@ -1409,18 +1049,14 @@ CLASS="section" >


1.9. Document Conventions

1.9. Document Conventions

This document uses the following conventions


Chapter 2. Using Bugzilla

Chapter 2. Using Bugzilla

2.1. What is Bugzilla?

2.1. What is Bugzilla?

Bugzilla is one example of a class of programs called "Defect Tracking Systems", or, more commonly, "Bug-Tracking Systems". Defect @@ -1880,9 +1512,7 @@ CLASS="section" >


2.2. Why Should We Use Bugzilla?

2.2. Why Should We Use Bugzilla?

2.3. How do I use Bugzilla?

2.3. How do I use Bugzilla?

2.3.1. Create a Bugzilla Account

2.3.1. Create a Bugzilla Account

First things first! If you want to use Bugzilla, first you need to create an account. Consult with the administrator @@ -2222,9 +1848,7 @@ CLASS="section" >


2.3.2. The Bugzilla Query Page

2.3.2. The Bugzilla Query Page

The Bugzilla Query Page is the heart and soul of the Bugzilla user experience. It is the master interface where you can @@ -2350,18 +1974,14 @@ CLASS="QUOTE"

Example 2-1. Some Famous Software Versions

Do you remember the hype in 1995 when Microsoft @@ -2414,18 +2034,14 @@ NAME="AEN309"

Example 2-2. Mozilla's Bugzilla Components

Mozilla's "Bugzilla" Product is composed of several pieces (Components): @@ -2755,9 +2371,7 @@ CLASS="section" >


2.3.3. Creating and Managing Bug Reports

2.3.3. Creating and Managing Bug Reports

2.3.3.1. Writing a Great Bug Report

2.3.3.1. Writing a Great Bug Report

Before we plunge into writing your first bug report, I encourage you to read some bug-writing guidelines. If you @@ -2901,9 +2513,7 @@ CLASS="section" >


2.3.3.2. Managing your Bug Reports

2.3.3.2. Managing your Bug Reports

OK, you should have a link to the bug you just created near the top of your page. It should say "Bug XXXX posted", with @@ -2983,9 +2593,7 @@ CLASS="section" >


2.4. Where can I find my user preferences?

2.4. Where can I find my user preferences?

2.4.1. Account Settings

2.4.1. Account Settings

On this page, you can change your basic Account Settings, including your password and full name. For security reasons, @@ -3063,17 +2669,13 @@ CLASS="section" >


2.4.2. Email Settings

2.4.2. Email Settings

2.4.2.1. Email Notification

2.4.2.1. Email Notification

Here you can reduce or increase the amount of email sent you from Bugzilla. Although this is referred to as @@ -3105,9 +2707,7 @@ CLASS="section" >


2.4.2.2. New Email Technology

2.4.2.2. New Email Technology


2.4.2.3. "Watching" Users

2.4.2.3. "Watching" Users


2.4.3. Page Footer

2.4.3. Page Footer


2.4.4. Permissions

2.4.4. Permissions

This is a purely informative page which outlines your current permissions on this installation of Bugzilla. If you have @@ -3315,9 +2909,7 @@ CLASS="section" >


2.5. Using Bugzilla-Conclusion

2.5. Using Bugzilla-Conclusion

Thank you for reading through this portion of the Bugzilla Guide. I anticipate it may not yet meet the needs of all @@ -3334,9 +2926,7 @@ TARGET="_top" CLASS="chapter" >


Chapter 3. Installation

Chapter 3. Installation

These installation instructions are presented assuming you are installing on a UNIX or completely POSIX-compliant system. If @@ -3349,9 +2939,7 @@ CLASS="section" >


3.1. ERRATA

3.1. ERRATA

Here are some miscellaneous notes about possible issues you main run into when you begin your Bugzilla installation. @@ -3495,17 +3083,13 @@ CLASS="section" >


3.2. Step-by-step Install

3.2. Step-by-step Install

3.2.1. Introduction

3.2.1. Introduction

Installation of bugzilla is pretty straightforward, particularly if your machine already has MySQL and the MySQL-related perl packages installed. @@ -3534,9 +3118,7 @@ CLASS="section" >


3.2.2. Installing the Prerequisites

3.2.2. Installing the Prerequisites


3.2.3. Installing MySQL Database

3.2.3. Installing MySQL Database

Visit MySQL homepage at


3.2.4. Perl (5.004 or greater)

3.2.4. Perl (5.004 or greater)

Any machine that doesn't have perl on it is a sad machine indeed. Perl for *nix systems can be gotten in source form @@ -3970,9 +3548,7 @@ CLASS="QUOTE" >


3.2.5. DBI Perl Module

3.2.5. DBI Perl Module

The DBI module is a generic Perl module used by other database related Perl modules. For our purposes it's required by the MySQL-related @@ -4067,9 +3641,7 @@ HREF="#downloadlinks"

Untar the module tarball -- it should create its own directory @@ -4214,9 +3784,7 @@ CLASS="section" >


3.2.6. Data::Dumper Perl Module

3.2.6. Data::Dumper Perl Module

The Data::Dumper module provides data structure persistence for Perl (similar to Java's serialization). It comes with later sub-releases of @@ -4239,9 +3807,7 @@ CLASS="section" >


3.2.7. MySQL related Perl Module Collection

3.2.7. MySQL related Perl Module Collection

The Perl/MySQL interface requires a few mutually-dependent perl modules. These modules are grouped together into the the @@ -4285,9 +3851,7 @@ CLASS="section" >


3.2.8. TimeDate Perl Module Collection

3.2.8. TimeDate Perl Module Collection

Many of the more common date/time/calendar related Perl modules have been grouped into a bundle similar to the MySQL @@ -4307,9 +3871,7 @@ CLASS="section" >


3.2.9. GD Perl Module (1.8.3)

3.2.9. GD Perl Module (1.8.3)

The GD library was written by Thomas Boutell a long while ago to programatically generate images in C. Since then it's @@ -4373,9 +3935,7 @@ CLASS="section" >


3.2.10. Chart::Base Perl Module (0.99c)

3.2.10. Chart::Base Perl Module (0.99c)

The Chart module provides bugzilla with on-the-fly charting abilities. It can be installed in the usual fashion after it @@ -4394,9 +3954,7 @@ CLASS="section" >


3.2.11. DB_File Perl Module

3.2.11. DB_File Perl Module

DB_File is a module which allows Perl programs to make use of the facilities provided by Berkeley DB version 1.x. This @@ -4410,9 +3968,7 @@ CLASS="section" >


3.2.12. HTTP Server

3.2.12. HTTP Server

You have a freedom of choice here - Apache, Netscape or any other server on UNIX would do. You can easily run the web @@ -4491,6 +4047,7 @@ COLOR="#000000" >


Options ExecCGI
+AllowOverride Limit
 

AllowOverride Limit allows the use of a Deny statement in the + .htaccess file generated by checksetup.pl +

Users of newer versions of Apache will generally find both of the above lines will be in the httpd.conf file, rather than srm.conf or access.conf. @@ -4582,9 +4143,7 @@ CLASS="section" >


3.2.13. Installing the Bugzilla Files

3.2.13. Installing the Bugzilla Files

You should untar the Bugzilla files into a directory that you're willing to make writable by the default web server user @@ -4673,9 +4232,7 @@ HREF="#patches"

Example 3-1. Setting up bonsaitools symlink


perl -pi -e 's@#!/usr/bonsaitools/bin/perl@#!/usr/bin/perl@' *cgi *pl Bug.pm
+>
perl -pi -e 's@#!/usr/bonsaitools/bin/perl@#!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb
 	    

3.2.14. Setting Up the MySQL Database

3.2.14. Setting Up the MySQL Database

After you've gotten all the software installed and working you're ready to start preparing the database for its life as a the back end to a high @@ -5022,11 +4577,9 @@ CLASS="section" >


3.2.15. Tweaking 3.2.15. Tweaking localconfig

This file contains a variety of settings you may need to tweak including @@ -5148,9 +4701,7 @@ CLASS="QUOTE"

Example 3-2. Running checksetup.pl as the web user


3.2.16. Setting Up Maintainers Manually (Optional)

3.2.16. Setting Up Maintainers Manually (Optional)

If you want to add someone else to every group by hand, you can do it by typing the appropriate MySQL commands. Run @@ -5278,9 +4827,7 @@ CLASS="section" >


3.2.17. The Whining Cron (Optional)

3.2.17. The Whining Cron (Optional)

By now you have a fully functional bugzilla, but what good are bugs if they're not annoying? To help make those bugs @@ -5364,9 +4911,7 @@ CLASS="section" >


3.2.18. Bug Graphs (Optional)

3.2.18. Bug Graphs (Optional)

As long as you installed the GD and Graph::Base Perl modules you might as well turn on the nifty bugzilla bug reporting @@ -5421,9 +4966,7 @@ CLASS="section" >


3.2.19. Securing MySQL

3.2.19. Securing MySQL

If you followed the installation instructions for setting up your "bugs" and "root" user in MySQL, much of this should not @@ -5708,9 +5251,7 @@ CLASS="section" >


3.3. Mac OS X Installation Notes

3.3. Mac OS X Installation Notes

There are a lot of common libraries and utilities out there that Apple did not include with Mac OS X, but which run @@ -5871,9 +5412,7 @@ CLASS="section" >


3.4. BSD Installation Notes

3.4. BSD Installation Notes

For instructions on how to set up Bugzilla on FreeBSD, NetBSD, OpenBSD, BSDi, etc. please consult


3.5. Installation General Notes

3.5. Installation General Notes

3.5.1. Modifying Your Running System

3.5.1. Modifying Your Running System

Bugzilla optimizes database lookups by storing all relatively static information in the versioncache file, located in the data/ subdirectory @@ -5928,9 +5463,7 @@ CLASS="section" >


3.5.2. Upgrading From Previous Versions

3.5.2. Upgrading From Previous Versions

The developers of Bugzilla are constantly adding new tables, columns and fields. You'll get SQL errors if you just update the code. The strategy @@ -5949,12 +5482,10 @@ CLASS="section" >


3.5.3. 3.5.3. .htaccess files and security

files and security

To enhance the security of your Bugzilla installation, Bugzilla will generate @@ -6104,12 +5635,10 @@ CLASS="section" >


3.5.4. 3.5.4. mod_throttle and Security

and Security

It is possible for a user, by mistake or on purpose, to access the database many times in a row which can result in very slow @@ -6140,9 +5669,7 @@ CLASS="section" >


3.5.5. Preventing untrusted Bugzilla content from executing malicious Javascript code

3.5.5. Preventing untrusted Bugzilla content from executing malicious Javascript code

It is possible for a Bugzilla to execute malicious Javascript code. Due to internationalization concerns, we are @@ -6199,9 +5726,7 @@ CLASS="section" >


3.5.6. UNIX Installation Instructions History

3.5.6. UNIX Installation Instructions History

This document was originally adapted from the Bonsai installation instructions by Terry Weissman @@ -6240,9 +5765,7 @@ CLASS="section" >


3.6. Win32 Installation Notes

3.6. Win32 Installation Notes

This section covers installation on Microsoft Windows 95, 98, ME, NT, and 2000. Bugzilla works fine on Win32 platforms, @@ -6268,9 +5791,7 @@ CLASS="section" >


3.6.1. Win32 Installation: Step-by-step

3.6.1. Win32 Installation: Step-by-step

  • Use ppm from your perl\bin directory to install the following packs: DBI, - DBD-Mysql, TimeDate, Chart, Date-Calc, Date-Manip, and GD. You may need - to extract them from .zip format using Winzip or other unzip program first. - These additional ppm modules can be downloaded from ActiveState. -

    Use ppm from your perl\bin directory to install the following + packs: DBI, DBD-Mysql, TimeDate, Chart, Date-Calc, Date-Manip, + GD, AppConfig, and Template. You may need to extract them from + .zip format using Winzip or other unzip program first. Most of + these additional ppm modules can be downloaded from ActiveState, + but AppConfig and Template should be obtained from OpenInteract + using the instructions on + the Template Toolkit web site. +

    http://www.activestate.com/PPMPackages/zips/5xx-builds-only/ + or http://www.activestate.com/PPMPackages/5.6plus

    Example 3-3. Installing ActivePerl ppd Modules on Microsoft Windows

    Watch your capitalization!

    You can find ActiveState ppm modules at - http://www.activestate.com/PPMPackages/5.6plus ActiveState's 5.6Plus directory also contains an AppConfig ppm, so + you might see the following error when trying to install the + version at OpenInteract: +

    Error installing package 'AppConfig': Read a PPD for + 'AppConfig', but it is not intended for this build of Perl + (MSWin32-x86-multi-thread) +

    If so, download both the + tarball and the + ppd directly from OpenInteract, then run ppm from within + the same directory to which you downloaded those files and + install the package by referencing the ppd file explicitly via in + the install command, f.e.: +

    +

  • bug 62000, the perl documentation says that you should always use , + the perl documentation says that you should always use + binmode() when dealing with binary files, but never when dealing with text files. That seems to suggest that rather than arbitrarily putting when dealing with binary + files, but never when dealing with text files. That seems + to suggest that rather than arbitrarily putting + binmode() at the beginning of the attachment files, there should be logic to determine if at the beginning of the + attachment files, there should be logic to determine if + binmode() is needed or not. @@ -7491,9 +7075,7 @@ CLASS="section" >


    3.6.2. Additional Windows Tips

    3.6.2. Additional Windows Tips

    From Andrew Pearson:

    You can make Bugzilla work with Personal Web Server for @@ -7603,11 +7183,9 @@ VALIGN="TOP"

    Example 3-4. Removing encrypt() for Windows NT Bugzilla version +>Example 3-5. Removing encrypt() for Windows NT Bugzilla version 2.12 or earlier


    3.6.3. Bugzilla LDAP Integration

    3.6.3. Bugzilla LDAP Integration

    What follows is some late-breaking information on using the LDAP authentication options with Bugzilla. The author has not @@ -7748,9 +7324,7 @@ address, query on users by email address, etc CLASS="chapter" >


    Chapter 4. Administering Bugzilla

    Chapter 4. Administering Bugzilla Or, I just got this cool thing installed. Now what the heck do I @@ -7777,9 +7351,7 @@ CLASS="section" >

    4.1. Post-Installation Checklist

    4.1. Post-Installation Checklist

    After installation, follow the checklist below to help ensure that you have a successful installation. If you do not see a @@ -8181,7 +7753,7 @@ CLASS="QUOTE" > would not normally be allowed to view a bug, the watcher cannot get around the system by setting herself up to watch the bugs of someone - with bugs outside her priveleges. She would still only + with bugs outside her privileges. She would still only receive email updates for those bugs she could normally view.


    4.2. User Administration

    4.2. User Administration

    User administration is one of the easiest parts of Bugzilla. Keeping it from getting out of hand, however, can become a @@ -8222,9 +7792,7 @@ CLASS="section" >


    4.2.1. Creating the Default User

    4.2.1. Creating the Default User

    When you first run checksetup.pl after installing Bugzilla, it will prompt you for the administrative username (email @@ -8294,17 +7862,13 @@ CLASS="section" >


    4.2.2. Managing Other Users

    4.2.2. Managing Other Users

    4.2.2.1. Logging In

    4.2.2.1. Logging In


      4.2.2.2. Creating new users

      4.2.2.2. Creating new users

      Your users can create their own user accounts by clicking the "New Account" link at the bottom of each page. However, @@ -8468,9 +8030,7 @@ CLASS="section" >


      4.2.2.3. Disabling Users

      4.2.2.3. Disabling Users

      I bet you noticed that big "Disabled Text" entry box available from the "Add New User" screen, when you edit an @@ -8524,9 +8084,7 @@ CLASS="section" >


      4.2.2.4. Modifying Users

      4.2.2.4. Modifying Users

      Here I will attempt to describe the function of each option on the Edit User screen. @@ -8834,7 +8392,7 @@ VALIGN="TOP" >: This flag allows a user do what you're doing right now: edit other users. This will allow those with the right to do so to remove - administrator priveleges from other users or grant them + administrator privileges from other users or grant them to themselves. Enable with care.


      4.3. Product, Component, Milestone, and Version - Administration

      4.3. Product, Component, Milestone, and Version + Administration

  • 4.3.1. Products

    4.3.1. ProductsFormerly, and in some spots still, called @@ -9014,27 +8568,21 @@ CLASS="section" >

    4.3.2. Components

    4.3.2. Components

    Components are subsections of a Product.

    Example 4-1. Creating some Components

    The computer game you are designing may have a "UI" @@ -9167,9 +8715,7 @@ CLASS="section" >


    4.3.3. Versions

    4.3.3. Versions

    Versions are the revisions of the product, such as "Flinders 3.1", "Flinders 95", and "Flinders 2000". Using Versions @@ -9178,18 +8724,14 @@ NAME="versions"

    Example 4-2. Common Use of Versions

    A user reports a bug against Version "Beta 2.0" of your @@ -9209,18 +8751,14 @@ NAME="AEN1501"

    Example 4-3. A Different Use of Versions

    This field has been used to good effect by an online @@ -9287,9 +8825,7 @@ CLASS="section" >


    4.3.4. Milestones

    4.3.4. Milestones

    Milestones are "targets" that you plan to get a bug fixed by. For example, you have a bug that you plan to fix for your 3.0 @@ -9355,18 +8891,14 @@ TYPE="1" >

    Example 4-4. Using SortKey with Target Milestone

    Let's say you create a target milestone called @@ -9457,9 +8989,7 @@ CLASS="section" >


    4.3.5. Voting

    4.3.5. Voting

    The concept of "voting" is a poorly understood, yet powerful feature for the management of open-source projects. Each user @@ -9566,9 +9096,7 @@ CLASS="section" >


    4.3.6. Groups and Group Security

    4.3.6. Groups and Group Security

    Groups can be very useful in bugzilla, because they allow users to isolate bugs or products that should only be seen by @@ -9578,18 +9106,14 @@ NAME="groups"

    Example 4-5. When to Use Group Security

    Many Bugzilla sites isolate "Security-related" bugs from @@ -9704,18 +9228,14 @@ TYPE="1"

    Example 4-6. Creating a New Group

    I created a group called DefaultGroup with a @@ -9839,9 +9359,7 @@ VALIGN="TOP"

    Example 4-7. Bugzilla Groups


    Bug7 can be seen by anyone who is in Group1, Group2, and Group3.  This
    is only User4.  All of the others are missing at least one of those
    -group priveleges, and thus cannot see the bug.
    +group privileges, and thus cannot see the bug.

    Bug8 can be seen by anyone who is in Group1, Group2, Group3, and
    Group4.  There is nobody in all four of these groups, so nobody can
    @@ -9948,9 +9466,7 @@ CLASS="section" >

    4.4. Bugzilla Security

    4.4. Bugzilla Security

    Chapter 5. Integrating Bugzilla with Third-Party Tools

    Chapter 5. Integrating Bugzilla with Third-Party Tools

    5.1. Bonsai

    5.1. Bonsai

    Bonsai is a web-based tool for managing


    5.2. CVS

    5.2. CVS

    CVS integration is best accomplished, at this point, using the Bugzilla Email Gateway. There have been some files @@ -10328,9 +9838,7 @@ CLASS="section" >


    5.3. Perforce SCM

    5.3. Perforce SCM

    You can find the project page for Bugzilla and Teamtrack Perforce integration (p4dti) at:


    5.4. Tinderbox/Tinderbox2

    5.4. Tinderbox/Tinderbox2

    We need Tinderbox integration information.


    Chapter 6. The Future of Bugzilla

    Chapter 6. The Future of Bugzilla
    CLASS="chapter" >

    Chapter 7. Bugzilla Variants and Competitors

    Chapter 7. Bugzilla Variants and Competitors

    I created this section to answer questions about Bugzilla competitors and variants, then found a wonderful site which covers @@ -11009,9 +10511,7 @@ CLASS="section" >


    7.1. Red Hat Bugzilla

    7.1. Red Hat Bugzilla

    Red Hat Bugzilla is probably the most popular Bugzilla variant on the planet. One of the major benefits of Red Hat Bugzilla is @@ -11033,9 +10533,7 @@ CLASS="section" >


    7.2. Loki Bugzilla (Fenris)

    7.2. Loki Bugzilla (Fenris)

    Fenris can be found at


    7.3. Issuezilla

    7.3. Issuezilla

    Issuezilla is another fork from Bugzilla, and seems nearly as popular as the Red Hat Bugzilla fork. Some Issuezilla team @@ -11074,9 +10570,7 @@ CLASS="section" >


    7.4. Scarab

    7.4. Scarab

    Scarab is a promising new bug-tracking system built using Java Serlet technology. As of this writing, no source code has @@ -11095,9 +10589,7 @@ CLASS="section" >


    7.5. Perforce SCM

    7.5. Perforce SCM

    Although Perforce isn't really a bug tracker, it can be used as such through the


    7.6. SourceForge

    7.6. SourceForge

    SourceForge is more of a way of coordinating geographically distributed free software and open source projects over the @@ -11137,9 +10627,7 @@ TARGET="_top" CLASS="appendix" >


    Appendix A. The Bugzilla FAQ

    Appendix A. The Bugzilla FAQ
    A.1.1. Where can I find information about Bugzilla?
    A.1.2. What license is Bugzilla distributed under?
    A.1.3. How do I get commercial support for Bugzilla?
    A.1.4. What major companies or projects are currently using Bugzilla for bug-tracking?
    A.1.5. Who maintains Bugzilla?
    A.1.6. How does Bugzilla stack up against other bug-tracking databases?
    A.1.7. How do I change my user name in Bugzilla?
    A.1.8. Why doesn't Bugzilla offer this or that feature or compatability with this other tracking software?
    A.1.9. Why MySQL? I'm interested in seeing Bugzilla run on Oracle/Sybase/Msql/PostgreSQL/MSSQL?
    A.1.10. Why do the scripts say "/usr/bonsaitools/bin/perl" instead of "/usr/bin/perl" or something else?
    A.2.1. What about Red Hat Bugzilla?
    A.2.2. What are the primary benefits of Red Hat Bugzilla?
    A.2.3. What's the current status of Red Hat Bugzilla?
    A.3.1. What is Loki Bugzilla (Fenris)?
    A.4.1. Is Bugzilla web-based or do you have to have specific software or specific operating system on your machine?
    A.4.2. Has anyone you know of already done any Bugzilla integration with Perforce (SCM software)?
    A.4.3. Does Bugzilla allow the user to track multiple projects?
    A.4.4. If I am on many projects, and search for all bugs assigned to me, will Bugzilla list them for me and allow me to sort by project, severity etc?
    A.4.5. Does Bugzilla allow attachments (text, screenshots, urls etc)? If yes, are there any that are NOT allowed?
    A.4.6. Does Bugzilla allow us to define our own priorities and levels? Do we have complete freedom to change the labels of fields and format of them, and the choice of acceptable values? @@ -11308,7 +10796,7 @@ HREF="#AEN1911" >
    A.4.7. The index.html page doesn't show the footer. It's really annoying to have to go to the querypage just to check my "my bugs" link. How do I get a footer on static HTML pages? @@ -11316,35 +10804,35 @@ HREF="#AEN1918" >
    A.4.8. Does Bugzilla provide any reporting features, metrics, graphs, etc? You know, the type of stuff that management likes to see. :)
    A.4.9. Is there email notification and if so, what do you see when you get an email? Do you see bug number and title or is it only the number?
    A.4.10. Can email notification be set up to send to multiple people, some on the To List, CC List, BCC List etc?
    A.4.11. If there is email notification, do users have to have any particular type of email application?
    A.4.12. If I just wanted to track certain bugs, as they go through life, can I set it up to alert me via email whenever that bug changes, whether it be owner, status or description etc.? @@ -11352,7 +10840,7 @@ HREF="#AEN1965" >
    A.4.13. Does Bugzilla allow data to be imported and exported? If I had outsiders write up a bug report using a MS Word bug template, could that template be imported into "matching" fields? If I wanted to take the results of a query @@ -11361,47 +10849,47 @@ HREF="#AEN1970" >
    A.4.14. Has anyone converted Bugzilla to another language to be used in other countries? Is it localizable?
    A.4.15. Can a user create and save reports? Can they do this in Word format? Excel format?
    A.4.16. Can a user re-run a report with a new project, same query?
    A.4.17. Can a user modify an existing report and then save it into another name?
    A.4.18. Does Bugzilla have the ability to search by word, phrase, compound search?
    A.4.19. Can the admin person establish separate group and individual user privileges?
    A.4.20. Does Bugzilla provide record locking when there is simultaneous access to the same bug? Does the second person get a notice that the bug is in use or how are they notified? @@ -11409,19 +10897,19 @@ HREF="#AEN2008" >
    A.4.21. Are there any backup features provided?
    A.4.22. Can users be on the system while a backup is in progress?
    A.4.23. What type of human resources are needed to be on staff to install and maintain Bugzilla? Specifically, what type of skills does the person need to have? I need to find out if we were to go with Bugzilla, what types of @@ -11431,7 +10919,7 @@ HREF="#AEN2024" >
    A.4.24. What time frame are we looking at if we decide to hire people to install and maintain the Bugzilla? Is this something that takes hours or weeks to install and a couple of hours per week to maintain and customize or is this @@ -11441,7 +10929,7 @@ HREF="#AEN2031" >
    A.4.25. Is there any licensing fee or other fees for using Bugzilla? Any out-of-pocket cost other than the bodies needed as identified above?
    A.5.1. How do I download and install Bugzilla?
    A.5.2. How do I install Bugzilla on Windows NT?
    A.5.3. Is there an easy way to change the Bugzilla cookie name?
    A.6.1. How do I completely disable MySQL security if it's giving me problems (I've followed the instructions in the installation section of this guide!)?
    A.6.2. Are there any security problems with Bugzilla?
    A.6.3. I've implemented the security fixes mentioned in Chris Yeh's security advisory of 5/10/2000 advising not to run MySQL as root, and am running into problems with MySQL no longer working correctly. @@ -11514,48 +11002,48 @@ HREF="#faq-email" >
    A.7.1. I have a user who doesn't want to receive any more email from Bugzilla. How do I stop it entirely for this user?
    A.7.2. I'm evaluating/testing Bugzilla, and don't want it to send email to anyone but me. How do I do it?
    A.7.3. I want whineatnews.pl to whine at something more, or other than, only new bugs. How do I do it?
    A.7.4. I don't like/want to use Procmail to hand mail off to bug_email.pl. What alternatives do I have?
    A.7.5. How do I set up the email interface to submit/change bugs via email?
    A.7.6. Email takes FOREVER to reach me from bugzilla -- it's extremely slow. What gives?
    A.7.7. How come email never reaches me from bugzilla changes?
    A.8.1. I've heard Bugzilla can be used with Oracle?
    A.8.2. Bugs are missing from queries, but exist in the database (and I can pull them up by specifying the bug ID). What's wrong?
    A.8.3. I think my database might be corrupted, or contain invalid entries. What do I do?
    A.8.4. I want to manually edit some entries in my database. How?
    A.8.5. I try to add myself as a user, but Bugzilla always tells me my password is wrong.
    A.8.6. I think I've set up MySQL permissions correctly, but bugzilla still can't connect.
    A.8.7. How do I synchronize bug information among multiple different Bugzilla databases?
    A.8.8. Why do I get bizarre errors when trying to submit data, particularly problems with "groupset"?
    A.8.9. How come even after I delete bugs, the long descriptions show up?
    A.9.1. What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)?
    A.9.2. Is there a "Bundle::Bugzilla" equivalent for Win32?
    A.9.3. CGI's are failing with a "something.cgi is not a valid Windows NT application" error. Why?
    A.9.4. Can I have some general instructions on how to make Bugzilla on Win32 work?
    A.9.5. I'm having trouble with the perl modules for NT not being able to talk to to the database.
    A.10.1. The query page is very confusing. Isn't there a simpler way to query?
    A.10.2. I'm confused by the behavior of the "accept" button in the Show Bug form. Why doesn't it assign the bug to me when I accept it?
    A.10.3. I can't upload anything into the database via the "Create Attachment" link. What am I doing wrong?
    A.10.4. Email submissions to Bugzilla that have attachments end up asking me to save it as a "cgi" file.
    A.10.5. How do I change a keyword in Bugzilla, once some bugs are using it?
    A.11.1. What bugs are in Bugzilla right now?
    A.11.2. How can I change the default priority to a null value? For instance, have the default priority be "---" instead of "P2"?
    A.11.3. What's the best way to submit patches? What guidelines should I follow?

    1. General Questions

    1. General Questions

    A.1.1. Where can I find information about Bugzilla?

    A.1.2. What license is Bugzilla distributed under? @@ -11811,9 +11293,7 @@ CLASS="qandaentry" CLASS="question" >

    A.1.3. How do I get commercial support for Bugzilla? @@ -11848,9 +11328,7 @@ CLASS="qandaentry" CLASS="question" >

    A.1.4. What major companies or projects are currently using Bugzilla @@ -11958,9 +11436,7 @@ CLASS="qandaentry" CLASS="question" >

    A.1.5. Who maintains Bugzilla? @@ -11987,9 +11463,7 @@ CLASS="qandaentry" CLASS="question" >

    A.1.6. How does Bugzilla stack up against other bug-tracking databases? @@ -12028,9 +11502,7 @@ CLASS="qandaentry" CLASS="question" >

    A.1.7. How do I change my user name in Bugzilla? @@ -12053,9 +11525,7 @@ CLASS="qandaentry" CLASS="question" >

    A.1.8. Why doesn't Bugzilla offer this or that feature or compatability @@ -12093,9 +11563,7 @@ CLASS="qandaentry" CLASS="question" >

    A.1.9. Why MySQL? I'm interested in seeing Bugzilla run on @@ -12109,9 +11577,7 @@ CLASS="answer" > Terry Weissman answers,

    You're not the only one. But

    A.1.10. Why do the scripts say "/usr/bonsaitools/bin/perl" instead of @@ -12207,9 +11671,7 @@ CLASS="answer" >

    Here's Terry Weissman's comment, for some historical context:

    [This was] purely my own convention. I wanted a place to put a version of @@ -12262,9 +11724,7 @@ VALIGN="TOP" CLASS="qandadiv" >

    2. Red Hat Bugzilla

    2. Red Hat Bugzilla

    A.2.1. What about Red Hat Bugzilla? @@ -12330,9 +11788,7 @@ CLASS="answer" >

    Dave Lawrence, the original Red Hat Bugzilla maintainer, mentions:

    Somebody needs to take the ball and run with it. I'm the only @@ -12353,9 +11809,7 @@ CLASS="qandaentry" CLASS="question" >

    A.2.2. What are the primary benefits of Red Hat Bugzilla? @@ -12371,9 +11825,7 @@ CLASS="answer" >Dave Lawrence:

    For the record, we are not using any template type implementation for @@ -12487,9 +11939,7 @@ CLASS="qandaentry" CLASS="question" >

    A.2.3. What's the current status of Red Hat Bugzilla? @@ -12535,9 +11985,7 @@ VALIGN="TOP" >Dave Lawrence:

    I suppose the current thread warrants an update on the status of @@ -12595,18 +12043,14 @@ CLASS="BLOCKQUOTE" CLASS="qandadiv" >

    3. Loki Bugzilla (AKA Fenris)

    3. Loki Bugzilla (AKA Fenris)

    A.3.1. What is Loki Bugzilla (Fenris)? @@ -12632,9 +12076,7 @@ TARGET="_top" CLASS="qandadiv" >

    4. Pointy-Haired-Boss Questions

    4. Pointy-Haired-Boss Questions

    A.4.1. Is Bugzilla web-based or do you have to have specific software or @@ -12698,9 +12138,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.2. Has anyone you know of already done any Bugzilla integration with @@ -12724,9 +12162,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.3. Does Bugzilla allow the user to track multiple projects? @@ -12752,9 +12188,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.4. If I am on many projects, and search for all bugs assigned to me, will @@ -12777,9 +12211,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.5. Does Bugzilla allow attachments (text, screenshots, urls etc)? If yes, @@ -12807,9 +12239,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.6. Does Bugzilla allow us to define our own priorities and levels? Do we @@ -12844,9 +12274,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.7. The index.html page doesn't show the footer. It's really annoying to have @@ -13031,9 +12459,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.8. Does Bugzilla provide any reporting features, metrics, graphs, etc? You @@ -13072,9 +12498,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.9. Is there email notification and if so, what do you see when you get an @@ -13099,9 +12523,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.10. Can email notification be set up to send to multiple @@ -13124,9 +12546,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.11. If there is email notification, do users have to have any particular @@ -13183,9 +12603,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.12. If I just wanted to track certain bugs, as they go through life, can I @@ -13212,9 +12630,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.13. Does Bugzilla allow data to be imported and exported? If I had outsiders @@ -13259,9 +12675,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.14. Has anyone converted Bugzilla to another language to be used in other @@ -13287,9 +12701,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.15. Can a user create and save reports? Can they do this in Word format? @@ -13312,9 +12724,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.16. Can a user re-run a report with a new project, same query? @@ -13336,9 +12746,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.17. Can a user modify an existing report and then save it into another name? @@ -13361,9 +12769,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.18. Does Bugzilla have the ability to search by word, phrase, compound @@ -13387,9 +12793,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.19. Can the admin person establish separate group and individual user @@ -13412,9 +12816,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.20. Does Bugzilla provide record locking when there is simultaneous access @@ -13439,9 +12841,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.21. Are there any backup features provided? @@ -13469,9 +12869,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.22. Can users be on the system while a backup is in progress? @@ -13495,9 +12893,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.23. What type of human resources are needed to be on staff to install and @@ -13536,9 +12932,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.24. What time frame are we looking at if we decide to hire people to install @@ -13569,9 +12963,7 @@ CLASS="qandaentry" CLASS="question" >

    A.4.25. Is there any licensing fee or other fees for using Bugzilla? Any @@ -13594,18 +12986,14 @@ CLASS="answer" CLASS="qandadiv" >

    5. Bugzilla Installation

    5. Bugzilla Installation

    A.5.1. How do I download and install Bugzilla? @@ -13632,9 +13020,7 @@ CLASS="qandaentry" CLASS="question" >

    A.5.2. How do I install Bugzilla on Windows NT? @@ -13657,9 +13043,7 @@ CLASS="qandaentry" CLASS="question" >

    A.5.3. Is there an easy way to change the Bugzilla cookie name? @@ -13680,18 +13064,14 @@ CLASS="answer" CLASS="qandadiv" >

    6. Bugzilla Security

    6. Bugzilla Security

    A.6.1. How do I completely disable MySQL security if it's giving me problems @@ -13719,9 +13099,7 @@ CLASS="qandaentry" CLASS="question" >

    A.6.2. Are there any security problems with Bugzilla? @@ -13746,9 +13124,7 @@ CLASS="qandaentry" CLASS="question" >

    A.6.3. I've implemented the security fixes mentioned in Chris Yeh's security @@ -13773,18 +13149,14 @@ CLASS="answer" CLASS="qandadiv" >

    7. Bugzilla Email

    7. Bugzilla Email

    A.7.1. I have a user who doesn't want to receive any more email from Bugzilla. @@ -13808,9 +13180,7 @@ CLASS="qandaentry" CLASS="question" >

    A.7.2. I'm evaluating/testing Bugzilla, and don't want it to send email to @@ -13834,9 +13204,7 @@ CLASS="qandaentry" CLASS="question" >

    A.7.3. I want whineatnews.pl to whine at something more, or other than, only new @@ -13866,9 +13234,7 @@ CLASS="qandaentry" CLASS="question" >

    A.7.4. I don't like/want to use Procmail to hand mail off to bug_email.pl. @@ -13884,9 +13250,7 @@ CLASS="answer" You can call bug_email.pl directly from your aliases file, with an entry like this:

    bugzilla-daemon: "|/usr/local/bin/bugzilla/contrib/bug_email.pl" @@ -13905,9 +13269,7 @@ CLASS="qandaentry" CLASS="question" >

    A.7.5. How do I set up the email interface to submit/change bugs via email? @@ -13930,9 +13292,7 @@ CLASS="qandaentry" CLASS="question" >

    A.7.6. Email takes FOREVER to reach me from bugzilla -- it's extremely slow. @@ -13964,9 +13324,7 @@ CLASS="qandaentry" CLASS="question" >

    A.7.7. How come email never reaches me from bugzilla changes? @@ -13995,18 +13353,14 @@ CLASS="answer" CLASS="qandadiv" >

    8. Bugzilla Database

    8. Bugzilla Database

    A.8.1. I've heard Bugzilla can be used with Oracle? @@ -14031,9 +13385,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.2. Bugs are missing from queries, but exist in the database (and I can pull @@ -14068,9 +13420,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.3. I think my database might be corrupted, or contain invalid entries. What @@ -14115,9 +13465,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.4. I want to manually edit some entries in my database. How? @@ -14144,9 +13492,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.5. I try to add myself as a user, but Bugzilla always tells me my password is wrong. @@ -14170,9 +13516,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.6. I think I've set up MySQL permissions correctly, but bugzilla still can't @@ -14199,9 +13543,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.7. How do I synchronize bug information among multiple different Bugzilla @@ -14237,9 +13579,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.8. Why do I get bizarre errors when trying to submit data, particularly problems @@ -14265,9 +13605,7 @@ CLASS="qandaentry" CLASS="question" >

    A.8.9. How come even after I delete bugs, the long descriptions show up? @@ -14302,18 +13640,14 @@ CLASS="option" CLASS="qandadiv" >

    9. Bugzilla and Win32

    9. Bugzilla and Win32

    A.9.1. What is the easiest way to run Bugzilla on Win32 (Win98+/NT/2K)? @@ -14336,9 +13670,7 @@ CLASS="qandaentry" CLASS="question" >

    A.9.2. Is there a "Bundle::Bugzilla" equivalent for Win32? @@ -14362,9 +13694,7 @@ CLASS="qandaentry" CLASS="question" >

    A.9.3. CGI's are failing with a "something.cgi is not a valid Windows NT @@ -14385,9 +13715,7 @@ CLASS="answer" >

    Microsoft has some advice on this matter, as well:

    "Set application mappings. In the ISM, map the extension for the script @@ -14410,9 +13738,7 @@ CLASS="qandaentry" CLASS="question" >

    A.9.4. Can I have some general instructions on how to make Bugzilla on Win32 work? @@ -14524,9 +13850,7 @@ CLASS="qandaentry" CLASS="question" >

    A.9.5. I'm having trouble with the perl modules for NT not being able to talk to @@ -14592,18 +13916,14 @@ TARGET="_top" CLASS="qandadiv" >

    10. Bugzilla Usage

    10. Bugzilla Usage

    A.10.1. The query page is very confusing. Isn't there a simpler way to query? @@ -14631,9 +13951,7 @@ CLASS="qandaentry" CLASS="question" >

    A.10.2. I'm confused by the behavior of the "accept" button in the Show Bug form. @@ -14686,9 +14004,7 @@ CLASS="qandaentry" CLASS="question" >

    A.10.3. I can't upload anything into the database via the "Create Attachment" @@ -14713,9 +14029,7 @@ CLASS="qandaentry" CLASS="question" >

    A.10.4. Email submissions to Bugzilla that have attachments end up asking me to @@ -14740,9 +14054,7 @@ CLASS="qandaentry" CLASS="question" >

    A.10.5. How do I change a keyword in Bugzilla, once some bugs are using it? @@ -14765,18 +14077,14 @@ CLASS="answer" CLASS="qandadiv" >

    11. Bugzilla Hacking

    11. Bugzilla Hacking

    A.11.1. What bugs are in Bugzilla right now? @@ -14820,9 +14128,7 @@ CLASS="qandaentry" CLASS="question" >

    A.11.2. How can I change the default priority to a null value? For instance, have the default @@ -14854,9 +14160,7 @@ CLASS="qandaentry" CLASS="question" >

    A.11.3. What's the best way to submit patches? What guidelines should I follow? @@ -14931,9 +14235,7 @@ TARGET="_top" CLASS="appendix" >


    Appendix B. Software Download Links

    Appendix B. Software Download Links

    All of these sites are current as of April, 2001. Hopefully they'll stay current for a while. @@ -15042,9 +14344,7 @@ TARGET="_top" CLASS="appendix" >


    Appendix C. The Bugzilla Database

    Appendix C. The Bugzilla Database


    C.1. Database Schema Chart

    C.1. Database Schema Chart

    Bugzilla database relationships chart


    C.2. MySQL Bugzilla Database Introduction

    C.2. MySQL Bugzilla Database Introduction

    This information comes straight from my life. I was forced to learn how Bugzilla organizes database because of nitpicky requests from users for tiny @@ -15170,9 +14463,7 @@ CLASS="section" >


    C.2.1. Bugzilla Database Basics

    C.2.1. Bugzilla Database Basics

    If you were like me, at this point you're totally clueless about the internals of MySQL, and if it weren't for this @@ -15293,9 +14584,7 @@ CLASS="section" >


    C.2.1.1. Bugzilla Database Tables

    C.2.1.1. Bugzilla Database Tables

    Imagine your MySQL database as a series of spreadsheets, and you won't be too far off. If you use this @@ -15550,9 +14839,7 @@ CLASS="section" >


    C.3. MySQL Permissions & Grant Tables

    C.3. MySQL Permissions & Grant Tables


    OR

    -mysql> GRANT ALL PRIVELEGES 
    +mysql> GRANT ALL PRIVILEGES 
    ON keystone.*
    TO <$sys_dbuser name>@localhost
    IDENTIFIED BY '(password)'
    @@ -15768,9 +15055,7 @@ http://www.mysql.com/Manual/manual.html.
    CLASS="appendix" >


    Appendix D. Useful Patches and Utilities for Bugzilla

    Appendix D. Useful Patches and Utilities for Bugzilla

    Are you looking for a way to put your Bugzilla into overdrive? Catch some of the niftiest tricks here in this section.


    D.1. Apache D.1. Apache mod_rewrite magic

    magic

    Apache's


    D.2. The setperl.csh Utility

    D.2. The setperl.csh Utility

    You can use the "setperl.csh" utility to quickly and easily change the path to perl on all your Bugzilla files. This @@ -15990,9 +15271,7 @@ CLASS="command"

    Example D-1. Using Setperl to set your perl path


    D.3. Command-line Bugzilla Queries

    D.3. Command-line Bugzilla Queries

    Users can query Bugzilla from the command line using this suite of utilities. @@ -16158,9 +15435,7 @@ CLASS="section" >


    D.4. The Quicksearch Utility

    D.4. The Quicksearch Utility

    Quicksearch is a new, experimental feature of the 2.12 release. It consist of two Javascript files, "quicksearch.js" and @@ -16222,9 +15497,7 @@ CLASS="section" >


    D.5. Hacking Bugzilla

    D.5. Hacking Bugzilla

    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, @@ -16237,9 +15510,7 @@ CLASS="section" >


    D.5.1. Things that have caused problems and should be avoided

    D.5.1. Things that have caused problems and should be avoided


      D.5.2. Coding Style for Bugzilla

      D.5.2. Coding Style for Bugzilla

      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, @@ -16585,15 +15854,11 @@ CLASS="function" CLASS="appendix" >


      Appendix E. GNU Free Documentation License

      Appendix E. GNU Free Documentation License

      Version 1.1, March 2000

      Copyright (C) 2000 Free Software Foundation, Inc. @@ -16603,12 +15868,10 @@ of this license document, but changing it is not allowed.



      0. PREAMBLE

      0. PREAMBLE

      The purpose of this License is to make a manual, textbook, or other written document "free" in the sense of freedom: to @@ -16635,12 +15898,10 @@ NAME="gfdl-0" >



      1. APPLICABILITY AND DEFINITIONS

      1. APPLICABILITY AND DEFINITIONS

      This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be @@ -16708,12 +15969,10 @@ NAME="gfdl-1" >



      2. VERBATIM COPYING

      2. VERBATIM COPYING

      You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this @@ -16731,12 +15990,10 @@ NAME="gfdl-2" >



      3. COPYING IN QUANTITY

      3. COPYING IN QUANTITY

      If you publish printed copies of the Document numbering more than 100, and the Document's license notice requires Cover Texts, @@ -16778,12 +16035,10 @@ NAME="gfdl-3" >



      4. MODIFICATIONS

      4. MODIFICATIONS

      You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided @@ -16931,12 +16186,10 @@ TYPE="A" >



      5. COMBINING DOCUMENTS

      5. COMBINING DOCUMENTS

      You may combine the Document with other documents released under this License, under the terms defined in section 4 above for @@ -16963,12 +16216,10 @@ NAME="gfdl-5" >



      6. COLLECTIONS OF DOCUMENTS

      6. COLLECTIONS OF DOCUMENTS

      You may make a collection consisting of the Document and other documents released under this License, and replace the @@ -16985,12 +16236,10 @@ NAME="gfdl-6" >



      7. AGGREGATION WITH INDEPENDENT WORKS

      7. AGGREGATION WITH INDEPENDENT WORKS

      A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of @@ -17011,12 +16260,10 @@ NAME="gfdl-7" >



      8. TRANSLATION

      8. TRANSLATION

      Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section @@ -17032,12 +16279,10 @@ NAME="gfdl-8" >



      9. TERMINATION

      9. TERMINATION

      You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any @@ -17050,12 +16295,10 @@ NAME="gfdl-9" >



      10. FUTURE REVISIONS OF THIS LICENSE

      10. FUTURE REVISIONS OF THIS LICENSE

      The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. @@ -17079,20 +16322,16 @@ TARGET="_top" >



      How to use this License for your documents

      How to use this License for your documents

      To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:

      Copyright (c) YEAR YOUR NAME. @@ -17122,17 +16361,13 @@ CLASS="BLOCKQUOTE" CLASS="GLOSSARY" >

      Glossary

      Glossary

      0-9, high ascii

      0-9, high ascii

      A

      A

      B

      B

      Component

      CPAN

      D

      D

      I

      I
      Infinite Loop

      M

      M

      P

      P

      Example 1. A Sample Product

      Q

      Q

      R

      R
      Recursion

      S

      S

      T

      T
      Target Milestone

      Z

      Z
      Zarro Boogs Found

      +> \ No newline at end of file diff --git a/docs/html/about.html b/docs/html/about.html index ecab1b62f..739bea103 100644 --- a/docs/html/about.html +++ b/docs/html/about.html @@ -4,7 +4,7 @@ >About This Guide
    Prev

    Chapter 1. About This Guide

    Chapter 1. About This Guide
    Next
    PrevPurpose and Scope of this Guide
    HomeNext
    Prev

    1.1. Purpose and Scope of this Guide

    1.1. Purpose and Scope of this Guide

    This document was started on September 17, 2000 by Matthew P. Barnson after a great deal of procrastination updating the @@ -111,9 +112,9 @@ NAME="aboutthisguide" > Newer revisions of the Bugzilla Guide follow the numbering conventions of the main-tree Bugzilla releases, available at http://www.mozilla.org/projects/bugzillahttp://www.bugzilla.org/. Intermediate releases will have a minor revision number following a period. The current version of Bugzilla, as of this writing (August 10, 2001) is 2.14; if @@ -142,6 +143,7 @@ CLASS="NAVFOOTER" >


    Next
    PrevUp
    HomeNext
    Administering Bugzilla