.TH AUB 1
.SH NAME
aub \- assemble usenet binaries
.SH SYNOPSIS
.B aub
[ 
.B \-\fIc\fP
] [ 
.B \-\fIn\fP
] [ 
.B \-\fId\fPN
] [ 
.B \-\fIm\fP
] [
.B \-\fIM\fP
] [ 
.B \-\fIC\fP
]
.SH DESCRIPTION
.I aub 
accesses news either remotely via the NNTP protocol or locally, 
by scanning a news spool directory,
and searches for new pieces of split, encoded
binaries that have recently been received.  Binaries are expected to contain 
subject lines conformant with de-facto usenet standards; aub may not be able 
to identify pieces of binaries which are not named according to accepted 
conventional practice.  If new binaries are found, 
.I aub
retrieves, organizes and decodes them, leaving the decoded files in a 
configurable location.
.PP
A configuration file, $HOME/.aubconf, is required.  Invoke 
.I aub
with the
.B \-\fIM\fP
flag to learn about the structure of 
configuration files.  This will also present a full discussion of 
.I aub
and its capabilities.
.PP
.I aub
understands the following options, all of which are discussed in detail 
in the internal documentation:
.TP
.B \-\fIc\fP
Catch-up mode; binaries are processed but not assembled.
.TP
.B \-\fIn\fP
No-checkpoint mode; the user's .aubrc file is not modified.
.TP
.B \-\fId\fPN
Specifies the debug level that 
.I aub
is to run at.
.TP
.B \-\fIm\fP
Prints a summary of the manual.
.TP
.B \-\fIM\fP
Prints the manual.
.TP
.B \-\fIC\fP
Lists changes since the last version of 
.I aub.
.SH ENVIRONMENT
.ta 2.25i
.br
AUBDIR				Default location for decoded binaries
.br
AUBDESC				Default location for description file
.br
AUBHOOK				Default hook program
.br
NNTPSERVER			Potential NNTP server
.br
HOME				Home directory
.SH FILES
.ta 2.25i
.br
 ~/.aubconf			Configuration file
.br
 ~/.aubrc			Historical data maintained by aub
.br
 /usr/local/bin/perl		Source interpreter
.SH AUTHOR
Mark Stantz
.SH DIAGNOSTICS
Diagnostic messages are intended to be self-explanatory.
.SH "SEE ALSO"
news(1),
perl(1),
"The Introducing Aub Document"
.SH BUGS
The man page is skimpy and essentially defers all explanation to 
the auxiliary documentation.
.PP
.B \-\fId\fP0 
does not override the DEBUG keyword in the configuration file.