Invoking the GNATS tools

The following programs comprise GNATS:

User Utilities

These tools are used by the maintainers of a body of work (send-pr is also used by the end users of the product).

send-pr

Used by anyone who has a problem with a body of work to submit a report of the problem to the maintainers of that work (see section Submitting Problem Reports).

query-pr

Used by software maintainers to query the GNATS database (see section Querying the database).

edit-pr

Used by software maintainers to edit Problem Reports (to record new data, to change the responsible party, etc.) (see section Editing existing Problem Reports).

view-pr

Used by software maintainers to view individual Problem Reports using Emacs (see section Viewing individual Problem Reports).

Administrative Utilities

These tools are used by the GNATS administrator; see also section GNATS Administration. For complete explanations of these utilities, see section Administrative utilities.

mkcat

Creates new categories (see section Adding a problem category).

rmcat

Removes existing categories (see section Removing a problem category).

gen-index

Generates an up-to-date copy of the index used by query-pr and edit-pr (see section The index file). Use gen-index to rebuild the index if it becomes corrupted, or if you need a copy of the current index for some reason (see section Regenerating the index).

mkdist

Creates a distribution of the program send-pr for offsite submitters of PRs (see section Configuring send-pr for the outside world).

Internal Utilities

These tools are used internally by GNATS. You should not need to run these by hand. For complete explanations of these utilities, see section Internal utilities.

queue-pr

Handles incoming bugs, first through a mail alias by queueing incoming PRs as they arrive, and second as a periodic transfer agent between the queue and the database.

file-pr

Files Problem Reports as they come in.

at-pr

Sends reminders to maintainers based on quoted response times.

pr-edit

Used by edit-pr to error-check and submit edited Problem Reports (also see section Editing existing Problem Reports).

pr-addr

Used by the edit-pr script to retrieve correct addresses from the `responsible' file.

See section Where GNATS lives.

Go to the first, previous, next, last section, table of contents.