From: mbs@adastra.cvl.va.us (Michael B. Smith)
Newsgroups: alt.sys.amiga.uucp
Subject: Re: Bugreport logging ... (was: Re: Bug in sendmail)
Distribution: world
X-NewsSoftware: GRn 1.16f (10.11.92) by Mike Schwartz & Michael B. Smith
Date: 15 Oct 92 06:43:26 EDT
Organization: Well, I haven't decided on a name yet...

In article <13Oct1992.015908.16001@hactar.hanse.de> wusel@straylight.uucp (Kai 'wusel' Siering) writes:
>      BTW, is  there a new official KOTS for Amiga UUCP; and if not, at
> least someone willing to act as such? Michael?

Matt's bug report format is quite simple, and a copy of the program he used
is distributed with AmigaUUCP. 'amiuufilter' or some such. I've appended the
man page for it.

I've volunteered to be KOTS, as have at least a couple of others. To the best
of my knowledge Matt never "passed the torch".
--
  //   Michael B. Smith
\X/    mbs@adastra.cvl.va.us  -or-  uunet.uu.net!virginia.edu!adastra!mbs

NAME
        AmiUUFilter

SYNOPSIS
        AmiUUFilter [dummy group]

DESCRIPTION
        AmiUUFilter filters out specially formatted messages and appends
        them to a TODO and STAT file in the UUCP: directory.

        If run without arguments, AmiUUFilter scans stdin, thus useful
        as part of a mail alias like this:

dillon: \dillon, >uu:mail/mbox, |amiuufilter

        Which extracts ##B and ##E bug reports from my personal mail.
        AmiUUFilter may also be used to automatically extract specially
        formatted reports from NETNEWS.  This is done by making a dummy
        UULIB:Sys file entry:

-------- UULIB:Sys ---------
uuscan:alt.sys.amiga.*
----------------------------

        Which causes RNEWS to add entries to the UUSPOOL:BATCH/UUSCAN
        file for the selected newsgroups.  Since this node does not
        exist in your L.sys file, it will never be processed into queue
        files.

        Instead, you want to run 'AmiUUFilter uuscan' every once in a
        while, usually via DCRON as in this example:

--------- S:CRONTAB --------
8  3 * * *     uucp:c/amiuufilter uuscan
----------------------------

        Doing so will cause AmiUUFilter to scan UUSPOOL:BATCH/UUSCAN
        and then scan all the specified articles, deleting the uuscan
        file when it is through.

SCAN EXTRACTION FORMAT

        AmiUUFilter searches for ##<c> lines and extracts any data between
        them, the final message should be terminated with ## alone.  The
        ##'s must be flush with the left margin.  Here is an example (##'s
        not flush w/ the left margin on purpose):

        ##B dillon.bug23

        Hello, I have found a bug in uucico ...

        ##B dillon.bug24

        I have found another bug in sendmail ...

        ##


TODO AND STAT FILE FORMATS

        The TODO file format to which extracted information is appended
        is in the following format:

        ##<c> <bug-id>
        %T <date>
        %F From: <poster>
        %S <status>

        Other control information may be added in the future.  As you can
        see, AmiUUFilter will automatically scan the From: field and
        will also append the current date to the entry, making it easy
        to determine when something came in.  The %S entry is set to
        'NEW', and normally modified by you to whatever you like --
        I use it as a comment to what I intend to do with the bug report
        in question.

CURRENTLY DEFINED CONTROLS

        ##B <unique-id>             specifies a BUG REPORT
        ##E <unique-id>             specifies an ENHANCEMENT request
        ##S uucp:src/.../file       specifies a SOURCE CODE UPDATE

REFERENCES
        Aliases
        Sys