home *** CD-ROM | disk | FTP | other *** search
/ Fractal Frenzy 1 / WalnutCreekFractalFrenzy-1.iso / pc / macutils / maclha_2_13 / maclhae.doc < prev   
Text File  |  1994-01-24  |  14KB  |  270 lines
  1. -------------------------------------------------------------------------
  2.                 LHA for Macintosh Version 2.13
  3.         Copyright (C) 1989-1994 Kazuaki Ishizaki
  4. -------------------------------------------------------------------------
  5.  
  6. 1. Usage
  7.   1. How to launch the application
  8.      There are three ways to launch the application "MacLHA 2.13"
  9.     A. Launching the application
  10.         Double-click the icon of MacLHA 2.13. Then it's invoked.
  11.     B. Launching from its document
  12.         Double-click the icon of MacLHA document, which shows an elephant
  13.         pressing a floppy disk. In this case, the archive file is selected
  14.         by application automatically, so you may skip to section 3, Archive
  15.         operations.
  16.         When you are pushing shift key while the application is launching,
  17.         MacLHA starts defreezing the archive file automatically.
  18.     C. Launching by Drag-and-Drop its document or folder
  19.         Put the icon of MacLHA document into the icon of MacLHA 2.13.
  20.         Then it's invoked. In this case, the archive file is selected
  21.         by application automatically, so you may skip to section 3, Archive
  22.         operations.
  23.         When you are pushing shift key while the application is launching,
  24.         MacLHA starts defreezing the archive file automatically.
  25.  
  26.   2. How to select archive file
  27.     A. To create new archive file
  28.         Select "NewArchive" of "File" menu. Then there opens an empty
  29.         archive list, named as 'NewArchive.lzh'.
  30.     B. To open existing archive file
  31.         Select "OpenArchive" of "File" menu. The Open-Dialog comes up, so
  32.         double-click appropriate archive, or select an archive and
  33.         select "open".
  34.  
  35.   3. Archive operations
  36.     A. Defreezing from archive (restore archived files)
  37.         There appears a list of archived files. Please select file-names
  38.         that you want to defreeze (or to restore). 
  39.         To select target files, what you have to do is only click
  40.         the file-name that you want to defreeze. As you know, You can
  41.         select continuous list or multiple files by holding down shift key
  42.         while you are clicking.
  43.         After finishing file selection, click "extract" button, then LHA
  44.         starts defreezing. Cursor turns from arrow to beach ball, and
  45.         there appears Save-dialog. Input file-name and push return key,
  46.         or click the "Save" button, you get one restored file.
  47.         If you click the "Save All" button, LHA defreezes all of files
  48.         after it. Clicking the "Done" button skips the current file
  49.         to the next file. The bar graph, showing the status of defreezing,
  50.         will grow to rightward, and when it reaches to the right end and
  51.         the Alert Sound rings, all defreezings are finished.
  52.         While defreezing, you may stop defreezing by clicking the "Cancel"
  53.         button of status window.
  54.         When there is a file whose name is same in the folder, there appears
  55.         a dialog to ask how to defreeze. Select "Smart Replace", and replace
  56.         only older files by defreezing files. Select "Replace", and replace all 
  57.         files by defreezing files. Select "Query", and there appears Save-Dialog.
  58.         Select "Cancel", stop defreezing.
  59.         
  60.     B. Freezing to archive (compress files and archive)
  61.         When the file list window of selected archive is open, click "add"
  62.         button. And a select file to be compressed in the Open Dialog by
  63.         double-clicking, or by clicking the "OK" button. To select
  64.         more files, repeat this operation as you wish.
  65.         After the selection, click the "save" button, the Save Dialog opens.
  66.         Choose the folder to create the target archive file, enter its name
  67.         and push return key or click the "save" button. The mouse cursor
  68.         turns from arrow to beach ball, and LHA starts freezing files.
  69.         The bar graph, showing the status of freezing, will grow
  70.         to rightward, and when it reaches to the right end and the Alert
  71.         Sound rings, all freezings are finished.
  72.         While freezing, you may stop freezing by clicking the "Cancel"
  73.         button of status window.
  74.         
  75.     C. Deleting archive files
  76.         There appears a list of archived files. Please select file-names
  77.         that you want to delete. The way of selecting files is the same
  78.         as the defreezing. After the selection, click "delete" button,
  79.         then the selected file names disappear from the list.
  80.         After deleting file names, click the "save" button, the mouse cursor
  81.         turns from arrow to beach ball, and LHA starts deleting files from
  82.         the archive.
  83.         The bar graph, showing the status of deleting, will grow to
  84.         rightward, and when it reaches to the right end and the Alert
  85.         Sound rings, all deletings are finished.
  86.         While freezing, you may stop deleting by clicking the "Cancel"
  87.         button of status window.
  88.         
  89.      You can select files both to be frozen and to be deleted
  90.     at once, and click the "save" button to save the archive file.
  91.  
  92.    D. validate files
  93.         There appears a list of archived files. Please select file-names
  94.         that you want to validate. 
  95.         To select target files, what you have to do is only click
  96.         the file-name that you want to validate. As you know, You can
  97.         select continuous list or multiple files by holding down shift key
  98.         while you are clicking.
  99.         After finishing file selection, click "validate" button, then LHA
  100.         starts validate. Cursor turns from arrow to beach ball. The bar graph, 
  101.         showing the status of validating, will grow to rightward, and when it
  102.         reaches to the right end. If Alert Sound rings, all selected files are
  103.         correct. But, there appears dialog to show error, selected file is
  104.         incorrect.
  105.  
  106.     You can select same item of "Command" menu to do above all.
  107.  
  108.   4. Quit MacLHA application
  109.         Select "Quit" of "File" menu. LHA will be terminated.
  110.  
  111.   5. Transfer from LHA to another application
  112.         Select "Transfer" of "File" menu. There appears the Open Dialog,
  113.         and you may select the application by double clicking or by the
  114.         combination of selecting file name and clicking the "Open" button.
  115.         In case you are using MultiFinder, LHA stays on memory and invokes
  116.         the selected application. Using LHA from Finder, LHA quits and
  117.         the selected application is invoked.
  118.  
  119.   6. About "Options" menu
  120.     A. "BackGround On"
  121.         In the "Options" menu, "BackGround On" is available only under
  122.         MultiFinder. When LHA starts under MultiFinder, first this option
  123.         is off.
  124.         If this option is selected, while both freezing and defreezing,
  125.         you may bring other application as a foreground job, and let LHA
  126.         work as a background job. But the execution speed becomes slightly
  127.         slower.
  128.         When this option is off, LHA cannot run as a background job of
  129.         other application. But in this case, the performance becomes
  130.         faster.
  131.  
  132.     B. "Show Type"
  133.         In the "Options" menu, "Show Type" decides the file type stored
  134.         in archive file. 
  135.         If this option is selected, one check button and nine radio buttons
  136.         appear at the bottom of a list of archived files. They are divided
  137.         into "MacBinary", "Path", "Header", and "Type". When a list of
  138.         archived files appears, "MacBinary" is ON, "Path" is partial,
  139.         "Header" is level 1, and "Type" is LHA.
  140.         
  141.      B-1. "MacBinary"
  142.         Each "MacBinary" file has a 128 byte header at the beginning of it,
  143.         and both Data Fork and Resource Fork are stored into archives. Since
  144.         there is a header block added at the begging of each file, you have
  145.         to care to exchange the file with DOS LHA and others.
  146.         "Normal type" does not have any header like "MacBinary", but
  147.         it stores only either Data Fork or Resource Fork into archives.
  148.         If a file has only either Data Fork or Resource Fork, it's stored
  149.         into archives. In case a file has both Data Fork and Resource Fork,
  150.         only the Data Fork is stored.
  151.         
  152.      B-2. "Path"
  153.         You can select the format of file name in archive files by "Path"
  154.         radio button. You can select 3 kind of path, "non path",
  155.         "partial path", "full path".
  156.         Let's assume a file exists as "/THINK C/Mac Libraries/MacTraps" in
  157.         your archive file, for example. You can get the file name "MacTraps"
  158.         from your archive, if "non path" is selected. In case "partial path"
  159.         or "full path" is selected, you can get
  160.         "THINK C/Mac Libraries/MacTraps ".
  161.         In the freezing phase, "MacTraps" is stored in your archive, when
  162.         "non path" is specified. By "partial path" option, if you select
  163.         the file directly, "MacTraps" is stored. If you select a folder
  164.         "THINK C", "THINK C/Mac Libraries/MacTraps" is stored in your
  165.         archive file. In case "full path" is specified, the file is stored
  166.         as full path name like "/THINK C/Mac Libraries/MacTraps".
  167.  
  168.      B-3. "Header"
  169.         "Header" decides the format of file information stored in archives.
  170.         You can choose "level 0", "level 1" or "level 2" of "Header" radio
  171.         button. When the "Type" menu is set to "LHarc", "level 0" is
  172.         specified by force.
  173.  
  174.      B-4. "Type"
  175.         "Type" decides the format of file information stored in archives.
  176.         In the "Type" radio button , you can select one of three types,
  177.         "LHarc", "LHA", or "none". "LHarc" selects -lh1- as its compress
  178.         method. "LHA" selects -lh4-, -lh5-. No compression is done by
  179.         "none".
  180.         When LHA defreezes, "type" specification does not limit compression
  181.         method of defreezing files.
  182.         
  183.     C. "Folder Info. visible"
  184.         In the format of file information stored in archives, there is 
  185.         special format (-lhd-) which indicates about folder. If this option
  186.         is off, the format does not appear in a list of archived files.
  187.         When LHA starts, the format does not appear in it.
  188.  
  189.     D. "No beep when finished"
  190.         If this option is on, the beep does not let you finish freezing or 
  191.         defreezing.
  192.         When LHA starts, the beep lets you do so.
  193.  
  194.     E. "CR/LF -> CR convert"
  195.         If this option is on,  only non-macbinary file is converted LF or
  196.         CR+LF into CR.
  197.         When LHA starts, the convert is off.
  198.  
  199.     Option A - D are stored into preference file when MacLHA is terminated.
  200.     Next time MacLHA is invoked, these settings are available.
  201.  
  202. 2. Compatibility
  203.         MacLHA has the compatibilities with LHA, LHarc or LArc for each
  204.         system.
  205.         But if an archive file created by LHarc for other systems has sub
  206.         directories in it, sometimes MacLHA cannot defreeze it correctly.
  207.  
  208. 3. Changes from former versions (MacLHA 2.12)
  209.         Fix bugs that occurred system error when drag-and-drop files.
  210.         Recompile the program by Symantec C++.
  211.         Converting LF or CR+LF into CR is enable when the file is
  212.         MacBinary and 'TEXT'.
  213.  
  214. 4. Warnings any restrictions
  215.         Frozen archive file by MacLHA 2.11 is not correctly stored.
  216.         Until LHarc 0.32, defreezing a file which has either Data Fork or
  217.         Resource Fork occupies more than 100 KB and which has both Data
  218.         Fork, the defreezes file was not correct one. In such cases, the
  219.         archive file itself is correctly stored, so please defreeze with
  220.         LHarc 0.33 or later, or LHA.
  221.         Frozen archive file by LHarc 0.40 (a or b) is not correctly stored,
  222.         so please refreeze by other version of LHarc or LHA.
  223.         This program works on HFS system only.
  224.  
  225. 5. About distribution
  226.     Under following conditions, this software can be distributed or uploaded
  227.     freely, and not be restricted.
  228.  
  229.     1.  Do NOT modify the copyright notice
  230.     2.  The contents of original package (both objects and documents) should
  231.         be redistributed. If some modifications are made, a documentation
  232.         mentioned about the modifications should be included.
  233.     3.  Distribute the newest version as possible (though no obligation)
  234.     4.  There's no guarantee about troubles caused by the existence of this
  235.         program or by using this program
  236.     5.  The author will not have any obligations for modifying this program,
  237.         if there happens some trouble.
  238.     6.  Business usage is accepted under following restrictions above all,
  239.         a. Selling a package that this program is main, is prohibited.
  240.         b. All files in the package that include LHA should not be
  241.            protected.
  242.         c. Do not distribute if the target customers for the business are
  243.            considered as not appropriate for users of this program.
  244.         d. Indicate the copyright of this program and this distribution
  245.            notice on its package, documents or floppy disk label of
  246.            the business.
  247.  
  248. 6. Afterword
  249.         This program is written in Symantec C++ (Think C 6.0.1).
  250.         Thanks for Haruhiko Okumura, who release the LZARI method which
  251.         became the base of LZHUF method. Thanks for Kazuhiko Miki, who
  252.         introduced it on NiftyServe, and who is the author of LArc.
  253.         Thanks for Haruyasu Yoshizaki,
  254.         who release the LZHUF method, and the author of LHarc/LHA.
  255.         Thanks for many people who gave me advice and bug reports under
  256.         developing this program.
  257.         On this program, ASLfont+ is available. Thanks for hiroo@N-MIX, for
  258.         granting permission for using it on this program.
  259.  
  260. 7. Network address of author
  261.         Nikkei MIX:     k.ishi
  262.         NiftyServe:     PDE00013
  263.         CompuServe:     74340,13
  264.         Internet:       ishiz@muraoka.info.waseda.ac.jp
  265.  
  266. 8. English documentation by Takaaki Higuchi &
  267.                               Kazuaki Ishizaki (added on 2.12)
  268.         Nikkei MIX:     galshy
  269.         Internet:       thiguchi@Japan.Sun.COM
  270.