home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CD-ROM Aktief 1995 #3
/
CDA3.iso
/
cdrom
/
arj
/
arj241a.exe
/
REARJ.DOC
< prev
next >
Wrap
Text File
|
1993-07-20
|
20KB
|
503 lines
User's Manual for the REARJ archive conversion program, April 1993
REARJ software and manual copyright (c) 1991-93 by Robert K Jung.
All rights reserved.
REARJ version 2.25 release
INTRODUCTION:
REARJ is an archive conversion program designed to facilitate the
conversion of LZH, ZIP, PAK, ARC, DWC, HYP, LZS, and ZOO archives to
the ARJ format.
Registered ARJ users can order an improved version of REARJ that
offers !listfile selection and exclusion, file date-time selection,
REARJ_SW environment variable support, skipping a conversion when
the converted archive is larger, and other features. And more
registered REARJ enhancements will be forthcoming.
MAJOR FEATURES:
Supports all major archiver programs (PAK, LHARC, PKZIP, ZOO, ARJ,
PKPAK, DWC, HYPER, LARC, LHA).
Supports file attributes within archives.
Supports directories within archives.
Supports converting archives within archives (ZIPs in a ZIP).
Ensures reliable archive conversion with a file count and total size
check.
Supports the use of virus checkers and BBS ad removers.
Supports recursive scanning through subdirectories.
Optional logging of conversions.
********************
* WORDS OF CAUTION:*
********************
If you plan to convert many archives at one time, it is STRONGLY
suggested that you make a backup of your hard disk. This is a wise
precaution to take any time that you make major modifications to data
on your hard disk drive.
The standard REARJ conversion DOES NOT convert any archive comments
and volume labels. They will be lost.
Some of the other archivers have significant bugs which can cause data
loss that REARJ cannot detect. It is not the purpose of this document
to point out other program's shortcomings. I suggest logging the
conversion output to a printer to facilitate checking for errors.
If the archives you are converting will ONLY extract to absolute
paths, you must use the /w option to set the working directory to an
empty root directory such as a RAMDRIVE. This will allow extraction
to the root.
REARJ and the archiver executables must be located in the DOS PATH
directories. This is due to REARJ creating and using a temporary
directory.
If you have changed the MS-DOS switch character from "/" to another
character via an undocumented MS-DOS interrupt or the TurboC
setswitchar() function, REARJ may not work properly with the default
REARJ.CFG configuration file.
The most thorough testing was done with ARJ as the target format and
ZIP as the original format. In any case, you should verify that the
extract commands of your favorite archive formats in the configuration
file are correct. The extract commands are the most important to get
right because REARJ has a built-in verification procedure to ensure
that the ADD commands executed properly.
You should NOT set the "-t1" option for ARJ in ARJ_SW or in the
REARJ.CFG configuration file. This may cause file size mismatches.
Be sure you have enough disk space on your working directory to
extract the largest archive that you want to convert!!!
The versions of archivers tested:
ARJ 1.00, 1.10, 2.00, 2.10, 2.20, 2.21, 2.30, current release
LHA 2.12, 2.13
PAK 2.51
PKZIP 1.10
PKPAK 3.61
ZOO 2.01, 2.10
DWC A5.01
LARC 3.33
HYPER 2.5
INSTALLATION:
Copy REARJ.EXE and REARJ.CFG to one of the DOS PATH directories. They
do not have to be placed in the same directory. The PATH directories
are usually set by the PATH command in your AUTOEXEC.BAT file. At
this version of REARJ, changing its name to something else will cause
operation difficulties.
Be sure the archiver programs (ARJ, PAK, PKZIP, PKUNZIP, etc.) and
virus scanner are installed in a DOS PATH directory! It is STRONGLY
recommended that the REARJ.CFG be modified to use FULL PATHNAMES to
specify all archiver executables.
This version assumes that you have the new SCAN version 80 and use
the new option /sub to scan subdirectories. This version's
configuration file also assumes that SCAN.EXE is installed in
the directory C:\BIN.
OPERATION OF REARJ:
REARJ will build a temporary directory in the current directory and
extract the archive(s) to this directory. REARJ will then build the
target archive(s) with the files in this directory. If the target
archiver does not support reading of hidden or system files, REARJ
will reset those bits and then re-archive the files without those
attributes. If the original archive has directories in it, REARJ will
extract it with full paths and re-archive it with full paths if the
target archiver supports directories. In this case, if the archiver
does not support directories, REARJ will skip converting this archive.
If the "/a" option has been selected, REARJ will execute REARJ to
convert any internal archives of the same type to the target format.
Any "/s" option will be carried over to the recursive REARJ command.
As an extra test, REARJ will count the files extracted from the
original archive and total their sizes. Then REARJ will extract the
new archive and count the files and total the sizes. If the count and
size do not match, REARJ will skip converting the archive.
REARJ assumes that the supported archivers will pass a non-zero error
code when there is an operation failure.
COMMAND SYNTAX:
REARJ [switch options] filespec(s) or wildspec(s)
You can specify one or more filespecs on the command line. These
filespecs can have paths and wildcards. Up to 100 filespecs can be
accepted by REARJ. If you specify *.* as a wildspec, REARJ will look
at all filenames, but will skip those filenames not ending in standard
archive suffixes. If you specify the /r switch, REARJ will look for
filenames matching the filespec(s) in the current directory and all
subdirectories of the current directory.
The switch options and filespecs can be entered in any order. REARJ
uses the default MS-DOS switch character "/". REARJ uses the Turbo
C++ function getswitchar() to determine the MS-DOS switch character.
If the switch character is "-", REARJ will translate any UNIX style
pathnames to MS-DOS syntax ("dir/file" to "dir\file").
SWITCH OPTIONS:
/a - convert archives within archives
This option causes REARJ to recursively execute REARJ to convert
any archives of the original type found within the original
archive (ex. ZIPs within a ZIP). This option requires additional
memory to execute successfully.
You may specify the type of internal archive to convert with the
"/a" option.
Examples: REARJ *.zip /aLZH convert only internal LZH archives.
REARJ *.zip /a* convert any internal archive.
If you use the "/a*" option, you may need to also specify "/u"
because of nested archives of the target type.
/b - execute command before extracting files
This option is used to specify a DOS command to be executed before
extracting the original archive.
In addition, REARJ passes the name of the original archive to
this command as a command line argument when executing it. This
may cause a problem with DOS commands that expect no arguments.
A workaround would be to install the DOS command in a batch file.
This feature is to allow the user to prep the environment before
extracting the archive. This can be used to prep for archive
comments or volume labels, etc.
/c - execute command on extracted files before counting them
This option is used to speci