----------------------------------------------------------------------------
 aub - Assemble Usenet Binaries

 Original Author:
  Mark Stantz		[1992] [Nov2001: no valid email addresses known]

 Updates:
  2.0.5 to 2.0.10	[1998] blong@fiction.net	Brandon Long
  2.1			[2001] avinash@acm.org		Avinash Chopde
  2.1.1+                [2002] mako@debian.org          Mako Hill
----------------------------------------------------------------------------

REQUIREMENTS
------------------------

* >= Perl 5.6
* access to an NNTP news server or a local news spool

People have reported running aub on Linux, various other flavors of
UN*X, Windows NT, and similar operations systems. aub should run
anywhere Perl does.


INSTALLATION INSTRUCTIONS (Debian GNU/Linux)
------------------------

  1) Simply download and install the deb file. It can be downloaded
     from the Debian archive with the famous apt-get program or
     downloaded directly from the AUB homepage linked at the bottom of
     this file.


INSTALLATION INSTRUCTIONS (OTHER UN*X)
------------------------

  1) Make sure aub is executable; copy it to some directory in your
     $PATH:
      % chmod a+x aub
      % cp aub <directory in $PATH>
  2) Create an ".aubconf" file in your $HOME directory.
     (see aubconf.example or aub docs for details)


INSTALLATION INSTRUCTIONS (WIN32)
------------------------

  1) You might want to open up aub in a text editor and edit lines
     near the top. aub's default behavior is very UN*Xy but the
     methods for having it run in a much more windows type of mode is
     clearly marked in the source. If you want, you should edit aub at
     this step paying special attention to the default values for
     $AUBHOME, etc).
  2) Copy the "aub" file to some directory in your $PATH, make it
     executable.
  3) Create the $AUBHOME directory (default: ~/aub or c:/aub)
  4) Create a "aubconf" file in $AUBHOME.
     (see aubconf.example or aub docs for details)


DOCUMENTATION
------------------------

AUB documentation has historically been retrieved by running 'aub -m'
or 'aub -M'. This behavior has been left in tact but it also now
distributed more standard methods.

Documentation included in this release can be found in the following
locations:
 * Introducing_AUB - the Introducing AUB document (also retrievable
   with aub -M)
 * USAGE - command and configuration options (also retrievable with
   aub -m)
 * aub's manpage (in man, html, and source DocBook sgml format)
 * aubconf's manpage (in man, html, and source DocBook sgml format)


----------------------------------------------------------------------------
AUB HOME: http://yukidoke.org/~mako/projects/aub/

Mako Hill
mako@debian.org
http://people.debian.org/~mako/

