home *** CD-ROM | disk | FTP | other *** search
/ The People Multimedia CD-Plus / VolumeOne.iso / LHARC / LHA213.TXT < prev    next >
Text File  |  1996-06-23  |  36KB  |  1,036 lines

  1.  
  2.                         LHA v2.11 HELP GUIDE
  3.  
  4.                  by Irv Hoff, cleared by Yoshi-san
  5.  
  6.                             3 March 1991
  7.  
  8.  
  9. LHA v2.11 - WHAT IS IT?
  10. -----------------------
  11.  
  12.      LHA v2.11 is a dual purpose archive program.
  13.  
  14.      1)  Its primary purpose is to take normal binary or text files
  15.          and make them smaller in size.  This saves great amounts of
  16.          storage space, with typical results being approximately 1/4
  17.          to 1/3 of original size.  It can handle any size file that
  18.          can be placed on the disk, together with the compressed file
  19.          it then makes.  Files in excess of 1 Mb may be easily used,
  20.          even though perhaps only 200 Kb RAM might be available.
  21.  
  22.          This eliminates any potential problems from one computer to
  23.          another.
  24.  
  25.          It does this with by using special "compression tables."
  26.          These are automatically built into the program and involve
  27.          mathematical procedures which are simple for a computer.
  28.  
  29.      2)  The secondary purpose is to take more than one of these
  30.          programs and include them in just one file, although each
  31.          will have its own individual name inside that file.
  32.  
  33.                This is called an "archive."  In the days of
  34.                CP/M, they were called "library" files.  In the
  35.                early days of MS-DOS (and other comparable pro-
  36.                grams used by IBM computers) they were called
  37.                .ARC files.
  38.  
  39.                However, as other comparable programs appeared,
  40.                they were given various "extents" to identify
  41.                the program used.  Some sample names are .ARC,
  42.                .DWC, .LZH, .PAK, .ZIP, .ZOO, etc.
  43.  
  44.                Each has its own special characteristics.
  45.                Lists comparing the various programs are
  46.                available.
  47.  
  48.  
  49. ARCHIVE FILES
  50. -------------
  51.  
  52.      LHA v2.11 can have hundreds of files in a single .LZH archive.
  53.      This allows storing complete hard disk directories in a space
  54.      typically 1/2 or less the original total - although many of the
  55.      files might already be archived.
  56.  
  57.      One such check we tried, made a file we called "TEST.LZH."  It
  58.      had 200 files and was 41% the original directory size.
  59.  
  60.      Not only is this a great saving in size for storage, but puts
  61.      (in this case), the 200 files into one, single file.  This is
  62.      often beneficial.  Among other things, all files associated with
  63.      one program are kept together in the same archive.
  64.  
  65.  
  66. ------------------------------------------------------------------------
  67.  
  68. SIMPLE INSTRUCTIONS FOR USING LHA v2.11
  69. ---------------------------------------
  70.  
  71.      1)  To compress one file called ABC.TXT.  (It will make a
  72.          file called ABC.LZH.)
  73.  
  74. 'a'               LHA a ABC ABC.TXT
  75.              or
  76. 'a'               LHA a ABC.LZH ABC.TXT
  77.                       ^    ^       ^
  78.                       a    b       c
  79.  
  80.  
  81.                   a  =  command
  82.                   b  =  archive program name
  83.                   c  =  pgm (or pgms) to be added/compressed
  84.  
  85.  
  86.          Either is suitable, one requires more typing.
  87.  
  88.          a)  In this case, the "a" is called a command.  There are
  89.              12 of those available (shown below).  A few are dupli-
  90.              cates to initially help users more familiar with other
  91.              programs.
  92.  
  93.              Typing LHA <ret> will display this list on the screen.
  94.              It also gives a very short summary what the command
  95.              does.
  96.  
  97.  
  98.      2)  ADDING a program to an existing file:
  99.  
  100. 'a'               LHA a ABC ABC.DOC
  101.                          ^
  102.                          archive name
  103.  
  104.  
  105.      3)  ADDING SEVERAL files at one time:
  106.  
  107. 'a'               LHA a ABC PGM1.EXT PGM2.EXT PGM3.EXT
  108.                          ^
  109.                          archive name
  110.  
  111.  
  112.      4) DELETING a file called PGM4.EXT:
  113.  
  114. 'd'               LHA d ABC PGM4
  115.                          ^
  116.                          archive name
  117.  
  118.  
  119.      5) EXTRACTING a file called PGM4.EXT:
  120.  
  121. 'e'  (or 'x')     LHA e ABC PGM4
  122.                          ^
  123.                          archive name
  124.  
  125.  
  126.      6) LOOKING at the archive contents:
  127.  
  128. 'l'  (or 'v')     LHA l ABC PGM4
  129.                          ^
  130.                          archive name
  131.  
  132.  
  133.      7) MOVES files into archive and deletes file from directory:
  134.  
  135. 'm'               LHA m ABC PGM1 PGM2 PGM3
  136.                          ^
  137.                          archive name
  138.  
  139.  
  140.      8) DISPLAY a text file in an archive:
  141.  
  142. 'p'               LHA p ABC PGM4
  143.                          ^
  144.                          archive name
  145.  
  146.  
  147.      9) TEST the integrity of an archive:
  148.  
  149. 't'               LHA t ABC PGM4
  150.                          ^
  151.                          archive name
  152.  
  153.  
  154.           NOTE:  LHA.EXE makes both "long and short SFX files."
  155.                  Check the advanced .DOC file for information.
  156.                  It has a quite extensive discussion on the SFX
  157.                  files.
  158.  
  159.  
  160. COMMANDS:
  161. ---------
  162.  
  163.      There are 12 commands available.
  164.  
  165.      The 'l' and 'v' are very slightly different, the 'v' putting
  166.      the file name on a line by itself.)  The 'e' and 'x' are
  167.      slightly different, as well.
  168.  
  169.      These are listed by typing just LHA without any command of
  170.      file name:
  171.  
  172. -------------------------------------------------------------------------------
  173.  
  174.   <command>
  175.      a: Add files           u: Update files        m: Move files
  176.      f: Freshen files       d: Delete files        p: disPlay files
  177.      e: Extract files       x: eXtract files with pathnames
  178.      l: List of files       v: View listing of files with pathnames
  179.      s: make a Self-extracting archive   t: Test the integrity of an archive
  180.  
  181.  
  182. OPTIONS
  183. -------
  184.  
  185.      There are 15 "options" which many users will not need/use.
  186.      They will be explained in detail in the LHA211.DOC manual for
  187.      advanced users.  Those are:
  188.  
  189.  
  190.   <option>
  191.      r: Recursively collect files        w: assign Work directory
  192.      x: allow eXtended file names        m: no Message for query
  193.      p: distinguish full Path names      c: skip time-stamp Check
  194.      a: allow any Attributes of files    z: Zero compression (only store)
  195.      t: archive's Time-stamp option      h: select Header level (default = 1)
  196.      o: use Old compatible method        n: display No indicator a/o pathname
  197.      i: not Ignore lower case            l: display Long name with indicator
  198.      -: '-' or '@' as the first letter of filenames
  199. ===============================================================================
  200.  
  201.                                   - end -
  202.  
  203.  
  204.  
  205. ------------------------------------------------------------------------
  206.                        Manual for LHA Version 2.13
  207.  
  208.                                                  Ver 2.13  
  209. ------------------------------------------------------------------------
  210.                              NIFTY-Serve  SDI00506    HARUYASU YOSHIZAKI
  211.                              ASCII-pcs    pcs02846    Yoshi
  212.                              PC-VAN       FEM12376
  213. ------------------------------------------------------------------------
  214.  
  215.      This is a manual for the public release of LHA.EXE.v 2.13. LHA
  216.      is an upward compatible and improved version of LH Ver 1.13C.
  217.      Since Microsoft's DOS 5.0 now has an interior command LH (for
  218.      Load High), the name has been changed from LH.EXE to LHA.EXE.
  219.  
  220.  
  221. 0.  To begin with
  222. -----------------
  223.  
  224.      This is a revised version of LH113c.EXE, an archiver which was
  225.      rather slow in execution but tight in compression rate.  I am
  226.      grateful for the support of LH113c's users both in Japan where
  227.      the .LZH file is a standard archived file name and in other
  228.      countries where .LZH has become well-known and used often.  I
  229.      have been  working on this new version for two years since the
  230.      last release of LH113c.EXE.  I am now glad to announce the re-
  231.      lease of LHA. I am constantly upgrading upon user's report on
  232.      bugs and on new requests.
  233.  
  234.  
  235.      LHA differs from LH113c:
  236.      -----------------------
  237.  
  238.      LHA is better than LH Ver 1.13 in compression rate, especially
  239.      with large files.  There are a few exceptions if using rather
  240.      small files.  (Under 1 Kb.)  LHA is faster than LH113c in de-
  241.      compressing, with new static Huffman coding, compared with the
  242.      older dynamic Huffman.  The speed of compression is not as fast
  243.      as I was expecting.  <Sigh>
  244.  
  245.      LHA needs more memory than LH113c did.  If there is not enough
  246.      for LHA to work, it may have looser compression rate, although
  247.      it tries to continue execution.  LHA is upward compatible with
  248.      LH113c.  But LH113c is not completely compatible with the LHA
  249.      format.  Please switch from LH113c to LHA as soon as you can.
  250.      With the "/o" option, you can make archives dearchivable by
  251.      LHarc Ver 1.xx - otherwise LHarc will complain for "unknown
  252.      method".
  253.  
  254.      LHA is distributed as a free program with copyright reserved.
  255.      There is no restriction for the use within private corporations
  256.      or the use for governmental agencies.  Users must be respon-
  257.      sible for the use of facilities of the software, especially of
  258.      the auto ! batch file (Often called a "Telop file).  The soft-
  259.      ware is distributed as is.  I am not liable for any damage
  260.      caused by the use of this software.  For commercial use, please
  261.      refer to our distribution policy.
  262.  
  263.      You can now proceed to read the complete description of com-
  264.      mands and options.  However, if you are not familiar with what
  265.      an archiver is, please refer to the introductory note LHA.HLP
  266.      written especially for LHA.EXE by late Irvin Hoff.
  267.  
  268.  
  269. 1.  Usage
  270. ---------
  271.  
  272.   A.  General Format:
  273.   ==================
  274.  
  275.     LHA <command> [/<option> ARC [[DIR\] [FILE]...]...  [-+012|WDIR]...]
  276.  
  277.  
  278.     <command>: if one is not used, you get the help screen or a list of
  279.                FILE(s).
  280.     <option>:  you may supply one or more of options explained below.
  281.                (needs an  /  or  -  in front, to designate an option)
  282.  
  283.     ARC:       archive name.
  284.     DIR:       base directory name.
  285.     FILE:      File name or full pathname if specified.
  286.     WDIR:      Working Directory name.
  287.  
  288.  
  289.   B.  <command>
  290.   =============
  291.  
  292.    a (Add) compress and add to an archive.
  293.  
  294.      Compress and Add files specified to an archive.  If the named
  295.      archive does not exist, then create one with the name.  LHA
  296.      overwrites any file in the archive by the given file name with
  297.      'a' command.  Compare with 'u' command.
  298.  
  299.      The commands 'a' and 'm' are used to make an archive.
  300.  
  301.      < Example 1 >  LHA a EX *.EXE
  302.  
  303.      LHA makes an archive named EX.LZH from all the files with ex-
  304.      tension 'EXE'.  Extension .LZH is default.
  305.  
  306.  
  307.    u (Update) Compress and Update.
  308.  
  309.      Compress and add files specified to an archive as command 'a'.
  310.      If LHA detects a file with the name same as the one in the
  311.      archive, then LHA selects the new one to add to archive, by
  312.      comparing the time stamp of each.
  313.  
  314.      < Example 2 > LHA u EX *.C
  315.  
  316.      All the FILE(s) with extension '.C' are archived in EX.LZH.
  317.      If you already have an SX.LZH containing a FILE with the same
  318.      name, only the one with newer time stamp is archived.
  319.  
  320.  
  321.    m (Move)
  322.  
  323.      Compress and add to an archive as 'u' command with checking
  324.      time stamps.  The difference is that LHA deletes all the files
  325.      moved into the archive.
  326.  
  327.      < Example 3 > LHA m EX *.C
  328.  
  329.      does  the same as
  330.  
  331.                   LHA u EX *.C
  332.                   del *.C
  333.  
  334.      Watch the second line.  With the /C option, LHA removes all the
  335.      FILE(s) into the ARChive ignoring time stamps.  You may lose
  336.      the one with the older time stamp.
  337.  
  338.  
  339.    f (Freshen)
  340.  
  341.      LHA looks for a FILE with the same name as the FILE in the
  342.      archive.  If it finds one with a newer time stamp, LHA
  343.      rewrites the one in the archive.  'LHA f /c ARC ' will not
  344.      check the time stamp.
  345.  
  346.      < Example 4 > LHA f EX LHA.DOC
  347.  
  348.      You have LHA.DOC compressed and archived in EX.LZH.  You get a
  349.      new LHA.DOC, then you replace the one in the ARChive, also.
  350.  
  351.  
  352.    d (Delete)
  353.  
  354.      LHA deletes a file (or files) in the archive.
  355.     
  356.      < Example 5 > LHA d ex lha.doc
  357.  
  358.      LHA deletes lha.doc in the ARChive ex.LZH.
  359.  
  360.    e (Extract)
  361.  
  362.      LHA extracts FILE(s) from the archive with decompressing.  If
  363.      LHA finds a FILE in the archive with a newer FILE on the same
  364.      DIR and having the same name, it skips that FILE(s).  LHA
  365.      extracts FILE(s) from ARChives made by L113C, namely, those
  366.      with the compression ids -lzs-, -lz4-, -lz5-.
  367.  
  368.      <Example 6 > LHA e EX 
  369.  
  370.      Extracts all the FILE(s) in the archive 'EX.LZH'.
  371.  
  372.      < Example 7 > LHA e EX *.COM
  373.  
  374.      LHA extracts all the files with extension .COM from 'EX.LZH'.
  375.  
  376.  
  377.   x (eXtract) LHA eXtracts compressed FILE with pathnames.
  378.  
  379.      If LHA can not find any path, then it will create directories.
  380.      FILE(s) must be archived with full-pathnames.  LHA restores the
  381.      entire directory structure.  'LHA e /x1m1 ARC' does the same.
  382.  
  383.      < EXample 8 > LHA x EX
  384.  
  385.      Suppose '\BIN\CG86.EXE' were among the FILE(s) in 'EX.LZH'.  LHA
  386.      creates directory '\BIN' if necessary, and extracts 'CG86.EXE'
  387.      there.
  388.  
  389.  
  390.    p (Print) Print FILE on standard out.
  391.  
  392.      LHA prints FILE decompressing from ARC to standard output.
  393.  
  394.      < Example 9 >  LHA  p ex lha.doc
  395.  
  396.      LHA extracts 'LHA.DOC' from 'EX.LZH' and displays it on your
  397.      terminal.
  398.  
  399.      < Example 10 > LHA p EX LHA.DOC > prn
  400.  
  401.      LHA extracts 'LHA.DOC' from 'EX.LZH' and prints it out from
  402.      your printer.
  403.  
  404.  
  405.    l (List)
  406.  
  407.      LHA lists FILE names in the archive on a line.  A FILE with
  408.      pathname will have a mark '+' on the head of the line.  'LHA
  409.      l /x ARC' shows full-pathnames of FILE(s) in ARC, and in 2 lines
  410.      per FILE.  You need not type 'l' to have the list.
  411.  
  412.      <Example 11> LHA LHA213.EXE
  413.  
  414.      LHA assumes command 'l' and shows list of FILE(s) archived FILE
  415.      per line.
  416.  
  417.      < Example 11x > LHA /x LHA213.EXE
  418.  
  419.      You get a similar list but full-pathnames are inserted, and
  420.      each FILE is shown on two lines.
  421.  
  422.      NOTE:  Forward slash '/' is used as the pathname separator.
  423.  
  424.  
  425.    v (View)
  426.  
  427.      'LHA v ARC' is the same with 'LHA l /x ARC'.
  428.  
  429.  
  430.    t (Test)
  431.  
  432.      Check the integrity of ARC, by CRC check.
  433.  
  434.      LHA t LHA.EXE or LHA t LHA213.EXE
  435.  
  436.      will announce the authenticity of the file you own.
  437.  
  438.            LHA t LHA.EXE
  439.  
  440.      "This file seems to be ORIGINAL distributed from H.Yoshi."
  441.  
  442.      LHA.EXE tests itself for you.  This guarantees the version you
  443.      have is not hacked by anyone, though it is not the full guaran-
  444.      tee in the present state of art.  You can't check LHA.EXE if
  445.      you have used executable file compressors such as LZEXE, PKLITE
  446.      or DIET.
  447.  
  448.      < Example 12 > LHA t EX
  449.  
  450.      LHA tests integrity of the FILE(s) in 'EX.LZH'.
  451.  
  452.      < Example 13 > LHA t LHA.EXE
  453.  
  454.      LHA checks if LHA.EXE is the original file distributed.
  455.      
  456.      It has often been asked that files made by LHarc v 1.xx
  457.      fail this test. You cannot test LHARC.exe with this test.
  458.      If you get an answer "file corrupt", don't get panic.
  459.      These files often have extra padding in the back of the file.
  460.  
  461.    s (Self-extract)
  462.  
  463.      LHA makes a Self-Extracting archive from ARC.LZH.  The default
  464.      switch /x0 is assumed when you do not specify.  SFX made with
  465.      the /x0 switch, small model, extracts files on the current
  466.      directory.  You can't activate some programs in the archived
  467.      FILE(s) automatically with small model.  The size of the SFX file
  468.      is smaller than those made with /x1 switch, large model.
  469.  
  470.      The large model SFX has the ability to restore subdirectory
  471.      structures and can automatically start execution from a FILE
  472.      inside the archive.
  473.  
  474.      < Example 14 > LHA s EX
  475.  
  476.      In this case, LHA makes a small model EX.EXE from EX.LZH.
  477.      
  478.      We had many inquiries that LHA does not make SFX file.
  479.      You must first make LZH file by 'a' or 'm' command. Then
  480.      you use 's' command to make it a self-extracting file.
  481.  
  482.  
  483.   C.  </option>
  484.   =============
  485.  
  486.      Each option takes 3 numerical values to define its finer
  487.      actions.  Use 0,1 and 2 to specify.  For some options, the
  488.      values 1 and 2 does the same thing.  You may toggle 0 and 1 by
  489.      '+' and '-" as with LH113c.  You may change switch character
  490.      (option) from  /  to  - if you prefer the '-'.
  491.  
  492.      /x[0|1] (eXtend)
  493.  
  494.  
  495.      LHA uses eXtended FILE names, namely full-pathnames for FILE(s).
  496.  
  497.      You are on the root directory.  Suppose you want to archive the
  498.      FILE '\tc\include\sys\stat.h' in an archive 'ARC.LZH'.  You type
  499.      'LHA a /x1 ARC.LZH \tc\include\sys\stat.h' to store the FILE
  500.      with full-pathname,'\tc\include\sys\stat.h'.  Similarly, you
  501.      have a 2-lined list with full-pathnames with 'l' command.
  502.  
  503.      /p[0|1|2] (Precise)
  504.  
  505.  
  506.      Search file names precisely.
  507.  
  508.      Suppose an ARChive 'TC.LZH' contains both 'STAT.H' and
  509.      'SYS\STAT.H'.  A simple command like 'LHA e TC stat.h' will
  510.      extract both files on the current directory and let one
  511.      override the other.  To avoid such confusion, you can type 'LHA
  512.      e -p TC stat.h' to extract 'STAT.H' only.  While by typing 'LHA
  513.      e -p TC sys\stat.h' you will get 'SYS\STAT.H'.
  514.  
  515.      /c[0|1|2]  (ignore Comparison of time)
  516.  
  517.  
  518.      With commands 'u', 'f', 'e', 'x', LHA ignores the checking of
  519.      time stamps.  With these commands, LHA chooses the newest FILE
  520.      with the same pathname to act on, by default.  This option lets
  521.      LHA ignore the time stamps.
  522.  
  523.  
  524.      /m[0|1|2]  (no Message)
  525.  
  526.      The switch '/m1' let LHA assumes answer 'Y' for all the
  527.      queries. "LHA e /m1 ARC" will extract files in ARC.LZH
  528.      wherever "Y" is typed for the queries "Overwrite? [Y/N]"
  529.      are asked. If there is a file in the directory with the
  530.      same name but with attribute read-only, LHA reports
  531.      'file creation error'. Similarly LHA creates new directory
  532.      if it meets 'Directory DIR does not exit. Create [Y/N]'.
  533.    
  534.      On the other hand, with '/m2' switch LHA acts differently.
  535.      'LHA e /m2 ARC.LZH FILE' dearchives every FILE by choosing
  536.      an unused file extension among 000-999, when LHA finds
  537.      FILE(s) with the same name as in the ARChive.
  538.  
  539.      /a[0|1] (any Attribute)
  540.  
  541.  
  542.      This switch enables LHA to archive FILE(s) with any attributes.
  543.  
  544.      In the process of archiving with default switch /a0, LHA will
  545.      not archive FILE(s) with hidden and system attributes.  FILE(s)
  546.      with read-only attribute is archived with the attribute. With
  547.      this switch on, '/a1', FILE(s) of any attribute are archived
  548.  
  549.      In the process of dearchiving, with /a1, dearchived FILE(s)
  550.      preserve their original attributes. With /a0, you can't
  551.      dearchive files with hidden and system attributes.  Read-only
  552.      FILE(s) are dearchived deprived of their original attribute.
  553.  
  554.      /r[0|1|2] (Recursive)
  555.  
  556.  
  557.      LHA archives and extracts files recursively from subdirect-
  558.      ories.  'Recursively' means LHA searches all FILE(s) from all
  559.      subdirectories under the specified directory if there is any.
  560.  
  561.      There are three different modes for the '/r' switch.
  562.  
  563.      /r0: (non-recursive mode, default)
  564.  
  565.  
  566.      LHA collects files specified by path names only.
  567.  
  568.      /r1:
  569.  
  570.  
  571.      LHA separates the given pathname into a directory name and FILE
  572.      name.  LHA recursively collects FILE(s) with the given name from
  573.      all the directories under the directory specified.
  574.  
  575.      < Example 15 > LHA a /r1 SOURCE.LZH \SOURCE.C\SOURCE\*.H
  576.  
  577.      LHA collects FILE(s) with extension C and H from the directory
  578.      \source and its subdirectories, probably '\SOURCES\SAMPLES\*.C'
  579.      but not '\SOURCE\*.OBJ'.
  580.  
  581.      /r2:
  582.  
  583.  
  584.      LHA recursively collects all the files from all the specified
  585.      subdirectories.  Tree structure of the specified directory is
  586.      archived as it is.
  587.  
  588.      < Example 16 > LHA a /r2x1 a:\*.*
  589.  
  590.  
  591.      NOTE:  LH113c has set /x whenever /r is set in 'e' or 'x'
  592.             commands.  LHA differs from LH113c in that /x is
  593.             not set with /r automatically.
  594.  
  595.      The following questions are the most frequently asked ones:
  596.  
  597.      (1) How do you backup a disk a: ?
  598.  
  599.                         LHA a /r2x1 LZH a:\
  600.  
  601.      (2) Then how do you retrieve all the directories and files on
  602.          b:?
  603.  
  604.                         LHA x ARC.LZH b:\
  605.  
  606.  
  607.      /w[0|1|<Directory Name>] (Work directory)
  608.  
  609.      Specify the directory name where LH makes temporary files.
  610.  
  611.                         LHA a /wd:\  ARC.LZH FILE(s)
  612.  
  613.      set -w switch on.
  614.  
  615.      By default, LHA makes all the temporary files on the directory
  616.      where ARC.LZH is to be made.  It will rename the temporary file
  617.      as ARC.LZH.
  618.  
  619.      LHA makes temporary files on the current directory if no name
  620.      is specified with '/w+'.
  621.  
  622.      When you set Environmental variable 'TMP' this switch is set
  623.      automatically to be 1, and you have the directory set by 'TMP='.
  624.      as your working directory.
  625.  
  626.      The switch helps LHA when you have not enough room in your base
  627.      directory, or when you have a high speed memory device like RAM
  628.      disk or HARD ram.
  629.  
  630.  
  631.  
  632.  
  633.      /t[0|1] (Time stamp)
  634.  
  635.      With command a,u,m,f,d reset time stamp of ARC.lzh according to
  636.      the newest file in the archive.  By default, the time stamp of
  637.      an ARC.LZH is the time when the ARC.LZH is made.
  638.  
  639.  
  640.      /z[0|1|2] (Zero compression)
  641.  
  642.      LHA makes an archive without compressing.
  643.  
  644.      /z1: None of the FILE(s) is compressed
  645.  
  646.      /z2: Compress and archive except for the FILE(s) with exten-
  647.           sions:
  648.  
  649.                .ARC, .LZH, .LZS, .PAK, .ZIP, .ZOO.
  650.  
  651.      /z<extension>:  Do not compress FILE(s) with the specified
  652.      extension.  This switch assumes /z2.  You may use wild card to
  653.      specify, and you may or may not put '.' in front of the exten-
  654.      sion.  With '/zdbf' you don't compress FILE(s) with extension
  655.      '.DBF'.  With '/z' you will not have FILE(s) with no extension
  656.      compressed.  You may specify multiple extensions by writing
  657.      sequentailly:
  658.  
  659.                LHA a /ZCOM /ZERO ARChive.LH *.*.
  660.  
  661.      /o[0|1] (Old compatible compression)
  662.  
  663.      LHA makes an archive compatible with the LH113c format.  Even
  664.      in this case, LHA makes tighter compression than LH113c ver
  665.      1xx.  The header id is automatically set to -h1.
  666.  
  667.      /h[0|1|2] (Header level)
  668.  
  669.      Choice of header level, default is /h0.
  670.  
  671.  
  672.      /i[0|1] (don't Ignore case)
  673.  
  674.      Recognize Upper and Lower cases.  LH(arc)s have common header
  675.      format in other OS's where cases are recognized as distinct.
  676.      This option is prepared for dearchiving archives made by other
  677.      OS'.  In the DOS version of LHA, you can't differentiate upper
  678.      and lower when LHA archives FILE(s) into the archive.  Names
  679.      are all stored in upper case.
  680.  
  681.      /n[0|1|2] (No indicator)
  682.  
  683.      In this version, LHA outputs compressing indicator "ooo....."
  684.      to standard error.  The switch is to suppress this output.
  685.  
  686.      /n1: LHA disables output "ooo....." to indicate its progress.
  687.  
  688.      /n2: LHA disables outputs of filename, compression rates.
  689.  
  690.  
  691.      /l[0|1|2] (Long display ).
  692.  
  693.      LHA outputs filenames in different formats when LHA archives
  694.      and dearchives.
  695.  
  696.       /l0 : FILE names only.
  697.       /l1 : Full-pathnames stored or to be stored in archive in 2 lines.
  698.       /l2 : Full-pathname of FILEs accessed by LHA in 2 lines.
  699.  
  700.      < Example 16 > LHA a /r1x1l2 LINK.LZH c:\LINK.*
  701.  
  702.      LHA collects LINK.* with full-pathname from directories below
  703.      c:\, with information from where LHA gets this FILE(s).
  704.  
  705.  
  706.      /-[1|2] (The first letter switch).
  707.  
  708.      LHA recognizes the characters '-' and '@' as the first letter
  709.      of a FILE name.  By default, any file beginning with '@', like
  710.      '@xxx' is recognized as a Response File 'xxx'.  
  711.  
  712.      With
  713.      '/-1' switch LHA reads '@' as a character in the file name,
  714.      while with switch
  715.      '/-2' LHA recognizes both '-' and '@' as characters.
  716.  
  717.      To exit from this mode specify '/-[0]'.  You cannot use '--0' 
  718.      in this particular case.  LHA believes '--0' as a file name.
  719.  
  720.      /s[0|1] (refrain from "Skipped filename.ext" message).
  721.      
  722.      When LHA finds a file with the same name with newer time stamp,
  723.      LHA skips decompressing a file from an ARChive. This message may
  724.      cause some confusion in Batch mode execution. You may suppress the
  725.      display. New from this version 2.13.
  726.  
  727.   D.  Base Directory.
  728.   ==================
  729.  
  730.      Base directory is not the current nor the root directory.  It
  731.      is the directory on which LHA is executed.  Or you may believe
  732.      that you move to this directory and execute LHA from there. You
  733.      may specify a number of directories as your base directories.
  734.  
  735.  
  736.   < Example 17 > LHA x program c:\BIN\ *.EXE *.COM c:\TEMP\ *.MAN *.DOC
  737.                               ~~~~~~~             ~~~~~~~~
  738.  
  739.      Suppose you are on the directory d:\.  You want to extract
  740.      files with extensions .COM and .EXE on c:\BIN, and those with
  741.      extensions .MAN and .DOC on the directory c:\TEMP.  This is
  742.      equivalent to the following set of command lines:
  743.  
  744.              D>C:
  745.              C>CD \BIN
  746.              C>LHA x D:\program *.COM *.EXE
  747.              C>cd \TEMPp
  748.              C>LHA x D:\program *.MAN *.DIX
  749.  
  750.      Naturally, you can't dearchive a single FILE on multiple di-
  751.      rectories.  The directory specified first has the priority.
  752.  
  753.  
  754.   E.  DOS redirection and response file
  755.   =====================================
  756.  
  757.      LHA can't accept too many file names on a command line due to
  758.      MS-DOS's restriction.  To avoid this inconvenience, LHA now
  759.      accepts PIPES and REDIRECTS of DOS.  Besides, LHA can use work
  760.      file called response file to record the names of the files to
  761.      be archived like MAKEFILE for some compilers.
  762.  
  763.  a.  Response File.
  764.  
  765.      The response file name will be marked with the letter '@' as of
  766.      LINK.EXE, which is a text file.  You may just write whatever
  767.      you want LHA to be done on this file.  Response file ignores CR
  768.      code and uses space as a separator.  You may write options in
  769.      the response file but you can't nest, calling other response
  770.      file, file names.
  771.  
  772.  
  773.  b.  DOS Pipes and Redirects.
  774.  
  775.      You may specify the same information supplied by a response
  776.      FILE by using pipes or redirections.  You may create a response
  777.      FILE by redirection.
  778.  
  779.      < Example 18 > LHA l /n1 PARTS > FILE(s)
  780.                     LHA a NEWPARTS @FILE(s)
  781.  
  782.      Make a list of files in the 'PARTS.LZH' archive and use it to
  783.      make a new ARChive 'NEWPARTS.LZH'.  This is done by using the
  784.      response files, after some editing.
  785.  
  786.      < Example 19 > LS | SORTR | LHA a ALL ls -c | LHA a ALL
  787.  
  788.      Make a list of files in a directory by LS.EXE.  Sort file names
  789.      and make a sorted archive ALL.LZH.  Beware of the various for-
  790.      mats from output of LS.EXE.  LS.EXE is supposed to list files
  791.      one name per line without any attributes or time stamps.  LS
  792.      designed after UNIX will do the trick by "ls -c" or "ls -C".
  793.      C or c stand for "sorted by columns".
  794.  
  795.  
  796.   F.  Environmental Variables
  797.   ===========================
  798.  
  799.  a.  LHA and LHARC
  800.  
  801.      LHA overrides LHARC.  This will reset default optional.
  802.  
  803.  
  804.  b.  TMP
  805.  
  806.      Set working directory as -w option.  In case LHA recognizes no
  807.      working directory, it uses the current directory as the working
  808.      directory and creates temporary files on it.
  809.  
  810.  
  811.  c.  TZ
  812.  
  813.      The time zone (EST, PST, etc.) must be set when you archive
  814.      with the header level -h2- and when you dearchive with -h2-. In
  815.      the Eastern Standard Time zone you have to set TIME ZONE with
  816.      the DOS command: set TZ=EST+5.  Remember the default Remember
  817.      the default header level is -h1-, in which case you are all
  818.      set.
  819.  
  820.  
  821.   G.  Exit Codes.
  822.   ==============
  823.  
  824.      LHA will return following result codes after batch or other
  825.      processes' execution.
  826.  
  827.      0.  Normal.
  828.  
  829.      1.  CRC error occured, probably with 'e','x','t' commands.
  830.          Or LHA failed to create files because of disk space, or
  831.          because of files in existence.
  832.  
  833.      2.  Fatal error.  Process terminated without transactions.
  834.  
  835.      3.  Failed to write temporary files in the archive.  You may
  836.          find a temporary file LHTEMP)2(.LZH on your working direct-
  837.          ory.  You may rename this file with extension LZH, and use
  838.          it as an archive.
  839.  
  840.  
  841.   H.  Working File Names
  842.   ======================
  843.  
  844.        LHTMP)1(.LZH : Old ARChive renamed.
  845.        LHTMP)2(.LZH : Working file to be renamed as ARChive.
  846.  
  847.  
  848. 2.SFX, Self-Extracting archive
  849. ------------------------------
  850.  
  851.       General Usage:
  852.  
  853.          SFX.EXE [/x] [/!] [/eDIR] [DIR]
  854.  
  855.            /x: do not create new directory.
  856.            /!: auto-execution batch enable.
  857.            /a: restore file attributes.
  858.            [/eDIR],[DIR]; specify directory to extract.
  859.  
  860.  
  861.          SFX.EXE is an executable file with FILE(s) stored in
  862.          the archive to be automatically extracted by exe-
  863.          cution.  All the LHA distribution will be in the
  864.          Self-Extracting (SFX) .EXE-format.  Only LHA.EXE makes
  865.          SFX files from archive *.LZH made by LHA.EXE.  You
  866.          can't make a Self-Extracting executable file from the
  867.          archive made by 'LH113c.1.xx'.
  868.  
  869.      LHA makes two models of SFX files: (a) the small model and (b)
  870.      the large model according to the switch /x0 or /x1, with the
  871.      following special functions.
  872.  
  873.  
  874.    A.  Telop.
  875.    =========
  876.  
  877.      LHA displays any file with name '!' if SFX.EXE finds it
  878.      archived. LHA holds one screen after showing [Y/N] prompt.  LHA
  879.      proceeds to execute if it receives 'Y'.  It quits (aborts)
  880.      execution for 'N'.  (The '!' character was used as it is the
  881.      first printing character.  A file starting with '!' will always
  882.      be the first file in that archive.)
  883.  
  884.  
  885.    B.  Directory Specification.
  886.    ===========================
  887.  
  888.      This is possible only for the large model.  You can name the
  889.      directory on which to execute SFX.EXE.
  890.  
  891.      < Example 20 > LHA213.EXE c:\user
  892.  
  893.      LHA extracts FILE(s) in LHA212.EXE on C:\USER.  You may of
  894.      course type:
  895.  
  896.                 LHA e /x0 LHA213.EXE c:\user ,
  897.  
  898.      to keep the TELOP file.
  899.  
  900.  
  901.    C.  Auto Execution
  902.    ==================
  903.  
  904.      This is possible only for large models.
  905.  
  906.      Archive a batch file with the name "!.BAT" and include it in
  907.      the SFX file.  This batch works if and only if you type:
  908.  
  909.                      LHA213 /!
  910.  
  911.      LHA always extracts files on the current directory.  Any
  912.      existing "!.BAT" file is overwritten.  You can't activate an
  913.      existing !.BAT by using the "/!" switch even if there is one on
  914.      the current directory.  The batch file is read if and only if
  915.      it is archived in the SFX file.
  916.  
  917.      Two Models of Self-Extracting files are available:
  918.  
  919.  
  920.  a.  Small Model  (LHA s SFX.LZH)
  921.  
  922.      This is the default model.
  923.  
  924.      LHA ignores the directory structures even if you make the
  925.      archive file with the /x or /r[1|2] switch.  LHA holds only the
  926.      FILE names.  SFX.EXE extracts files to the current directory.
  927.  
  928.      There is no limit on the size of SFX.EXE as there was for
  929.      LH113c.
  930.  
  931.  
  932.  b.  Large Model  (LHA s /x1 SFX.LZH)
  933.  
  934.      You can run a batch file to specify the directory to extract
  935.      files.  You can retrieve original directory structures with
  936.      this model.  You may refrain from creating unexpected
  937.      structures by using the /x switch.
  938.  
  939.  
  940. 3.  Main Differences from LH113c
  941. --------------------------------
  942.  
  943.      LHA is an improved version of LH113c in principle.  You will
  944.      notice a number of differences between the two, when comparing.
  945.      Some of the differences will be mentioned at this time.  (You
  946.      may wish to read the LH113c manual for a better comparison if
  947.      anything appears confusing.)
  948.  
  949.      FILE names are not sorted when entered into an archive.  They
  950.      are entered in the order in which they appear in the directory,
  951.      when using wild cards.  (This is different from LH113c.) 
  952.      If you specify the order of FILE, then the order is
  953.      reproduced in the archive.  If you add new FILE(s), they will
  954.      be added at the end of the existing files.
  955.  
  956.      There are external utility programs by other authors which you
  957.      may use to sort the FILE names in your directory prior to
  958.      adding them to the archive.  Some programs actually resort the
  959.      archive itself.  Few include LH113c archives as LH113c already
  960.      sorted those.  LHA210 doesn't.  By using a 'pipe' you can type:
  961.  
  962.      < Example 21 >   LS *.C *.H | SORT | LHA a EX.
  963.  
  964.      LHA collects FILE(s) with extensions C and H sorted in the
  965.      archive named 'EX.LZH'.
  966.  
  967.      With LHA, the /r switch does not necessarily activate the /x
  968.      switch in extraction. In this version of LHA, the 'x' command
  969.      is equivalent to using 'E /x1m1', namely, LHA restores all the
  970.      tree structures of subdirectories.
  971.  
  972.      LHARC executed an AUTOLARC.BAT file by key word upon self-
  973.      extracting.  LHA no more uses keyword comparison.  If a SFX
  974.      file contains an !.BAT file, the batch is activated by '-!'
  975.      following the executable file name.
  976.  
  977.      The time stamp of LHA is relatively counted from 1970-01-01,
  978.      00:00:00 UTC by seconds.  You must be careful not to set date
  979.      or time which is illusory, like 00-00-00.  LHA will display
  980.      some indefinite date from overflow of the counter.
  981.  
  982.  
  983. 4.  Our distribution Policy
  984. ---------------------------
  985.  
  986.      This software, this document and LHA.EXE, is a copyright-
  987.      reserved free program.  You may use, copy and distribute this
  988.      software free of charge under the following conditions.
  989.  
  990.   1.  Never change Copyright statement.
  991.  
  992.   2.  The enclosed documents must be distributed with as a package.
  993.  
  994.   3.  When you have changed the program, or implemented the program
  995.       for other OS or environment, then you must specify the part
  996.       you have changed.  Also make a clear statement as to your name
  997.       and MAIL address or phone number.
  998.  
  999.   4.  The author is not liable for any damage on your side caused by
  1000.       the use of this program.
  1001.  
  1002.   5.  The author has no duty to remedy for the deficiencies of the
  1003.       program.
  1004.  
  1005.   6.  When you are to distribute this software with publications or
  1006.       with your product, you have to print the copyright statement
  1007.       somewhere on the disk or on the package.  You cannot
  1008.       distribute this software with copyprotected products.
  1009.  
  1010.  
  1011.           As long as those conditions are satisfied, you do not
  1012.           need to get the author's permission to use or to dis-
  1013.           tribute the software.
  1014.  
  1015.  
  1016. 5.  How to contact the author.
  1017. ------------------------------
  1018.  
  1019.      Please send MAIL to Forum flabo on Nifty Serve.  Go Nifty on
  1020.      CompuServe and read the instructions there.  Your inquiries or
  1021.      your questions are to be addressed to the one of the above
  1022.      Nifty forums.  Direct MAIL to the author.
  1023.  
  1024.     My mail address :  SDI00506 | PFF00253 on Nifty Serve.
  1025.                        pcs02846               ASCII-NET pcs.
  1026.                        FEM12376               PC-VAN.
  1027.  
  1028.     Oversea Users may send inquiries, also, to K.Okubo to the address:
  1029.                        [74100,2565]        on Compuserve,
  1030.                        K.Okubo                Genie,
  1031.                        c00236@sinet.ad.jp.    INTERNET,CSNET etc.
  1032.  
  1033.  
  1034.                                     - end -
  1035.  
  1036.