home *** CD-ROM | disk | FTP | other *** search
/ The Ham Radio & Scanner Companion / scanner.iso / pcutil1 / arj239.exe / INTRO.DOC < prev    next >
Text File  |  1992-11-22  |  7KB  |  221 lines
  1.  
  2.      INTRO.DOC                            October 1992
  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 bytes.  Combining 100 small files in an archive can save up to
  14.     200 K bytes of space.
  15.  
  16.     Currently, ARJ is the leading PC archiver in terms of archive size,
  17.     power and flexibility.
  18.  
  19.  
  20.      INSTALLATION:
  21.  
  22.     This assumes that you have already executed ARJ240.EXE and
  23.     extracted its archived files into a 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 may use no 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
  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.  
  117.      EXTRACTING ARJ ARCHIVES:
  118.  
  119.     To extract all of the files in an archive to the current
  120.     directory:
  121.  
  122.         ARJ e archive
  123.  
  124.     To extract all of the files in an archive to a named directory:
  125.  
  126.         ARJ e archive named_directory\
  127.  
  128.     To extract all files with the ".DOC" extension to the current
  129.     directory:
  130.  
  131.         ARJ e archive *.DOC
  132.  
  133.     To extract all of the files in an archive recreating the
  134.     original directory structure:
  135.  
  136.         ARJ x archive
  137.  
  138.     To extract all of the files in an archive containing absolute
  139.     pathnames to the original paths:
  140.  
  141.         ARJ x -jf archive
  142.  
  143.  
  144.      TESTING THE INTEGRITY OF AN ARCHIVE:
  145.  
  146.     To test the contents of an archive:
  147.  
  148.         ARJ t archive
  149.  
  150.     This testing verifies that the contents of the archive data matches
  151.     the original file.  This is done using cylical redundancy checking,
  152.     CRC for short.    ARJ uses a 32 bit CRC for increased reliability.
  153.  
  154.  
  155.      CREATING A SELF-EXTRACTING ARJ ARCHIVE:
  156.  
  157.     A self-extracting ARJ archive is an EXE file that contains an ARJ
  158.     archive.  This self-extractor will when executed extract the
  159.     contents of its archive.
  160.  
  161.     The command "ARJ y -je archive" will create a full featured
  162.     self-extracting archive from an already built archive.
  163.  
  164.     The command "ARJ y -je1 archive" will create a smaller
  165.     self-extracting archive.
  166.  
  167.     Syntax:  ARJ y -je archive    produces archive.exe
  168.  
  169.  
  170.      CONVERTING ZIP ARCHIVES TO ARJ ARCHIVES:
  171.  
  172.     You can convert a directory of ZIP archives to ARJ archives with
  173.     the following commands:
  174.  
  175.     1)  Change to the directory with the ZIP archives.
  176.     2)  Type REARJ *.ZIP
  177.  
  178.  
  179.      COMMON PROBLEMS USING ARJ:
  180.  
  181.     By default, ARJ stores the path specified with the filename in the
  182.     archive.  "ARJ a archive temp\*.*" will store the path "temp\" with
  183.     the filenames.    You may eliminate the paths with the "-e" option.
  184.     You can remove the paths with the "r" command as in "ARJ r archive".
  185.  
  186.     ARJ identifies each file by the name stored in the archive.
  187.     Filenames with paths are considered by ARJ to be DIFFERENT from
  188.     filenames without paths.  In other words, "temp\notes" is not the
  189.     same as "notes".  This can result in archives that have duplicates
  190.     if you archive a set of files twice with different file
  191.     specifications as in
  192.     "ARJ a archive temp\*.*" and "ARJ a archive *.*".
  193.  
  194.     When updating an ARJ archive, ARJ builds the new archive as a
  195.     temporary file in the same directory as the original archive.  This
  196.     can require a lot of extra disk space.    If you are adding files,
  197.     you will need as much free space as the original archive plus space
  198.     for the added files.
  199.  
  200.     When archiving files to DISKETTES, it is STRONGLY recommended that
  201.     you use the "-w" option and the "-jt" option.  The "-w" option sets
  202.     a working directory.  This should point to a fast disk drive
  203.     directory.  The "-jt" option verifies the archive.
  204.  
  205.     ARJ a -wC:\ -jt a:archive *.*
  206.  
  207.     When copying archives to DISKETTES, it is strongly recommended that
  208.     you verify that the diskette archives are intact.  Most damaged
  209.     archives involve diskettes.
  210.  
  211.  
  212.      FOR FURTHER STUDY:
  213.  
  214.     ARJ supports hundreds of options for functions such as archiving
  215.     across multiple diskettes, accessing hidden files, selecting files
  216.     by date, and more.  See the ARJ.DOC reference guide for more
  217.     information.
  218.  
  219.  
  220.      end of document
  221.