SplitIndex.doc 
==============

Disclaimer:
-----------

This program and it's source is fully public domain - do what you like with
it, but remember:  if you use the program and your computer explodes, you
get invaded by martians, or any other unpleasant occurance befalls you,
it's not my fault! :)  It seems to run properly, but...  (everyone repeat
the mantra) "I use PD software at my own risk..."


What Does It Do?
----------------

The program takes an aminet index file and splits it into several
sub-indexes by aminet directory, i.e.  from your INDEX file, you create
list.biz, list.comm, ...  list.util.  etc...  This is usefull for those of
us without enough memory to have the whole index in a text reader at once.

This program was based on an AREXX script by Andreas Arleving which did
exactly the same thing - So why did I make SplitIndex????  Two reasons:

(1) Running Andreas's script took 1 hour and 40 minutes on my rather humble
68000 based 2000 - SplitIndex (being written in C) did it in about 4
minutes.
 
(2) I'm only just getting to grips with C on the Amiga, so I thought it
would be a good project to get some practice with.


Usage:
------

SplitIndex is CLI only - if it is run from WB, it will do nothing.  Command
format is:

SplitIndex <INDEXFILE> <OUTFILE>

Where <INDEXFILE> is the name of the aminet index to split and <OUTFILE> is
the prefix for the sub indexes to be created, eg:

SplitIndex INDEX output/List


Personal Notes:
---------------

* Thanks to Andreas Arleving for releasing his AREXX script to Aminet - my
program is based largely on his script.

* This is my first release to Aminet, so any comments, criticisms and bug
reports would be very much appreciated.

email:          peter.ashford@stonebow.otago.ac.nz
snail mail:     4 Muri St, Aramoana, Dunedin, New Zealand.
