buglog - take a log message and attachment data on stdin and log it appropriately
buglog [-B bugsystem] [-n] headline < description
buglog [-B bugsystem] [-n] headline command [args...]
buglog takes a change headline on the command line and a description on its input and logs it to the bug subsystems enumerated by the environment variable $BUGSYSTEMS. $BUGSYSTEMS is a space separated list of subsystems that accept log information.
Deliver reports to the specified bugsystems instead of the default.
No description.
The follow bugsystems are known:
Any bugsystem name may be prefixed with /prefix/ to constrain its use. If the headline does not commence with a string matching the regular expression prefix that bugsystem is skipped. For example, including the bugsystem ``/BORG:/mailto:borglog@b.org'' in your bugsystems will only dispatch buglogs to borglog@b.org if the headline commences with ``BORG:''.
The headline alone is passed to my dlog command.
The description is sent as the body of an email message to the specified email-address with the Subject: line ``prefix: headline''. Also, the header line ``X-Buglog-Date: date'' is included to assist with automatic filtering.
Run command (which may have no whitespace and must name an executable) with the headline as its sole argument and the description on its standard input.
Submit the description
as an enclosure text to any ClearDDTS bug identifiers
(as identified by the ddtsids(1) script)
mentioned in the headline.
For example,
we routinely commit trivial CVS changes with headlines like:
moved user home dir from here to there [CISaa12345]
which would add an enclosure to bug CISaa12345.
Submit the description
as an attachment called ``log.txt'' to any Infra bug identifiers
(as identified by the infraids(1) script)
mentioned in the headline.
For example,
we routinely commit trivial CVS changes with headlines like:
moved user home dir from here to there [infra12345]
which would add an attachment to Infra bug 12345.
Submit the headline alone to syslog using the logger command, thus:
logger -t buglog -- "$USER: $headline"
$BUGSYSTEMS, the list of bug subsystems to notify. Default: ``dlog logger''.
dlog(1cs), logger(1)
Cameron Simpson <cs@zip.com.au> 09jul2004