csbug - a simple bug tracking system
csbug [-b bugnum] [-d bugrootdir] op [op-args...]
csbug is a simple bug system.
Specify the bug to which the operation op is to be applied. The environment variable $CSBUG_BUGNUM contains the default bug number.
Specify the root directory of the bug data. The default may be controlled by the $CSBUG_ROOT environment variable, which in turn defaults to $HOME/var/bugs.
The following operations are supported.
Attach the named files or URLs to the bug.
Add or delete bug numbers of bugs this bug waits on. Use GET CHILDREN to obtain the current list.
Duplicate a bug. Print the number of the new bug.
Add the mail item on stdandard input to the bug as a comment.
Print the value of the supplied field on the standard output. The following field names are special:
Print the full pathname of the bug.
Print other bugs that this bug depends upon. This requires the sqlite package: http://freshmeat.net/projects/sqlite/
Print the full pathname to each comment file.
Print the number of comments.
Print comment number n. Comments count from 1.
Print the defined fields and their values.
Print the list of other bugs waiting on this bug.
Emit HTML markup for various bug sections on the standard output. If no sections are specified, the following are printed: hacker COMMENTS ATTACHMENTS. Lower case sections are field names. The following special sections are supported:
The full listing of comment #n.
The Subject: lines of the comments to the bug.
The attachments to the bug.
List all bug numbers.
Create a new bug with the specified headline. Print:
bugnum
on the standard output, where bugnum is the bug number of the new bug.
Add or delete bug numbers of bugs waiting on this bug. Use GET PARENTS to obtain the current list.
Print the root directory of the bug database.
Set the value of the specified field to the specified value.
Perform an SQL query on the bug database. This requires the sqlite package: http://freshmeat.net/projects/sqlite/
$CSBUG_ROOT, the root directory of the bug data. Default: $HOME/var/bugs
CSBUG_BUGNUM, the default bug number for per-bug operations.
$TMPDIR, where temporary files reside. Default: /tmp
sqlite(1)
Cameron Simpson <cs@zip.com.au> 28jun2005