home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / cdrom / lha213 / lha213.doc < prev    next >
Text File  |  1991-08-01  |  32KB  |  884 lines

  1. ------------------------------------------------------------------------
  2.                        Manual for LHA Version 2.13
  3.  
  4.                                                  Ver 2.13  July 20, 1991
  5. ------------------------------------------------------------------------
  6.                              NIFTY-Serve  SDI00506    HARUYASU YOSHIZAKI
  7.                              ASCII-pcs    pcs02846    Yoshi
  8.                              PC-VAN       FEM12376
  9. ------------------------------------------------------------------------
  10.  
  11.      This is a manual for the public release of LHA.EXE.v 2.13. LHA
  12.      is an upward compatible and improved version of LH Ver 1.13C.
  13.      Since Microsoft's DOS 5.0 now has an interior command LH (for
  14.      Load High), the name has been changed from LH.EXE to LHA.EXE.
  15.  
  16.  
  17. 0.  To begin with
  18. -----------------
  19.  
  20.      This is a revised version of LH113c.EXE, an archiver which was
  21.      rather slow in execution but tight in compression rate.  I am
  22.      grateful for the support of LH113c's users both in Japan where
  23.      the .LZH file is a standard archived file name and in other
  24.      countries where .LZH has become well-known and used often.  I
  25.      have been  working on this new version for two years since the
  26.      last release of LH113c.EXE.  I am now glad to announce the re-
  27.      lease of LHA. I am constantly upgrading upon user's report on
  28.      bugs and on new requests.
  29.  
  30.  
  31.      LHA differs from LH113c:
  32.      -----------------------
  33.  
  34.      LHA is better than LH Ver 1.13 in compression rate, especially
  35.      with large files.  There are a few exceptions if using rather
  36.      small files.  (Under 1 Kb.)  LHA is faster than LH113c in de-
  37.      compressing, with new static Huffman coding, compared with the
  38.      older dynamic Huffman.  The speed of compression is not as fast
  39.      as I was expecting.  <Sigh>
  40.  
  41.      LHA needs more memory than LH113c did.  If there is not enough
  42.      for LHA to work, it may have looser compression rate, although
  43.      it tries to continue execution.  LHA is upward compatible with
  44.      LH113c.  But LH113c is not completely compatible with the LHA
  45.      format.  Please switch from LH113c to LHA as soon as you can.
  46.      With the "/o" option, you can make archives dearchivable by
  47.      LHarc Ver 1.xx - otherwise LHarc will complain for "unknown
  48.      method".
  49.  
  50.      LHA is distributed as a free program with copyright reserved.
  51.      There is no restriction for the use within private corporations
  52.      or the use for governmental agencies.  Users must be respon-
  53.      sible for the use of facilities of the software, especially of
  54.      the auto ! batch file (Often called a "Telop file).  The soft-
  55.      ware is distributed as is.  I am not liable for any damage
  56.      caused by the use of this software.  For commercial use, please
  57.      refer to our distribution policy.
  58.  
  59.      You can now proceed to read the complete description of com-
  60.      mands and options.  However, if you are not familiar with what
  61.      an archiver is, please refer to the introductory note LHA.HLP
  62.      written especially for LHA.EXE by late Irvin Hoff.
  63.  
  64.  
  65. 1.  Usage
  66. ---------
  67.  
  68.   A.  General Format:
  69.   ==================
  70.  
  71.     LHA <command> [/<option> ARC [[DIR\] [FILE]...]...  [-+012|WDIR]...]
  72.  
  73.  
  74.     <command>: if one is not used, you get the help screen or a list of
  75.                FILE(s).
  76.     <option>:  you may supply one or more of options explained below.
  77.                (needs an  /  or  -  in front, to designate an option)
  78.  
  79.     ARC:       archive name.
  80.     DIR:       base directory name.
  81.     FILE:      File name or full pathname if specified.
  82.     WDIR:      Working Directory name.
  83.  
  84.  
  85.   B.  <command>
  86.   =============
  87.  
  88.    a (Add) compress and add to an archive.
  89.  
  90.      Compress and Add files specified to an archive.  If the named
  91.      archive does not exist, then create one with the name.  LHA
  92.      overwrites any file in the archive by the given file name with
  93.      'a' command.  Compare with 'u' command.
  94.  
  95.      The commands 'a' and 'm' are used to make an archive.
  96.  
  97.      < Example 1 >  LHA a EX *.EXE
  98.  
  99.      LHA makes an archive named EX.LZH from all the files with ex-
  100.      tension 'EXE'.  Extension .LZH is default.
  101.  
  102.  
  103.    u (Update) Compress and Update.
  104.  
  105.      Compress and add files specified to an archive as command 'a'.
  106.      If LHA detects a file with the name same as the one in the
  107.      archive, then LHA selects the new one to add to archive, by
  108.      comparing the time stamp of each.
  109.  
  110.      < Example 2 > LHA u EX *.C
  111.  
  112.      All the FILE(s) with extension '.C' are archived in EX.LZH.
  113.      If you already have an SX.LZH containing a FILE with the same
  114.      name, only the one with newer time stamp is archived.
  115.  
  116.  
  117.    m (Move)
  118.  
  119.      Compress and add to an archive as 'u' command with checking
  120.      time stamps.  The difference is that LHA deletes all the files
  121.      moved into the archive.
  122.  
  123.      < Example 3 > LHA m EX *.C
  124.  
  125.      does  the same as
  126.  
  127.                   LHA u EX *.C
  128.                   del *.C
  129.  
  130.      Watch the second line.  With the /C option, LHA removes all the
  131.      FILE(s) into the ARChive ignoring time stamps.  You may lose
  132.      the one with the older time stamp.
  133.  
  134.  
  135.    f (Freshen)
  136.  
  137.      LHA looks for a FILE with the same name as the FILE in the
  138.      archive.  If it finds one with a newer time stamp, LHA
  139.      rewrites the one in the archive.  'LHA f /c ARC ' will not
  140.      check the time stamp.
  141.  
  142.      < Example 4 > LHA f EX LHA.DOC
  143.  
  144.      You have LHA.DOC compressed and archived in EX.LZH.  You get a
  145.      new LHA.DOC, then you replace the one in the ARChive, also.
  146.  
  147.  
  148.    d (Delete)
  149.  
  150.      LHA deletes a file (or files) in the archive.
  151.     
  152.      < Example 5 > LHA d ex lha.doc
  153.  
  154.      LHA deletes lha.doc in the ARChive ex.LZH.
  155.  
  156.    e (Extract)
  157.  
  158.      LHA extracts FILE(s) from the archive with decompressing.  If
  159.      LHA finds a FILE in the archive with a newer FILE on the same
  160.      DIR and having the same name, it skips that FILE(s).  LHA
  161.      extracts FILE(s) from ARChives made by L113C, namely, those
  162.      with the compression ids -lzs-, -lz4-, -lz5-.
  163.  
  164.      <Example 6 > LHA e EX 
  165.  
  166.      Extracts all the FILE(s) in the archive 'EX.LZH'.
  167.  
  168.      < Example 7 > LHA e EX *.COM
  169.  
  170.      LHA extracts all the files with extension .COM from 'EX.LZH'.
  171.  
  172.  
  173.   x (eXtract) LHA eXtracts compressed FILE with pathnames.
  174.  
  175.      If LHA can not find any path, then it will create directories.
  176.      FILE(s) must be archived with full-pathnames.  LHA restores the
  177.      entire directory structure.  'LHA e /x1m1 ARC' does the same.
  178.  
  179.      < EXample 8 > LHA x EX
  180.  
  181.      Suppose '\BIN\CG86.EXE' were among the FILE(s) in 'EX.LZH'.  LHA
  182.      creates directory '\BIN' if necessary, and extracts 'CG86.EXE'
  183.      there.
  184.  
  185.  
  186.    p (Print) Print FILE on standard out.
  187.  
  188.      LHA prints FILE decompressing from ARC to standard output.
  189.  
  190.      < Example 9 >  LHA  p ex lha.doc
  191.  
  192.      LHA extracts 'LHA.DOC' from 'EX.LZH' and displays it on your
  193.      terminal.
  194.  
  195.      < Example 10 > LHA p EX LHA.DOC > prn
  196.  
  197.      LHA extracts 'LHA.DOC' from 'EX.LZH' and prints it out from
  198.      your printer.
  199.  
  200.  
  201.    l (List)
  202.  
  203.      LHA lists FILE names in the archive on a line.  A FILE with
  204.      pathname will have a mark '+' on the head of the line.  'LHA
  205.      l /x ARC' shows full-pathnames of FILE(s) in ARC, and in 2 lines
  206.      per FILE.  You need not type 'l' to have the list.
  207.  
  208.      <Example 11> LHA LHA213.EXE
  209.  
  210.      LHA assumes command 'l' and shows list of FILE(s) archived FILE
  211.      per line.
  212.  
  213.      < Example 11x > LHA /x LHA213.EXE
  214.  
  215.      You get a similar list but full-pathnames are inserted, and
  216.      each FILE is shown on two lines.
  217.  
  218.      NOTE:  Forward slash '/' is used as the pathname separator.
  219.  
  220.  
  221.    v (View)
  222.  
  223.      'LHA v ARC' is the same with 'LHA l /x ARC'.
  224.  
  225.  
  226.    t (Test)
  227.  
  228.      Check the integrity of ARC, by CRC check.
  229.  
  230.      LHA t LHA.EXE or LHA t LHA213.EXE
  231.  
  232.      will announce the authenticity of the file you own.
  233.  
  234.            LHA t LHA.EXE
  235.  
  236.      "This file seems to be ORIGINAL distributed from H.Yoshi."
  237.  
  238.      LHA.EXE tests