home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / cdrom / arj / rearj.doc < prev    next >
Text File  |  1993-07-20  |  20KB  |  503 lines
  1.  
  2.      User's Manual for the REARJ archive conversion program,    April 1993
  3.  
  4.  
  5.     REARJ software and manual copyright (c) 1991-93 by Robert K Jung.
  6.     All rights reserved.
  7.  
  8.     REARJ version 2.25 release
  9.  
  10.  
  11.  
  12.      INTRODUCTION:
  13.  
  14.      REARJ is an archive conversion program designed to facilitate the
  15.      conversion of LZH, ZIP, PAK, ARC, DWC, HYP, LZS, and ZOO archives to
  16.      the ARJ format.
  17.  
  18.      Registered ARJ users can order an improved version of REARJ that
  19.      offers !listfile selection and exclusion, file date-time selection,
  20.      REARJ_SW environment variable support, skipping a conversion when
  21.      the converted archive is larger, and other features.  And more
  22.      registered REARJ enhancements will be forthcoming.
  23.  
  24.  
  25.      MAJOR FEATURES:
  26.  
  27.      Supports all major archiver programs (PAK, LHARC, PKZIP, ZOO, ARJ,
  28.      PKPAK, DWC, HYPER, LARC, LHA).
  29.  
  30.      Supports file attributes within archives.
  31.  
  32.      Supports directories within archives.
  33.  
  34.      Supports converting archives within archives (ZIPs in a ZIP).
  35.  
  36.      Ensures reliable archive conversion with a file count and total size
  37.      check.
  38.  
  39.      Supports the use of virus checkers and BBS ad removers.
  40.  
  41.      Supports recursive scanning through subdirectories.
  42.  
  43.      Optional logging of conversions.
  44.  
  45.  
  46.      ********************
  47.      * WORDS OF CAUTION:*
  48.      ********************
  49.  
  50.      If you plan to convert many archives at one time, it is STRONGLY
  51.      suggested that you make a backup of your hard disk.  This is a wise
  52.      precaution to take any time that you make major modifications to data
  53.      on your hard disk drive.
  54.  
  55.      The standard REARJ conversion DOES NOT convert any archive comments
  56.      and volume labels.  They will be lost.
  57.  
  58.      Some of the other archivers have significant bugs which can cause data
  59.      loss that REARJ cannot detect.  It is not the purpose of this document
  60.      to point out other program's shortcomings.  I suggest logging the
  61.      conversion output to a printer to facilitate checking for errors.
  62.  
  63.      If the archives you are converting will ONLY extract to absolute
  64.      paths, you must use the /w option to set the working directory to an
  65.      empty root directory such as a RAMDRIVE.  This will allow extraction
  66.      to the root.
  67.  
  68.      REARJ and the archiver executables must be located in the DOS PATH
  69.      directories.  This is due to REARJ creating and using a temporary
  70.      directory.
  71.  
  72.      If you have changed the MS-DOS switch character from "/" to another
  73.      character via an undocumented MS-DOS interrupt or the TurboC
  74.      setswitchar() function, REARJ may not work properly with the default
  75.      REARJ.CFG configuration file.
  76.  
  77.      The most thorough testing was done with ARJ as the target format and
  78.      ZIP as the original format.  In any case, you should verify that the
  79.      extract commands of your favorite archive formats in the configuration
  80.      file are correct.    The extract commands are the most important to get
  81.      right because REARJ has a built-in verification procedure to ensure
  82.      that the ADD commands executed properly.
  83.  
  84.      You should NOT set the "-t1" option for ARJ in ARJ_SW or in the
  85.      REARJ.CFG configuration file.  This may cause file size mismatches.
  86.  
  87.      Be sure you have enough disk space on your working directory to
  88.      extract the largest archive that you want to convert!!!
  89.  
  90.  
  91.      The versions of archivers tested:
  92.  
  93.      ARJ   1.00, 1.10, 2.00, 2.10, 2.20, 2.21, 2.30, current release
  94.      LHA   2.12, 2.13
  95.      PAK   2.51
  96.      PKZIP 1.10
  97.      PKPAK 3.61
  98.      ZOO   2.01, 2.10
  99.      DWC   A5.01
  100.      LARC  3.33
  101.      HYPER 2.5
  102.  
  103.  
  104.      INSTALLATION:
  105.  
  106.      Copy REARJ.EXE and REARJ.CFG to one of the DOS PATH directories.  They
  107.      do not have to be placed in the same directory.  The PATH directories
  108.      are usually set by the PATH command in your AUTOEXEC.BAT file.  At
  109.      this version of REARJ, changing its name to something else will cause
  110.      operation difficulties.
  111.  
  112.      Be sure the archiver programs (ARJ, PAK, PKZIP, PKUNZIP, etc.) and
  113.      virus scanner are installed in a DOS PATH directory!  It is STRONGLY
  114.      recommended that the REARJ.CFG be modified to use FULL PATHNAMES to
  115.      specify all archiver executables.
  116.  
  117.      This version assumes that you have the new SCAN version 80 and use
  118.      the new option /sub to scan subdirectories.  This version's
  119.      configuration file also assumes that SCAN.EXE is installed in
  120.      the directory C:\BIN.
  121.  
  122.  
  123.      OPERATION OF REARJ:
  124.  
  125.      REARJ will build a temporary directory in the current directory and
  126.      extract the archive(s) to this directory.    REARJ will then build the
  127.      target archive(s) with the files in this directory.  If the target
  128.      archiver does not support reading of hidden or system files, REARJ
  129.      will reset those bits and then re-archive the files without those
  130.      attributes.  If the original archive has directories in it, REARJ will
  131.      extract it with full paths and re-archive it with full paths if the
  132.      target archiver supports directories.  In this case, if the archiver
  133.      does not support directories, REARJ will skip converting this archive.
  134.  
  135.      If the "/a" option has been selected, REARJ will execute REARJ to
  136.      convert any internal archives of the same type to the target format.
  137.      Any "/s" option will be carried over to the recursive REARJ command.
  138.  
  139.      As an extra test, REARJ will count the files extracted from the
  140.      original archive and total their sizes.  Then REARJ will extract the
  141.      new archive and count the files and total the sizes.  If the count and
  142.      size do not match, REARJ will skip converting the archive.
  143.  
  144.      REARJ assumes that the supported archivers will pass a non-zero error
  145.      code when there is an operation failure.
  146.  
  147.  
  148.      COMMAND SYNTAX:
  149.  
  150.      REARJ [switch options] filespec(s) or wildspec(s)
  151.  
  152.      You can specify one or more filespecs on the command line.  These
  153.      filespecs can have paths and wildcards.  Up to 100 filespecs can be
  154.      accepted by REARJ.  If you specify *.* as a wildspec, REARJ will look
  155.      at all filenames, but will skip those filenames not ending in standard
  156.      archive suffixes.    If you specify the /r switch, REARJ will look for
  157.      filenames matching the filespec(s) in the current directory and all
  158.      subdirectories of the current directory.
  159.  
  160.      The switch options and filespecs can be entered in any order.  REARJ
  161.      uses the default MS-DOS switch character "/".  REARJ uses the Turbo
  162.      C++ function getswitchar() to determine the MS-DOS switch character.
  163.      If the switch character is "-", REARJ will translate any UNIX style
  164.      pathnames to MS-DOS syntax ("dir/file" to "dir\file").
  165.  
  166.  
  167.      SWITCH OPTIONS:
  168.  
  169.      /a - convert archives within archives
  170.  
  171.       This option causes REARJ to recursively execute REARJ to convert
  172.       any archives of the original type found within the original
  173.       archive (ex. ZIPs within a ZIP).  This option requires additional
  174.       memory to execute successfully.
  175.  
  176.       You may specify the type of internal archive to convert with the
  177.       "/a" option.
  178.  
  179.       Examples:  REARJ *.zip /aLZH    convert only internal LZH archives.
  180.              REARJ *.zip /a*    convert any internal archive.
  181.  
  182.       If you use the "/a*" option, you may need to also specify "/u"
  183.       because of nested archives of the target type.
  184.  
  185.      /b - execute command before extracting files
  186.  
  187.       This option is used to specify a DOS command to be executed before
  188.       extracting the original archive.
  189.  
  190.       In addition, REARJ passes the name of the original archive to
  191.       this command as a command line argument when executing it.  This
  192.       may cause a problem with DOS commands that expect no arguments.
  193.       A workaround would be to install the DOS command in a batch file.
  194.  
  195.       This feature is to allow the user to prep the environment before
  196.       extracting the archive.  This can be used to prep for archive
  197.       comments or volume labels, etc.
  198.  
  199.      /c - execute command on extracted files before counting them
  200.  
  201.       This option is used to speci