===========================================================================

                    #     #      ###              ###
                    #     #     #   # # ##   ### #   #
                    #     ####  ##### ##  # #    #####
                    #     #   # #   # #     #    #   #
                    ##### #   # #   # #      ### #   #

    A high performance Data compression utility for the Commodore Amiga
        Amiga user interface and compression code by Stefan Boberg
              Original 80x86 LZHuf code by Haruyasu Yoshizaki

                             PRE-RELEASE V0.99

===========================================================================

Ok,  so  here it is, the fully Intuitionized, FAST!  LhArc compression tool
for  the  Commodore  Amiga,  this  is only a pre-release so there's no real
documentation  yet.  It is 100% compatible with LhArc version 1.13c (MSDOS)
and  Amiga  LhArc  (The Italian CLI version), only it is more than twice as
fast  !!!  I hope you will understand how to use it anyway, but here's some
tips to get you going:

EXTRACTING

If  you  want to extract files from an existing archive, first select 'Open
Archive'  from  the  Project menu or press Right-Amiga+O or just press 'O'.
Then  select  the  file  from  the  file  requester  by entering the source
directory  in  the  Dir gadget and then click twice on the file you want to
extract from, or enter the file's name in the File gadget and press RETURN.
Then  click  on  the  files  you  want  to  extract (clicking once selects,
clicking  a  second  time  deselects again), or use the 'Mark all', 'UnMark
all'  and  'Mark...'  gadgets.  The 'Mark...' gadgets allow you to enter an
ARP-pattern mask to select certain files.  (For example.  '*.c' will select
all files ending in '.c' and 'a*z' will select all files that begin with an
'a'  and  end  with  a  'z',  detailed explanations of the pattern matching
functions  will  be  in  the  final  documentation).   When you have marked
(highlighted) all files you want to extract, click on the 'Extract' gadget.
Now  you will be asked where to put the extracted files, select a directory
and  click on the 'OK' gadget.  Now LhArcA will extract your files!  If you
want  LhArcA to consider extended filenames, select 'Extended filenames' in
the Settings menu.

CREATING AN ARCHIVE

When  you want to create a new archive, select 'New archive' in the Project
menu,  then  enter  the  destination directory and archive name.  NOTE:  In
this  pre-release  you  must  append  '.lzh'  after the filename, otherwise
LhArcA  cannot  open  it  for  extraction!  This will be fixed in the final
release.   Then  do  just  like  you  do  when you add files to an existing
archive.  (Described below).

ADDING FILES TO AN EXISTING ARCHIVE

This  is  easy, first open the archive as when extracting (see above), then
click  on the 'Add files' gadget and then select the files you like to add.
You  can  select  as  many files as you like and in as many directories you
like.   If  you want pathnames to be stored, select 'Extended filenames' in
the Settings menu and then set 'Home directory' to the part of the pathname
that  should  not be stored.  (Not enough space to describe this here, wait
for the final version)

ADDITIONAL NOTES

The final version (this is the only pre-release I intend to release), there
will  be  all the features found in other archivers (including PkAZip), and
more.   LhArcA  is  FASTER  than  PkAZip!!!   (About  15%),  and  also more
effective.   To  make  it  even  faster  I  am  working  on some new search
algorithms  which  will  (hopefully) be finished until the final release!!!
Also  in  the  final  release  there  will  be the option to issue archiver
commands  directly  from the CLI command line (as Zoo, Arc, LhArc etc.), my
intention is to make a program everybody can use, both novices and experts.
(Though  this  version  may be a little hard to understand, I will add some
online  help  stuff  in  the  final  version).  Also it will be possible to
create SFX-archives (self-extracting archives), and more....

Anyway,  if  you  have any ideas for improvements, or find any bugs (I have
sorted  out most of them now, there are (I hope) no serious bugs left, just
some  things  that  need  to be more polished).  Anyway hope you like this,
because  it  took  be  two months to get this far!!  If you like it, PLEASE
consider  sending  me  a  contribution, look in the About...  text for more
details.



SYSTEM REQUIREMENTS:

You'll need:

* Arp.library (Version 39.1 is included in this archive).
* An Amiga with at least 512K of RAM.
* You must have ASSIGNed 't:' somewhere. (Preferably to RAM:, to do this,
  enter the command 'ASSIGN t: ram:' before running LhArcA.

INSTALLING

To install LhArcA, extract the files from this archive, then execute the
following commands from CLI:

copy Arp.library to libs:
delete Arp.library

This will move the Arp.library to where it should be.
