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