home *** CD-ROM | disk | FTP | other *** search
/ Best of German Only 1 / romside_best_of_german_only_1.iso / finanzen / finanzbe / lharc.man < prev    next >
Text File  |  1989-05-26  |  32KB  |  919 lines
  1.  
  2.       User's Manual for High-Performance File-Compression Program
  3.  
  4.                           LHarc Version 1.12B
  5.                                 04/29/89
  6.  
  7.            Copyright (c) Haruyasu Yoshizaki (Yoshi), 1988-89
  8.  
  9.                                                     Nifty Serve PFF00253
  10.                                                     ASCII PCS   pcs02846
  11.  
  12. ------------------------------------------------------------------------
  13.  
  14. 0. It Came to Pass One Day...
  15.  
  16.    After reading "A Hard Disk Cookbook" from Shouei Press, I had a
  17.    strong desire to write my own archiving utility.  On the Nifty Serve
  18.    network, I was first exposed to Mr. Miki's Larc, which surpassed the
  19.    well-known PKware in compression ratios, as reported in the Forum
  20.    Software Debut and Review.  The next shock came when I saw Mr.
  21.    Okumura's LZari, which has even better compaction-ratio performance.
  22.    I started to rewrite LZari for in assembly level language, trying to
  23.    make it run faster, but I could find no way of speeding up the
  24.    process of de-archiving.
  25.  
  26.    So, as an alternative, I used adaptive Huffman coding with an LZSS
  27.    encoder in order to achieve a similar rate of compression with a
  28.    faster decompression process.  This is the idea used in LHarc.
  29.  
  30.    No one can be sure of eradicating all possible bugs, yet if SPACE is
  31.    more valuable than TIME to you, please give this program a try.  It
  32.    may be slower in execution, but it achieves the tightest compression
  33.    ratios of any general archiver in the present environment (copyright
  34.    reserved).
  35.  
  36.  
  37. 1. How to Use It:
  38.  
  39.    Just type "LHarc" to see the help screen.
  40.  
  41.  
  42.    Command-line synopsis:
  43.    ======================
  44.  
  45.    LHarc [command] [/<switches>[-|+|2|<option>]] <archive_name>
  46.          [<path_name>] [<home_directory_name>\ | <drive_name>:]
  47.  
  48.          You may place switch(es) at any place following the
  49.          command.  A group of switches can be specified together.
  50.  
  51.  
  52.    Terminology:
  53.    ============
  54.  
  55.    A path name comprises a directory name and a file name:
  56.  
  57.         a:\tc\include\stdio.ext
  58.         |<---- Path_name ---->|
  59.         |<Directory_>||<File_>|
  60.         |<-- name -->||<name >|
  61.  
  62.  
  63.    Commands:
  64.    =========
  65.  
  66.    a (Add)
  67.  
  68.    LHarc a Archive.LZH file1.ext
  69.  
  70.         Adds 'file1.ext' to 'Archive.LZH'.  If 'Archive.LZH' does
  71.         not exist, then LHarc creates it.  If a file with the name
  72.         'file1.ext' already exists in the archive, then LHarc will
  73.         replace it with the specified file.
  74.  
  75.  
  76.    u (Update)
  77.  
  78.    LHarc u Archive.LZH file1.ext
  79.  
  80.         Adds 'file1.ext' to 'Archive.LZH', the same as with the 'a'
  81.         command.  However, if 'file1.ext' already exists in the
  82.         archive, LHarc will check its time stamp, and will keep the
  83.         newer one and ignore the older one.  (The /c switch forces
  84.         LHarc to skip this time-stamp comparison.)
  85.  
  86.  
  87.    m (Move)
  88.  
  89.    LHarc m Archive.LZH file1.ext
  90.  
  91.         is equivalent to
  92.  
  93.    LHarc u Archive.LZH file1.ext
  94.    DEL file1.ext
  95.  
  96.         Beware the fact that the second line is always active.  You
  97.         might lose the file 'file1.ext' for eternity.
  98.  
  99.  
  100.    f (Freshen)
  101.  
  102.    LHarc f Archive.LZH file1.ext
  103.  
  104.         Replaces 'file1.ext' in 'Archive.LZH' with the newer one
  105.         only if a file with this name already exists in the archive.
  106.         Otherwise, no action is taken.  (The /c switch forces LHarc
  107.         to skip this time-stamp comparison.)
  108.  
  109.  
  110.    e (Extract) or x (eXtract)
  111.  
  112.    LHarc e Archive.LZH
  113.  
  114.         Extracts all the files from 'Archive.LZH' to the specified
  115.         drive or directory.  If the specified directory does not
  116.         exist, then LHarc will prompt you whether to create it.
  117.  
  118.    LHarc e Archive.LZH file1.ext
  119.  
  120.        Extracts only 'file1.ext' from 'Archive.LZH'.  If a file with
  121.        the name 'file1.ext' exists in the home directory, then LHarc
  122.        will refrain from extraction if the existing file has the
  123.        same time stamp or is newer.  (The /c switch forces LHarc to
  124.        skip this time-stamp comparison.)
  125.  
  126.    LHarc e Archive.LZS file.ext
  127.  
  128.         Extracts 'file.ext' from an .LZS file archived with Larc
  129.         3.xx.
  130.  
  131.         NOTE:  Larc is another popular archiver on Japanese PDS's.
  132.  
  133.  
  134.    p (disPlay)
  135.  
  136.    LHarc p Archive.LZH file1.ext
  137.  
  138.         Extracts 'file1.ext' from 'Archive.LZH' and redirects it to
  139.         standard output.
  140.  
  141.    LHarc p /v Archive.LZH file1.ext
  142.  
  143.         Invokes the default utility LESS to format and display the
  144.         redirected output.  LHarc creates a temporary file
  145.         'LHARC.TMP' for review that will be deleted later.
  146.  
  147.    LHarc p /vsee Archive.LZH file1.ext
  148.  
  149.         Invokes the text formatter SEE, which then displays
  150.         'file1.ext' to standard output in a paged format.  Refer to
  151.         PC-LESS.ARC, LIST64A.ARC, and SEE15.ARC.  (These should be
  152.         available in most BBS libraries.)
  153.  
  154.  
  155.    d (Delete)
  156.  
  157.    LHarc d Archive.LZH file1.ext
  158.  
  159.         Deletes 'file1.ext' from 'Archive.LZH'.
  160.  
  161.  
  162.    l (List)
  163.  
  164.    LHarc l Archive.LZH
  165.  
  166.         Lists information about all the files in 'Archive.LZH'.
  167.         Each file takes one line of output.  A '+' before the file
  168.         name indicates that a directory na e is stored with the file
  169.         name. (The /x switch forces LHarc to display extended file
  170.         names.)
  171.  
  172.         If you specify file names and extensions, then only the
  173.         files with matching names or extensions will be listed:
  174.  
  175.    LHarc l Archive.LZH *.c *.h readme.DOC
  176.  
  177.         Lists information on all the .C, .H, and README.DOC files
  178.         in 'Archive.LZH'.
  179.  
  180.  
  181.    v (View)
  182.  
  183.    LHarc v Archive.LZH
  184.  
  185.         Which is equivalent to:
  186.  
  187.    LHarc l /x Archive.LZH
  188.  
  189.         Lists information about all the files in 'Archive.LZH',
  190.         except that each listing takes two lines: the first for the
  191.         full path name, and the second for the rest of the
  192.         information.  (The /x switch forces LHarc to display
  193.         extended file names.)
  194.  
  195.  
  196.    s (Self-extract)
  197.  
  198.    LHarc s [/x] [k<KEY>] Archive.LZH
  199.  
  200.         Creates a self-extracting file 'Archive.COM' (or
  201.         'Archive.EXE' if larger than 64K) from 'Archive.LZH' on the
  202.         specified drive or directory.
  203.  
  204.         NOTE:  There are now two versions of self-extracting
  205.                models.  The switch /x after s command specifies
  206.                large SFX to be made.  This always makes a file
  207.                Archive.EXE.  AUTOEXEC.BAT file can run on this
  208.                /x switch if key word KEY is properly typed.
  209.                You may self-extract a file of size more than
  210.                1 Mb in this mode.  Without the /x switch, you
  211.                have 'Archive.COM' or 'Archive.EXE' according to
  212.                the reduced size.  To have self-extracting file,
  213.                it is as large as the 640K DOS free-memory area.
  214.                Please check normally, to see whether your self-
  215.                extracting file exceeds 400K in size.  If more,
  216.                use the /x switch then.
  217.  
  218.  
  219.    (no command specified)
  220.  
  221.    LHarc Archive.LZH
  222.  
  223.         Acts exactly the same as the 'l' command.  This optional
  224.         action is temporary.  Don't count on it in future versions.
  225.  
  226.    LHarc t Archive.LZH
  227.  
  228.         Will check integrity of the archived file Archive.LZH by
  229.         CRC check.  This is new in this version 1.12.
  230.  
  231.  
  232.    Switches:
  233.    =========
  234.  
  235.    Specify switch(es) following the switch character '/'.  If you want
  236.    to specify more than one switch, type characters continuously
  237.    without any intervening spaces, like "/rxwe:\work" or "/cxvless".
  238.    When the 'v' and 'w' switches are used with other switches, they must
  239.    be specified at the end of a sequence, as shown in the above
  240.    examples.
  241.  
  242.    You may place a '+' or '-' sign after switches, with the following
  243.    meanings: '+' turns the switch on, and '-' turns the switch off.
  244.    The '2' creates a special option for the /r and /v switches (see
  245.    below).  If you just specify /<switch> without '+' or '-', then
  246.    <switch> will be toggled from 'on' to 'off' or vice