home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 292.lha / Lharc_v.31 / lzh.doc < prev    next >
Text File  |  1992-09-02  |  4KB  |  132 lines
  1. ________________________________________________________________________
  2. ------------------------------------------------------------------------
  3.  
  4.  
  5.                         LHARC        vers. 0.30         
  6.  
  7.                         for the Commodore AMIGA
  8.          Compatible with version 1.13 of Lharc for MSDOS systems
  9.  
  10.                             by Paolo Zibetti
  11.  
  12.  
  13.  
  14. ------------------------------------------------------------------------
  15.  IMPORTANT NOTICE: This program is PUBBLIC DOMAIN and can be freely
  16.  distributed, provided no change is made to it and this document always
  17.  accompanies it.
  18.  You are not allowed to charge any fee for this program exept for,
  19.  possibly, the cost of magnetic media.
  20.  Also remember that this program is supplied 'as is': the entire risk as
  21.  to the quality of the program is to the user. In no event will I be 
  22.  liable for direct or indirect damage or loss resulting from the use
  23.  of this program.
  24. ------------------------------------------------------------------------
  25.  
  26. ________________________________________________________________________
  27. ------------------------------------------------------------------------
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35. Lharc is an archive program such as Arc and Zoo. It can store files in a
  36. compressed form which is generally more efficent than that used by Arc
  37. and Zoo.
  38.  
  39.  
  40.  
  41.  
  42.  
  43. Lharc is run from CLI:
  44.  
  45.  
  46.   lharc <Command> <Archive name> [<dest path>] [<file names/patterns>]
  47.  
  48.  
  49. <Command> can be any of the following:
  50.  
  51.   e,x  extract files from archive
  52.   l,v  show archives contents
  53.   p    extract and print files to screen
  54.   t    test archive integrity
  55.   a    create archives or add to existing archives
  56.  
  57.  
  58.  
  59. <Archive name> is the name (eventually preceded by a path) of the
  60. archive you want to work on. If no extension is specified the default
  61. extension .LZH is used. 
  62.  
  63.  
  64. [<dest path>] is optional: it tells where to put the extracted files.
  65. If not specified, extracted files will go to the current directory.
  66. Please note that this paramenter must always end with '/' or ':'
  67. otherwise it will not be recognized as such and will be considered
  68. as one of the file patterns
  69.  
  70.  
  71. [<file names/patterns>] rappresents an optional number of file names
  72. or file patterns. They indicate which files to
  73. extract/compress/list. Accepted wild cards are the standard
  74. AmigaDOS '#' and '?'
  75.  
  76.  
  77.  
  78.  
  79. For the program to properly work the T: device must be assigned. In fact
  80. Lharc puts temporary work files in T: if you don't assign this device
  81. before executing the program you will get a requester asking  "Please
  82. insert volume T: in any drive". 
  83. In order to increase compression speed I raccomand that you assign T: to
  84. a directory in the ram-disk.
  85. Note however that T: is usually automatically assigned in the
  86. startup-sequence of the standard Workbench, so, unless you have modified
  87. the startup-sequence, you don't have to worry about this.
  88.  
  89.  
  90.  
  91.  
  92. This program is aimed at full compatibility with the MSDOS version
  93. 1.13 of Lharc. Please note however that the MSDOS version has also
  94. the capability of extracting files from archives produced by Larc
  95. (a pupular Giapanise archive program): this feature will not be
  96. implemented in the Amiga version.
  97.  
  98.  
  99.  
  100.  
  101. Acknowledgements:
  102.  
  103. Since the source to the msdos version of Lharc is not available, I
  104. had to rewrite the program from scratch.
  105. Note howerer that for the Huffman compression/decompression I have
  106. used with few modifications a source of an example of single file
  107. compression which I found on a BBS. For sake of correctness I
  108. quote here the the header of this source:  
  109.  
  110. /*
  111.  * LZHUF.C English version 1.0
  112.  * Based on Japanese version 29-NOV-1988
  113.  * LZSS coded by Haruhiko OKUMURA
  114.  * Adaptive Huffman Coding coded by Haruyasu YOSHIZAKI
  115.  * Edited and translated to English by Kenji RIKITAKE
  116.  */
  117.  
  118. I whish to thank the above people whose work has been of
  119. foundamental importance for this project.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. Please send suggestions, comments and bug reports to
  128.  
  129. Paolo Zibetti       Fido node 2:331/101.6
  130.  
  131.  
  132.