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