
     UPDATE.TXT, ARJ 2.70 OFFICIAL RELEASE                  September 1999


     This documents new or updated information since ARJ 2.60.
     Please refer to UPD260.TXT for more information.


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

     ** THIS RELEASE OF ARJ USES A NEW REGISTRATION SCHEME WHICH **
     ** OBSOLETES ALL PREVIOUS REGISTRATION KEYS.  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 IBM, 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 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.

        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.

        ARJ Software, Inc. is now marketing three archiver products, ARJ, 
        ARJ32, and JAR (JAR16/JAR32).  JAR produces "J" archives which are 
        not compatible with ARJ.  The 32 bit version of JAR (JAR32) 
        supports the Windows NT operating system version 3.50 and above as 
        well as Windows 95/98.

        We have developed the new archiver, JAR, so that we could provide
        state of the art data compression with solid archiving techniques
        and new compression algorithms.  These improvements could not be
        added to ARJ without introducing serious compatibility issues with
        older releases of ARJ.  JAR16/32 compresses significantly better
        than ARJ and PKZIP for many files and provides long filename
        support for both Windows 9x and Windows NT.  JAR16/32 duplicates
        many of ARJ's powerful functionality and provides new original
        functionality.  However, it does not duplicate ARJ and it requires 
        more system resources (memory and cpu power) to run.  It also is
        more difficult for third party archiver software to support.  
        There are very few JAR add-ons.  See our web site for a copy of 
        this archiver.

        Please note that ARJ is our MAIN product and it is our intention 
        to continue supporting and enhancing the ARJ product. ARJ has the 
        advantages of a large installed base, a simple archive format, 
        significant third party software support, and a long history of 
        reliable performance.  We also plan to provide ARJ support for 
        Windows. 
        
        A 32 BIT CONSOLE MODE ARJ32 FOR WINDOWS 95/98 AND WINDOWS NT IS 
        AVAILABLE.

        This ARJ version has been changed with regard to the storage of 
        the SFX modules and the built-in help information.  The change now
        requires that MS-DOS 3.0 and above be used to access the SFX
        modules and the help information.  Under DOS 2.11, the help
        screens and self-extractor creation will work if ARJ.EXE is
        located in the CURRENT directory.  This change frees up more
        conventional memory for ARJ use.
          
        At this release, ARJ will automatically roll a multiple volume 
        archive from the .A99 extension to .100.


        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.


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


     ARJ YEAR 2000 COMPLIANCE STATEMENT

        See the file YEAR2000.TXT.


     ARJ YEAR 2000 IMPROVEMENTS

        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

        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 recommend 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 for more information about this feature.


     WINDOWS 98 SUPPORT

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


     LONG FILENAME SUPPORT

        ARJ versions 2.60 and above support long filenames ONLY in the
        Windows 95/98 graphical environment.  ARJ 2.6x does NOT support 
        long filenames in Windows NT, 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.

        In development is a 32 bit console mode version of ARJ32 that
        supports Win 9x and Win NT long filenames.  It is available for 
        public testing and comment as a test release.  The 32 bit version
        will provide 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.


     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/NT 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 "_".


     COMPATIBILITY WITH ARJ32

        With this release, a new program ARJ32 for Windows 95/98/NT 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.


     ARJSFXV SUPPORT FOR FILE DTA AND DTC PROPERTIES

        The ARJSFXV self-extractor 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.


     ARJ COMMAND LINE SHORTCUT

        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

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


     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.


     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.


     "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 "0" 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 if they exist in the archive.

        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.

     
     "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

     "-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) 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.


     "-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".


     "-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.


     "-odb" switch

        The "-od" and "-odb" switches allow the user to select files based
        upon the number of days from today.  The "-odb" switch allows the
        user to select files modified before the specified number of days
        from today.  You CAN combine the "-od" and "-odb" switches.


     "-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*


     "-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.


     "-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 
        regardless of whether the "-hg" option is specified or not.  
        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 create ARJ-PROTECT damage protection
        data which is appended to the archive.  This ARJ-PROTECT data 
        contains necessary information to repair damage to the protected
        archive.  The "-hk1", "-hk2" .... "-hk9" options will generate 
        more ARJ-PROTECT data affording a higher probability of a 
        successful repair at the cost of a larger archive.
        
        This protection feature is sector based and allows repair due to
        typical types of disk corruption (bad sector, virus damage, cross
        links, etc).  This type of sector protection is NOT effective for
        most data transmission problems where data is missing from the
        middle of a transmission.

        If an archive already exists, the archive can be ARJ-PROTECTED 
        via the "t" command.  If the archive is already protected, ARJ
        will not protect it again.

        Example:  ARJ t archive -hk             appends ARJ-PROTECT data

        Repair of a damaged ARJ-PROTECTED archive is done with the "Q" 
        command.  The repaired archive is named ARJFIXED.ARJ.  The original 
        damaged archive is not modified.  In addition, ARJFIXED.ARJ is
        newly ARJ-PROTECTED.
                  
        Example:  ARJ q docs                    repairs archive

        For older style ARJ-PROTECTED archives (with accompanying .XRJ 
        file), you must specify the "-hk" option along with the "q" 
        command.

        Example:  ARJ q docs -hk                repairs archive

        Once an archive has been ARJ-PROTECTED, future archive updates 
        will automatically include ARJ-PROTECTION.  That feature can be
        disabled with the "y" command.

        Example:  ARJ y docs -hk


     "-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 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.  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.


     "-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.


     "-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.


     "-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

        There is a limitation in that multiple volume archives will generate
        (size) errors for the files split over volumes.


     end document

