home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 October / Chip_1997-10_cd.bin / sharewar / jar / jar101dx.exe / INTRO.DOC < prev    next >
Text File  |  1996-11-09  |  6KB  |  193 lines
  1.  
  2.     INTRO.DOC                                                November 1996
  3.  
  4.  
  5.     INTRODUCTION:
  6.  
  7.  
  8.     This document is intended for new users of the file archiver, JAR.
  9.  
  10.     JAR is a program that allows the user to store one or more files in a
  11.     compressed format in an archive file.
  12.  
  13.  
  14.     INSTALLATION:
  15.  
  16.  
  17.     This assumes that you have already executed the self-extracting
  18.     distribution archive and extracted its archived files into a directory.
  19.  
  20.     To install the JAR software, simply copy JAR16.EXE, JAR32.EXE, JAR.CFG,
  21.     REARJ.EXE, REARJ.CFG and optionally JAR_C.COM and JAR_C.DLL (available
  22.     in the non-export version only) to one of the directories named in your
  23.     DOS PATH statement found in your AUTOEXEC.BAT. On many PCs, this
  24.     directory may be C:\DOS or C:\BIN.
  25.  
  26.     In addition, for a DOS machine or for a DOS environment one MB of
  27.     available XMS strongly recommended.  Four MB of EMS preferred for
  28.     outstanding compression.  More memory is better.  Detailed information
  29.     about memory usage is available in JAR.DOC in section "HOW JAR USES
  30.     AVAILABLE MEMORY".
  31.  
  32.  
  33.     JAR COMMAND USAGE:
  34.  
  35.  
  36.     The JAR archiver gives you a lot of flexibility in command usage. You
  37.     can use zero options or many options on a command line.
  38.  
  39.     The basic command line consists of:
  40.     1) the command "JAR16" or "JAR32"
  41.     2) the JAR command letter(s) such as "a" (add), or "e" (extract)
  42.     3) the switch options such as "-r" (recurse through subdirectories)
  43.     4) the name of the JAR archive
  44.     5) the names of the selected files
  45.  
  46.     JAR16 <command> [<options>] <archive_name> [<files>]
  47.  
  48.     Switch options (-r, -hk, and so on) may be placed anywhere in the
  49.     command line after the command "JAR16".  The default for the selected
  50.     files is "*.*".
  51.  
  52.     To run the 32-bit JAR version (for Windows 95 and Windows NT) instead
  53.     of the "JAR16" command you must specify "JAR32". "JAR32.EXE" is a
  54.     32-bit executable which does not run in DOS but works in Windows 95 and
  55.     Windows NT. "JAR32.EXE" is much faster and compresses better than the
  56.     DOS version "JAR16.EXE".
  57.  
  58.  
  59.     CREATING JAR ARCHIVES:
  60.  
  61.  
  62.     To create an JAR archive containing all of the files in the current
  63.     directory:
  64.  
  65.        JAR16 a archive
  66.  
  67.     To create an JAR archive in another directory containing all of the
  68.     files in the current directory:
  69.  
  70.        JAR16 a directory\archive
  71.  
  72.     To create an JAR archive containing all files with the ".DOC" extension
  73.     in the current directory:
  74.  
  75.        JAR16 a archive *.DOC
  76.  
  77.     To create an JAR archive containing all files with the ".DOC" and
  78.     ".EXE" extension in the current directory:
  79.  
  80.        JAR16 a archive *.DOC *.EXE
  81.  
  82.     To create an JAR archive containing all of the files in a named
  83.     directory:
  84.  
  85.        JAR16 a archive named\*.*
  86.  
  87.     To create an JAR archive containing all of the files in the named
  88.     directory and all files in subdirectories of the named directory:
  89.  
  90.        JAR16 a -r archive named\*.*
  91.  
  92.     For maximum compression, use the "-m3" or "-m4" options. For better
  93.     speed, use the -m1 option.
  94.  
  95.        JAR16 a -r -m4 archive named\*.*
  96.  
  97.     To use the 32-bit JAR version simply replace JAR16 with JAR32.
  98.  
  99.  
  100.     LISTING THE CONTENTS OF AN ARCHIVE:
  101.  
  102.  
  103.     To list all of the files in an archive:
  104.  
  105.        JAR16 l archive
  106.  
  107.     To list all of the files in short form:
  108.  
  109.        JAR16 ls archive
  110.  
  111.     It may be useful to redirect the listing to a file or pipe:
  112.  
  113.        JAR16 ls archive > archive.lst
  114.        JAR16 ls archive | more
  115.  
  116.     To view only the files with a ".DOC" file extension in an archive:
  117.  
  118.        JAR16 v archive *.DOC
  119.  
  120.  
  121.     EXTRACTING JAR ARCHIVES:
  122.  
  123.  
  124.     To extract all of the files in an archive to the current directory:
  125.  
  126.        JAR16 e archive
  127.  
  128.     To extract all of the files in an archive to a named directory:
  129.  
  130.        JAR16 e archive -onamed
  131.  
  132.     To extract all files with the ".DOC" extension to the current
  133.     directory:
  134.  
  135.        JAR16 e archive *.DOC
  136.  
  137.     To extract all of the files in an archive recreating the original
  138.     directory structure:
  139.  
  140.        JAR16 x archive
  141.  
  142.  
  143.     TESTING THE INTEGRITY OF AN ARCHIVE:
  144.  
  145.  
  146.     To test the contents of an archive:
  147.  
  148.        JAR16 t archive
  149.  
  150.     This testing verifies that the contents of the archive data matches the
  151.     original file. This is done using cyclical redundancy checksumming, CRC
  152.     for short. JAR uses a 32 bit CRC for increased reliability.
  153.  
  154.  
  155.     COMMON PROBLEMS USING JAR:
  156.  
  157.  
  158.     By default, JAR stores the path specified with the filename in the
  159.     archive.  "JAR16 a archive temp\*.*" will store the path "temp\" with
  160.     the filenames. Another alternative is to store the RELATIVE path using
  161.     the "-jf-" option.
  162.  
  163.     When updating an JAR archive, JAR builds the new archive as a temporary
  164.     file in the same directory as the original archive. This can require a
  165.     lot of extra disk space. If you are adding files, you will need as much
  166.     free space as the original archive plus space for the added files.
  167.  
  168.     When archiving files to DISKETTES, it is STRONGLY recommended that you
  169.     use the "-w" and "-hk" options.  The "-w" option sets a working
  170.     directory.  This should point to a fast disk drive directory.  The
  171.     "-hk" adds recovery records which will allow you to repair a slightly
  172.     damaged archive (this is a common problem when using diskettes).  In
  173.     addition, the "-jt" option may be used to test the created archive;
  174.     however, this requires a re-read of all the diskettes.
  175.  
  176.     JAR16 a -wc:\ -hk a:archive *.*
  177.  
  178.     When copying archives to DISKETTES, it is strongly recommended that you
  179.     verify that the diskette archives are intact.  Most damaged archives
  180.     involve diskettes.
  181.  
  182.  
  183.     FOR FURTHER STUDY:
  184.  
  185.  
  186.     JAR supports a great number of options for functions such as archiving
  187.     across multiple diskettes, accessing files with selected attributes,
  188.     selecting files by date, and more. See the JAR.DOC reference guide for
  189.     more information.
  190.  
  191.  
  192.     end of document
  193.