Table of Contents

1. Introducing GNATS

1.1 The database paradigm
1.2 Flowchart of GNATS activities
1.3 States of Problem Reports
1.4 Problem Report format

1.4.1 Mail header fields
1.4.2 Problem Report fields

2. Invoking the GNATS tools

2.1 Submitting Problem Reports

2.1.1 Creating new Problem Reports
2.1.2 Using send-pr from within Emacs
2.1.3 Invoking send-pr from the shell
2.1.4 Submitting a Problem Report via direct e-mail
2.1.5 Helpful hints

2.2 Editing existing Problem Reports

2.2.1 Using edit-pr from within Emacs
2.2.2 Invoking edit-pr from the shell

2.3 Querying the database

2.3.1 Invoking query-pr
2.3.2 Example queries
2.3.3 Reporting on groups of Problem Reports

2.4 Viewing individual Problem Reports

3. GNATS Administration

3.1 Managing GNATS over a network
3.2 Changing your local configuration

3.2.1 Default behavior
3.2.2 The config file
3.2.3 The categories file
3.2.4 The responsible file
3.2.5 The submitters file
3.2.6 The states file
3.2.7 The addresses file

3.3 Administrative data files

3.3.1 The index file
3.3.2 The current file

3.4 Administrative utilities

3.4.1 Adding a problem category
3.4.2 Removing a problem category
3.4.3 Regenerating the index
3.4.4 Configuring send-pr for the outside world

3.5 Internal utilities

3.5.1 Handling incoming traffic
3.5.2 Processing incoming traffic
3.5.3 Timely reminders
3.5.4 The edit-pr driver
3.5.5 Address retrieval

A. Installing GNATS

A.1 Configuring and compiling the software
A.2 Installing the utilities
A.3 Setting up mail aliases
A.4 Installing the daemon
A.5 Installing the user tools
A.6 Upgrading from older versions

B. Where GNATS lives

B.1 prefix
B.2 exec-prefix
B.3 GNATS_ROOT
B.4 Default installation locations

C. Multiple Databases on one host
D. Controlling access to databases
E. Querying using regular expressions
Index