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