home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / LARC24.ZIP / LARC24.DOC < prev   
Encoding:
Text File  |  1990-03-17  |  6.4 KB  |  188 lines
  1.  
  2.   LARC Utility                          Version 2.4     Page 1
  3.   ------------                           March 17, 1989
  4.  
  5.   Purpose:
  6.  
  7.     To create the smallest possible archive files.
  8.  
  9.   Usage:
  10.     LARC d:[\inpath\]filespec  [d:\outpath]
  11. |                   [/A] [/C] [/G] [/K] [/P] [/Z] [/H]
  12.                    [/L] [/R]
  13.  
  14.     The input drive and/or path is required and specifies the
  15.     location of file(s) to be processed.  The inpath name is
  16.     optional.  You may include wildcards.  The extension defaults
  17.     to ARC.
  18.  
  19.     The output drive and path are optional. If omitted, the
  20.     original ARC files are replaced with any smaller versions
  21.     created by the LARC process. If supplied, all archive files
  22.     are newly created in the output directory. This is handy
  23.     for insuring that you get the archive file in the format
  24.     that you want, e.g. in SEA ARC format only.
  25.  
  26.     At least two disk directories are required.  The first (from
  27.     d:\inpath) contains the original files.  The second (the
  28.     current drive and path) is used for temporary storage where
  29.     all  files are extracted and re-created.  A large RAM disk
  30.     is recommended.  Optionally, a third directory (from
  31.     d:\outpath) is used as the destination for all new files.
  32.  
  33.     You MUST not have the d:\inpath the same as the current drive
  34.     and path.  The current drive (and directory) is used for
  35.     temporary work space. You can have the inpath and outpath the
  36.     same to force replacement of all existing ARC files. The smallest
  37.     files - in terms of bytes,  not clusters - is used.
  38.  
  39.     Use one or more of the option switches to specify the program(s)
  40.     to be used for creating archive files:
  41.  
  42.       /A for ARCA          /K for PKARC        /H for LHARC
  43.       /C for SEA's ARC        /P for PKPAK
  44.       /G for GSARC or PAK      /Z for PKZIP
  45.  
  46.     If none is supplied, the default is to use ARCA only.
  47.  
  48.  
  49.   LARC Utility           OPERATION              Version 2.4     Page 2
  50.   ------------                           March 17, 1989
  51.  
  52.     If an LBR library file is encountered, it is converted to
  53.     an ARC file. You must have LUE.COM available in the DOS path.
  54.     If you plan to just convert LBR files, use an input file
  55.     specification of "*.LBR" to avoid unnecessary processing.
  56.     The LBR file is not deleted unless the /L option is supplied.
  57.     This gives you complete control of the process.
  58.  
  59.     A summary report is produced at the end of the program. It
  60.     is normally displayed on the screen, but you can have a
  61.     duplicate written to the file LARC.RPT by supplying the /R
  62.     option on the command line.
  63.  
  64.     You should have ARCA, PKXARC, PKARC, PKPAK, PKZIP, PAK, LUE
  65.     and ARC.EXE accessible from the DOS path, preferably in a RAM
  66.     disk, depending on the options supplied pn the command line. Of
  67.     course, you may substitute BAT files for any of those programs.
  68.  
  69.  
  70.     Each ARC file is individually unpacked by PKXARC (so that
  71.     squashed files can be processed), and then ARCed using ARC,
  72.     PKARC, PKPAK and/or ARCA. If any of the resulting ARC files is
  73.     smaller than the original, the original is immediately
  74.     replaced. The original ARC file's date and time are preserved.
  75.  
  76.     Each PAK file is unpacked by the GSARC/PAK program. If /G is
  77.     specified, a PAK file is created in place of the original
  78.     ARC file.
  79.  
  80.     Each ZIP file is unpacked with PKUNZIP. If /Z is specified,
  81.     a new ZIP file is created in place of the original ARC, LBR,
  82.     or PAK file if the ZIP file is smaller.
  83.  
  84.     It takes a long time to process several archive files. Figure
  85.     an hour for 10 megs of files on an AT.    LARC beeps when
  86.     it is finished, and displays a summary of the files processed.
  87.  
  88.     You can eliminate squashed files by using an early version
  89.     of PKARC, or by patching PKARC to disable squashing.
  90.  
  91.     I use LARC to process newly uploaded files. It is a brute
  92.     force method of testing the integrity of the files, and
  93.     results in saving disk space.
  94.  
  95.  
  96.  
  97.   LARC Utility           EXAMPLES              Version 2.4     Page 3
  98.   ------------                           March 17, 1989
  99.  
  100.  
  101.      o    There are several ARC files in the directory C:\TEST; drive
  102.     D: is an 800K RAM disk. Any smaller ARC files replace the
  103.     existing files. Only ARC is used.
  104.  
  105.          d:|cd \
  106.          larc c:\test\*
  107.  
  108.      o    All ARC files in the directory C:\UPLOADS are copied to a
  109.     new directory, C:\TEST, in their smallest versions. The disk
  110.     directory C:\WORK is the current directory and is used for
  111.     temporarily extracting ARC files. All files in C:\WORK are
  112.     deleted. Both ARCA and PKARC are used.
  113.  
  114.          c:|cd \work
  115.          larc c:\uploads\* c:\test /A/P
  116.  
  117.      o    Convert all library LBR files on C:\TEST to ARC files, and
  118.     delete the original library files. Drive d: is used for
  119.     temporary storage.
  120.  
  121.          d:
  122.          larc c:\test\*.lbr /l
  123.  
  124.      o    Replace existing ARC file on B:\ with the smallest ARC
  125.     files. Drive C: is used for temporary storage.
  126.  
  127.          c:
  128.          larc b:\* b:\ /a/p/c
  129.  
  130.  
  131.  
  132.   LARC Utility        VERSION HISTORY           Version 2.4     Page 4
  133.   ------------                           March 17, 1989
  134.  
  135.    1.5, 3/15/87
  136.     Ccorrects an overflow (error 6) problem, and adds another check to
  137.     be sure that the temporary directory is different from the input and
  138.     output directories. Remember, all files in the temporary directory
  139.     are deleted.
  140.  
  141.     Also, DOS 3.1 or later is required for proper operation.
  142.     There's no guarentee of anything, anyway.
  143.  
  144.  
  145.    1.6, 4/15/87
  146.     Adds more checks to insure that the temporary directory is empty.
  147.     Also, you may now press ESCape while LARC is running to cancel it.
  148.     A check was added to stop processing if an error occurred creating
  149.     a new ARC file
  150.  
  151.    2.1, 2/24/89
  152.     Adds internal tables for specifying the various programs to be used.
  153.     The defaults include ARCA, ARC, PAK, PKARC, PKPAK, and PKZIP.
  154.  
  155.    2.2, 3/08/89
  156.     Correct a problem deleting original ARC files
  157.  
  158. |  2.3, 9/05/89
  159. |    Changes to info screen.
  160. |  2.4, 3/17/90
  161. |    Add /H option to process LHARC (.LZH) files
  162. |    Approximately 256k of memory is required.
  163.  
  164.     Use LARC at your own risk. There is no warranty or guarentee
  165.     that the program will work as expected.
  166.  
  167.  
  168.             Notes
  169.             -----
  170.  
  171.     (c) Copyright Vernon D. Buerg 1987-90. All rights reserved.
  172.  
  173.               139 White Oak Circle
  174.               Petaluma, CA  94952
  175.               VOR BBS: (707) 778-8944
  176.               Compuserve: 70007,1212 (Go IBMSYS)
  177.  
  178.     Written in MS BASIC Compiler version 7 using the ADVBAS (v9B)
  179.     object library by Thomas Hanlin III, 6812 Sydenstricker Rd.,
  180.     Springfield, VA 22152.
  181.  
  182.     The LARC program and materials may be distributed and copied
  183.     with these restrictions:
  184.  
  185.         - no fee is charged,
  186.         - the material is not modified.
  187.  
  188.