LHA for Macintosh Version 2.22

1. Usage
1. How to launch the application
There are three ways to launch the application "MacLHA 2.22"
A. Launching the application
Double-click the icon of MacLHA 2.22. Then it's invoked.
B. Launching from its document
Double-click the icon of MacLHA document, which shows an elephant
tread on a floppy disk. In this case, the archive file is selected
by application automatically, so you may skip to section 3, Archive
operations.
When you are pushing shift key while the application is launching,
MacLHA starts defreezing the archive file automatically.
C. Launching by Drag-and-Drop its document or folder
Put the icon of MacLHA document into the icon of MacLHA 2.22.
Then it's invoked. In this case, the archive file is selected
by application automatically, so you may skip to section 3A,
freezing.
When you are pushing shift key (without pushing any key if 7.1.H is
on) while the application is launching, MacLHA starts defreezing
the archive file automatically.
Put the icon of document into the icon of MacLHA 2.22.
Then it's invoked. In this case, the files are added into the target
archive by application automatically, so you may skip to section 3B,
defreezing.
When you are pushing shift key while the application is launching,
MacLHA starts freezing the files automatically.

2. How to select archive file
A. To create new archive file
Select "NewArchive" of "File" menu. Then there opens an empty
archive list, named as 'NewArchive.lzh'.
B. To open existing archive file
Select "OpenArchive" of "File" menu. The Open-Dialog comes up, so
double-click appropriate archive, or select an archive and
select "open".

3. Archive operations
A. Defreezing from archive (restore archived files)
There appears a list of archived files. Please select file-names
that you want to defreeze (or to restore).
To select target files, what you have to do is only click
the file-name that you want to defreeze. As you know, You can
select continuous list or multiple files by holding down shift key
while you are clicking.
After finishing file selection, click "extract" button, then LHA
starts defreezing. Cursor turns from arrow to beach ball, and
there appears Save-dialog. Input file-name and push return key,
or click the "Save" button, you get one restored file.
If you click the "Save All" button, LHA defreezes all of files
after it. The bar graph, showing the status of defreezing,
will grow to rightward, and when it reaches to the right end and
the Alert Sound rings, all defreezings are finished.
While defreezing, you may stop defreezing by clicking the "Cancel"
button of status window.
When there is a file whose name is same in the folder, there appears
a dialog to ask how to defreeze. Select "Smart Replace", and replace
only older files by defreezing files. Select "Replace", and replace all
files by defreezing files. Select "Query", and there appears Save-Dialog.
Select "Cancel", stop defreezing.

If the file is not freezed using MacBinary, MacLHA decides type and
creator of the file by extension mapping that is the feature of
Internet Config.

B. Freezing to archive (compress files and archive)
When the file list window of selected archive is open, click "add"
button. And a select file to be compressed in the Open Dialog by
double-clicking, or by clicking the "OK" button. To select
more files, repeat this operation as you wish.
After the selection, click the "save" button, the Save Dialog opens.
Choose the folder to create the target archive file, enter its name
and push return key or click the "save" button. The mouse cursor
turns from arrow to beach ball, and LHA starts freezing files.
The bar graph, showing the status of freezing, will grow
to rightward, and when it reaches to the right end and the Alert
Sound rings, all freezings are finished.
While freezing, you may stop freezing by clicking the "Cancel"
button of status window.

C. Deleting archive files
There appears a list of archived files. Please select file-names
that you want to delete. The way of selecting files is the same
as the defreezing. After the selection, click "delete" button,
then the selected file names disappear from the list.
After deleting file names, click the "save" button, the mouse cursor
turns from arrow to beach ball, and LHA starts deleting files from
the archive.
The bar graph, showing the status of deleting, will grow to
rightward, and when it reaches to the right end and the Alert
Sound rings, all deletings are finished.
While freezing, you may stop deleting by clicking the "Cancel"
button of status window.

You can select files both to be frozen and to be deleted
at once, and click the "save" button to save the archive file.

D. validate files
There appears a list of archived files. Please select file-names
that you want to validate.
To select target files, what you have to do is only click
the file-name that you want to validate. As you know, You can
select continuous list or multiple files by holding down shift key
while you are clicking.
After finishing file selection, click "validate" button, then LHA
starts validate. Cursor turns from arrow to beach ball. The bar graph,
showing the status of validating, will grow to rightward, and when it
reaches to the right end. If Alert Sound rings, all selected files are
correct. But, there appears dialog to show error, selected file is
incorrect.

You can select same item of "Command" menu to do above all.

4. Quit MacLHA application
Select "Quit" of "File" menu. LHA will be terminated.

5. Transfer from LHA to another application
Select "Transfer" of "File" menu. There appears the Open Dialog,
and you may select the application by double clicking or by the
combination of selecting file name and clicking the "Open" button.
In case you are using MultiFinder, LHA stays on memory and invokes
the selected application. Using LHA from Finder, LHA quits and
the selected application is invoked.

6. About "View" menu
A. "Show Type"
In the "View" menu, "Show Type" decides the file type stored
in archive file.
If this option is selected, one check button and nine radio buttons
appear at the bottom of a list of archived files. They are divided
into "MacBinary", "Path", "Header", and "Type". When a list of
archived files appears, "MacBinary" is ON, "Path" is partial,
"Header" is level 1, and "Type" is LHA.

A-1. "MacBinary"
Each "MacBinary" file has a 128 byte header at the beginning of it,
and both Data Fork and Resource Fork are stored into archives. Since
there is a header block added at the begging of each file, you have
to care to exchange the file with DOS LHA and others.
"Normal type" does not have any header like "MacBinary", but
it stores only either Data Fork or Resource Fork into archives.
If a file has only either Data Fork or Resource Fork, it's stored
into archives. In case a file has both Data Fork and Resource Fork,
only the Data Fork is stored.

A-2. "Path"
You can select the format of file name in archive files by "Path"
radio button. You can select 3 kind of path, "non path",
"partial path", "full path".
Let's assume a file exists as "/THINK C/Mac Libraries/MacTraps" in
your archive file, for example. You can get the file name "MacTraps"
from your archive, if "non path" is selected. In case "partial path"
or "full path" is selected, you can get
"THINK C/Mac Libraries/MacTraps ".
In the freezing phase, "MacTraps" is stored in your archive, when
"non path" is specified. By "partial path" option, if you select
the file directly, "MacTraps" is stored. If you select a folder
"THINK C", "THINK C/Mac Libraries/MacTraps" is stored in your
archive file. In case "full path" is specified, the file is stored
as full path name like "/THINK C/Mac Libraries/MacTraps".

A-3. "Header"
"Header" decides the format of file information stored in archives.
You can choose "level 0", "level 1" or "level 2" of "Header" radio
button. When the "Type" menu is set to "LHarc", "level 0" is
specified by force.

A-4. "Type"
"Type" decides the format of file information stored in archives.
In the "Type" radio button , you can select one of three types,
"LHarc", "LHA", or "none". "LHarc" selects -lh1- as its compress
method. "LHA" selects -lh4-, -lh5-. No compression is done by
"none".
When LHA defreezes, "type" specification does not limit compression
method of defreezing files.

B. "Folder Info. visible"
In the format of file information stored in archives, there is
special format (-lhd-) which indicates about folder. If this option
is off, the format does not appear in a list of archived files.
When LHA starts, the format does not appear in it.

7. About "Miscs" menu
7-1 "Set Preference"
In this menu, the following items are set. When the setting is finished
with "Ok" button, the current setting is enable. When the setting is
finished with "Cancel" button, the former setting is enable.

C. "BackGround On"
"BackGround On" is available only under MultiFinder. When LHA starts
under MultiFinder, first this option is off.
If this option is selected, while both freezing and defreezing,
you may bring other application as a foreground job, and let LHA
work as a background job. But the execution speed becomes slightly
slower.
When this option is off, LHA cannot run as a background job of
other application. But in this case, the performance becomes
faster.

D. "No beep when finished"
If this option is on, the beep does not let you finish freezing or
defreezing.
First, the beep lets you do so.

E. "CR/LF -> CR convert"
If this option is on, file is converted LF or CR+LF into CR.
First, the option is off.

F. "Default button "Save All" in save dialog"
If this option is on, default button in the Save-dialog is changed
"Save" into "Save all" when defreezing.
First, the option is off.

G. "Delete original archive when drag&drop"
If this option is on, archived files are deleted after defreezing
files with drag-and-drop.
First, the option is off.

H. "Extract automatically when drag&drop"
If this option is on, extract files without pushing any key
at drag-and-drop.
First, the option is off.

I. "Use Japanese message"
If this option is on, all message is shown in Japanese.
First, the option is off.

J. "Extract To Folder"
This option specifies the folder where archived files are defreezed
into.
If "Select" button in the dialog is clicked, select appropriate folder
or "open", and select "Done".
First, the convert is off.

7-2 "Save Preference"
When this menu is selected, option A , C - H are stored
into preference file. Next time MacLHA is invoked,
these settings are available.

2. Compatibility
MacLHA has the compatibilities with LHA, LHarc or LArc for each
system.
But if an archive file created by LHarc for other systems has sub
directories in it, sometimes MacLHA cannot defreeze it correctly.

3. Changes from former versions
From 2.21 to 2.22
Enable to defreeze the archive files with -lh7-.
From 2.20 to 2.21
Fix some messages is not translated in Japanese.
From 2.14 to 2.20
This appilcation is FAT binary now.
Support extension mapping that is the feature of Internet Config.
Support Japanese messages.
Fix problems when Cancel is selected at file extract.
Fix memory leaks at Drag&Drop.
Fix bugs related to extract -lh6- files.
Fix generating incorrect level 2 header.

4. Warnings any restrictions
When the archive file that has level2 header frozen by MacLHA 2.14
or earlier is defreezed, the date information is not restored correctly.
In order to restore it correctly, please defreeze with MacLHA 2.14.
Frozen archive file by MacLHA 2.11 is not correctly stored.
Until LHarc 0.32, defreezing a file which has either Data Fork or
Resource Fork occupies more than 100 KB and which has both Data
Fork, the defreezes file was not correct one. In such cases, the
archive file itself is correctly stored, so please defreeze with
LHarc 0.33 or later, or LHA.
Frozen archive file by LHarc 0.40 (a or b) is not correctly stored,
so please refreeze by other version of LHarc or LHA.
This program works on HFS system only.

5. About distribution
Under following conditions, this software can be distributed or uploaded
freely, and not be restricted.

1. Do NOT modify the copyright notice
2. The contents of original package (both objects and documents) should
be redistributed. If some modifications are made, a documentation
mentioned about the modifications should be included.
3. Distribute the newest version as possible (though no obligation)
4. There's no guarantee about troubles caused by the existence of this
program or by using this program
5. The author will not have any obligations for modifying this program,
if there happens some trouble.
6. Business usage is accepted under following restrictions above all,
a. Selling a package that this program is main, is prohibited.
b. All files in the package that include LHA should not be
protected.
c. Do not distribute if the target customers for the business are
considered as not appropriate for users of this program.
d. Indicate the copyright of this program and this distribution
notice on its package, documents or floppy disk label of
the business.

6. Afterword
This program is written in CodeWarrior 12.
Thanks for Haruhiko Okumura, who release the LZARI method which
became the base of LZHUF method. Thanks for Kazuhiko Miki, who
introduced it on NiftyServe, and who is the author of LArc.
Thanks for Haruyasu Yoshizaki,
who release the LZHUF method, and the author of LHarc/LHA.
Thanks for many people who gave me advice and bug reports under
developing this program.
On this program, ASLfont+ is available. Thanks for hiroo@mix.or.jp,
for granting permission for using it on this program.

7. Network address of author
Internet: k_ishi@tka.att.ne.jp
HomePage: http://www.vector.co.jp/authors/VA008909/

8. English documentation by Takaaki Higuchi
Nikkei MIX: galshy@mix.or.jp
Internet: Takaaki.Higuchi@sun.co.jp

Original file name: MacLHAE.doc - converted on Thursday, 3 February 2000, 00:12