
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


