home *** CD-ROM | disk | FTP | other *** search
/ What the Doctor Required - The Freshest December / December.iso / archivat / arj.all / arj255bx.exe / arj / UPDATE.DOC < prev    next >
Text File  |  1996-07-16  |  40KB  |  909 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.55b ALPHA TEST                            July 1996
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.50.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.         *** THIS VERSION OF ARJ IS THE SECOND PUBLIC ALPHA TEST RELEASE.
  11.         *** A few bugs have been fixed.  See WHATSNEW.DOC for details.
  12.  
  13.         This is a test release with new features which may be changed in
  14.         the final release.  The purpose of this release is to gather
  15.         comment on the design of the new features and to find program
  16.         bugs.  We welcome any suggestions or bug reports that you might
  17.         have to improve upon this version of ARJ.
  18.  
  19.         The most likely areas of bugs involve handling filenames longer
  20.         than 80 characters and using XMS memory to handle a large number
  21.         of filenames.
  22.  
  23.         DO NOT USE THIS TEST VERSION OF ARJ AFTER DECEMBER 1996.  Look
  24.         for an official release of ARJ then.  There is NO expiration
  25.         timer in this program.  The time limit is for your protection and
  26.         is strictly voluntary.  You should not use a test version of any
  27.         software for too long.
  28.  
  29.         The mailing address of ARJ Software has changed as of August 1993.
  30.  
  31.         ARJ Software
  32.         Robert and Susan Jung
  33.         P.O. Box 249
  34.         Norwood MA 02062
  35.         USA
  36.  
  37.         FAX: 617-769-4893
  38.  
  39.         EMAIL: robjung@world.std.com
  40.  
  41.         There is ARJ Internet mailing list and WEB site support
  42.         information added to the file ARJ.DOC.
  43.  
  44.         ---------
  45.  
  46.         This version of ARJ will use more conventional memory than
  47.         previous versions of ARJ.  However, using the "-hm1" or "-hm!"
  48.         option will reduce your memory requirements especially when
  49.         archiving a large number of files.
  50.  
  51.         ---------
  52.  
  53.         After ARJ version 2.41a, full functionality of certain ARJ
  54.         software features will NOT be available in the shareware
  55.         versions of ARJ (registered or not).  These features include the
  56.         multiple volume self-extractor, the ARJSFX embedded command line
  57.         feature, and the inhibit display messages option.  The full
  58.         featured versions will ONLY be available from ARJ Software and
  59.         its agents.  Registered ARJ users can upgrade to this version
  60.         for a small shipping/handling fee ($5) or a SASE with diskette.
  61.         For credit card users, the upgrade fee will be $10 because of
  62.         minimum fee charge requirements.
  63.  
  64.         Check the WHATSNEW.DOC file for changes since ARJ 2.41a.
  65.  
  66.         ---------
  67.  
  68.         ** THIS VERSION OF ARJ HAS LONG FILENAME SUPPORT UNDER WINDOWS 95.
  69.  
  70.         ---------
  71.  
  72.         This version now supports ARJ-SECURITY for multiple volume
  73.         archives and multiple volume self-extractors.
  74.  
  75.         ---------
  76.  
  77.         New to this version of ARJ is a data damage protection option.
  78.         A slightly damaged/corrupted ARJ file can be repaired if the
  79.         archive was protected by creating a data protection file before
  80.         the damage occurred.  See below for more information.
  81.  
  82.         ---------
  83.  
  84.         New to this version of ARJ is the concept of backup CHAPTERS.
  85.         This allows the user to do MULTIPLE full backups to a SINGLE
  86.         archive in such a manner as to allow the full restoration of the
  87.         files at the time of ANY of the backups (CHAPTERS).  This allows
  88.         the user to backtrack easily, a feature valuable to software
  89.         developers.  Deleted files are also accounted for in this
  90.         chapter scheme.
  91.  
  92.         To go along with the new CHAPTER feature, ARJ now fully supports
  93.         the UPDATE of multiple volume archives.  To implement this
  94.         feature reliably in multiple volumes, all new or changed files
  95.         are added at the END of the LAST volume.  This re-arrangement
  96.         only occurs with multiple volume archives.  This prevents the
  97.         diskette overflow that would occur with earlier versions of ARJ.
  98.  
  99.         Because of the new CHAPTER feature, ARJ NO LONGER SUPPORTS the
  100.         old ARJ backup file feature.  This is the old "-jb / -jg"
  101.         functionality.  This version of ARJ will not process this type
  102.         of archive properly.
  103.  
  104.         See the "ac" command and "-jb" option for more information about
  105.         CHAPTER archives.
  106.  
  107.         ---------
  108.  
  109.         New to this version is the "hollow" archive.  This is an ARJ
  110.         archive that does NOT contain the compressed file data.  The
  111.         main application for this kind of archive is scanning for
  112.         CHANGED files.  This makes the hollow archive useful for file
  113.         integrity scanning as in virus damage scanning.
  114.  
  115.         ---------
  116.  
  117.         This version of ARJ provides a new encryption scheme based upon
  118.         the Russian encryption algorithm (GOST 28147-89 cipher). This
  119.         algorithm is similar in design to DES; however, GOST is designed
  120.         for software implementation.  This implementation uses the 64
  121.         bit cipher feedback mode.
  122.  
  123.         This new encryption is accessed by using the "-g" option to
  124.         specify the password and the "-hg" option to specify the new
  125.         scheme.  This new scheme is in addition to the older XOR garble
  126.         scheme.
  127.  
  128.         ** Please NOTE that losing your password means losing your file!
  129.         ** Please do NOT ask for technical support on lost passwords.
  130.         ** There is no shortcut/backdoor for determining lost passwords.
  131.  
  132.         The encryption module is a separate COM file named ARJCRYPT.COM.
  133.         ARJ expects to find the encryption module in the same directory
  134.         as itself.  ARJ treats the COM file as an overlay type module.
  135.         This has the advantage of saving space with the ARJSFXV module
  136.         and the DEARJ.EXE module when encryption is not needed.  You
  137.         simply do not include the encryption module in the archive.
  138.  
  139.         For non-USA users, the encryption overlay module is not included
  140.         with this version of ARJ.  Because of USA export regulations,
  141.         the encryption overlay module may not be exported from the USA.
  142.  
  143.         ---------
  144.  
  145.         ARJ can archive up to 32,000 files at one time when the "-hm"
  146.         option is specified.  This option enables ARJ to use disk space
  147.         instead of memory space to manage the names of the files being
  148.         archived.  The "-hm!" option uses XMS memory to manage the list
  149.         of names.  At this revision of ARJ, checking for duplicates is
  150.         NOT disabled as it was in 2.50.
  151.  
  152.         ---------
  153.  
  154.         The multiple volume SELF-EXTRACTION FUNCTION is LIMITED in the
  155.         ARJ shareware version.  Only volumes of 360K or less in size can
  156.         be created AND only such volumes will be processed by the
  157.         self-extractor.  This feature is accessed through the "-je"
  158.         option along with the "-v" option.
  159.  
  160.         This multiple volume self-extractor supports ANSI escape
  161.         sequence displays.  It also supports ARJ-SECURE over multiple
  162.         volumes and the new encryption method.
  163.  
  164.         ---------
  165.  
  166.         The extraction "-jo" option now works in cooperation with the
  167.         "-f" and "-u" type options.  Previously, the "-jo" option
  168.         disabled the "-f" and "-u" options.
  169.  
  170.         ---------
  171.  
  172.         The "-g" option will NOW force compression even when a size
  173.         increase results except when the "-m0" option is used.
  174.         Encrypted compressed data is more secure than encrypted stored
  175.         (-m0) data.
  176.  
  177.         ---------
  178.  
  179.         This version no longer detects the older 2.30 ARJ-SECURE
  180.         archives.
  181.  
  182.         ---------
  183.  
  184.         ** CAUTIONS **
  185.  
  186.         Whenever archiving to diskettes, it is HIGHLY recommended that
  187.         the option "-jt" be used.  This helps spot BAD diskettes or BAD
  188.         diskette drives.  It is HIGHLY recommended that the "-jt" option
  189.         be used in a Windows or multi-tasking or network environment.
  190.  
  191.         UNERASE or UNDELETE commands do not always recover a file
  192.         correctly.  This will result in damaged archives.  This is true
  193.         for all archive types.  You should always test an archive after
  194.         unerasing it.
  195.  
  196.         CAUTION: To those who use the "-t1" and/or "-t1g" options to
  197.         save a few extra bytes.  This option should only be used on TEXT
  198.         FILES. Those are files created by EDLIN, EDIT, QEDIT, BRIEF,
  199.         NOTEPAD, and others.  Text files typically contain only letters,
  200.         numbers, spaces, and punctuation marks.  WORD PROCESSOR format
  201.         files ARE NOT TEXT FILES!  MS WORD, Wordperfect, AMIPRO, WRITE,
  202.         and similar files ARE NOT TEXT FILES. Using the "-t1" or "-t1g"
  203.         on any other kind of file probably will result in DATA LOSS!
  204.  
  205.      **********************************************************************
  206.  
  207.  
  208.      WINDOWS 95 LONG FILENAME SUPPORT
  209.  
  210.         This version of ARJ supports the use of long filenames under the
  211.         Windows 95 in the MS-DOS Prompt environment.  It does not support
  212.         long filenames under MS-DOS 6.22 and below.  It supports long
  213.         filenames ONLY when the Windows 95 GUI (graphical user interface)
  214.         is running.  In other words, there is no long filename support in
  215.         Windows 95 MS-DOS mode (accessed from the Win95 shutdown menu).
  216.  
  217.         The small ARJ self-extractor (-je1) does NOT support the handling
  218.         of long filenames.
  219.  
  220.         The ARJSFX and ARJSFXV modules (-je) support long filename
  221.         handling.  However, they will only extract archived Win95 long
  222.         filename files under Win95.  If long filename files are being
  223.         extracted to plain DOS, an error message will be displayed.  They
  224.         can be forced to extract the Win95 archived files with the "-j"
  225.         option.
  226.  
  227.         For compatibility with MS-DOS and older versions of ARJ, ARJ can
  228.         create a dual-name compatibility ARJ archive.  This is an archive
  229.         with both shortnames and longnames stored in it.  The longnames are
  230.         stored in the file comment field.  New versions of ARJ will treat
  231.         the dual-name archive according to the operating system
  232.         environment.  In other words, under MS-DOS, a dual-name archive
  233.         will look like a shortname archive.  Under WIN95, a dual-name
  234.         archive will look like a longname archive.  This is also true of
  235.         the ARJSFX and ARJSFXV modules (-je).
  236.  
  237.         For efficiency reasons ARJ does not repeatedly check for file
  238.         system support of long filenames.  ARJ only tests the "C:" file
  239.         system.  An error may occur if ARJ under Win95 tries to access a
  240.         disk drive that does not support long filename handling.  The "-hf"
  241.         option can be used to force ARJ to use the standard 8.3 filename
  242.         APIs instead of the longname APIs.
  243.  
  244.         There are three new options "-hf", "-hf1", and "-hf2" that provide
  245.         choices in the handling of long filenames.  See the discussion of
  246.         those options below for more information.
  247.  
  248.         ARJ will save Win95 long filenames in the letter case they are
  249.         stored on disk; however, all filename matching is done without
  250.         regard to case.  In other words, "ThisName.Ext" matches
  251.         "thisNAME.ext".
  252.  
  253.         When archiving files under Windows 95, be sure to EXCLUDE files
  254.         from processing that are OPEN such as WIN386.SWP.
  255.  
  256.  
  257.      ARJ RESPONSE FILE PROCESSING:
  258.  
  259.         ARJ will accept an ARJ command line from a response file as in
  260.         "ARJ @command.rsp".  The "@" symbol indicates that the appended
  261.         name is the name of the response file.  In this case, the file is
  262.         command.rsp. The response file symbol cannot be changed.
  263.  
  264.         The response file should contain the ARJ command line minus the
  265.         initial "ARJ".  The command line may be split over as many lines
  266.         as necessary.  The response file feature will NOT accept QUOTED
  267.         command line options.  Options with embedded blanks ("-vasTEST X")
  268.         will not be processed as expected.  See the "-@" option for
  269.         help on options with blanks.  When using the response file feature,
  270.         ARJ will accept only the "-+", and "-&" switch options on the DOS
  271.         command line along with the response file name.  All other command
  272.         options must be specified in the response file or in the ARJ
  273.         environment variable.
  274.  
  275.         To better support long filenames, ARJ provides the "-@" option to
  276.         handle the processing of filenames and switch options that contain
  277.         embedded spaces.  The "-@" switch option enables the interpretation
  278.         of a text line in an ARJ response file as a single token.  In other
  279.         words, when ARJ scans an "-@" option, it will process the NEXT text
  280.         line in the response file as a single token including all embedded,
  281.         leading, and trailing blanks.  ARJ will continue to process each
  282.         subsequent text line in the same manner.  If ARJ scans a subsequent
  283.         "-@" option, ARJ will revert to its normal multiple tokens per line
  284.         processing.
  285.  
  286.  
  287.      ARJ-PROTECT DATA PROTECTION FEATURE
  288.  
  289.         With this version, ARJ can repair "protected" archives that suffer
  290.         from slight amounts of data damage (CRC error, bad header, etc). An
  291.         ARJ archive is "protected" with the "-hk" option.  With the "-hk"
  292.         option, ARJ will generate a separate ARJ data protection file. This
  293.         protection file is REQUIRED in order to repair damaged ARJ
  294.         archives.  The size of this file ranges from a minimum of 4096
  295.         bytes and upwards.  For larger archives, the protection file size
  296.         is typically less than one percent of the archive file size.
  297.  
  298.         For this release, the protection file is a separate file.  This
  299.         avoids the problem of uploading unnecessary data to BBSes and ftp
  300.         sites.  The name of the protection file is based upon the archive
  301.         name plus the extension ".XRJ".  Volume protection files end in
  302.         ".X01", etc.
  303.  
  304.         This protection feature is sector based and allows repair due to
  305.         typical types of disk corruption (bad sector, virus damage, cross
  306.         links, etc).  This type of sector protection is NOT effective for
  307.         most data transmission problems where data is missing from the
  308.         middle of a transmission.
  309.  
  310.         Technically, this protection feature uses a series of XOR sums and
  311.         checksums in order to allow repairs.  Larger archives are logically
  312.         treated as separate streams of data.  ARJ can protect each "stream"
  313.         from one or two damaged sections 1024 bytes in size.  However, for
  314.         large archives (1 MB or larger) ARJ can sometimes repair up to four
  315.         damaged sections per MByte.  The "-hk1, "-hk2" ... "-hk9" options
  316.         can offer more data protection at the cost of a proportionately
  317.         larger protection file.
  318.  
  319.         The "-hk" option sets ARJ to build a protection file.  The "q"
  320.         command is used to repair a damaged archive.  The repaired archive
  321.         is named ARJFIXED.ARJ.
  322.  
  323.         Example:  ARJ a archive -hk       generates archive.xrj
  324.                   ARJ q archive           repairs archive.arj
  325.  
  326.  
  327.      ARJ ANSI COMMENT HANDLING
  328.  
  329.         At version 2.55, ARJ will use its own ANSI sequence display handler
  330.         to display ARJ comments.  In previous versions, ARJ depended upon
  331.         the "-ja" option and an installed ANSI.SYS driver to handle the
  332.         ANSI escape sequences.  The "-ja" option has a new function now.
  333.         The "-ja" option will set the "P" command to display files using
  334.         the new ANSI sequence display handler.
  335.  
  336.         The ARJSFXV module (-je -v) also will display ANSI comments now.
  337.  
  338.         Please note that the ARJ comment field size is limited to about 2K
  339.         bytes.
  340.  
  341.  
  342.      ARJSFXV MULTIPLE VOLUME SELF-EXTRACTOR
  343.  
  344.         This module now supports ARJ-SECURE and ANSI escape sequences in
  345.         the archive comment.  You can build a single volume
  346.         self-extracting archive by specifying a larger volume size.  The
  347.         ARJ distribution archive uses the ARJSFXV module because of the
  348.         ANSI comment support.
  349.  
  350.         Example:  ARJ a archive *.* -je -v300K
  351.  
  352.  
  353.      ARJ COMMANDS
  354.  
  355.      "ac" command
  356.  
  357.         This is a new two character command for ARJ.  It is actually an
  358.         abbreviation for the following command and switch options:
  359.         "u -u2 -jb".  The "ac" command will add a chapter backup to a new
  360.         archive or add a new chapter (updating) to a chapter archive.
  361.  
  362.         Example:  ARJ ac archive c:\dir\*.* -r -jt
  363.  
  364.         The advantage of a chapter archive is that you can make numerous
  365.         full backups (chapters) to a SINGLE archive.  Major space savings
  366.         will result when some files do not change from backup to backup.
  367.  
  368.         See the "-jb" option for more details.
  369.  
  370.  
  371.      "e" command
  372.      "x" command
  373.  
  374.         Chapter archives do NOT support extraction with deletion.
  375.  
  376.         ARJ x archive *.doc -d   generates "Bad command syntax"
  377.  
  378.  
  379.      "q" command
  380.  
  381.         The "q" command is used to repair a damaged "protected" archive.
  382.         An archive is protected with the "-hk" option.  Both the protected
  383.         archive and its ARJ-PROTECT data protection file are required to
  384.         repair any damage.  The "q" command will attempt to repair all
  385.         damages and put the repaired archive in a file named ARJFIXED.ARJ.
  386.  
  387.         Example:  ARJ q archive
  388.  
  389.         When working with a damaged archive and the "Abort, Retry, Ignore,
  390.         Fail" prompt appears, you should select the "Ignore" option.
  391.  
  392.  
  393.      "y" command
  394.  
  395.         When used with the "-g" option and optionally the "-hg" option,
  396.         ARJ will ungarble a previously garbled archive.
  397.  
  398.         Example:  ARJ y archive -gpasswrd
  399.  
  400.         When used with the "-jb" option, ARJ will convert a standard
  401.         archive to a chapter archive.
  402.  
  403.         Example:  ARJ y archive -jb
  404.  
  405.         When used with the "-jb*" option, ARJ will convert a chapter
  406.         archive to a standard archive.
  407.  
  408.         Example:  ARJ y archive -jb*
  409.  
  410.  
  411.      ARJ SWITCHES
  412.  
  413.      "-@" switch
  414.  
  415.         This switch sets ARJ to enable/disable the interpretation of text
  416.         lines in an ARJ RESPONSE file as a complete single token. Normally,
  417.         in an ARJ response file, blanks are interpreted as token
  418.         separators.  (Tokens are commands, filenames, wildcards, and switch
  419.         options).  However, if ARJ scans an "-@" option in a response file,
  420.         it will process subsequent text lines as single tokens per line.  A
  421.         subsequent "-@" option will revert ARJ to normal multiple tokens
  422.         per line mode.
  423.  
  424.         Example:  ARJ @text.rsp
  425.  
  426.         TEXT.RSP contains:
  427.         a c:\dir\archive -r -jt1 -@ -a1
  428.         c:\long directory name\*.*
  429.         c:\other directory name\*.*
  430.         -@
  431.         dir1\*.* dir2\*.* dir3\*.*
  432.  
  433.         One common error when using the "-@" option is including extraneous
  434.         leading and/or trailing blanks.  For example, ARJ will abort with
  435.         an invalid switch option error if the second "-@" above has one or
  436.         more trailing blanks.
  437.  
  438.  
  439.      "-b" switch
  440.  
  441.         Under Windows 95, the use of the "-b" type switch options to reset
  442.         the archive bit may result in a sharing violation error.  Under
  443.         ARJ 2.55b, ARJ will display the error and then proceed ignoring
  444.         the error.
  445.  
  446.  
  447.      "-e" switch
  448.  
  449.         This switch used during extraction will exclude the beginning
  450.         characters of the filename.  This can be useful for shortening a
  451.         long output pathname.
  452.  
  453.         Examples:  ARJ x archive -e10  will exclude the first 10
  454.                                        characters of the output filename.
  455.  
  456.                    ARJ x archive -e4   will exclude the first 4 characters.
  457.  
  458.  
  459.      "-f1" switch
  460.  
  461.         This switch is used to select files that are OLDER for extracting
  462.         or adding.
  463.  
  464.  
  465.      "-f2" switch
  466.  
  467.         This switch is used to select files that are DIFFERENT (different
  468.         date-time or different size) for extracting or adding.
  469.  
  470.         There is a slight limitation to this switch.  When processing
  471.         files that are split across volumes, the size test is skipped.
  472.  
  473.  
  474.      "-g" switch
  475.  
  476.         The garble option in this version of ARJ has two versions. One
  477.         is the original version found in earlier ARJ releases.  It is
  478.         compatible with older versions and works like those versions.
  479.  
  480.         The other garble version uses a separate encryption module.  ARJ
  481.         treats this module as an overlay.
  482.  
  483.         This new option is accessed by using the new "-hg" option.  This
  484.         option sets ARJ to use the separate encryption module to encrypt
  485.         the data.  By default, ARJ will look for the file "ARJCRYPT.COM"
  486.         in the same directory where the ARJ.EXE being executed is found.
  487.         The user may specify the pathname of the module to use.
  488.  
  489.         Examples:  ARJ a archive *.doc -gThis_is_a_password -hg
  490.                    ARJ a archive *.doc -gpassword -hgc:\dir\enc.com
  491.  
  492.         The new garble option accepts a password key up to 32 characters
  493.         long.  Excess characters are ignored.  Garble passwords ARE CASE
  494.         SENSITIVE!  DO NOT LOSE your password!  There is no known method to
  495.         recover the password other than by brute force, which could take a
  496.         very long time.  The longer the password, the longer it would take
  497.         to "guess" it.
  498.  
  499.         This new encryption scheme is not compatible with the "-g" option
  500.         of pre-2.55 versions of ARJ.  If you want to maintain compatibility
  501.         with pre-2.55 versions of ARJ, you should NOT use the "-hg" option.
  502.  
  503.         Only the multiple volume self-extractor supports the new encryption
  504.         module.
  505.  
  506.         When garbling or ungarbling an existing archive, ARJ will detect
  507.         the method of encryption previously used and select that same
  508.         method even if the "-hg" option was not specified.
  509.  
  510.  
  511.      "-s3" switch
  512.  
  513.         This switch sets ARJ to keep both the original archive file
  514.         time-stamp as well as the original internal archive modified
  515.         time-stamp when modifying the archive.
  516.  
  517.         This feature is helpful when adding a copy of the data damage
  518.         protection file to the "protected" archive.  Using this switch,
  519.         you can add a file to an archive and then remove that file and
  520.         end up with the original archive.  This is necessary because any
  521.         change in archive contents would be perceived as damage by the
  522.         ARJ "q" (repair archive) command.
  523.  
  524.         Example:   ARJ a archive *.doc -hk
  525.                    ARJ a archive archive.xrj -s3
  526.                    ARJ e archive archive.xrj -d -s3
  527.                    ARJ q archive
  528.  
  529.         The above sequence of commands replicates a situation where the
  530.         user embeds a copy of the data damage protection file into the
  531.         "protected" archive.  In the case of slight archive damage, the
  532.         protection file can be extracted and used to recover damaged data.
  533.  
  534.  
  535.      "-u1" switch
  536.  
  537.         This switch is used to select files that are OLDER or NEW for
  538.         extracting or adding.
  539.  
  540.  
  541.      "-u2" switch
  542.  
  543.         This switch is used to select files that are DIFFERENT (different
  544.         date-time or different size) or NEW for extracting or adding.
  545.  
  546.         There is a slight limitation to this switch.  When processing
  547.         files that are split across volumes, the size test is skipped.
  548.  
  549.  
  550.      "-v" switch
  551.  
  552.         For specifying sizes for this option, ARJ will accept the "M"
  553.         modifier to multiply by 1,000,000 (one million).
  554.  
  555.         Examples:  ARJ a vol -v100M
  556.                    ARJ a vol -vr1M1440
  557.  
  558.  
  559.      "-hf" switch
  560.  
  561.         This switch disables Windows 95 long filename handling.  ARJ will
  562.         use the standard DOS 8.3 APIs to do its processing.  Files so
  563.         archived with this switch can be extracted under Windows 95 and
  564.         DOS.
  565.  
  566.         This switch can be used while listing a dual-name archive under
  567.         Win95 to list/process the shortnames.
  568.  
  569.  
  570.      "-hf1" switch
  571.  
  572.         This switch in Win95 during archival sets ARJ to build a dual-name
  573.         compatibility archive by storing the shortname in the filename
  574.         field and the longname in the file comment field, so that both long
  575.         filenames and short filenames are stored in the archive.
  576.  
  577.         Such a dual-name archive is compatible with older versions of ARJ.
  578.         New versions of ARJ process such an archive according to the
  579.         current operating system environment.  Under Win95, the long
  580.         filenames in the archive are used.  Under MS-DOS, the short
  581.         filenames are used.  This processing is automatic for this release
  582.         of ARJ.
  583.  
  584.         The "-e1" option does not affect the short name that is stored.
  585.  
  586.         This switch during extraction in an environment where long
  587.         filenames are not supported sets ARJ to extract files using
  588.         generated names.  ARJ will generate a short name based upon
  589.         "W95LNAME.000" and its sequence number in the archive.
  590.  
  591.  
  592.      "-hf2" switch
  593.  
  594.         This switch sets ARJ to attempt to extract using the long filenames
  595.         stored in the archive.  No modification is done to the long
  596.         filenames except by DOS itself.  This switch also sets ARJ to use
  597.         the standard DOS 8.3 APIs for processing.  Because of the
  598.         shortening of the filenames by DOS, duplicate filenames may result.
  599.  
  600.  
  601.      "-hg" switch
  602.  
  603.         This switch is used to specify the filename of the encryption
  604.         module to be used when encrypting a new archive.  The default
  605.         filename is "ARJCRYPT.COM".  ARJCRYPT.COM contains a new encryption
  606.         scheme that is incompatible with earlier releases of ARJ.  ARJ will
  607.         look for the encryption module in the directory that contains the
  608.         copy ARJ.EXE that is being executed unless the specified module
  609.         name contains a path symbol "\" as in "ARJ\OLDCRYPT.COM".  If you
  610.         want to use a module in the current directory, you should specify
  611.         the name as in ".\ARJCRYPT.COM".  The "." indicates the current
  612.         directory.
  613.  
  614.         With an existing archive, ARJ detects the encryption scheme that
  615.         was used to encrypt the archive and uses the same scheme regardless
  616.         of whether the "-hg" option is specified or not.
  617.  
  618.  
  619.      "-hk" switch
  620.  
  621.         The "-hk" switch sets ARJ to create an ARJ-PROTECT data protection
  622.         file.  This file is named similarly to the created archive except
  623.         for an "X" in the beginning of the file extension as in NAME.XRJ.
  624.         This ARJ-PROTECT file contains necessary information to repair
  625.         damage to the original archive.  The "-hk1", "-hk2" ... "-hk9"
  626.         options will generate larger ARJ-PROTECT files affording a higher
  627.         probability of a successful repair.
  628.  
  629.         For users who do not like the separate protection file feature,
  630.         there is a work-around.  Using the new "-s3" option (keep original
  631.         time-stamps), the user can add the ARJ-PROTECT file to the
  632.         protected archive and extract it later for repair purposes.
  633.  
  634.         Example:  ARJ a docs *.txt -hk          builds protected archive
  635.  
  636.                   ARJ a docs docs.xrj -s3       inserts protect file
  637.  
  638.                   ARJ e docs docs.xrj -s3 -d    extracts and removes
  639.                                                 protect file restoring
  640.                                                 the original archive
  641.  
  642.                   ARJ q docs                    repairs archive
  643.  
  644.  
  645.      "-hm" switch
  646.  
  647.         The "-hm" switch sets ARJ to transfer the list of filenames to be
  648.         archived from the limited conventional memory to file storage.
  649.         This allows a much larger number of files to be processed (over
  650.         32,000).  This option is ignored for all ARJ commands except
  651.         "a", "f", "j", "m", "u".
  652.  
  653.         Normally, this switch sets ARJ to wait until it is out of memory
  654.         storing filenames into a list before transferring that list to a
  655.         temporary file.  That temporary file is put in the current
  656.         directory or the special work directory if specified (-hm!F:\) or
  657.         XMS memory is specified (-hm!).
  658.  
  659.         However, there may be a few cases where ARJ will run out of memory
  660.         doing other tasks while it is storing this list.  In these cases,
  661.         ARJ will abort.  The user can specify a numeric argument of "1" to
  662.         this switch to force ARJ to transfer the list to file storage
  663.         immediately.
  664.  
  665.         The "-hm" work directory is specified by appending a "!" to the
  666.         "-hm" or "-hm1" options and then appending the filename to the
  667.         option.  See below.
  668.  
  669.         Examples:  ARJ a archive c:\*.* -r -hm
  670.                    ARJ a archive c:\*.* -r -hm1
  671.                    ARJ a a:archive c:\*.* -r -va -hm500!F:\
  672.                    ARJ a a:archive c:\*.* -r -hm!G:\temp\
  673.  
  674.         The use of a RAMDISK directory will provide the fastest operation.
  675.  
  676.  
  677.      "-hm!" switch
  678.  
  679.         The "-hm!" option with no pathname appended to it will set ARJ to
  680.         store its list of filenames in XMS memory.  List processing will be
  681.         faster using XMS memory as opposed to using disk space.  If no XMS
  682.         memory is available, ARJ will use conventional memory and then disk
  683.         space if needed.
  684.  
  685.         If there is not enough XMS memory for available for the internal
  686.         list, ARJ will abort.
  687.  
  688.  
  689.      "-j#" switch
  690.  
  691.         This switch allows the building and testing of a special ARJ
  692.         "HOLLOW" archive that is missing the actual compressed file
  693.         contents.  This allows the creation of small archives for CRC
  694.         testing against the CRCs of actual files.  This is suited for
  695.         special applications. Please take note that NO actual file data can
  696.         be extracted from these "HOLLOW" archives.
  697.  
  698.         For example, a user has transported a directory of files from one
  699.         PC to another PC.  At a later time, that user would like to
  700.         determine which files have actually changed their contents
  701.         regardless of the date-time stamps.  That user could archive the
  702.         original directory using the -j# switch which builds the ARJ
  703.         "hollow" archive with the sole exception that no compressed data is
  704.         stored with the archive.  This allows the rapid building of a much
  705.         smaller archive.  The file CRC is computed and stored in the
  706.         archive.  This new "hollow" archive is transported to the other PC.
  707.         A simple ARJ test command with the "-jt1" option on the other PC
  708.         would point out files whose content's CRC do not match.
  709.  
  710.         Another use of this "hollow" archive is for FILE INTEGRITY
  711.         checking.  You can create this "hollow" CRC archive and use it at a
  712.         later time to determine if any files have been corrupted or damaged
  713.         by VIRUS or system problems.
  714.  
  715.         Please note that there is a VERY SMALL possibility that a file has
  716.         been changed and its new 32 bit CRC still matches.  That
  717.         possibility is approximately one in four billion.
  718.  
  719.         The -j# option during an ARJ archive build will set the compression
  720.         method to 9.  The only change is that the file header will indicate
  721.         that the compressed file size is ZERO.  Otherwise, the file header
  722.         is the same as in an archive where the file was actually compressed
  723.         and stored.
  724.  
  725.         To use this "hollow" archive to test CRCs against actual file CRCs,
  726.         use the following syntax:
  727.  
  728.         Syntax:  ARJ t archive_name -jt1
  729.                  ARJ t archive_name target_dir\ -jt1
  730.  
  731.         The second command above is used where the relative pathnames
  732.         stored in the archive do not match up with the current directory.
  733.         See the discussion in ARJ.DOC for more information on the option
  734.         "-jt".
  735.  
  736.         When ARJ displays "NOT matched" for a "hollow" archive, it means
  737.         the file size in the archive and the size of the actual file do NOT
  738.         match.
  739.  
  740.  
  741.      "-ja" switch
  742.  
  743.         This switch has acquired NEW functionality.  Its OLD function was
  744.         to set ARJ to fully display ANSI escape sequences.  It now is used
  745.         with the "ARJ p" command to display files using ARJ's own ANSI
  746.         display handler.  ANSI.SYS is no longer needed.
  747.  
  748.         Example:  ARJ p ansifile -ja -q
  749.  
  750.  
  751.      "-jb" switch
  752.  
  753.         This switch sets ARJ to build a chapter archive.  Once an archive
  754.         is set to a chapter archive, all subsequent processing will
  755.         continue to treat it as a chapter archive.
  756.  
  757.         The advantage of a chapter archive over a series of separate
  758.         archives of the same set of files is that space can be saved when
  759.         archived files do not change.  A single chapter archive can produce
  760.         the same results as one hundred standard archive backups.  In other
  761.         words, one can update a chapter archive one hundred times and fully
  762.         recover any one of those updates.
  763.  
  764.         Technically speaking, each file in a chapter archive has a chapter
  765.         lifespan range.  When a file is backed up and has not changed since
  766.         the last backup, only the lifespan range is changed.  A copy of the
  767.         file is NOT added to the archive since a copy already exists in the
  768.         archive.  If the backed up file is different from the previous
  769.         version, then that file is added to the archive with an appropriate
  770.         chapter range. The previous version of the file is still kept in
  771.         the chapter archive.  When a particular chapter is restored, ARJ
  772.         selects only the files whose lifespan includes the chapter number
  773.         requested.
  774.  
  775.         As an example, suppose one made a series of daily chapter backups
  776.         of a document directory where only one document out of the one
  777.         hundred documents changes on a daily basis.  The chapter archive
  778.         would contain the original one hundred documents plus a copy of
  779.         each day's changed document.
  780.  
  781.         When processing chapter archives, all ARJ add type commands
  782.         (A,M,F,U) will create a new chapter in the chapter archive.  Up to
  783.         a maximum of 250 chapters can be stored in a single archive.  The
  784.         proper way to build and update a chapter archive is with the "ac"
  785.         command.  You should use the same command line arguments for
  786.         each chapter update.  If you fail to select the same files as
  787.         before, the chapter archive will not update the lifespan ranges
  788.         properly and those unselected files will "appear" to have been
  789.         deleted for the current chapter.  By default, the "ac" command
  790.         will update a chapter archive with files that are DIFFERENT from
  791.         the previous chapter (different size or date-time stamp).  The
  792.         "ac" command is actually an abbreviation for the following
  793.         command and options: "u -u2 -jb", so you CANNOT use the "-u" or
  794.         "-jb" options with the "ac" command.
  795.  
  796.         ARJ ac archive dir\  *.txt *.doc *.wri      initial build
  797.         ARJ ac archive dir\  *.txt *.doc *.wri      second chapter
  798.         ARJ ac archive dir\  *.txt *.doc *.wri      third chapter
  799.         ARJ ac archive dir\  *.txt *.doc *.wri      fourth chapter
  800.         ARJ ac archive dir\  *.txt *.doc            fifth chapter will
  801.                                                  be missing all *.wri files
  802.  
  803.         An expert with ARJ may want to use the actual commands and switches
  804.         instead of the "ac" command.
  805.  
  806.         ARJ u -u2 -jb archive dir\ *.txt
  807.  
  808.         The "-jb$" option will allow ARJ add type commands to update/replace
  809.         files in the most recent chapter in the archive.  This option can be
  810.         used to "fix" a chapter where files are missing.  Be careful doing
  811.         this.  It is much simpler and safer to add a new chapter to the
  812.         archive.
  813.  
  814.         ARJ a archive -jb$ dir\  *.wri
  815.  
  816.         It is possible to change a standard ARJ archive to a chapter archive
  817.         with the "y" command and the "-jb" option.  The opposite is possible
  818.         with the "-jb*" option.
  819.  
  820.         ARJ y archive -jb      converts archive to chapter archive
  821.         ARJ y archive -jb*     converts chapter archive to standard archive
  822.  
  823.         You can restore the files in the most recent chapter as in:
  824.  
  825.         ARJ x archive
  826.  
  827.         You can restore a specific chapter as in:
  828.  
  829.         ARJ x archive -jb10    restores chapter 10
  830.         ARJ x archive -jb20    restores chapter 20
  831.  
  832.         You can list a specific chapter as in:
  833.  
  834.         ARJ l archive -jb10    lists chapter 10
  835.         ARJ l archive          lists the most recent chapter
  836.  
  837.         You can see the chapter ranges for each file in the archive with
  838.         the following command:
  839.  
  840.         ARJ l archive -jb* -jv
  841.  
  842.         To start all over again with a chapter archive, you should purge all
  843.         of the previous chapters, convert the archive to a standard archive,
  844.         and then back to an archive chapter.
  845.  
  846.         You cannot modify specific chapters other than the most recent
  847.         chapter.
  848.  
  849.         You can remove the most recent chapter with the following command:
  850.  
  851.         ARJ d archive *.* -jb
  852.  
  853.         If you do not specify the "-jb" with a delete command, the archive
  854.         chapter header will not be deleted.
  855.  
  856.  
  857.      "-jb*" switch
  858.  
  859.         This switch is used to select all chapters.
  860.  
  861.         When it is used with the LIST command, ARJ displays all chapters.
  862.  
  863.         ARJ l archive -jb*     displays all chapters
  864.  
  865.         This switch can be used with the DELETE command to remove all
  866.         chapters of selected file(s).
  867.  
  868.         ARJ d archive -jb* *.bak *.tmp
  869.  
  870.         This switch is also used with the "y" command to convert a standard
  871.         archive to a chapter archive.
  872.  
  873.         ARJ y archive -jb*     converts chapter archive to standard archive
  874.  
  875.  
  876.      "-jb$" switch
  877.  
  878.         This switch can be used with the ADD command to modify the most
  879.         recent chapter files.
  880.  
  881.         ARJ a archive -jb$ dir\  *.wri
  882.  
  883.         This switch can be used with the DELETE command to purge all BUT
  884.         the current chapter.
  885.  
  886.         ARJ d archive -jb$ *.*     is the same as    ARJ k archive *.*
  887.  
  888.  
  889.      "-jo" switch
  890.  
  891.         New to this release, the "-jo" option during extraction works along
  892.         with the "-f" and "-u" type options.  In other words, if you want to
  893.         freshen a set of files from an archive, the use of the "-jo" option
  894.         will generate unique names for any files extracted.
  895.  
  896.         Example:  ARJ x archive *.* -u -jo
  897.  
  898.  
  899.      "-jyv" switch
  900.  
  901.         As a clarification of older documentation, the "-jyv" option will
  902.         disable the next volume prompt EVEN with removable media.  The
  903.         global "-y" option does not disable the next volume prompt with
  904.         removable media.
  905.  
  906.  
  907.      end document
  908.  
  909.