LhTest_readme
===========================================================================
# # # ##### ##### #### #####
# # # # # # #
# ##### # ##### ### #
# # # # # # #
##### # # # ##### #### #
LhTest V1.00
Copyright © 1990 By Stefan Boberg
Original 80x86 LZHuf compression code by Haruyasu Yoshizaki
Amiga/680x0 translation by Stefan Boberg
===========================================================================
INTRODUCTION
LhTest's only purpose is to check an archives (LhArc type) integrity. That
is, to check that a file has been correctly compressed/transmitted. The
syntax is:
LhTest [t] <archive name[.lzh]>
One way to use it is together with the AmiExpress BBS program, to get this
to work with current versions of AmiExpress you'll have to some patching:
Locate where in the file the 'LhArc ' string is (in the main program called
'Express' , change this to 'LhTest'. Then locate where the '-n t ' string is,
then fill this with spaces or change it to ' t ', and you're finished!!
Of course you'll have to place LhTest in your c: directory too!!!
WHY?
LhArc already contains a command to check an archive's integrity, but since
it is so slow I decided to write a stand-alone program to do this. LhTest
is TWICE as fast as LhArc is at testing archives!!!!
If the archive is not Ok, LhTest terminates with a return code of 20, if it
is Ok, the return code is 0.
LhTest is PURE! This means you can make the program resident (WShell
'resi' command, ARP-Shell 'ares' or Commodore's 'resident' command will do
the job)
DISTRIBUTION AND USE
You are free to use, copy and distribute LhTest for noncommercial use if:
1) No fee is charged for use, copying or distribution.
2) This documentation file accompanies the executable.
3) It is not modified in any way.
===========================================================================
DISCLAIMER
The author makes no warranties, either expressed or implied, with
respect to the program described herein. Should the program
prove defective, the user (and not the author), assumes the
entire cost of all damages. In no event will the author be
liable for direct, indirect, incidental or consequential damages
resulting from any defect in the program.
===========================================================================
Finally, if you have any ideas for improvements (or programs), want to send
me a contribution, or find bugs in this or any of my other programs,
contact:
Stefan Boberg
Tynne Björke Phone: Int. +4649854076
62023 Romakloster Nat. 0498-54076
SWEDEN
Or send a message to 'Stefan Boberg' at FidoNet node 2:204/302 .
Read_Me
+------------------------------------------------------------------------+
| This version's extract-routine is about 25% faster than before!!! This |
| means it is more than twice as fast as LhArc 1.10 and about 20% faster |
| than LhUnArc 0.9!!! |
+------------------------------------------------------------------------+
Another new feature is recursive file collection + some cosmetic changes,
read the 'Changes' file for more info.
This is the very last pre-release version, only released because some guys
wanted a faster version. Also included is LhTest, intended for use with
AmiExpress. Read the 'LhTest.doc' file for more info on how to use this.
===========================================================================
# # ### ###
# # # # # ## ### # #
# #### ##### ## # # #####
# # # # # # # # #
##### # # # # # ### # #
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.99d
===========================================================================
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:
SYSTEM REQUIREMENTS
* Arp.library (V33 or higher) must be in the libs: directory
[Note that version 39.1 should be included in this archive].
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, it will probably work differently then).
