LHUNARC 0.96
                                 31st March, 1990

                         Fast .LZH extractor for the Amiga

                            Written by Jonathan Forbes

   Disclaimer

   I am in no way responsible for anything this program does; you are using it
entirely at your own risk, so if servile tadpoles from Vega wreak havoc in
your neighbourhood, the human race is wiped out, the universe suddenly
explodes, or some other such inconvenience occurs, don't blame me!

   If Lhunarc does have a small bug or two, it will show up as a CRC error
when you decompress a file.  If you get a CRC error, use LHARC to decompress
the file.  If LHARC *doesn't* gives you a CRC error, then you've probably
discovered a bug, and I'd be grateful if you'd inform me of this as soon as
is humanly possible.


   What is Lhunarc?

   Lhunarc is a lightning fast file extractor for LHARC archives (files with an
extension of .LZH.)  It is compatible with MS-DOS version 1.13c, and is two and
a half times as fast as Amiga Lharc 1.1, as you will soon discover.

   Lhunarc features some incredibly optimised assembly language, enabling it
to burn through any .LZH archive at high speed.  This sucker really cooks!


   Usage: LHUNARC [V] <Archive> [File...]


1) To extract all files from 'BLAH.LZH', type:
        Lhunarc BLAH.LZH
   - or -
        Lhunarc BLAH


2) To extract the files 'HELLO' and 'WORLD' from 'BLAH.LZH', type:
        Lhunarc BLAH.LZH HELLO WORLD


3) Wildcards are allowed, so the following line will cause Lhunarc to extract
   all files beginning with "Glug":
        Lhunarc Glug#?


   Directories will automatically be created if they are required.  If a file
which Lhunarc wishes to extract, already exists, you will be prompted with:

   "File exists - overwrite? (Yes/No/All/Quit):"

   Entering "Y" will overwrite the file, while entering "N" will skip the file.
Entering "A" will overwrite all files automatically from there onwards, and "Q"
will abort Lhunarc immediately.

   Lhunarc will also permit you to view the contents of archives.  Simply enter
a "V" before you enter the name(s) of the file(s) you wish to view.  For
example, the following command will view the contents of WHATEVER.LZH:

        Lhunarc V WHATEVER

   For a very brief and useless help screen, type:

        Lhunarc H


   Acknowledgements

   The original LHARC (MS-DOS) was written by Haruyasu Yoshizaki.  I used his
freely distributable source code "lzhuf.c" and "lharc.c", and ported "lzhuf.c"
to assembly language.

   I used Amiga Lharc 1.1, ported by Paolo Zibetti, for testing purposes.


   This Program

   Lhunarc is a freely distributable, copyrighted piece of software.  You do
not have to pay money to use it, and may upload it wherever you choose, but
you are not allowed to sell Lhunarc for profit, or include Lhunarc on a disk
which is sold for profit, without the author's (Jonathan Forbes) permission.

   I can be contacted at Canada Remote Systems as "Jonathan Forbes" (isn't
that better than some twenty digit ID code?)

   My BBS (416-921-6638) is currently down, pending completion of Xenolink,
a full featured FidoNet-compatible BBS program for the Amiga, which I have
almost finished.


   Closing Notes

   When I ported the decompression routines back into Lhwarp, disks
decompressed *at least* twice as fast as they did before.  A typical disk now
takes about 5 and a half minutes to decompress.  I'll have an update shortly.