home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Original Shareware 1992
/
TheOrigSharewareV1.cdr
/
25
/
arj200.exe
/
arj
/
UPDATE.DOC
< prev
next >
Wrap
Text File
|
1991-04-10
|
21KB
|
538 lines
UPDATE.DOC, ARJ 2.00 April 1991
This documents new or updated information since ARJ 1.00.
***IMPORTANT CHANGES*****************************************************
At 2.00, ARJ methods 1 and 2 compression have been greatly improved
in compression speed. Method 1 speed and compression is better than
LHA 2.12. Method 2 speed is similar to PKZIP (slower on some files
and faster on other files) and always with better compression.
Methods 3 and 4 are only slightly faster than 1 and 2 now. Method 2
is aimed at those who want PKZIP-like speed and better compression.
The options "-l", "-ji", "-z" will now prompt for file overwrite
situations. If you choose not to overwrite, ARJ will abort with an
error.
If you created archives with the "-jf" option to store full paths,
then you will need to use the "-jf" option with the "x" command to
restore to the full path.
Example: ARJ a backup C:\DOS\*.* -jf
ARJ x backup -jf
ARJ x backup C:\ (also works)
At 1.10, ARJ no longer supports the older version of method 4
compression used by ARJ 0.13 and 0.14. ARJ cannot extract files
compressed with the older version of method 4. However, ARJ supports
the version of method 4 used by ARJ 0.15 and up. It is suggested
that any files compressed with the older method 4 be extracted and
rearchived. Never by default does ARJ select method 4 compression.
You can determine ARJ support with the command "ARJ t *.ARJ".
Corrupted older method 4 files could crash older versions of ARJ.
The way ARJ handles specified filenames with paths has been changed
at 1.10. For non-update commands, ARJ will match the full pathname
of filenames with paths. To force an exact match for filenames
consisting of a filespec (*.EXE), you should use the "-p" option.
ARJ.EXE is now released in a standard uncompressed EXE format. You
can use LZEXE, DIET, etc., to compress ARJ.EXE to save space. Older
versions of ARJ.EXE were compressed by LZEXE. The ARJ "i" command
can not check the program integrity of a compressed ARJ.EXE.
*************************************************************************
CONVERTING OTHER ARCHIVE FORMATS TO THE ARJ FORMAT
The ARJ software now comes with REARJ, an archive conversion utility.
This utility can convert all of the non-ARJ archives on your disk or
diskette to ARJ archives with only ONE command. A log file option is
available to store on disk the ARJ conversion savings. See the
REARJ.DOC for more information on this utility.
COMMON PROBLEMS USING ARJ
ARJ by default stores the pathname specified by the user and not just
the filespec as is the manner of other archivers such as LHARC. You
can exclude the path portion of the filename by specifying the "-e"
option as in "ARJ a -e archive temp\*.*". You can also remove the
path information from an already built archive with the command
"ARJ r archive".
The "f"reshen command in ARJ works differently from the "f"reshen
command in LHARC. In LHARC, the "f" command always assumes the same
directory structure as that of the archive. In other words, if the
LHARC archive contains the "TEMP\*.*" files, you can only freshen the
archive from the same directory. To emulate that function in ARJ,
you must specify the "-r -p" options as in "ARJ f -r -p archive".
When updating archives containing paths, you will need to use the
"-p" option if there are duplicate filespecs and you want to update
only one of them.
THE FILESPEC "..."
Several times in the ARJ.DOC and UPDATE.DOC files, there is mention
of the filespec "...". This filespec is chosen so as to not match
any existing filename. ARJ will NOT generate an error or warning for
not matching "..." specifically.
HOW TO CREATE AN EXECUTABLE SELF-EXTRACTING ARJ ARCHIVE
The command "ARJ f archive ... -je" will create a full featured
self-extracting archive from an already built archive. At ARJ 1.10
no error message will be displayed concerning not finding "...".
The command "ARJ f archive ... -je1" will create a smaller
self-extracting archive.
Syntax: ARJ f archive ... -je produces archive.exe
Under DOS systems other than 2.11, 3.2, 3.3, 4,0, you may have to
rename the self-extract module to ARJSFX.EXE to do the extraction.
ARJ now supports several errorlevels for DOS errorlevel testing.
0 -> success
1 -> warning (specified file to add to archive not found or
specified file to list, extract, etc., not found)
2 -> fatal error
3 -> CRC error (header or file CRC error)
4 -> ARJ-SECURITY error or attempt to update an ARJ-SECURED archive
5 -> disk full or write error
6 -> can't open archive or file
7 -> simple user error (bad parameters)
8 -> not enough memory
UNARJ C source code
Now included is the ANSI C source code for a simple UNARJ extractor
program. This UNARJ is NOT meant for use as a production quality ARJ
extractor. It is meant for the use of 3rd party developers who want
to build file readers, etc., for ARJ. The source code has been built
and tested under Turbo C++ 1.0 and Quick C 2.5 IDE. No executables
have been included.
Syntax: UNARJ archive (extract all files to full path)
UNARJ archive NUL (test all files)
"c" command
The "c" command is used to comment ARJ archives. You can specify
that ARJ only prompt for the archive header comment by the following
command:
Syntax: ARJ c archive -z
You can erase a comment by entering a single blank followed by a
carriage return.
"i" command
The "i" command allows the user to check the integrity of the ARJ
program. ARJ will report CRC ERROR! if the tested ARJ program does
not pass its integrity check. This indicates that the program is
probably corrupted. Please note that the "i" command should not be
used on a compressed ARJ executable (DIETed, LZEXEd, etc.), since the
"i" command will then ALWAYS report a CRC error. If the program name
is not specified, then ARJ will check the current program being
executed.
Syntax: ARJ i ARJ.EXE
ARJ i at DOS 3.0 and up
"j" command
The "j" command allows the user to merge multiple ARJ archives. At
2.00, ARJ is able to handled merged multiple volume ARJ archives. At
1.10, ARJ would not be able to access entries after the first split
file. In any case, you should not use the "o" command to reorder a
merged multiple volume archive. ARJ expects to find the pieces of a
split file in consecutive order.
Syntax: ARJ j archive archive1.arj archive2.arj
ARJ j archive *.arj -r
Some switches NOT supported by the "j" command are: -o, -ob, -f, -u,
-c, -d.
Note that switches that do work like "-x" select the archives to be
merged and NOT the contents of the archives.
"l" command
The "l" and "v" command date displays have been slightly modified to
handle 21st century dates (2000+). The column before the year field
will be blank for 1900 dates and will contain a "+" sign for 2000
dates. There are a number of utilities that will mistakenly set
dates as 2080 instead of 1980.
ARJ SWITCHES
ARJ switches works similarly to those of LHARC and LHA. Many
switches have toggle functionality. The options -k -k negate
themselves because of the toggling functionality. The options -k -k+
turns on the "-k" option because of the "+" sign. This is important
if you use the SET ARJ_SW= command to preset certain ARJ options. In
this case, you should use the "+" modifier to force ON the options
that you want to use.
"-!" switch
This option allows the user to set the character used for list files.
The option "-!" with no specified character toggles (turns off) the
current list file character (default "!").
Syntax: ARJ a archive -!@ @list.fil
ARJ a archive -! !.bat
The first example above sets the list file character to the one used
by LHA and PKZIP.
"-a1" switch
This switch causes ARJ to add any directories in the selected set of
matching filespecs to the archive being built. This switch also
selects hidden and system files as in the "-a" switch. Even empty
directories will be added. The "l" command will display such
directories with a "D" under the "T" (file type) header.
This option can create an archive that is NOT compatible with earlier
releases of ARJ. Older releases of ARJ will skip over empty
directory entries. At 1.10, ARJSFX and ARJSFXJR modules CAN process
empty directory entries. Your comments on this option are welcome.
This option is useful for saving software directories with needed
empty directories.
"-m" switch
Method 0 = storing (no compression)
Method 1 = maximum compression (default compression method)
(requires 282,000 plus bytes memory)
Method 2 = slightly less compression and faster
(requires 282,000 plus bytes memory)
Method 3 = less compression and less memory
(requires 249,000 plus bytes memory)
Method 4 = fastest compression
(requires 235,000 plus bytes memory)
Method 1 or 2 with "-jm" option
(requires 300,000 plus bytes memory)
Syntax: ARJ a archive *.* -m2
"-p" switch
At 1.10, this switch is not needed when using non-update commands
and specifying filenames with paths (filenames with "\" symbols).
For example, "ARJ e archive dir\*.exe" will work as it appears. All
of the dir\*.exe files will be extracted.
If you wish to extract files with no path with an exact match such as
"*.EXE", you must specify the "-p" switch.
"-s1" switch
The "-s1" switch is used to keep the old archive date-time stamp.
The new archive will have the same timestamp as the original archive.
The "-s" switch is used to set the archive timestamp to the same as
the newest file within the archive.
"-t1" switch
The "-t1" option for text mode compression is designed for
compressing 7-bit ASCII text files. These are files without
graphics, printer control characters, or binary data. Any 8-bit
symbols will be truncated to 7-bit symbols during compression.
The original file size reported by the "l" and "v" commands is the
actual number of bytes input during text mode compression. This is
usually the MS-DOS file size minus the number of carriage returns in the
file, since C text mode strips a file of carriage returns.
"-v" switch
During ARJ operation in non-update commands, ARJ will not abort when
it cannot open the correct sequential ARJ volume archive. It will
report the open error and proceed to the "Ok to process the next
volume?" prompt. At this point it is possible to swap diskettes to
put the correct volume in place. This feature is disabled if the
"-y" option has been specified.
For those who have enough free hard disk space, the -v option can be
used to make backing up the hard disk fairly easy. ARJ can be set to
create multiple floppy sized volumes on the hard disk for later copy
to diskettes. So even if ARJ is slow, you can fire up an ARJ backup
and some time later, you can quickly copy the volumes to floppies.
Below is are sample backup commands:
arj a backup *.* -b2 -r -v360 -y -jt -js full backup
arj a backup *.* -b1 -r -v360 -y -jt -js incremental backup
"-x" switch
This switch is used to exclude filespecs or pathspecs from being
selected for processing by ARJ. A new feature allows you to exclude
an entire path including subdirectories from being selected for
processing.
Syntax: ARJ a archive C:\*.* -xC:\TEMP\
The "\" after C:\TEMP indicates to ARJ that everything below
C:\TEMP\ is to be excluded.
Note that the exclude directory option requires that the directory be
specified in the same relative path that the selected files use.
Example:
arj a archive \temp\*.* -x\temp\firstdir is correct usage
arj a archive \temp\*.* -xC:\temp\firstdir is NOT correct because
of the C:
The "-x" switch has been modified to work for non-update commands
like "e"xtract and "l"ist.
Examples:
arj e archive -x*.exe extract all files except *.exe files
arj l archive -x*.exe -x*.obj list all files except *.exe and *.obj
"-z" switch
The "-z" switch has been provided to facilitate batch commenting of
ARJ archives. When the "-z" option has been specified with or
without a comment file, ARJ will only process the archive header
comment and will skip any file commenting unless the "-jz" switch has
been specified.
A comment file containing only a single blank can be used to erase
comments from ARJ archives.
Syntax: arj c archive -z
arj c archive -zcomment.txt
New at ARJ 2.00 is the facility to dump the ARJ archive header
comment to a file. This will only extract the main archive comment
and not the individual file comments.
Syntax: arj e archive ... -zcomment.txt dumps only the comment
arj x archive -zcomment.txt dumps comment and files
"-jd" switch
WARNING! The disk space checking routine in ARJ appears to have
problems with some disk partitions over 120 megabytes in size. ARJ
uses the getdfree() function from Turbo C++ to calculate free disk
space.
"-je1" switch
The ARJSFXJR self-extraction module has been fixed to display
multiple comments lines correctly. The -je and -je1 switches create
self-extracting executable archives. The ARJSFXJR module now
supports automatic directory creation. If you build the ARJSFXJR
module with directory paths, then the module will extract with the
directory paths.
"-jf" switch
The "-jf" switch in add mode allows you to save the full user
specified pathname in the archive. With this option, you can save the
drive letter and root symbol in the archive. However, on extraction,
ARJ will not extract to the full path (with drive and root) with the
"x" command unless the "-jf" option is also specified.
Example: ARJ a backup C:\DOS\*.* -jf (saves C:\)
ARJ x backup -jf (extracts to C:\)
ARJ x backup C:\ (also works)
"-ji" switch
The "-ji" switch is used to create an index file containing the
filenames archived. This is especially helpful when using ARJ to do
multiple floppy type archives. This file SHOULD NOT be created on
the floppy diskette if the floppy diskette is changed during the
archival process.
The index file contains two types of text lines. The first type is
the volume name record. It contains the date, time, starting file
position, and the archive name. The second type is the filename
record. It contains only the filename.
This information is also useful for restarting "-v" multiple volume
archives. You need the filename and the starting file position.
"-jm" switch
The "-jm" switch sets the maximum compression mode. This mode
changes both method 1 and method 2 to the maximum compression for
those methods. This will increase compression time significantly.
"-jn" switch
The "-jn" switch is used to restart interrupted multiple volume
archives in conjunction with the "-jx" switch. All selected files
are skipped up to but not including the named file.
Example: ARJ a volume -v360 -r -jn\BIN\TREE.COM -jx1230
In the above example, all files scanned up to \BIN\TREE.COM are
skipped. Archival will start at file position 1230 of file
\BIN\TREE.COM.
IMPORTANT!!! The exact name of the starting file must be specified
according to the wildnames/filespecs specified. This name is the
same as displayed by the Adding filename display and the same as
written to the "-ji" index file. Please note that \DOS\TREE.COM is
not considered the same as DOS\TREE.COM with this option.
"-jz" switch
The "-jz" switch has been provided to facilitate batch commenting of
one or more files within an ARJ archive. Only one comment file can
be specified. That file will be used to comment each file specified
on the command line.
A comment file containing only a single blank can be used to erase
comments from ARJ archives.
Syntax: arj c archive file1 -jzcomment.txt
arj c archive file1 -zheader.cmt -jzfile.cmt
THIRD PARTY PROGRAMS THAT SUPPORT ARJ DIRECTLY OR INDIRECTLY
The following are programs that I have briefly tested that work with
ARJ and ARJ archives. This is not a comprehensive list nor guarantee
of compatibility with ARJ.
2ALL 2.10 - archive file converter (handles any archiver, free)
ZZAP 6.2A - archive file converter (handles any archiver)
ZAP2ARJ - archive to ARJ converter (automation and batch options)
SHEZ 6.0C - archive menu shell (handles conversions, too)
ZGEN 1.37 - archive menu shell (configurable ARJ options)
ARJ TECHNICAL SUPPORT:
I will try to resolve software problems with ARJ as they are made
known to me. Please notify me of any ARJ problems by mail, email
or via the ARJ support BBSes mentioned below. Despite the fact that
ARJ is free for many users, I will strive to make ARJ a robust,
stable and useful product for all users.
To ensure a reply when using the postal system, please enclose a
stamped self-addressed envelope with your correspondence. Keeping up
with the ARJ mail has become expensive. Foreign corresponders should
include currency instead of stamps.
As of this ARJ version, only users who have provided financial
support to ARJ may request technical support.
Your financial support is needed for the ARJ archiver and format to
succeed.
I can be reached at:
Robert Jung at Wonderland BBS (508) 663-6220
Robert Jung at Dimensional Crossroads BBS (508) 427-5379
Robert Jung at Bay State BBS (617) 598-6646
Robert Jung in the COMPRESS (ILINK), or LHARC / COMPRESSIONS
(SMARTNET) echo conferences.
2606 Village Road West
Norwood, Massachusetts 02062
Internet address: robjung@world.std.com (Checked daily)
Compuserver users can enter >INTERNET: robjung@world.std.com
at the "Send to" prompt. I prefer CompuServe users to send mail
to this address as opposed to my CompuServe userid below.
CompuServe userid: 72077,445 (Checked infrequently)
ARJ SUPPORT BBSes:
The latest version of ARJ can be obtained from the following
ARJ SUPPORT BBSes:
Wonderland BBS, Billerica, MA, BBS (508) 663-6220
Bay State BBS, Beverly, MA, BBS (617) 598-6646
Dimensional Crossroads BBS, Brockton, MA, BBS (508) 427-5379
The Cutting Edge BBS, CT, BBS (203) 233-8993
Tunnels of Vesarius BBS (San Diego, California)
Node I (619) 587-9825, USRobotics HST/V32, 1:202/202 Fidonet
Node II (619) 453-1781, Compucom 9600, 1:202/208 Fidonet
Data Express BBS (AUSTRALIA)
61 2 564 2172 (V.32), 3:712/607 Fidonet
Crystal Circuitry BBS (AUSTRALIA)
61 2 868 4490 (300-9600)
CBBS CANAL VIP BBS (BRAZIL)
(011) 853-5333
Paulo Cesar Breim
Rua Fradique Coutinho 266
Sao Paulo SP
CEP: 05416
Fone: (011) 64-7199
C.A.T. Kommunikations-System (GERMANY)
49-6192-42054 (1200-2400)
49-6192-42057 (19200 PEP)
Packet switching networks: 45619270055
B-Catel BBS (THE NETHERLANDS)
+31,33,612819
end of document