home *** CD-ROM | disk | FTP | other *** search
/ Gambler 5 / GAMBLERCD05.BIN / utils / arch / arj / arj250a.exe / INTRO.DOC < prev    next >
Text File  |  1995-12-12  |  7KB  |  230 lines
  1.  
  2.      INTRO.DOC                                                   July 1995
  3.  
  4.  
  5.      INTRODUCTION:
  6.  
  7.     This document is intended for new users of the file archiver, ARJ.
  8.  
  9.     ARJ is a program that allows the user to store one or more files in
  10.     a compressed format in an archive file.  This saves space both in
  11.     the compression and in the saving of disk sector clusters.  On a
  12.     hard disk, each file requires a minimum amount of space, typically,
  13.         2048 to 8192 bytes.  Combining 100 small files in an archive can
  14.         save 200K bytes of space or more.
  15.  
  16.     For archiver flexibility, ARJ is arguably unsurpassed for features.
  17.  
  18.  
  19.      INSTALLATION:
  20.  
  21.     This assumes that you have already executed the self-extracting
  22.     distribution archive and extracted its archived files into a
  23.     directory.
  24.  
  25.     To install the ARJ software, simply copy ARJ.EXE, REARJ.EXE,
  26.     REARJ.CFG, and ARJSORT.COM to one of the directories named in your
  27.     DOS PATH statement found in your AUTOEXEC.BAT.    On many PCs, this
  28.     directory may be C:\DOS or C:\BIN.
  29.  
  30.  
  31.      ARJ COMMAND USAGE:
  32.  
  33.     The ARJ archiver gives you a lot of flexibility in command usage.
  34.     You can use zero options or many options on a command line.
  35.  
  36.     The basic command line consists of:
  37.     1) the command "ARJ"
  38.     2) the ARJ command letter such as "a" (add), or "e" (extract)
  39.     3) the switch options such as "-r" (recurse through subdirectories)
  40.     4) the name of the ARJ archive
  41.     5) the name of the target directory (if any)
  42.     6) the names of the selected files
  43.  
  44.     ARJ <command> [<options>] <archive_name> [<target_dir\>] [<files>]
  45.  
  46.     Switch options (-r, -jp, and so on) may be placed anywhere in the
  47.     command line after the command "ARJ".  The target directory name is
  48.     optional and should end in a "\" symbol.  The default for the
  49.     selected files is "*.*".
  50.  
  51.  
  52.      CREATING ARJ ARCHIVES:
  53.  
  54.     To create an ARJ archive containing all of the files in the
  55.     current directory:
  56.  
  57.         ARJ a archive
  58.  
  59.     To create an ARJ archive in another directory containing all of
  60.     the files in the current directory:
  61.  
  62.         ARJ a directory\archive
  63.  
  64.     To create an ARJ archive containing all files with the ".DOC"
  65.     extension in the current directory:
  66.  
  67.         ARJ a archive *.DOC
  68.  
  69.     To create an ARJ archive containing all files with the ".DOC"
  70.     and ".EXE" extension in the current directory:
  71.  
  72.         ARJ a archive *.DOC *.EXE
  73.  
  74.     To create an ARJ archive containing all of the files in a
  75.     named directory:
  76.  
  77.         ARJ a archive named_directory\*.*
  78.  
  79.     To create an ARJ archive containing all of the files in the
  80.     named directory and all files in subdirectories of the named
  81.     directory:
  82.  
  83.         ARJ a -r archive named_directory\*.*
  84.  
  85.     To create an archive containing files without pathname information
  86.     in the archive, creating slightly smaller archives:
  87.  
  88.         ARJ a -e archive named_directory\*.*
  89.  
  90.     For maximum compression, use the "-jm" or "-jm1" options.
  91.     For better speed, use the -m2 option.
  92.  
  93.         ARJ a -r -jm1 archive named_directory\*.*
  94.         ARJ a -r -m2 archive named_directory\*.*
  95.  
  96.     To create an ARJ archive containing the full specified pathnames
  97.     of the stored files including any drive and root specs:
  98.  
  99.         ARJ a -r -jf archive C:\top_directory\*.*
  100.  
  101.  
  102.      LISTING THE CONTENTS OF AN ARCHIVE:
  103.  
  104.     To list all of the files in an archive:
  105.  
  106.         ARJ l archive
  107.  
  108.     To list all of the files with display pauses:
  109.  
  110.         ARJ l archive -jp
  111.  
  112.     To list only the files with a ".DOC" file extension in an archive:
  113.  
  114.         ARJ l archive *.DOC
  115.  
  116.     The last field on the LIST display "BTPMGVX" stands for:
  117.         B -> file has been marked as a backup
  118.         T -> text/binary/directory type
  119.         P -> path information available in "V" listing
  120.         M -> compression method used
  121.         G -> file has been garbled (encrypted)
  122.         V -> archive has been continued to another volume
  123.         X -> this file is an extended portion of a larger file
  124.  
  125.  
  126.      EXTRACTING ARJ ARCHIVES:
  127.  
  128.     To extract all of the files in an archive to the current
  129.     directory:
  130.  
  131.         ARJ e archive
  132.  
  133.     To extract all of the files in an archive to a named directory:
  134.  
  135.         ARJ e archive named_directory\
  136.  
  137.     To extract all files with the ".DOC" extension to the current
  138.     directory:
  139.  
  140.         ARJ e archive *.DOC
  141.  
  142.     To extract all of the files in an archive recreating the
  143.     original directory structure:
  144.  
  145.         ARJ x archive
  146.  
  147.     To extract all of the files in an archive containing absolute
  148.     pathnames to the original paths:
  149.  
  150.         ARJ x -jf archive
  151.  
  152.  
  153.      TESTING THE INTEGRITY OF AN ARCHIVE:
  154.  
  155.     To test the contents of an archive:
  156.  
  157.         ARJ t archive
  158.  
  159.     This testing verifies that the contents of the archive data matches
  160.     the original file.  This is done using cylical redundancy checking,
  161.     CRC for short.    ARJ uses a 32 bit CRC for increased reliability.
  162.  
  163.  
  164.      CREATING A SELF-EXTRACTING ARJ ARCHIVE:
  165.  
  166.     A self-extracting ARJ archive is an EXE file that contains an ARJ
  167.     archive.  This self-extractor when executed will extract the
  168.     contents of its archive.
  169.  
  170.     The command "ARJ y -je archive" will create a full featured
  171.     self-extracting archive from an already built archive.
  172.  
  173.     The command "ARJ y -je1 archive" will create a smaller
  174.     self-extracting archive.
  175.  
  176.     Syntax:  ARJ y -je archive    produces archive.exe
  177.  
  178.  
  179.      CONVERTING ZIP ARCHIVES TO ARJ ARCHIVES:
  180.  
  181.     You can convert a directory of ZIP archives to ARJ archives with
  182.     the following commands:
  183.  
  184.     1)  Change to the directory with the ZIP archives.
  185.     2)  Type REARJ *.ZIP
  186.  
  187.  
  188.      COMMON PROBLEMS USING ARJ:
  189.  
  190.     By default, ARJ stores the path specified with the filename in the
  191.     archive.  "ARJ a archive temp\*.*" will store the path "temp\" with
  192.     the filenames.    You may eliminate the paths with the "-e" option.
  193.     You can remove the paths with the "r" command as in "ARJ r archive".
  194.  
  195.     ARJ identifies each file by the name stored in the archive.
  196.     Filenames with paths are considered by ARJ to be DIFFERENT from
  197.     filenames without paths.  In other words, "temp\notes" is not the
  198.     same as "notes".  This can result in archives that have duplicates
  199.     if you archive a set of files twice with different file
  200.     specifications as in
  201.     "ARJ a archive temp\*.*" and "ARJ a archive *.*".
  202.  
  203.     When updating an ARJ archive, ARJ builds the new archive as a
  204.     temporary file in the same directory as the original archive.  This
  205.     can require a lot of extra disk space.    If you are adding files,
  206.     you will need as much free space as the original archive plus space
  207.     for the added files.
  208.  
  209.     When archiving files to DISKETTES, it is STRONGLY recommended that
  210.     you use the "-w" option and the "-jt" option.  The "-w" option sets
  211.     a working directory.  This should point to a fast disk drive
  212.     directory.  The "-jt" option verifies the archive.
  213.  
  214.     ARJ a -wC:\ -jt a:archive *.*
  215.  
  216.     When copying archives to DISKETTES, it is strongly recommended that
  217.     you verify that the diskette archives are intact.  Most damaged
  218.     archives involve diskettes.
  219.  
  220.  
  221.      FOR FURTHER STUDY:
  222.  
  223.     ARJ supports hundreds of options for functions such as archiving
  224.     across multiple diskettes, accessing hidden files, selecting files
  225.     by date, and more.  See the ARJ.DOC reference guide for more
  226.     information.
  227.  
  228.  
  229.      end of document
  230.