
     UPDATE.TXT, ARJ 2.81a OFFICIAL FULL RELEASE                  May 2002


     This documents new or updated information since ARJ 2.70.
     Please refer to UPD260.TXT for older information about ARJ.

     See UPDATE32.TXT for information specific to ARJ32 our Win32 product
     for Windows NT/2000/XP specifically.


     ** IMPORTANT NEWS ****************************************************


     ** THE UNREGISTERED VERSIONS OF ARJ AND ARJ32 HAVE A VERY   **
     ** SHORT TIME DELAY AT THE START OF EXECUTION.              **
     **                                                          **
     ** AFTER A YEAR OR SO, THE UNREGISTERED VERSIONS WILL       **
     ** NOTIFY THE USER TO DOWNLOAD A NEWER VERSION.  THE        **
     ** SOFTWARE WILL CONTINUE TO FUNCTION ALBEIT MORE SLOWLY.   **

        Unregistered ARJ self-extracting modules will display a
        shareware message with a time delay.

        This version of ARJ and ARJ32 has been significantly improved in
        the updating of multiple volumes and the testing of archives and
        chapter archives.  Check the WHATSNEW.TXT file for specific
        details.


     ** THIS RELEASE OF ARJ USES A NEW REGISTRATION SCHEME WHICH **
     ** OBSOLETES ALL PREVIOUS REGISTRATION KEYS BEFORE 2.70.    **
     ** YOU CAN OBTAIN A REPLACEMENT REGISTRATION KEY FROM ARJ   **
     ** SOFTWARE, INC.  PLEASE PROVIDE AS PROOF YOUR OLD         **
     ** REGISTRATION KEY OR A PRINTOUT OR A SCREEN CAPTURE OF    **
     ** YOUR ARJ.EXE REGISTRATION DISPLAY.                       **

     ** THE UNREGISTERED DEARJ DOES NOT SUPPORT VOLUMES.         **

        Several users have reported that various releases of ARJ have
        caused (false) VIRUS ALARMS from certain versions of Norton
        AntiVirus for Windows software.  This release and all previous
        releases have been checked by Norton, and McAfee virus scanners.

     ** THIS RELEASE USES AN ENHANCED ARJ ARCHIVE HEADER FORMAT  **
     ** COMPATIBLE WITH PREVIOUS VERSIONS OF ARJ.  HOWEVER,      **
     ** SOME THIRD PARTY ARCHIVER MENU PROGRAMS MAY NOT BE       **
     ** COMPATIBLE WITH ARCHIVES PRODUCED BY THIS ARJ VERSION.   **

        The ARJ.TXT section on building self-extractors has been moved to
        a separate file called SFX.TXT and rewritten for more clarity and
        better organization.

        The ARJ file header has been lengthened by a number of bytes to
        support additional file properties.  The new "-j$" option will
        disable this new header enhancement.  However, some of the new
        header space is used to save file size information in multiple
        volumes so that the "-u2" option and the ARJ "ac" chapter command
        work more efficiently.

        It is RECOMMENDED that you run the TESTARJ.BAT batch file to
        verify that this version of ARJ.EXE is compatible with your
        computer system.


        The mailing address of ARJ Software, Inc. has changed as of
        August 1993.

        ARJ Software, Inc.
        P.O. Box 249
        Norwood MA 02062
        USA

        FAX: 781-769-4893

        EMAIL: robjung@world.std.com

        There is ARJ Web site support information added to the file
        ARJ.TXT.  It is excerpted below:

        http://www.ARJSOFTWARE.com                    (ARJ homepage)

        http://www.Dunkel.de/ARJ                      (German and English)
        http://www.tsf.be                             (French and English)

        You can find information about the world of ARJ on the Internet by
        using various search sites including www.altavista.com,
        www.yahoo.com, and www.dejanews.com.

        Our credit card ordering procedures have changed.  We now process
        credit cards directly.


     **********************************************************************


     KNOWN ISSUES

        The "-jn" option does not work properly WHEN updating a multiple
        volume archive.  The "-jn" option was designed for restarting a
        new multiple volume archive build after a halt.  A fix is being
        considered.

        ARJ and ARJ32 will not handle total file size calculations
        correctly when the totals exceed 2 GBytes.  This is only a
        cosmetic display issue.

        Selecting a large ARJ-PROTECT factor "-hkX" for a multiple volume
        build with very small volumes may result in a malfunction due to
        the size of the ARJ-PROTECT recovery data relative to the volume
        size.  But this is a very uncommon situation.  A fix is planned.

        The ARJ move command now deletes files at the end of a multiple
        volume build process rather than after each volume.


     WINZIP COMPATIBILITY

        Winzip 7.0 has compatibility issues with the copyright header of
        ARJ 2.70 and 2.71.  With this release, the header was modified to
        allow compatibility with Winzip 7.0.  Winzip 8.0 does NOT have this
        compatibility issue with ARJ 2.70 and 2.71.

        ARJ32.EXE is not supported by Winzip at this time.  However, if you
        rename ARJ32.EXE to ARJ.EXE, Winzip should support it.

        However, if you want to avoid this problem, I recommend Windows
        Commander from http://www.ghisler.com.  Windows Commander supports
        the ZIP, ARJ, RAR, CAB, TAR, and other archive formats.


     ARJ YEAR 2000 COMPLIANCE STATEMENT

        See the file YEAR2000.TXT.


     ARJ YEAR 2000 IMPROVEMENTS  (new at 2.70)

        This version of ARJ has been modified to allow the specification
        of the century for the ARJ date options "-o" and "-ob".  Prior to
        this version, the ARJ date options would accept a date in the form
        of YYMMDD.  With this version, ARJ will accept dates in both
        YYMMDD and YYYYMMDD formats.  ARJ will presume that any year
        specifications beginning with 19, 20, and 21 are YYYY type
        specifications and any year specifications beginning with 80, 81,
        82 .... 99, 00, 01 .... 18 are YY type specifications.

        Example:  -o980105         -> on or after Jan 5, 1998
                  -o19980105       -> on or after Jan 5, 1998
                  -o100105         -> on or after Jan 5, 2010
                  -o20100105       -> on or after Jan 5, 2010
                  -o201001051200   -> on or after Jan 5, 2010 12:00 P.M.
                  -o100105         -> on or after Jan 5, 2010 12:00 A.M.


     ARJ-PROTECT ARCHIVE DAMAGE PROTECTION  (new at 2.70)

        ARJ has a feature "-hk" (since 2.60) where archive data damage
        protection information can be saved when an archive is built.
        This damage information can be used to repair slight amounts of
        damage to either the archive header or file data.  The competitive
        product PKZIPFIX only fixes directory damage, not file data
        damage.

        This protection data must be created before the archive becomes
        damaged.

        New to this release is the enhancement of ARJ-PROTECT where the
        damage protection data is appended to the archive instead of being
        saved as a separate file (*.XRJ).  In addition, once an archive is
        ARJ-PROTECTED, ARJ will automatically ARJ-PROTECT that archive
        during future updates with the level of protection originally used
        (-hkX).

        It is STRONGLY recommended that this option be used on important
        archives and on archives saved on diskettes.  Frequently used
        diskettes are notorious for developing bad sectors and corrupting
        data.  The cost for this feature is some extra computer time and
        about a one percent increase in archive file size.

        See the "-hk" section of ARJ.TXT for more information about this
        feature.


     ARJ VOLUME NAMING OPTIONS  (new at 2.71)

        By default, ARJ has been naming successive volumes in a multiple
        volume archive by using a numeric file extension (archive.ARJ,
        archive.A01, archive.A02, and so on).  Because the file extension
        changes, this naming scheme may not be appropriate in an Internet
        environment.  Some browsers will not properly download an ARJ
        archive with the normal LEFT mouse click.  Most browsers will
        properly download an EXE file with a LEFT mouse click.

        New to ARJ 2.71 and ARJ32 3.04 is an OPTIONAL naming scheme that
        maintains the initial file extension (EXE or ARJ) and numbers the
        filenames.  This option is set with the "e" option for "-v".

        Examples:  ARJ a archive -ve1440        =>
                       archive.ARJ, arch001.ARJ, arch002.ARJ, ....
                   ARJ a archive -je -ve1440    =>
                       archive.EXE, arch001.EXE, arch003.EXE, ....
                   ARJ a name001 -je -ve1440    =>
                       name001.EXE, name002.EXE, name003.EXE, ....

        If the base archive name ends with a number, ARJ will use that
        number as the base volume number.

        When building a multiple volume self-extractor using the "-ve"
        option, ARJ will put the self-extractor ONLY in the first volume.
        Successive EXE volumes will include an EXE stub that displays a
        usage message.

        Versions of ARJ before 2.71 and ARJ32 before 3.04 will not be
        able to process these alternatively named multiple volume archives.
        Use of the self-extractor avoids this problem.


     VERY LARGE ARCHIVES

        Because of the limitations of the DOS file system, ARJ and ARJ32
        can only build archives up to 2 GBytes in size.

        When creating a new archive with files whose total size is greater
        than 2 GBytes, ARJ will automatically create volumes as needed.

        ARJ and ARJ32 will not handle total file size calculations
        correctly when the totals exceed 2 GBytes.


     WINDOWS 98/ME SUPPORT

        ARJ 2.60 and above supports Windows 98 and Windows Millenium.  In
        this document, references to Windows 9x include Windows 95,
        Windows 98, and Windows Millenium.


     LONG FILENAME SUPPORT

        ARJ versions 2.60 and above support long filenames ONLY in the
        Windows 95/98/ME graphical environment.  ARJ 2.x does NOT support
        long filenames in Windows NT, 2000, NTFS, or OS/2.  ARJ is a DOS
        program that uses the special DOS hooks available in Windows 9x to
        access the long filenames.  This means that long filename support
        will not be available via some software driver add-ons if they do
        not provide the necessary DOS hooks.

        There is now a 32 bit console mode version of ARJ32 that supports
        Win 9x and Win NT and Win 2000 long filenames.  It is available
        from our website.  The 32 bit version provides full long filename
        support wherever Windows itself supports long filenames.  This is
        not always the case for the DOS version of ARJ.

        REMINDER: When specifying filenames with embedded blanks or
        symbols like ">", "<", or "|" on the command line, you MUST quote
        the filenames.  Example:  "Program Files\*.*"

        When specifying a target directory name that contains spaces, you
        must quote the directory name.  If the name specification ends in
        a "\" backslash (needed for a non-existent directory), you must
        insert a space after the "\".  Alternatively, you can use the
        "-ht" option.

        Example:  ARJ x archive "C:\Program Files\ "    or
                  ARJ x archive "-htC:\Program Files"

        In addition, ARJ 2.62 and up supports the Win9x file properties 
        date-time accessed and date-time created.  This support results in 
        slightly larger archives.  The "-j$" option can be used to disable 
        this new feature.  ARJ does not support the file attributes of 
        TEMPORARY or COMPRESSED.

        REMINDER: The small ARJ self-extractor (ARJSFXJR) created with the
        "-je1" option does NOT support Windows long filenames.  Use the 
        "-je" option instead.


     WINDOWS LONG FILENAME LABELING

        A very noticeable change is how ARJ archives files within Windows
        9x.  In 2.60, ARJ would label/mark all files saved in Windows 
        9x as Windows long filename files.  In 2.61 and above, ARJ will 
        label as Windows long filename files only those files whose 
        Windows 9x filename is different from its MS-DOS filename.  Note 
        that "NAME.txt" is NOT the same as "NAME.TXT" because of case.  As 
        an aid, ARJ will display the count of long filenames encountered
        when adding files or listing an archive.  The longname test is 
        done based upon the filename or pathname specified by the user.  
        Filenames within a longname directory would not necessarily be 
        labeled as Windows long filenames if the filename specification 
        excluded the directory name.

        The new "-hf4" option will set ARJ to label all files saved under
        Windows 9x as Windows long filenames (as in ARJ 2.60).

        To help locate Windows 9x files within an archive, ARJ has a new
        "w" option for the "-hb" option.  For extraction, deletion, and
        listing, the "-hbw" option will select only files that are marked
        as Windows long filenames files.  This option is non-functional 
        for adding or updating files.  It is limited to selecting files 
        within an existing archive.  This option is useful when extracting 
        an archive in MS-DOS and encountering one or more "Requires 
        Win95/98 or -hf...." error messages.  The user would be able to 
        view the files that are affected and take appropriate actions.

        Example:  ARJ x archive *.*           (assume some Win9x errors)
                  ARJ x archive *.* -hf1

        Windows 9x DOS support (and therefore ARJ) do not support 
        access to long filenames containing certain characters.  For 
        example, a filename containing the copyright symbol or the 
        trademark symbol cannot be accessed in a Win9x DOS window with the 
        COPY command or with ARJ.  These type of filenames can only be 
        accessed via their short names.  The Win9x system normally stores 
        filename characters as two bytes per symbol allowing an alphabet 
        of 65536 possible symbols.  Because Win9x DOS only uses one byte 
        per character position allowing only a 256 symbol alphabet, many
        characters are displayed by Win9x DOS as "_".


     UNIVERSAL NAMING CONVENTION (UNC)

        ARJ supports archiving filenames using UNC paths.  By default, ARJ
        will remove the leading "\\" symbols to allow ARJ to treat the
        pathname as a relative pathname.  The use of the "-jf" option will
        set ARJ to keep the "\\" symbols.  The "-jf1" will remove the
        leading "\\" symbols.  UNC pathnames stripped of the "\\" can be
        restored to their network paths with "ARJ x archive \\".


     MULTIPLE VOLUME CHAPTER ARCHIVES

        Please note that deleting files or purging old chapters from a
        multiple volume archive is not recommended.  With a multiple
        volume archive, deletions do not save space, so deletions are not
        useful.


     COMPATIBILITY WITH ARJ32

        A new program ARJ32 for Windows 95/98/ME/NT/2000 is now available.
        ARJ32 has been designed to support the Windows 32 bit environment.
        It is generally compatible with ARJ for DOS (2.xx).  However,
        ARJ32 has an option to use the ANSI codepage to access the file
        system instead of the default OEM codepage.  This ANSI codepage
        option would most likely be chosen by users using languages
        containing foreign symbols.

        Archives created using the ANSI codepage may not be processed
        correctly by ARJ for DOS because of a filename translation issue
        (ANSI to OEM codepage).  Special symbols and foreign characters
        may not be translated correctly.  In addition, ANSIPAGE archives
        have an additional compatibility issue with versions of ARJ from
        2.30 and earlier.  Those versions will treat ANSI codepage
        archives as CORRUPTED ARJ-SECURED archives.  This should not be
        an issue since ANSI codepage archives should not be processed by
        ARJ for DOS.  ARJ 2.62c and above will not process such an archive
        unless the "-hy" option is specified.

     
     ARJSFX/ARJSFXV POST EXTRACTION EXECUTION OPTION

        For software distributors, this version of ARJ provides for the
        execution of a command after self-extraction.  The ARJSFX and
        ARJSFXV modules support the execution of a command after a
        successful extraction.

        The ARJSFX and ARJSFXV modules support the "-!" option which
        allows the user to build a self-extractor which will execute a
        command after its files are successfully extracted.

        This option is most useful with the embedded command line feature.
        The command must not contain any blanks if it is used in the
        embedded command line.  If a target directory is specified, the
        target directory will be set as the working directory for the
        post-extraction command.

        Example:  )) C:\DIR\ -!SETUP.EXE

        The above example will cause the command "SETUP.EXE" to be 
        executed in the directory C:\DIR.

        Please note that the user will always be prompted by the
        self-extractor for permission to execute this command.  This
        prompt is disabled for ARJ-SECURED self-extracting archives.


     ARJSFX/ARJSFXV VIRUS CHECK

        Both the ARJSFX and ARJSFXV self-extractors now perform a simple
        virus damage check before processing the self-extractor's archive.
        If damage is detected, the self-extractor will abort with an error
        message indicating possible damage.

        This check will not work against a virus designed specifically to
        attack ARJ self-extractors.

        The ARJSFX self-extractor has a "-s" option to skip this virus
        check.  The ARJSFXV self-extractor has a "-a" option to skip the
        virus check.  You can include the above skip option as part of
        a custom built-in command line.


     ARJSFX/ARJSFXV VERIFY BEFORE EXTRACTION OPTION

        Both the ARJSFX and ARJSFXV self-extractors now accept the "-x" 
        and "-t" options simultaneously to enable the testing of an
        archive just before extracting the archive.

        Example:  )) C:\DIR\ -x -t


     ARJSFXV PASSWORD PROMPT

        A garbled ARJSFXV self-extracting archive will automatically
        prompt the user for the password when extracting or testing the
        archive.

        You must use ARJ 2.61 and above to create the garbled archive as
        well as create the ARJSFXV self-extractor.

        Example: ARJ a vendor *.* -gpassword -je -v360

        NOTE: If you create a garbled archive with ARJ 2.61 and above and
        add ungarbled files and then delete the garbled files, ARJ will
        continue to mark the archive as a garbled archive.  Currently,
        only the ARJSFXV module takes note of this marking.


     ARJSFX AND ARJSFXV SUPPORT FOR FILE DTA AND DTC PROPERTIES

        The ARJSFX and ARJSFXV self-extractors will restore Win9x file 
        date-time accessed and date-time created properties from an ARJ
        archive that contains those file properties.  ARJ 2.62 and up can
        create such an archive.  This feature will only work within the 
        Win9x GUI environment.  The "-j$" option can be used to disable 
        this support.  

        This file DTA support has a limitation in that it cannot restore
        the time field.  This is not a limitation for ARJSFX32.


     ARJSFX AND ARJSFXV SUPPORT FOR LONG FILENAMES IN WINDOWS 2000/XP

        The ARJSFX and ARJSFXV self-extractors will restore long filenames
        in Windows 2000 and Windows XP when the "-+" option is specified.
        This is set up as an option currently because this function uses
        features which are not documented for Windows 2000 and XP.


     ARJ COMMAND LINE SHORTCUT  (new at 2.62)

        New to ARJ 2.62 and up is the expansion of command line directory
        names to full wildcard specifications.  However, this feature will
        only work properly if the first filespec on the command line is
        NOT a directory.  The ARJ placeholder "..." can be used for that
        first filespec.  A directory name used as the first filespec will
        result in that directory being specified as the TARGET directory
        and affecting subsequent filespecs.

        Example:  ARJ a archive ... DIR1 dir2 dir\dir3
                  is equivalent to
                  ARJ a archive DIR1\*.* dir2\*.* dir\dir3\*.*

        Example:  ARJ a archive DIR1 dir2 dir\dir3
                  is equivalent to
                  ARJ a archive DIR1\dir2\*.* DIR1\dir\dir3\*.*


     ARJ CONFIGURATION FILE  (new at 2.72)

        The ARJ configuration option specified by "set arj_sw=c:\arj.cfg"
        or similar will now accept the commands: "ac", "cc", "dc", "lc",
        and "vc".

        At ARJ 2.73 is a new "-" (minus) symbol option in the
        configuration file.  The "-" symbol works similarly to the "+"
        symbol except that its associated switch string is PRE-pended to
        any subsequent command switch string.  This symbol should be more
        useful than the "+" symbol.

        ARJ.CFG contains:
        a -jm1 -jt -i1
        - -i
        e -i-

        AND is equivalent to:
        a -jm1 -jt -i1
        e -i -i-
        all other commands use -i


     ARJ RESPONSE FILE

        ARJ supports the specification of the "-g" and "-g?" options on
        the command line along with a response file specification.

        Using this feature is more secure than putting a password
        specification within an ARJ response file which is written to
        disk.


     SHAREWARE LIMITATIONS

        After ARJ version 2.41a, full functionality of a small set of ARJ
        software features MAY be limited to registered users.

        The most significant limitation is the 50,000 filename limit in
        the unregistered version.  The registered version can handle up to
        260,000 filenames at one time.  However, for evaluation purposes,
        ARJ/ARJ32 will process up to the larger limit when using the -j#1
        option.  Note: unregistered ARJ can handle up to 100,000 files.

        Example:  ARJ a archive c:\*.* d:\*.* -r -j#1

        Note that using the option "-j#1" does not store any of the
        contents of the files.  Only the name, date, and size is stored.


     REGISTER STAMPING ARJ

        *** REMINDER: ARJ 2.7x and ARJ32 use a new registration scheme
        *** which obsoletes all previous registration keys.

        If, when you purchase an ARJ license, you choose to receive your
        ARJ key by email, you will need to put the emailed key data into a
        file named REGISTER.DAT in the same directory as the ARJ software
        programs.  Then you need to execute REGISTER.EXE with either the
        -ARJ option or the -ARJ32 option depending upon your software.
        Please note that the registration key for ARJ does not work with
        ARJ32 and vice-versa.

        A more detailed explanation can be found in the file REGISTER.TXT.


     ENCRYPTION

        New to version 2.60 is a new encryption scheme based upon the
        Russian encryption algorithm (GOST 28147-89 cipher).  This
        algorithm is similar in design to DES; however, GOST is designed
        for software implementation.  GOST 28147-89 uses a 256 bit key and
        32 rounds of encryption.  In addition, this implementation of GOST
        also uses the 64 bit cipher feedback mode.

        This new encryption is accessed by using the "-g" option to
        specify the password and the "-hg" option to specify the new
        scheme.  This new scheme is in addition to the older XOR garble
        scheme.

        The encryption module is a separate COM file named ARJCRYPT.COM.
        ARJ expects to find the encryption module in the same directory as
        itself.  This has the advantage of saving space with the ARJSFXV
        module and the DEARJ.EXE module when encryption is not needed.
        You simply do not include the encryption module in the archive
        when not using encryption.

        At this release, support for a new version of ARJCRYPT.COM has
        been added.  This new version will support passwords up to 64
        characters in length.  ARJCRYPT version 1.0 only supports
        passwords up to 32 characters in length.  This release of ARJ can
        ONLY use ARJCRYPT.COM version 2.1.  ARJ 2.60 can use the new
        ARJCRYPT.COM version 2.1, but it will display a warning message
        indicating that ARJCRYPT is not a standard ARJ garble module.  ARJ
        2.60 will still not be able to use more than 32 character
        passwords.

        The encryption overlay module is not included with this version of
        ARJ.  Because of USA export regulations, ARJ Software, Inc. may
        not export the encryption overlay module from the USA.  It is
        available on the ARJ website for USA users only.

        ** Please NOTE that losing your password means losing your file!
        ** Please DO NOT ask for technical support on lost passwords.
        ** There is no shortcut/backdoor for determining lost passwords.

        New to ARJ 2.61 and up is a limited key size version of GOST
        encryption. ARJ now provides a "-hg!" option which invokes the
        built-in 40 bit key version of the Russian GOST encryption
        algorithm. The normal GOST algorithm has a 256 bit key size. This
        limited encryption is provided to meet USA encryption export
        rules.

        The "l" command will now indicate the type of encryption method
        used.  See the "l" command below for more details.


     ARJ CAUTIONS

        Whenever archiving to diskettes, it is HIGHLY recommended that
        the option "-jt" be used.  This helps spot BAD diskettes or BAD
        diskette drives.  It is HIGHLY recommended that the "-jt" option
        be used in a Windows or multi-tasking or network environment.
        In addition, the diskette drive should NOT be read or write
        cached.  This allows the "-jt" option to work properly.  For
        Windows 9x, ARJ.EXE at 2.61 and up automatically forces a re-read
        of the diskette drive.

        The XMS accelerator in Hurricane 2.0 MAY interfere with the use
        of the ARJ -hm! option within a Windows DOS box.  You can use
        the -hm option instead.

        UNERASE or UNDELETE commands do not always recover a file/archive
        correctly.  This will result in damaged archives.  This is true
        for all archive types.  You should always test an archive after
        unerasing it.

        CAUTION: To those who use the "-t1" and/or "-t1g" options to
        save a few extra bytes, this option should only be used on TEXT
        FILES. Those are files created by EDLIN, EDIT, QEDIT, BRIEF,
        NOTEPAD, and others.  Text files typically contain only letters,
        numbers, spaces, and punctuation marks.  WORD PROCESSOR format
        files ARE NOT TEXT FILES!  MS WORD, Wordperfect, AMIPRO, WRITE,
        and similar files ARE NOT TEXT FILES. Using the "-t1" or "-t1g"
        on any other kind of file probably will result in DATA LOSS!


     ARJ ERRORLEVELS

        ARJ will now return a DOS error code of 11 for a user control break
        action.  ARJ formerly returned a code of 2 for this situation.

        ARJ will now return a DOS error code of 12 when trying to modify a
        chapter archive that already has 250 chapters in it.  ARJ formerly
        returned a code of 2 for this situation.


     ARJ COMMANDS

     "g" command

        At ARJ 2.62d and up, you can use the -hg or -hg! option to encrypt
        an archive using the GOST algorithm.  Only archives that are
        ungarbled and created with ARJ 2.62 or higher can be garbled with
        the -hg or -hg! option.


     "j" command

        With the addition of new encryption functions, it is important to
        not mix encryption methods when joining archives. This current
        version of ARJ will attempt to prevent that.

        In addition, the dual-name and codepage properties should not be
        mixed by the join command.

        You should only join archives that have been created with very
        similar options.


     "k" command

        The "k" command can now be set to purge a specific number of
        chapters using the "-jbN" option.

        Example:  ARJ k archive *.* -jb3      purge the first 3 chapters


     "l" command
     "v" command

        ARJ will display the count of files selected within an archive
        that have Windows long filenames.

        The listing format has been changed to better indicate the century
        years.  Instead of a "+" symbol to indicate the year 2000, ARJ will
        now display a " " for year 2000, a "1" for the year 2100.  This
        character appears immediately before the date-time field.

        The "v" command will now display Win9x file date-time accessed
        and file date-time created properties and physical disk size if
        they exist in the archive.  If the physical disk file size is equal
        to the original file size value, then an "=" symbol will be
        displayed instead.

        As of ARJ 2.62d, the output under the "G" of the BTPMGUX area is
        changed.  Instead of a simple "G" to indicate that the file is
        garbled, that field may contain the values "0", "1", "2", "3", or
        "4".

        "0" indicates XOR garbling (archives created before 2.60).

        "1" indicates XOR garbling (archives created at 2.60 and greater).

        "2" indicates GOST encryption with a 32 byte password limit.

        "3" indicates GOST encryption (ARJCRYPT.COM 2.1) 64 byte limit.

        "4" indicates 40 bit encryption limit.


      "m" command

        The move command in multiple volume adds/updates now processes the
        file deletions after the multiple volume add/update process has
        completed.  This will require more disk space for some situations
        than older versions of ARJ required.

        This may change based upon user comments.


     "dc" command

        This command will now only accept "*.*" as the filespec.

        Example:  ARJ dc archive *.*


     "lc" command

        This is a new two character command for ARJ.  It is actually an
        abbreviation for the following command and switch option: 
        "l -jb* -hbc".  The "lc" command will list the chapter labels
        stored in the archive.  

        This is a quick way to see what backup chapters are stored in the
        archive and when they were created.

        Example:  ARJ lc archive


     "v" command

        ARJ now displays if available the physical disk file size of
        volume split files and text mode files "-t1" along with the
        DTA/DTC date fields.  If the physical disk file size is equal to
        the "original size" value, then an "=" symbol will be displayed
        instead.  If the physical disk size field is blank, there is no
        value stored and displayed for that field.


     "vc" command

        This is a new two character command for ARJ.  It is actually an
        abbreviation for the following command and switch option:
        "v -jb* -hbc".  The "vc" command will list the chapter labels
        and comments stored in the archive.

        This is a quick way to see what backup chapters are stored in the
        archive and when they were created as well as any comments about
        those chapters.

        Example:  ARJ vc archive


     "y" command

        When the "y" command is used with the "-g" option to ungarble an
        archive, ARJ will automatically test the archive after the
        ungarble.  If the test fails, ARJ will abort the ungarble.  There
        is no option to bypass this test.


     ARJ SWITCHES

     "-f4" switch

        The "-f4" switch works like the "-f2" switch except ARJ will use
        the text mode file size instead of the physical disk file size.

        This is useful when updating archives with text files on a PC and
        on a network drive from a Unix system.


     "-g" switch

        The garble option in this version of ARJ has three versions. One
        is the original version found in earlier ARJ releases.  It is
        compatible with older versions and works like those versions.

        The second garble version uses a separately available encryption
        module.

        This new option is accessed by using the new "-hg" option.  This
        option sets ARJ to use the separate encryption module to encrypt
        the data.  By default, ARJ will look for the file "ARJCRYPT.COM"
        in the same directory where the ARJ.EXE being executed is found.
        The user may specify the pathname of the module to use.

        Examples:  ARJ a archive *.doc -gThis_is_a_password -hg
                   ARJ a archive *.doc -gpassword -hgc:\dir\enc.com

        The new garble option accepts a password key up to 64 characters
        long.  Excess characters are ignored.  Garble passwords ARE CASE
        SENSITIVE!  DO NOT LOSE your password!  There is no known method
        to recover the password other than by brute force, which could
        take a very long time.  The longer the password, the longer it
        would take to "guess" it.

        ARJ 2.60 which also accepts the "-hg" option will only handle this
        garbled archive if the password is 32 characters or less.

        ARJ 2.60 can use ARJCRYPT.COM version 2.1; however, it will
        display a "Not a standard module" warning message.

        A variation of the "-hg" option is "-hg!".  This "-hg!" option
        accesses a built-in version of GOST that is limited to a 40 bit
        key size.  This algorithm is designed to meet USA encryption
        export rules.

        These new encryption schemes are not compatible with the "-g"
        option of pre-2.55 versions of ARJ.  If you want to maintain
        compatibility with pre-2.55 versions of ARJ, you should NOT use
        the "-hg" option.

        Only the multiple volume self-extractor (ARJSFXV and ARJSFX32)
        supports the new encryption module.

        When garbling or ungarbling an existing archive, ARJ will detect
        the method of encryption previously used and select that same
        method regardless of whether the "-hg" option is specified or not.


     "-l!" switch

        The "-l!" switch forces ARJ to append the list of filenames to be
        archived to the specified filename instead of overwriting it.

        Example:  ARJ a archive c:\*.* -r -l!names.lst


     "-oa" switch

        The "-oa" and "-oab" switches allow the user to select files under
        Windows 9x based upon file date-time last accessed.  "-oa" selects
        files after the date value, "-oab" selects files before.

        This ARJ version does NOT support combining "-o", "-oa", "-oc" with
        one another.  You can combine "-oa" with "-oab".

        Archived files without the stored DTA attribute (-j$) will not be
        selected.


     "-oc" switch

        The "-oc" and "-ocb" switches allow the user to select files under
        Windows 9x based upon file date-time created.  "-oc" selects
        files after the date value, "-ocb" selects files before.

        You can combine "-oc" with "-ocb".

        Archived files without the stored DTC attribute (-j$) will not be
        selected.


     "-od" switch

        The "-od" and "-odb" switches allow the user to select files based
        upon the number of days before today.  The "-od" switch allows the
        user to select files modified on or after the specified number of
        days before today.  The "-odb" selects files before the specified
        number of days.  You can combine the "-od" and "-odb" switches.

        Example:  ARJ a archive -od5    5 days old or less


     "-os" switch

        The "-os" and "-osb" switches allow the user to select files based
        upon the file size.  The "-os" switch allows the user to select
        files greater than or equal to the specified file size.  The
        "-osb" switch is used to select files smaller than the specified
        file size.  These two switches can be combined.  They can also be
        combined with any one set of date selection switches.

        Examples:  ARJ a archive -os100K -osb100M   Files >= 100K and < 100M
                   ARJ l archive -osb10K            Files < 10K

        NOTE: With multiple volume archives created by versions of ARJ
        before ARJ 2.81 and ARJ32 3.10 or created with the "-j$" option,
        ARJ will not select any split files based upon size.


     "-q" switch

        This switch causes ARJ to prompt the user prior to acting upon
        each archived file for following commands: "a", "c", "d", "e",
        "f", "g", "p", "r", "u", "x".

        This allows you selectively to delete, add, etc.

        Note: As of ARJ 2.81 and ARJ32 3.10, ARJ will try to limit its
        queries for subsequent portions of a file split across volumes for
        add and extract operations.


     "-u4" switch

        The "-u4" switch works like the "-u2" switch except ARJ will use
        the text mode file size instead of the physical disk file size.

        This is useful when updating archives with text files on a PC and
        on a network drive from a Unix system.


     "-v" switch

        At this release, ARJ will automatically handle the volumes past
        ninety-nine and one hundred by changing the suffix to .100, .101,
        .102, and so on.

        New to ARJ is a simple delete option "D" when creating volume
        archives.  For SAFETY REASONS, this delete option is limited in
        scope and specification.  The exact file or files (via wildcard)
        must be specified. A directory name is not sufficient (A:\ or
        C:\TEMP).  A filename or wildspec is required (A:\*.* or
        C:\TEMP\*.TXT).  In addition, this delete option does not delete
        through (recurse) subdirectories. In other words, this delete
        function works similar to the DOS DEL command except that a
        filespec is required.  ARJ accepts all characters after the "D"
        option as the filespec.

        Examples:  ARJ a a:archive -vada:\*.*
                   ARJ a testvol -v1440dtestvol.a*

        At ARJ release 2.71 and ARJ32 release 3.04 is an "E" option to set
        an alternate naming scheme for multiple volume archives.  Instead
        of naming succeeding volumes with a numeric file extension, ARJ
        can overlay the three digit numeric sequences before the DOT file
        extension.

        Examples:  ARJ a archive -ve1440        =>
                       archive.ARJ, arch001.ARJ, arch002.ARJ, ....
                   ARJ a archive -je -ve1440    =>
                       archive.EXE, arch001.EXE, arch003.EXE, ....
                   ARJ a name001 -je -ve1440    =>
                       name001.EXE, name002.EXE, name003.EXE, ....

        New to ARJ 2.81/ARJ32 3.10 is the "rr" modifier.  This reserves
        disk space on all volumes.  The number after the "rr" specifies
        the space to reserve.  You can use the "r" and "rr" modifiers
        at the same time.

        Example:  ARJ a install -varr50K    save 50k bytes on all volumes


     "-w!" switch

        This switch will force ARJ to use a temporary work directory ONLY
        when archiving to removable media such as a diskette.  Otherwise,
        ARJ will ignore this option.

        Example:  ARJ a a:archive -w!c:\temp *.* -jt

        Typically, this option would be used in an ARJ configuration file
        or a batch file.


     "-h#" switch

        This feature has been modified to use only the last two digits of
        the year.  So the year 2010 will be represented by "10".  This
        will still provide "uniqueness" for filename generation.  Daily
        created archives will not collide name-wise for 100 years.


     "-h$" switch

        This feature forces ARJ to attempt to use Win95 DOS long filename
        support functions under other operating systems such as Windows
        2000.

        Apparently, Windows 2000 provides some of the DOS program longname
        functionality that Windows 95/98 provides.  This switch option
        forces ARJ to try to access Windows 2000 long filenames.

        Windows NT does not provide these DOS long filename functions.

        ARJ Software provides this option as a result of user requests.
        However, since this DOS access hook is not an official Windows
        2000 feature, we cannot provide technical support for this
        feature.  We do provide the program ARJ32 to fully support the
        Windows 32 bit environment (including long filenames) in Windows
        95, 98, NT, ME, and 2000.


     "-hb" switch

        This switch is used to select by file attribute or file type.

        The "-hb" option can be used to select files by their attributes
        (normal, readonly, hidden, system, directory, and archive bit).
        "Normal" is defined as files that are NOT the following: readonly,
        hidden, system, label, chapter header, or directory.  For
        extract/list operations, you can also select chapter labels and
        volume labels.  By default, the "-hb" option by itself selects all
        types of files.  If you specify a letter symbol representing a file
        type, you are selecting ONLY that type of file.  You can specify a
        series of letters representing all of the file types that you want
        to select.  For example, the "-hbdr" option selects both
        directories and readonly files.  Selections are additive.

        Example: -hbnr   select only normal and readonly files

        Single letters represent each attribute or type.
          a - archive bit set
          b - archive bit clear
          h - hidden
          r - readonly
          s - system
          d - directory
          n - normal files (not d, h, r, s, l, c)
          l - volume label
          c - chapter label
          f - abbreviation for "ndhrs"
          w - Windows long filenames

        The archive bit selection ("a" or "b") is a special case.  If you
        have selected no types of files EXCEPT files with the archive bit
        set, ARJ will select from the set of all file types. If you have
        selected one or more file types, ARJ will select based upon the
        archive bit from the selected set of files types.

        Examples: -hbhrsa      select hidden, readonly files with archive
                               bit set
                  -hba         select all files with archive bit set

        Add/update options  :  f, d, r, h, s, n, a, b.

        Extract/list options:  f, d, r, h, s, n, a, b, c, l, w.

        Examples:  ARJ a archive *.* -r -hbrs     select only readonly
                                                  and system files
                   ARJ a archive *.* -r -hbd      store only directories
                   ARJ l archive *.* -hbr         list only readonly files
                   ARJ l archive -jb* -hbc        list chapter headers

        Notes:  The option "-hb" with no letter options is an abbreviation
        for "-hbndhrslc" (all types).


     "-hf3" switch

        When building a dual-name archive, ARJ will now check for files that
        have long filenames inaccessible through MS-DOS.  These are
        filenames that contain symbols that WIN9x/MS-DOS translates into the
        underscore "_" symbol.  ARJ will display the "Can't open ..." error
        message for each such file encountered.


     "-hf4" switch

        This switch sets ARJ to label all files archived under Windows
        as Windows long filenames.


     "-hg" switch

        This switch is used to specify the filename of the encryption
        module to be used when encrypting a new archive.  The default
        filename is "ARJCRYPT.COM".  ARJCRYPT.COM contains a new
        encryption scheme that is partly incompatible with earlier
        releases of ARJ.  This new scheme will accept passwords up to 64
        characters.  The old scheme accepted only the first 32 characters
        of a password.  As long as your passwords are 32 characters or
        less, your archives will be compatible with ARJ 2.60 encryption.

        ARJ will look for the encryption module in the directory that
        contains the copy ARJ.EXE that is being executed unless the
        specified module name contains a path symbol "\" as in
        "ARJ\OLDCRYPT.COM".  If you want to use a module in the current
        directory, you should specify the name as in ".\ARJCRYPT.COM".
        The "." indicates the current directory.

        With an existing archive, ARJ detects the encryption scheme
        that was used to encrypt the archive and uses the same scheme
        without the need to specify the type of encryption. However, if
        you encrypted with a non-default ARJCRYPT.COM, you must specify
        the pathname with the "-hg" option.

        This encryption module is available on the ARJ website for USA
        users only.


     "-hg!" switch

        This switch is used to specify the use of a built-in 40 bit
        version of the Russian GOST encryption algorithm.  This algorithm
        is limited to a 40 bit key to meet USA encryption export rules.
        Any password input to this function will be crunched down to a
        40 bit size.  Only the first 32 characters of the password will
        be accepted.


     "-hk!" switch

        The "-hk!" switch sets ARJ to enable ARJ-PROTECT ONLY when
        archiving to removable media.  Otherwise, this switch is ignored.
        Typically, this switch would be used in an ARJ configuration file
        or batch file.

        Examples:  ARJ a a:archive -hk!
                   ARJ a a:archive -hk!5


     "-hm" switch

        At ARJ 2.62c and up, ARJ will by default set -hm3000.  This means
        that if you are archiving over 3000 filenames, ARJ will use a disk
        file to manage the list of filenames.


     "-hq1" switch

        This switch sets ARJ to ignore the error that occurs when ARJ
        cannot open a file because it cannot be found during an add-type
        command and/or a compare command.  This is DOS error code 2.
        This option applies only to files being added to a new archive
        and/or being compared.  For an existing archive, this option
        will be ignored during the add operation, but NOT during a
        subsequent compare operation.

        This open error typically happens when a temporary file that ARJ
        has found to archive is purged by another process before ARJ can
        actually open and compress/compare it.  This is not the same
        error as when a user specifies a filename on the command line
        and ARJ cannot find it.

        This error also occurs in Windows 9x when trying to archive
        files with filenames that contain "unusual" symbols.  These are
        the symbols that have no equivalent in MS-DOS.  MS-DOS displays
        those symbols as "_" underscore.

        If you use the "-ji" option to set up an index file, ARJ will
        log any file that it cannot open.


     "-hy" switch

        This switch will set ARJ to allow the extraction of ARJ32 created
        archives containing ANSI codepage filenames.  ARJ for DOS always
        uses the OEM codepage which may translate ANSI codepage filenames
        incorrectly or not at all.  Filenames containing only alphanumeric
        characters and the DOT symbol should be translated correctly.

        The default for ARJ32 is the OEM codepage.


     "-j#2" switch

        This switch will set ARJ to restore the file attributes to the
        selected files.  No file will be extracted.  Archives created
        with the "-j#" and "-j#1" options can also be used.


     "-j#3" switch

        This switch will set ARJ to restore the file dates (written,
        accessed, created) to the selected files.  No file will be
        extracted.


     "-j#4" switch

        This switch will set ARJ to restore the file attributes and the
        file dates (written, accessed, created) to the selected files.  No
        file will be extracted.


     "-j$" switch

        This switch will set ARJ to NOT save the file properties date-time
        accessed and date-time created and the new physical disk file size
        on disk field.  This will save header size and result in a
        slightly smaller archive.  During extraction, this switch will set
        ARJ to NOT restore the file properties date-time accessed and
        date-time created.


     "-ja2" switch

        This switch is used with the "ARJ P" command to force the filename
        to be displayed in the output display.  This feature is intended
        with software tools for blind users.

        ARJ will generate a display similar to the following:
        Extracting BKC.BAT                    to STDOUT


     "-jb" switch

        The commands "ARJ d archive -jb" and "ARJ dc archive" will now
        ONLY accept "*.*" as the filespec.

        ARJ now supports the deletion of a file or files from ALL chapters.

        Example:  ARJ d archive vers.txt -jb*  removes all copies of vers.txt
                  ARJ d archive *.exe -jb*     removes all EXE files

        The "-jbn*", "-jbN-N*", "-jbN-*" options allow a user to
        extract/list only files that were newly added/updated to a chapter
        archive at the specified chapter or chapter range.  With this
        option, ARJ will NOT extract other files that are present in the
        specified chapter or chapter range but were not newly
        added/updated in the chapter or range.

        Example:  ARJ e archive *.* -jb5*

        In the above example, ARJ will only extract files that were newly
        added/updated in chapter 5.  Other files in chapter 5 will NOT be
        extracted.  This will let the user see what was updated in chapter
        5.

        Example:  ARJ l archive *.* -jb5

        List only files that were added/updated in chapter 5.

        Example:  ARJ e archive *.* -jb4-7*

        List only files that were added after chapter 5.

        Example:  ARJ l archive *.* -jb6-*

        In the above example, ARJ will only extract files that were newly
        added/updated in chapters 4, 5, 6, and 7.

        ARJ now supports the "-jt1" compare testing of older chapters.

        Examples:  ARJ t chapters -jt1 -jb*    compare all chapters
                   ARJ t chapters -jt1 -jb9    compare only chapter 9
                   ARJ t chapters -jt1 -jb9*   compare only updated files in
                                               chapter 9
                   ARJ t chapters -jt1 -jb2-4  compare files in chapters 2 to 4


     "-je" switch

        The ARJ.TXT "-je" section has been completely rewritten.


     "-ji" switch

        ARJ will now log extraction errors to the index file.


     "-jo1" switch

        This switch will set ARJ on extraction to generate unique output
        filenames AND keep the current file extension.

        Example:  NOTE.TXT will generate NOTE.001.TXT and so on.


     "-jp" switch

        When the ARJ output is being redirected to a file or device, the
        "-jp" option is ignored.

        Example:  ARJ l archive -jp  >  save.txt

        ARJ now automatically determines the screen page size for screen
        sizes greater than 25 lines, so that the option "-jpN" is
        unnecessary for sizes greater than 25.


     "-jt" switch
     "-jt1" switch

        In DOS and Windows 9x when using removable media (diskettes), ARJ
        will flush and invalidate cached diskette data from memory, so
        that testing is done on the actual data on the diskette.  A side
        effect of this improvement in reliability is longer diskette
        testing times.

        Missing directories will now be reported as errors.

        The "-jt1" switch can now be used to test compare older chapters.
        See the "-jb" option above.


     "-jt2" switch

        For a chapter archive, the "-jt2" option will only compare files
        that are physically added to the archive.  Other files in the
        latest chapter will be CRC checked only.

        Example:  ARJ u -jt2 archive dir\

        When "-jt2" is used with the "t"est command, ARJ will skip
        comparing files that do NOT exist on disk.  ARJ will only do
        a CRC check for those files.

        Example:  ARJ t -jt2 archive *.*

        For a hollow archive, the "-jt2" option will not count missing
        files as errors.  Only a CRC check will be done.


     "-jt3" switch

        This switch allows one to do a quick compare of files within an
        archive and on disk.  ARJ will only compare the date-time stamps
        and the size of the files.

        Example:  ARJ t archive -jt3

        For a chapter archive, the "-jt3" sets ARJ to compare only the
        files of the last chapter.

        Example:  ARJ ac -jt3 archive *.*
                  ARJ t -jt3 archive


     "-jv1" switch

        Fixed this switch to work as it did in ARJ 2.50 displaying CRC
        values with the "ARJ v" command.


     "-jv2" switch

        This switch displays the same information as the "-jv1" switch but
        if the archive is a chapter archive, the CRC value is replaced by
        the chapter range values.


     "-jyw" switch

        The "-jyw" switch sets ARJ to inhibits the multiple volume prompt
        EXCEPT when the volume is on removable media such as diskettes.

        The "-jyw" switch is typically used in an ARJ configuration file
        or batch file.


     end document

