home *** CD-ROM | disk | FTP | other *** search
/ GameStar 1998 October / Gamestar_00_1998-10_cd1.bin / programy / ARJ260X.EXE / UPDATE.DOC < prev    next >
Text File  |  1997-11-16  |  62KB  |  1,407 lines

  1.  
  2.      UPDATE.DOC, ARJ 2.60 FULL RELEASE                        October 1997
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.50.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.         The name of our company has changed to ARJ Software, Inc.
  11.  
  12.         ARJ Software, Inc. is now marketing two archiver products, ARJ
  13.         and a new archiver JAR (JAR16/JAR32), that produces "J"
  14.         archives which are not compatible with ARJ.  The 32 bit version
  15.         of JAR (JAR32) supports the Windows NT operating system version
  16.         3.50 and above as well as Windows 95.
  17.  
  18.         We have developed the new archiver, JAR, so that we could
  19.         provide state of the art data compression with solid archiving
  20.         techniques and new compression algorithms.  These improvements
  21.         could not be added to ARJ without introducing serious
  22.         compatibility issues with older releases of ARJ.  JAR16/32
  23.         compresses significantly better than ARJ and PKZIP for many
  24.         files and provides long filename support for both Windows 95 and
  25.         Windows NT.  JAR16/32 duplicates much of ARJ's powerful
  26.         functionality and provides new original functionality, too.
  27.         However, it does not duplicate ARJ and it requires more system
  28.         resources (memory and cpu power) to run.  See our web site for a
  29.         copy of this archiver.
  30.  
  31.         Please note that it is our intention to continue supporting and
  32.         enhancing the ARJ product.  There are a significant number of
  33.         new features in this release of ARJ.  ARJ has the advantages of
  34.         a large installed base, a simple archive format, significant
  35.         third party software support, and a long history of reliable
  36.         performance.  We also plan to provide ARJ support for Windows.
  37.  
  38.         The "ARJ y archive -jb0" command is NOW used to convert a chapter
  39.         archive to a standard archive instead of using "-jb*".
  40.  
  41.         This version has been changed with regard to the storage of the
  42.         SFX modules and the built-in help information.  The change now
  43.         requires that MS-DOS 3.0 and above be used to access the SFX
  44.         modules and the help information.  Under DOS 2.11, the help
  45.         screens and self-extractor creation will work if ARJ.EXE is
  46.         located in the CURRENT directory.  This change frees up more
  47.         conventional memory for ARJ use.
  48.  
  49.         The mailing address of ARJ Software, Inc. has changed as of
  50.         August 1993.
  51.  
  52.         ARJ Software, Inc.
  53.         P.O. Box 249
  54.         Norwood MA 02062
  55.         USA
  56.  
  57.         FAX: 781-769-4893 as of September 1997
  58.  
  59.         EMAIL: robjung@world.std.com
  60.  
  61.         There is ARJ Internet mailing list and WEB site support
  62.         information added to the file ARJ.DOC.  They are excerpted below:
  63.  
  64.         http://www.ARJSOFTWARE.com                    (ARJ homepage)
  65.         http://www.ARJSOFT.com                        (ARJ homepage)
  66.  
  67.         http://www.Dunkel.de/ARJ                      (German and English)
  68.         http://www.glo.be/tsf                         (French and English)
  69.  
  70.         You can find information about the world of ARJ on the Internet
  71.         by using various search sites including www.altavista.com and
  72.         www.dejanews.com.
  73.  
  74.         Our credit card ordering procedures have changed.  We now
  75.         process credit cards directly.
  76.  
  77.         ---------
  78.  
  79.         YEAR 2000 COMPLIANCE STATEMENT
  80.  
  81.  
  82.         This version of ARJ as well as all previous versions are YEAR 2000
  83.         compliant and will operate properly and with full functionality up
  84.         to the year 2079.
  85.  
  86.         For more details, see ARJ.DOC.
  87.  
  88.         ---------
  89.  
  90.         This version of ARJ will use more conventional memory than
  91.         previous versions of ARJ, but less than ARJ 2.55b.  However,
  92.         using the "-hm1" or "-hm!" option will reduce your memory
  93.         requirements especially when archiving a large number of files.
  94.  
  95.         ---------
  96.  
  97.         After ARJ version 2.41a, full functionality of a small set of
  98.         ARJ software features will NOT be available in the shareware
  99.         versions of ARJ (registered or not).  These features include the
  100.         multiple volume self-extractor, the ARJSFX embedded command line
  101.         feature, and the inhibit display messages option.  The full
  102.         featured versions will ONLY be available from ARJ Software, Inc.
  103.         and its agents.  Registered ARJ users can upgrade to this
  104.         version for a small shipping/handling fee (five dollars) or a
  105.         SASE with diskette.
  106.  
  107.         Check the WHATSNEW.DOC file for changes since ARJ 2.41a.
  108.  
  109.         ---------
  110.  
  111.         ** THIS VERSION OF ARJ HAS LONG FILENAME SUPPORT UNDER WINDOWS 95.
  112.         ** REARJ NOW SUPPORTS LONG FILENAMES UNDER WINDOWS 95.
  113.  
  114.         Windows 95 DOS support (and therefore ARJ) do not support access
  115.         to long filenames containing certain characters.  For example, a
  116.         filename containing the copyright symbol or the trademark symbol
  117.         cannot be accessed in a Win95 DOS window with the COPY command
  118.         or with ARJ.  These type of filenames can only be accessed via
  119.         their short names.  The Win95 system normally stores filename
  120.         characters as two bytes per symbol allowing an alphabet of 65536
  121.         possible symbols.  Because Win95 DOS only uses one byte per
  122.         character position allowing only a 256 symbol alphabet, many
  123.         characters are displayed by Win95 DOS as "_".
  124.  
  125.         With a workaround, ARJ will "extract" long filename archives to
  126.         other operating systems that support long filenames (OS/2,
  127.         WinNT, Linux). The "-hf1" option along with the "-ji" option
  128.         allows extracting files to "temporary" files to be later copied
  129.         to the original long filenames.  See the "-hf1" section for
  130.         details.
  131.  
  132.         ---------
  133.  
  134.         This version now supports ARJ-SECURITY for multiple volume
  135.         archives and multiple volume self-extractors.  ARJ-SECURE users
  136.         should note the upgrade information above.
  137.  
  138.         ---------
  139.  
  140.         New to this version of ARJ is a data damage protection option.
  141.         A slightly damaged/corrupted ARJ file can be repaired if the
  142.         archive was protected by creating a data protection file before
  143.         the damage occurred.  See below for more information.  The
  144.         current competing PKZIPFIX programs offers NO protection against
  145.         damage to actual file data.  PKZIPFIX fixes damaged archive
  146.         directories.
  147.  
  148.         ---------
  149.  
  150.         New to this version of ARJ is the concept of backup CHAPTERS.
  151.         This allows the user to do MULTIPLE full backups (up to 250) to
  152.         a SINGLE archive in such a manner as to allow the full
  153.         restoration of the files at the time of ANY of the backups
  154.         (CHAPTERS).  This allows the user to backtrack easily, a feature
  155.         valuable to software developers.  Deleted files are also
  156.         accounted for in this chapter scheme.  Inherent in this concept
  157.         is disk space savings.
  158.  
  159.         To go along with the new CHAPTER feature, ARJ now supports the
  160.         UPDATE of multiple volume archives.  The "-hu" option is
  161.         obsolete.  To implement this feature reliably in multiple
  162.         volumes, all new or changed files are added at the END of the
  163.         LAST volume.  This re-arrangement only occurs with multiple
  164.         volume archives.  This prevents the diskette overflow that would
  165.         occur with earlier versions of ARJ.  However, certain file
  166.         attributes such as TEXT MODE may not be carried over to the
  167.         updated file.
  168.  
  169.         Because of the new CHAPTER feature, ARJ NO LONGER SUPPORTS the
  170.         old ARJ backup file feature.  This is the old "-jb / -jg"
  171.         functionality.  This version of ARJ will not process this type
  172.         of archive properly.  The CHAPTER feature is powerful than the
  173.         ARJ backup feature.
  174.  
  175.         See the "ac" command and "-jb" option for more information about
  176.         CHAPTER archives.
  177.  
  178.         ---------
  179.  
  180.         New to this version is the "hollow" archive.  This is an ARJ
  181.         archive that does NOT contain the compressed file data.  The
  182.         main application for this kind of archive is scanning for
  183.         CHANGED files.  This makes the hollow archive useful for file
  184.         integrity scanning as in virus damage scanning.  However, this
  185.         feature should not be used solely in place of a anti-virus
  186.         program.
  187.  
  188.         ---------
  189.  
  190.         This version of ARJ provides a new encryption scheme based upon
  191.         the Russian encryption algorithm (GOST 28147-89 cipher).  This
  192.         algorithm is similar in design to DES; however, GOST is designed
  193.         for software implementation.  GOST 28147-89 uses a 256 bit key
  194.         and 32 rounds of encryption.  In addition, this implementation
  195.         of GOST also uses the 64 bit cipher feedback mode.
  196.  
  197.         This new encryption is accessed by using the "-g" option to
  198.         specify the password and the "-hg" option to specify the new
  199.         scheme.  This new scheme is in addition to the older XOR garble
  200.         scheme.
  201.  
  202.         ** Please NOTE that losing your password means losing your file!
  203.         ** Please DO NOT ask for technical support on lost passwords.
  204.         ** There is no shortcut/backdoor for determining lost passwords.
  205.  
  206.         The encryption module is a separate COM file named ARJCRYPT.COM.
  207.         ARJ expects to find the encryption module in the same directory
  208.         as itself.  This has the advantage of saving space with the
  209.         ARJSFXV module and the DEARJ.EXE module when encryption is not
  210.         needed.  You simply do not include the encryption module in the
  211.         archive when not using encryption.
  212.  
  213.         For non-USA users, the encryption overlay module is not included
  214.         with this version of ARJ.  Because of USA export regulations,
  215.         ARJ Software, Inc. may not export the encryption overlay module
  216.         from the USA.
  217.  
  218.         ---------
  219.  
  220.         ARJ can archive up to 65,000 files at one time when the "-hm"
  221.         option is specified.  This option enables ARJ to use disk space
  222.         instead of memory space to manage the names of the files being
  223.         archived.  The "-hm!" option uses XMS memory to manage the list
  224.         of names.  At this revision of ARJ, checking for duplicates is
  225.         NOT disabled as it was in 2.50.
  226.  
  227.         ---------
  228.  
  229.         ARJ can now select files based upon the file attributes and/or
  230.         file types.  For example, you can build an archive that contains
  231.         ONLY the directories and NOT the files on your hard drive.  See
  232.         the "-hb" option for details.
  233.  
  234.         ---------
  235.  
  236.         The multiple volume SELF-EXTRACTION FUNCTION is LIMITED in the
  237.         ARJ shareware version.  Only volumes of 360K or less in size can
  238.         be created AND only such volumes will be processed by the
  239.         self-extractor.  This feature is accessed through the "-je"
  240.         option along with the "-v" option.
  241.  
  242.         This multiple volume self-extractor supports ANSI escape
  243.         sequence displays.  It also supports ARJ-SECURE over multiple
  244.         volumes and the new encryption method.
  245.  
  246.         ---------
  247.  
  248.         The extraction "-jo" option now works in cooperation with the
  249.         "-f" and "-u" type options.  Previously, the "-jo" option
  250.         disabled the "-f" and "-u" options.
  251.  
  252.         ---------
  253.  
  254.         The "-g" option will NOW force compression even when a size
  255.         increase results except when the "-m0" option is used.
  256.         Encrypted compressed data is more secure than encrypted stored
  257.         (-m0) data.
  258.  
  259.         ---------
  260.  
  261.         This version no longer detects the older 2.30 ARJ-SECURE archives.
  262.  
  263.         ---------
  264.  
  265.         ** CAUTIONS **
  266.  
  267.         Whenever archiving to diskettes, it is HIGHLY recommended that
  268.         the option "-jt" be used.  This helps spot BAD diskettes or BAD
  269.         diskette drives.  It is HIGHLY recommended that the "-jt" option
  270.         be used in a Windows or multi-tasking or network environment.
  271.  
  272.         The XMS accelerator in Hurricane 2.0 MAY interfere with the use
  273.         of the ARJ -hm! option within a Windows DOS box.  You can use
  274.         the -hm option instead.
  275.  
  276.         UNERASE or UNDELETE commands do not always recover a file
  277.         correctly.  This will result in damaged archives.  This is true
  278.         for all archive types.  You should always test an archive after
  279.         unerasing it.
  280.  
  281.         CAUTION: To those who use the "-t1" and/or "-t1g" options to
  282.         save a few extra bytes.  This option should only be used on TEXT
  283.         FILES. Those are files created by EDLIN, EDIT, QEDIT, BRIEF,
  284.         NOTEPAD, and others.  Text files typically contain only letters,
  285.         numbers, spaces, and punctuation marks.  WORD PROCESSOR format
  286.         files ARE NOT TEXT FILES!  MS WORD, Wordperfect, AMIPRO, WRITE,
  287.         and similar files ARE NOT TEXT FILES. Using the "-t1" or "-t1g"
  288.         on any other kind of file probably will result in DATA LOSS!
  289.  
  290.      **********************************************************************
  291.  
  292.  
  293.      WINDOWS 95 LONG FILENAME SUPPORT
  294.  
  295.         This version of ARJ supports the use of long filenames under the
  296.         Windows 95 in the MS-DOS Prompt environment.  It does NOT support
  297.         long filenames under MS-DOS 6.22 and below.  It supports long
  298.         filenames ONLY when the Windows 95 GUI (graphical user interface)
  299.         is running.  In other words, there is no long filename support in
  300.         Windows 95 MS-DOS mode (accessed from the Win95 shutdown menu).
  301.  
  302.         The small ARJ self-extractor (-je1) does NOT support the handling
  303.         of long filenames.
  304.  
  305.         The ARJSFX and ARJSFXV modules (-je) support long filename
  306.         handling.  However, they will only extract archived Win95 long
  307.         filename files under Win95.  If long filename files are being
  308.         extracted to plain DOS, an error message will be displayed.  They
  309.         can be forced to extract the Win95 archived files with the "-j"
  310.         option.
  311.  
  312.         For compatibility with MS-DOS and older versions of ARJ, ARJ can
  313.         create a dual-name compatibility ARJ archive.  This is an archive
  314.         with both shortnames and longnames stored in it.  The longnames are
  315.         stored in the file comment field.  New versions of ARJ will treat
  316.         the dual-name archive according to the operating system
  317.         environment.  In other words, under MS-DOS, a dual-name archive
  318.         will look like a shortname archive.  Under Win95, a dual-name
  319.         archive will look like a longname archive.  This is also true of
  320.         the ARJSFX and ARJSFXV modules (-je).
  321.  
  322.         For efficiency reasons ARJ does not repeatedly check for file
  323.         system support of long filenames.  ARJ only tests the "C:" file
  324.         system.  An error may occur if ARJ under Win95 tries to access a
  325.         disk drive that does not support long filename handling.  The "-hf"
  326.         option can be used to force ARJ to use the standard 8.3 filename
  327.         APIs instead of the longname APIs.
  328.  
  329.         There are four new options "-hf", "-hf1", "-hf2", and "-hf3" that
  330.         provide choices in the handling of long filenames.  See the
  331.         discussion of those options below for more information.
  332.  
  333.         ARJ will save Win95 long filenames in the letter case they are
  334.         stored on disk; however, all filename matching is done without
  335.         regard to case.  In other words, "ThisName.Ext" matches
  336.         "thisNAME.ext".
  337.  
  338.         When archiving files under Windows 95, be sure to EXCLUDE files
  339.         from processing that are OPEN such as WIN386.SWP.
  340.  
  341.         REMINDER: When specifying filenames with embedded blanks or
  342.         symbols like ">", "<", or "|" on the command line, you MUST
  343.         quote the filenames.
  344.  
  345.         Examples:  ARJ a archive "C:\Program Files\*.*" -r
  346.                    ARJ c archive "<<<*" -jz -jb
  347.  
  348.         However, please note that ending a quoted filename with a "\"
  349.         will not work as expected.  The "\" before a special character
  350.         will quote it literally.  The string \" will result in a literal
  351.         double quote mark.  This is not a feature of ARJ.
  352.  
  353.         Example:  "C:\Program Files\"   will be translated to
  354.                   C:\Program Files"
  355.  
  356.         You will need to use two backslash marks as in "\\".
  357.  
  358.         Example:  "C:\Program Files\\"
  359.  
  360.         For Windows 95 disaster recovery, we make use of the program
  361.         DOSLFNBK.EXE 1.5 by D. J. Murdoch.  With this program while in
  362.         plain DOS, you can save all of the long filenames to BACKUP.LFN.
  363.         Then you can use ARJ or any other DOS backup scheme to backup
  364.         your system including the BACKUP.LFN.
  365.  
  366.         CAUTION: DOSLFNBK 1.5 may not work on all Windows 95 versions.
  367.         It apparently does NOT WORK on VFAT32 Windows 95.
  368.  
  369.         Here is a brief list of steps to backup and restore:
  370.  
  371.         1) Make a Win95 startup diskette if you do not have one.
  372.         2) Shutdown to MS DOS mode.
  373.         3) While you are on the C: drive, execute "DOSLFNBK C:\".
  374.            Change to the D: drive (if any) and execute "DOSLFNBK D:\".
  375.            Execute DOSLFNBK for each drive on each drive.
  376.         4) Use ARJ or other DOS backup program to backup ALL of the files.
  377.            Example:  ARJ a A:backup C:\*.* D:\*.* -r -a1 -jt1 -va -jf
  378.            CAUTION: For important backups, we always make TWO BACKUPS of
  379.            my system.  All too often, one or more files will not restore
  380.            correctly because of some data error (MURPHY'S LAW in action).
  381.         5) Save ARJ.EXE or your backup program to diskettes in a
  382.            restorable form.
  383.         6) Backup finished.
  384.  
  385.  
  386.         1) Boot from your Win95 startup diskette.
  387.         2) Execute "SYS C:" from the A: drive to re-install the boot.
  388.         3) Install ARJ.EXE or your backup program on the hard drive.
  389.         4) Restore all of the files.
  390.            Example:  ARJ x A:backup -v -jf -y -ha
  391.         5) On each drive, execute "DOSLFNBK /r" to restore the long
  392.            filenames.
  393.         6) Restore finished.
  394.  
  395.         
  396.      ARJ RESPONSE FILE PROCESSING
  397.  
  398.         ARJ will accept an ARJ command line from a response file as in
  399.         "ARJ @command.rsp".  The "@" symbol indicates that the appended
  400.         name is the name of the response file.  In this case, the file is
  401.         command.rsp. The response file symbol cannot be changed.
  402.  
  403.         The response file should contain the ARJ command line minus the
  404.         initial "ARJ".  The command line may be split over as many lines
  405.         as necessary.  The response file feature will NOT accept QUOTED
  406.         command line options.  Options with embedded blanks ("-vasTEST X")
  407.         will not be processed as expected.  See the "-@" option for
  408.         help on options with blanks.  When using the response file feature,
  409.         ARJ will accept only the "-+", and "-&" switch options on the DOS
  410.         command line along with the response file name.  All other command
  411.         options must be specified in the response file or in the ARJ
  412.         environment variable.
  413.  
  414.         To better support long filenames, ARJ provides the "-@" option to
  415.         handle the processing of filenames and switch options that contain
  416.         embedded spaces.  The "-@" switch option enables the interpretation
  417.         of a text line in an ARJ response file as a single token.  In other
  418.         words, when ARJ scans an "-@" option, it will process the NEXT text
  419.         line in the response file as a single token including all embedded,
  420.         leading, and trailing blanks.  ARJ will continue to process each
  421.         subsequent text line in the same manner.  If ARJ scans a subsequent
  422.         "-@" option, ARJ will revert to its normal multiple tokens per line
  423.         processing.
  424.  
  425.  
  426.      ARJ WILDCARDING
  427.  
  428.         As of 2.55c, the list of filenames that ARJ builds internally for
  429.         archiving is now affected by the "-o" and "-b" options.
  430.  
  431.         Prior to 2.55c, ARJ would include all matching filenames in its
  432.         internal list regardless of the "-o" and "-b" settings.  Then
  433.         during archival, ARJ would select from its internal list based upon
  434.         the "-o" and "-b" options.
  435.  
  436.         Now ARJ uses the "-o" and "-b" and "-hb" options while it is
  437.         building the internal list.  The advantage with this method is the
  438.         need for less memory to handle fewer files.
  439.  
  440.         For example, when doing a full backup of the C drive, ARJ builds an
  441.         internal list of filenames for all of the files on drive C.  When
  442.         doing an incremental backup (-b, -b1), ARJ builds a list of
  443.         filenames for only the files that have the archive bit set.  In
  444.         prior versions of ARJ, ARJ would build the same list regardless of
  445.         the "-b" setting.
  446.  
  447.         ARJ wildcarding can differ according to the operating system
  448.         environment.  When scanning the file system for filenames to
  449.         add/update an archive, ARJ uses the internal operating system
  450.         wildcard matching functions. When scanning an ARJ archive (list,
  451.         extract and so on), ARJ uses its own wildcard matching function.
  452.         This internal ARJ function is identical to the standard DOS
  453.         wildcard matching.
  454.  
  455.         Windows 95 and Windows NT use a slightly more complex wildcard
  456.         matching function.  In Windows 95, it is possible to specify a
  457.         wildcard specification of "a*d*c".  This would match ARJ.DOC,
  458.         ARJDISP.DOC, and others.
  459.  
  460.         As of ARJ 2.55c, ARJ will handle up to 65,000 filenames. Because
  461.         ARJ checks for duplicate filenames when necessary, processing over
  462.         20,000 filenames may slow down as the number of filenames processed
  463.         increase.  ARJ processes wildcards most efficiently when specified
  464.         as separate command line wildcards inclusive of drive letters.
  465.  
  466.         Example: ARJ a backup C:\*.* D:\*.* E:\*.* -r -a1
  467.  
  468.         If each drive letter is unique, ARJ will not need to check for
  469.         duplicates and can proceed faster.  This speedup does not work when
  470.         using listfiles.
  471.  
  472.  
  473.      ARJ-PROTECT DATA PROTECTION FEATURE
  474.  
  475.         With this version, ARJ can repair "protected" archives that suffer
  476.         from slight amounts of data damage (CRC error, bad header, etc). An
  477.         ARJ archive is "protected" with the "-hk" option.  With the "-hk"
  478.         option, ARJ will generate a separate ARJ data protection file. This
  479.         protection file is REQUIRED in order to repair damaged ARJ
  480.         archives.  The size of this file ranges from a minimum of 4096
  481.         bytes and upwards.  For larger archives, the protection file size
  482.         is typically less than one percent of the archive file size.
  483.  
  484.         For this release, the protection file is a separate file.  This
  485.         avoids the problem of uploading unnecessary data to BBSes and ftp
  486.         sites.  The name of the protection file is based upon the archive
  487.         name plus the extension ".XRJ".  Volume protection filenames end
  488.         in ".X01", etc.
  489.  
  490.         This protection feature is sector based and allows repair due to
  491.         typical types of disk corruption (bad sector, virus damage, cross
  492.         links, etc).  This type of sector protection is NOT effective for
  493.         most data transmission problems where data is missing from the
  494.         middle of a transmission.
  495.  
  496.         Technically, this protection feature uses a series of XOR sums and
  497.         checksums in order to allow repairs.  Larger archives are logically
  498.         treated as several streams of data.  ARJ can protect each "stream"
  499.         from one or two damaged sections 1024 bytes in size.  However, for
  500.         large archives (1 MB or larger) ARJ can sometimes repair up to four
  501.         damaged sections per MByte.  The "-hk1, "-hk2" ... "-hk9" options
  502.         can offer more data protection at the cost of a proportionately
  503.         larger protection file.
  504.  
  505.         This type of protection is NOT offered by the current competing
  506.         PKZIPFIX program which only repairs damaged archive directories.
  507.  
  508.         The "-hk" option sets ARJ to build a protection file.  The "q"
  509.         command is used to repair a damaged archive.  The repaired archive
  510.         is named ARJFIXED.ARJ.
  511.  
  512.         Example:  ARJ a archive -hk       generates archive.xrj
  513.                   ARJ q archive           repairs archive.arj
  514.  
  515.  
  516.      ARJ ANSI COMMENT HANDLING
  517.  
  518.         As of 2.55, ARJ will use its own ANSI sequence display handler
  519.         to display ARJ comments.  In previous versions, ARJ depended upon
  520.         the "-ja" option and an installed ANSI.SYS driver to handle the
  521.         ANSI escape sequences.  The "-ja" option has a new function now.
  522.         The "-ja" option will set the "P" command to display files using
  523.         the new ANSI sequence display handler.
  524.  
  525.         The ARJSFXV module (-je -v) also will display ANSI comments now.
  526.  
  527.         Please note that the ARJ comment field size is limited to about 2K
  528.         bytes.
  529.  
  530.  
  531.      ARJSFXV MULTIPLE VOLUME SELF-EXTRACTOR
  532.  
  533.         This module now supports ARJ-SECURE and ANSI escape sequences in
  534.         the archive comment.  You can build a single volume
  535.         self-extracting archive by specifying a larger volume size.  The
  536.         ARJ distribution archive uses the ARJSFXV module because of the
  537.         ANSI comment support.
  538.  
  539.         Example:  ARJ a archive *.* -je -v300K
  540.  
  541.  
  542.      ARJ ERRORLEVELS
  543.  
  544.         ARJ will now return a DOS error code of 11 for a user control break
  545.         action.  ARJ formerly returned a code of 2 for this situation.
  546.  
  547.         ARJ will now return a DOS error code of 12 when trying to modify a
  548.         chapter archive that already has 250 chapters in it.  ARJ formerly
  549.         returned a code of 2 for this situation.
  550.  
  551.  
  552.      ARJ COMMANDS
  553.  
  554.      "ac" command
  555.  
  556.         This is a new two character command for ARJ.  It is actually an
  557.         abbreviation for the following command and switch options:
  558.         "u -u2 -jb".  The "ac" command will add a chapter backup to a new
  559.         archive or add a new chapter (updating) to a chapter archive. A
  560.         chapter backup will consists of files that are DIFFERENT (different
  561.         date-time or size).
  562.  
  563.         Example:  ARJ ac archive c:\dir\*.* -r -jt
  564.  
  565.         The advantage of a chapter archive is that you can make numerous
  566.         full backups (chapters) to a SINGLE archive.  Major space savings
  567.         will result when some files do not change from backup to backup.
  568.  
  569.         See the "-jb" option for more details.
  570.  
  571.         Adding a new chapter adds a chapter label entry in the archive.
  572.  
  573.         There is a limit of 250 chapters per archive.
  574.  
  575.         Please note that the "ac" command abbreviation is dependent upon
  576.         file sizes and file date-time stamps.  Modifying file date-time
  577.         stamps with no relation to the system time may cause chapter update
  578.         problems.  In addition, changing the system time significantly may
  579.         also cause chapter update problems.
  580.  
  581.  
  582.      "cc" command
  583.  
  584.         This is a new two character command for ARJ.  It is actually an
  585.         abbreviation for the following command and switch option:
  586.         "y -jb".  The "cc" command will convert a standard ARJ archive to a
  587.         chapter archive.
  588.  
  589.         Example:  ARJ cc archive
  590.  
  591.  
  592.      "dc" command
  593.  
  594.         This is a new two character command for ARJ.  It is actually an
  595.         abbreviation for the following command and switch option:
  596.         "d -jb".  The "dc" command will delete the last chapter in an
  597.         archive using the specified file wildcard.  Normally, that
  598.         wildcard should be "*.*".
  599.  
  600.         Example:  ARJ dc archive *.*
  601.  
  602.  
  603.      "e" command
  604.      "x" command
  605.  
  606.         Chapter archives do NOT support extraction with deletion.
  607.  
  608.         ARJ x archive *.doc -d   generates "Bad command syntax"
  609.  
  610.  
  611.      "q" command
  612.  
  613.         The "q" command is used to repair a damaged "protected" archive.
  614.         An archive is protected with the "-hk" option.  Both the protected
  615.         archive and its ARJ-PROTECT data protection file are required to
  616.         repair any damage.  The "q" command will attempt to repair all
  617.         damages and put the repaired archive in a file named ARJFIXED.ARJ.
  618.  
  619.         Example:  ARJ q archive
  620.  
  621.         When working with a damaged archive and the "Abort, Retry, Ignore,
  622.         Fail" prompt appears, you should select the "Ignore" option.
  623.  
  624.  
  625.      "t" command
  626.  
  627.         When used with the "-hk" option, ARJ will test the archive and
  628.         upon successful completion, will generate the ARJ-PROTECT file.
  629.  
  630.         Example:  ARJ t archive -hk
  631.  
  632.  
  633.      "y" command
  634.  
  635.         When used with the "-g" option and optionally the "-hg" option,
  636.         ARJ will ungarble a previously garbled archive.
  637.  
  638.         Example:  ARJ y archive -gpasswrd
  639.  
  640.         When used with the "-jb" option, ARJ will convert a standard
  641.         archive to a chapter archive.
  642.  
  643.         Example:  ARJ y archive -jb
  644.  
  645.         When used with the "-jb0" option, ARJ will convert a chapter
  646.         archive to a standard archive.
  647.  
  648.         Example:  ARJ y archive -jb0
  649.  
  650.  
  651.      ARJ SWITCHES
  652.  
  653.      "-@" switch
  654.  
  655.         This switch sets ARJ to enable/disable the interpretation of text
  656.         lines in an ARJ RESPONSE file as a complete single token. Normally,
  657.         in an ARJ response file, blanks are interpreted as token
  658.         separators.  (Tokens are commands, filenames, wildcards, and switch
  659.         options).  However, if ARJ scans an "-@" option in a response file,
  660.         it will process subsequent text lines as single tokens per line.  A
  661.         subsequent "-@" option will revert ARJ to normal multiple tokens
  662.         per line mode.
  663.  
  664.         Example:  ARJ @text.rsp
  665.  
  666.         TEXT.RSP contains:
  667.         a c:\dir\archive -r -jt1 -@ -a1
  668.         c:\long directory name\*.*
  669.         c:\other directory name\*.*
  670.         -@
  671.         dir1\*.* dir2\*.* dir3\*.*
  672.  
  673.         One common error when using the "-@" option is including extraneous
  674.         leading and/or trailing blanks.  For example, ARJ will abort with
  675.         an invalid switch option error if the second "-@" above has one or
  676.         more trailing blanks.
  677.  
  678.  
  679.      "-#" switch
  680.  
  681.         For consistency, ARJ now interprets the file spec "10-" as 10 to
  682.         the end of the archive.
  683.  
  684.         Example:  ARJ l archive -# 21000-       means file 21000 to end
  685.  
  686.  
  687.      "-b" switch
  688.  
  689.         Under Windows 95, the use of the "-b" type switch options to reset
  690.         the archive bit may result in a sharing violation error.  Under
  691.         ARJ 2.55b and above, ARJ will display the error and then proceed
  692.         ignoring the error.
  693.  
  694.  
  695.      "-e" switch
  696.  
  697.         This switch used during extraction will exclude the beginning
  698.         characters of the filename.  This can be useful for shortening a
  699.         long output pathname.
  700.  
  701.         Examples:  ARJ x archive -e10  will exclude the first 10
  702.                                        characters of the output filename.
  703.  
  704.                    ARJ x archive -e4   will exclude the first 4 characters.
  705.  
  706.  
  707.      "-f1" switch
  708.  
  709.         This switch is used to select files that are OLDER for extracting
  710.         or adding.
  711.  
  712.  
  713.      "-f2" switch
  714.  
  715.         This switch is used to select files that are DIFFERENT (different
  716.         date-time or different size) for extracting or adding.
  717.  
  718.         There is a slight limitation to this switch.  When processing
  719.         files that are split across volumes, the size test is skipped
  720.         and the file is updated regardless.
  721.  
  722.  
  723.      "-f3" switch
  724.  
  725.         This switch is used to select files that are CRC mismatches or
  726.         different sizes for extracting or adding.  The 32 bit CRC
  727.         (checksum) of the file is matched against the CRC of the file in
  728.         the archive.
  729.  
  730.         There is a slight limitation to this switch.  When processing
  731.         files that are split across volumes, the CRC test is skipped
  732.         and the file is updated regardless.
  733.  
  734.  
  735.      "-g" switch
  736.  
  737.         The garble option in this version of ARJ has two versions. One
  738.         is the original version found in earlier ARJ releases.  It is
  739.         compatible with older versions and works like those versions.
  740.  
  741.         The other garble version uses a separate encryption module.
  742.  
  743.         This new option is accessed by using the new "-hg" option.  This
  744.         option sets ARJ to use the separate encryption module to encrypt
  745.         the data.  By default, ARJ will look for the file "ARJCRYPT.COM"
  746.         in the same directory where the ARJ.EXE being executed is found.
  747.         The user may specify the pathname of the module to use.
  748.  
  749.         Examples:  ARJ a archive *.doc -gThis_is_a_password -hg
  750.                    ARJ a archive *.doc -gpassword -hgc:\dir\enc.com
  751.  
  752.         The new garble option accepts a password key up to 32 characters
  753.         long.  Excess characters are ignored.  Garble passwords ARE CASE
  754.         SENSITIVE!  DO NOT LOSE your password!  There is no known method to
  755.         recover the password other than by brute force, which could take a
  756.         very long time.  The longer the password, the longer it would take
  757.         to "guess" it.
  758.  
  759.         This new encryption scheme is not compatible with the "-g" option
  760.         of pre-2.55 versions of ARJ.  If you want to maintain compatibility
  761.         with pre-2.55 versions of ARJ, you should NOT use the "-hg" option.
  762.  
  763.         Only the multiple volume self-extractor supports the new encryption
  764.         module.
  765.  
  766.         When garbling or ungarbling an existing archive, ARJ will detect
  767.         the method of encryption previously used and select that same
  768.         method regardless of whether the "-hg" option is specified or not.
  769.  
  770.  
  771.      "-i3" switch
  772.  
  773.         This switch shows the percentage progress of the WHOLE archive
  774.         build.  This switch is only operative during adds.
  775.  
  776.  
  777.      "-i4" switch
  778.  
  779.         This switch shows the percentage progress as a bar graph of the
  780.         WHOLE archive build.  This switch is only operative during adds.
  781.  
  782.  
  783.      "-i5" switch
  784.  
  785.         This switch shows the percentage progress including a bar graph
  786.         of the WHOLE archive build.  This switch is only operative during
  787.         adds.
  788.  
  789.  
  790.      "-i6" switch
  791.  
  792.         This switch shows the percentage progress of the WHOLE archive
  793.         build along with a progress bar graph for the current file.  This
  794.         switch is only operative during adds.
  795.  
  796.  
  797.      "-s3" switch
  798.  
  799.         This switch sets ARJ to keep both the original archive file
  800.         time-stamp as well as the original internal archive modified
  801.         time-stamp when modifying the archive.
  802.  
  803.         This feature is helpful when adding a copy of the data damage
  804.         protection file to the "protected" archive.  Using this switch,
  805.         you can add a file to an archive and then remove that file and
  806.         end up with the original archive.  This is necessary because any
  807.         change in archive contents would be perceived as damage by the
  808.         ARJ "q" (repair archive) command.
  809.  
  810.         Example:   ARJ a archive *.doc -hk
  811.                    ARJ a archive archive.xrj -s3
  812.                    ARJ e archive archive.xrj -d -s3
  813.                    ARJ q archive
  814.  
  815.         The above sequence of commands replicates a situation where the
  816.         user embeds a copy of the data damage protection file into the
  817.         "protected" archive.  In the case of slight archive damage, the
  818.         protection file can be extracted and used to recover damaged data.
  819.  
  820.  
  821.      "-u1" switch
  822.  
  823.         This switch is used to select files that are OLDER or NEW for
  824.         extracting or adding.
  825.  
  826.  
  827.      "-u2" switch
  828.  
  829.         This switch is used to select files that are DIFFERENT (different
  830.         date-time or different size) or NEW for extracting or adding.
  831.  
  832.         There is a slight limitation to this switch.  When processing
  833.         files that are split across volumes, the size test is skipped
  834.         and the file is updated regardless.
  835.  
  836.  
  837.      "-u3" switch
  838.  
  839.         This switch is used to select files that are CRC mismatches or NEW
  840.         for extracting or adding.  The 32 bit CRC (checksum) of the file is
  841.         matched against the CRC of the file in the archive.
  842.  
  843.         There is a slight limitation to this switch.  When processing
  844.         files that are split across volumes, the CRC test is skipped
  845.         and the file is updated regardless.
  846.  
  847.  
  848.      "-v" switch
  849.  
  850.         For specifying sizes for this option, ARJ will accept the "M"
  851.         modifier to multiply by 1,000,000 (one million).
  852.  
  853.         Examples:  ARJ a vol -v100M
  854.                    ARJ a vol -vr1M1440
  855.  
  856.  
  857.      "-hb" switch
  858.  
  859.         This switch is used to select by file attribute or file type.
  860.  
  861.         The "-hb" option can be used to select files by their attributes
  862.         (normal, readonly, hidden, system, directory, and archive bit).
  863.         "Normal" is defined as files that are NOT the following: readonly,
  864.         hidden, system, label, chapter header, or directory.  For
  865.         extract/list operations, you can also select chapter labels and
  866.         volume labels.  By default, the "-hb" option by itself selects all
  867.         types of files.  If you specify a letter symbol representing a file
  868.         type, you are selecting ONLY that type of file.  You can specify a
  869.         series of letters representing all of the file types that you want
  870.         to select.  For example, the "-hbdr" option selects both
  871.         directories and readonly files.  Selections are additive.
  872.  
  873.         Example: -hbnr   select only normal and readonly files
  874.  
  875.         Single letters represent each attribute or type.
  876.           a - archive bit set
  877.           b - archive bit clear
  878.           h - hidden
  879.           r - readonly
  880.           s - system
  881.           d - directory
  882.           n - normal files (not d, h, r, s, l, c)
  883.           l - volume label
  884.           c - chapter label
  885.           f - abbreviation for "ndhrs"
  886.  
  887.         The archive bit selection ("a" or "b") is a special case.  If you
  888.         have selected no types of files EXCEPT files with the archive bit
  889.         set, ARJ will select from the set of all file types. If you have
  890.         selected one or more file types, ARJ will select based upon the
  891.         archive bit from the selected set of files types.
  892.  
  893.         Examples: -hbhrsa      select hidden, readonly files with archive
  894.                                bit set
  895.                   -hba         select all files with archive bit set
  896.  
  897.         Add/update options  : f, d, r, h, s, n, a, b.
  898.  
  899.         Extract/list options: f, d, r, h, s, n, a, b, c, l.
  900.  
  901.         Examples:  ARJ a archive *.* -r -hbrs     select only readonly
  902.                                                   and system files
  903.                    ARJ a archive *.* -r -hbd      store only directories
  904.                    ARJ l archive *.* -hbr         list only readonly files
  905.                    ARJ l archive -jb* -hbc        list chapter headers
  906.  
  907.         Notes:  The option "-hb" with no letter options is an abbreviation
  908.         for "-hbndhrslc" (everything).
  909.  
  910.  
  911.      "-hf" switch
  912.  
  913.         This switch disables Windows 95 long filename handling.  ARJ will
  914.         use the standard DOS 8.3 APIs (DOS shortnames) to do its
  915.         processing.  Files so archived with this switch can be extracted
  916.         under Windows 95 and DOS.
  917.  
  918.         This switch can be used while listing a dual-name archive under
  919.         Win95 to list/process the shortnames.
  920.  
  921.  
  922.      "-hf1" switch
  923.  
  924.         This switch in Win95 during archival sets ARJ to build a dual-name
  925.         compatibility archive by storing the shortname in the filename
  926.         field and the longname in the file comment field, so that both long
  927.         filenames and short filenames are stored in the archive.
  928.  
  929.         The file system is wildcard scanned using longname wildcards.
  930.  
  931.         Such a dual-name archive is compatible with older versions of ARJ.
  932.         New versions of ARJ process such an archive according to the
  933.         current operating system environment.  Under Win95, the long
  934.         filenames in the archive are used.  Under MS-DOS, the short
  935.         filenames are used.  This processing is automatic for this release
  936.         of ARJ.
  937.  
  938.         The "-e1" option does not affect the short name that is stored.
  939.  
  940.  
  941.         During extraction this switch sets ARJ to extract files from a
  942.         Win95 archive (built without "-hf" option) by using generated
  943.         names.  ARJ will generate a short name based upon "W95LNAME.000"
  944.         and its sequence number in the archive.
  945.  
  946.         Specifying the "-ji" option with an index filename along with
  947.         "-hf1" will generate an index file with the W95LNAME.000 names and
  948.         the associated long filenames.  The long filenames are quoted.
  949.  
  950.         Example:  ARJ x archive -hf1 -jiindex.log
  951.  
  952.         This option with "-ji" can be useful when trying restore long
  953.         filenames on a system that allows long filenames such as OS/2,
  954.         WinNT, or Linux.
  955.  
  956.         Please note that modifying a dual-name archive outside of Windows
  957.         95 is possible but it may produce an archive with some dual-names
  958.         and some not.
  959.  
  960.         The "-hf1" option has no effect on a dual-name archive during
  961.         extraction.
  962.  
  963.  
  964.      "-hf2" switch
  965.  
  966.         This switch sets ARJ to attempt to extract using the long filenames
  967.         stored in the archive.  No modification is done to the long
  968.         filenames except by DOS itself.  This switch also sets ARJ to use
  969.         the standard DOS 8.3 APIs for processing.  Because of the
  970.         shortening of the filenames by DOS, duplicate filenames may result.
  971.  
  972.         You would typically use this option when transferring files from
  973.         a Win95 system to a DOS system.
  974.  
  975.  
  976.      "-hf3" switch
  977.  
  978.         This switch in Win95 during archival sets ARJ to build a dual-name
  979.         compatibility archive by storing the shortname in the filename
  980.         field and the longname in the file comment field, so that both long
  981.         filenames and short filenames are stored in the archive.
  982.  
  983.         This is similar to the "-hf1" switch functionality EXCEPT that ARJ
  984.         wildcard scans the file system using shortname wildcards.
  985.  
  986.         This switch provides a way of archiving files that have Win95 DOS
  987.         inaccessible symbols in them like the copyright and trademark
  988.         symbols.  Win95 DOS displays those filenames with the "_"
  989.         character.  ARJ will store the long filename with the "_" character
  990.         as is.  However, this means that a restore of the archive will not
  991.         restore the filename as it was with the inaccessible copyright or
  992.         trademark symbol.  It will be restored with a "_" symbol.
  993.  
  994.  
  995.      "-hg" switch
  996.  
  997.         This switch is used to specify the filename of the encryption
  998.         module to be used when encrypting a new archive.  The default
  999.         filename is "ARJCRYPT.COM".  ARJCRYPT.COM contains a new encryption
  1000.         scheme that is incompatible with earlier releases of ARJ.  ARJ will
  1001.         look for the encryption module in the directory that contains the
  1002.         copy ARJ.EXE that is being executed unless the specified module
  1003.         name contains a path symbol "\" as in "ARJ\OLDCRYPT.COM".  If you
  1004.         want to use a module in the current directory, you should specify
  1005.         the name as in ".\ARJCRYPT.COM".  The "." indicates the current
  1006.         directory.
  1007.  
  1008.         With an existing archive, ARJ detects the encryption scheme that
  1009.         was used to encrypt the archive and uses the same scheme regardless
  1010.         of whether the "-hg" option is specified or not.
  1011.  
  1012.  
  1013.      "-hk" switch
  1014.  
  1015.         The "-hk" switch sets ARJ to create an ARJ-PROTECT data protection
  1016.         file.  This file is named similarly to the created archive except
  1017.         for an "X" in the beginning of the file extension as in NAME.XRJ.
  1018.         This ARJ-PROTECT file contains necessary information to repair
  1019.         damage to the original archive.  The "-hk1", "-hk2" ... "-hk9"
  1020.         options will generate larger ARJ-PROTECT files affording a higher
  1021.         probability of a successful repair.
  1022.  
  1023.         If the archive already exists, an ARJ-PROTECT data file can be
  1024.         created via the "t" command.
  1025.  
  1026.         Example:  ARJ t archive -hk            builds archive.xrj file
  1027.  
  1028.         For users who do not like the separate protection file feature,
  1029.         there is a work-around.  Using the new "-s3" option (keep original
  1030.         time-stamps), the user can add the ARJ-PROTECT file to the
  1031.         protected archive and extract it later for repair purposes.
  1032.  
  1033.         Example:  ARJ a docs *.txt -hk          builds protected archive
  1034.  
  1035.                   ARJ a docs docs.xrj -s3       inserts protect file
  1036.  
  1037.                   ARJ e docs docs.xrj -s3 -d    extracts and removes
  1038.                                                 protect file restoring
  1039.                                                 the original archive
  1040.  
  1041.                   ARJ q docs                    repairs archive
  1042.  
  1043.  
  1044.      "-hm" switch
  1045.  
  1046.         The "-hm" switch sets ARJ to transfer the list of filenames to be
  1047.         archived from the limited conventional memory to file storage.
  1048.         This allows a much larger number of files to be processed (over
  1049.         65,000).  This option is ignored for all ARJ commands except
  1050.         "a", "f", "j", "m", "u".
  1051.  
  1052.         Normally, this switch sets ARJ to wait until it is out of memory
  1053.         storing filenames into a list before transferring that list to a
  1054.         temporary file.  That temporary file is put in the current
  1055.         directory or the special work directory if specified (-hm!F:\) or
  1056.         XMS memory is specified (-hm!).
  1057.  
  1058.         However, there may be a few cases where ARJ will run out of memory
  1059.         doing other tasks while it is storing this list.  In these cases,
  1060.         ARJ will abort.  The user can specify a numeric argument of "1" to
  1061.         this switch to force ARJ to transfer the list to file storage
  1062.         immediately.
  1063.  
  1064.         The "-hm" work directory is specified by appending a "!" to the
  1065.         "-hm" or "-hm1" options and then appending the filename to the
  1066.         option.  See below.
  1067.  
  1068.         Examples:  ARJ a archive c:\*.* -r -hm
  1069.                    ARJ a archive c:\*.* -r -hm1
  1070.                    ARJ a a:archive c:\*.* -r -va -hm500!F:\
  1071.                    ARJ a a:archive c:\*.* -r -hm!G:\temp\
  1072.  
  1073.         The use of a RAMDISK directory will provide the fastest operation.
  1074.  
  1075.  
  1076.      "-hm!" switch
  1077.  
  1078.         The "-hm!" option with no pathname appended to it will set ARJ to
  1079.         store its list of filenames in XMS memory.  List processing will be
  1080.         faster using XMS memory as opposed to using disk space.  If no XMS
  1081.         memory is available, ARJ will use conventional memory and then disk
  1082.         space if needed.
  1083.  
  1084.         If there is not enough XMS memory available for the internal list,
  1085.         ARJ will abort.  The XMS accelerator in Hurricane 2.0 for Windows
  1086.         may interfere with this switch while in Windows.
  1087.  
  1088.  
  1089.      "-hq" switch
  1090.  
  1091.         This switch sets ARJ to ignore the error that occurs when ARJ
  1092.         cannot open a file for lack of permitted access during an add-type
  1093.         command and/or a compare command.  This is DOS error code 5. This
  1094.         option applies only to files being added to a new archive and/or
  1095.         being compared.  For an existing archive, this option will be
  1096.         ignored during the add operation, but NOT during a subsequent
  1097.         compare operation.
  1098.  
  1099.         Typically, this switch would be used during network access or in
  1100.         Windows 95 where a file is open for exclusive use by another
  1101.         process.  Normally, in this situation, ARJ would return a non-zero
  1102.         DOS error level.  However, if this switch is specified, ARJ will
  1103.         NOT return a non-zero error level due to this specific open
  1104.         failure.
  1105.  
  1106.         If you use the "-ji" option to set up an index file, ARJ will log
  1107.         any file that it cannot open.
  1108.  
  1109.  
  1110.      "-hq1" switch
  1111.  
  1112.         This switch sets ARJ to ignore the error that occurs when ARJ
  1113.         cannot open a file because it cannot be found during an add-type
  1114.         command and/or a compare command.  This is DOS error code 2.  This
  1115.         option applies only to files being added to a new archive and/or
  1116.         being compared.  For an existing archive, this option will be
  1117.         ignored during the add operation, but NOT during a subsequent
  1118.         compare operation.
  1119.  
  1120.         This open error typically happens when a temporary file that ARJ
  1121.         has found to archive is purged by another process before ARJ can
  1122.         actually open and compress/compare it.  This is not the same error
  1123.         as when a user specifies a filename on the command line and ARJ
  1124.         cannot find it.
  1125.  
  1126.         If you use the "-ji" option to set up an index file, ARJ will log
  1127.         any file that it cannot open.
  1128.  
  1129.  
  1130.      "-hq2" switch
  1131.  
  1132.         This switch sets ARJ to ignore both the no access error and the
  1133.         not found error during an add-type command for new archives as
  1134.         above.
  1135.  
  1136.  
  1137.      "-ht" switch
  1138.  
  1139.         This switch is provided as an alternative to the standard method of
  1140.         specifying a target directory.  This new option can be specified in
  1141.         the ARJ configuration file or in the ARJ_SW environment variable as
  1142.         well as on the command line.
  1143.  
  1144.         Examples:  ARJ x archive *.* -htD:\DESTDIR
  1145.                    SET ARJ_SW=-hf -htD:\DESTDIR
  1146.  
  1147.  
  1148.      "-j#" switch
  1149.  
  1150.         This switch allows the building and testing of a special ARJ
  1151.         "HOLLOW" archive that is missing the actual compressed file
  1152.         contents.  This allows the creation of small archives for CRC
  1153.         testing against the CRCs of actual files.  This is suited for
  1154.         special applications. Please take note that NO actual file data can
  1155.         be extracted from these "HOLLOW" archives.
  1156.  
  1157.         For example, a user has transported a directory of files from one
  1158.         PC to another PC.  At a later time, that user would like to
  1159.         determine which files have actually changed their contents
  1160.         regardless of the date-time stamps.  That user could archive the
  1161.         original directory using the -j# switch which builds the ARJ
  1162.         "hollow" archive with the sole exception that no compressed data is
  1163.         stored with the archive.  This allows the rapid building of a much
  1164.         smaller archive.  The file CRC is computed and stored in the
  1165.         archive.  This new "hollow" archive is transported to the other PC.
  1166.         A simple ARJ test command with the "-jt1" option on the other PC
  1167.         would point out files whose content's CRC do not match.
  1168.  
  1169.         Another use of this "hollow" archive is for FILE INTEGRITY
  1170.         checking.  You can create this "hollow" CRC archive and use it at a
  1171.         later time to determine if any files have been corrupted or damaged
  1172.         by VIRUS or system problems.
  1173.  
  1174.         Please note that there is a VERY SMALL possibility that a file has
  1175.         been changed and its new 32 bit CRC still matches.  That
  1176.         possibility is approximately one in four billion.
  1177.  
  1178.         The -j# option during an ARJ archive build will set the compression
  1179.         method to 9.  The only change is that the file header will indicate
  1180.         that the compressed file size is ZERO.  Otherwise, the file header
  1181.         is the same as in an archive where the file was actually compressed
  1182.         and stored.
  1183.  
  1184.         To use this "hollow" archive to test CRCs against actual file CRCs,
  1185.         use the following syntax:
  1186.  
  1187.         Syntax:  ARJ t archive_name -jt1
  1188.                  ARJ t archive_name target_dir\ -jt1
  1189.  
  1190.         The second command above is used where the relative pathnames
  1191.         stored in the archive do not match up with the current directory.
  1192.         See the discussion in ARJ.DOC for more information on the option
  1193.         "-jt".
  1194.  
  1195.         When ARJ displays "NOT matched" for a "hollow" archive, it means
  1196.         the file size in the archive and the size of the actual file do NOT
  1197.         match.
  1198.  
  1199.  
  1200.      "-j#1" switch
  1201.  
  1202.         This option differs from the "-j#" option in that the 32 bit CRC is
  1203.         NOT stored.  The compression method is set to 8.
  1204.  
  1205.  
  1206.      "-ja" switch
  1207.  
  1208.         This switch has acquired NEW functionality.  Its OLD function was
  1209.         to set ARJ to fully display ANSI escape sequences.  It now is used
  1210.         with the "ARJ p" command to display files using ARJ's own ANSI
  1211.         display handler.  ANSI.SYS is no longer needed.
  1212.  
  1213.         Example:  ARJ p ansifile -ja -q
  1214.  
  1215.  
  1216.      "-jb" switch
  1217.  
  1218.         This switch sets ARJ to build a chapter archive.  Once an archive
  1219.         is set to a chapter archive, all subsequent processing will
  1220.         continue to treat it as a chapter archive.
  1221.  
  1222.         The advantage of a chapter archive over a series of separate
  1223.         archives of the same set of files is that space can be saved when
  1224.         archived files do not change.  A single chapter archive can produce
  1225.         the same results as one hundred standard archive backups.  In other
  1226.         words, one can update a chapter archive one hundred times and fully
  1227.         recover any one of those updates.
  1228.  
  1229.         Technically speaking, each file in a chapter archive has a chapter
  1230.         lifespan range.  When a file is backed up and has not changed since
  1231.         the last backup, only the lifespan range is changed.  A copy of the
  1232.         file is NOT added to the archive since a copy already exists in the
  1233.         archive.  If the backed up file is different from the previous
  1234.         version, then that file is added to the archive with an appropriate
  1235.         chapter range. The previous version of the file is still kept in
  1236.         the chapter archive.  When a particular chapter is restored, ARJ
  1237.         selects only the files whose lifespan includes the chapter number
  1238.         requested.
  1239.  
  1240.         As an example, suppose one made a series of daily chapter backups
  1241.         of a document directory where only one document out of the one
  1242.         hundred documents changes on a daily basis.  The chapter archive
  1243.         would contain the original one hundred documents plus a copy of
  1244.         each day's changed document.
  1245.  
  1246.         When processing chapter archives, all ARJ add type commands
  1247.         (A,M,F,U) will create a new chapter in the chapter archive.  Up to
  1248.         a maximum of 250 chapters can be stored in a single archive. The
  1249.         proper way to build and update a chapter archive is with the "ac"
  1250.         command.  You should use the same command line arguments for each
  1251.         chapter update.  If you fail to select the same files as before,
  1252.         the chapter archive will not update the lifespan ranges properly
  1253.         and those unselected files will "appear" to have been deleted for
  1254.         the current chapter.  By default, the "ac" command will update a
  1255.         chapter archive with files that are DIFFERENT from the previous
  1256.         chapter (different size or date-time stamp).  The "ac" command is
  1257.         actually an abbreviation for the following command and options: "u
  1258.         -u2 -jb", so you CANNOT use the "-u" or "-jb" options with the "ac"
  1259.         command.
  1260.  
  1261.         ARJ ac archive dir\  *.txt *.doc *.wri      initial build
  1262.         ARJ ac archive dir\  *.txt *.doc *.wri      second chapter
  1263.         ARJ ac archive dir\  *.txt *.doc *.wri      third chapter
  1264.         ARJ ac archive dir\  *.txt *.doc *.wri      fourth chapter
  1265.         ARJ ac archive dir\  *.txt *.doc            fifth chapter will
  1266.                                                  be missing all *.wri files
  1267.  
  1268.         An expert with ARJ may want to use the actual commands and switches
  1269.         instead of the "ac" command.
  1270.  
  1271.         ARJ u -u2 -jb archive dir\ *.txt
  1272.  
  1273.         It is possible to change a standard ARJ archive to a chapter
  1274.         archive with the "y" command and the "-jb" option.  The opposite is
  1275.         possible with the "-jb0" option.
  1276.  
  1277.         ARJ y archive -jb      converts archive to chapter archive
  1278.         ARJ y archive -jb0     converts chapter archive to standard archive
  1279.  
  1280.         The "cc" command is an abbreviation for the "y -jb" option.
  1281.  
  1282.         ARJ cc archive
  1283.  
  1284.         You can restore a specific chapter as in:
  1285.  
  1286.         ARJ x archive -jb10    restores chapter 10
  1287.         ARJ x archive -jb20    restores chapter 20
  1288.  
  1289.         You can restore a range of chapters as in:
  1290.  
  1291.         ARJ x archive -jb2-5   extracts chapters 2 to 5
  1292.         ARJ x archive -jb2-    extracts chapters 2 to the last chapter
  1293.  
  1294.         Please note that when restoring a range of chapters, ARJ will
  1295.         segregate each chapter's set of files in a numbered directory based
  1296.         upon the chapter number.  Files whose lifespans range over a series
  1297.         of chapters will be located in the first of that series.
  1298.  
  1299.         This feature is useful for looking over the changes that have
  1300.         occurred over a series of chapters.
  1301.  
  1302.         You can list a specific chapter or chapter range as in:
  1303.  
  1304.         ARJ l archive -jb10    lists chapter 10
  1305.         ARJ l archive -jb2-5   lists chapters 2 to 5
  1306.         ARJ l archive -jb2-    lists chapters 2 to the last chapter
  1307.         ARJ l archive          lists the most recent chapter
  1308.  
  1309.         You can see the chapter ranges for each file in the archive with
  1310.         the following command:
  1311.  
  1312.         ARJ l archive -jb* -jv
  1313.  
  1314.         When ARJ tries to modify a chapter archive that already has 250
  1315.         chapters in it, ARJ will return a DOS errorlevel of 12.  A batch
  1316.         program can take subsequent action by changing the name of the
  1317.         chapter archive to a backup name and then re-executing the failed
  1318.         ARJ command.
  1319.  
  1320.         To start all over again with a chapter archive, you can purge all
  1321.         of the previous chapters, convert the archive to a standard
  1322.         archive, and then back to an archive chapter.
  1323.  
  1324.         Example:  ARJ k archive *.*
  1325.                   ARJ y archive -jb0
  1326.                   ARJ d archive *.* -hbc       remove chapter labels
  1327.                   ARJ cc archive
  1328.  
  1329.         You cannot modify specific chapters other than the most recent
  1330.         chapter in terms of deleting files.
  1331.  
  1332.         You can remove the most recent chapter with one of the following
  1333.         commands:
  1334.  
  1335.         ARJ d archive *.* -jb
  1336.         ARJ dc archive *.*
  1337.  
  1338.         If you do not specify the "-jb" with a delete command, the archive
  1339.         chapter label will not be deleted.
  1340.  
  1341.         You can comment the chapter labels as a way of identifying each
  1342.         chapter backup.
  1343.  
  1344.         ARJ c archive -hbc -jz         comments the last chapter label
  1345.         ARJ c archive "<<*" -jz        comments the last chapter label
  1346.         ARJ c archive -hbc -jz -jb*    comments all chapter labels
  1347.         ARJ c archive -hbc -jz -jb5    comments the label for chapter 5
  1348.  
  1349.  
  1350.      "-jb0" switch
  1351.  
  1352.         This switch is also used with the "y" command to convert a standard
  1353.         archive to a chapter archive.
  1354.  
  1355.         ARJ y archive -jb0     converts chapter archive to standard archive
  1356.  
  1357.  
  1358.      "-jb*" switch
  1359.  
  1360.         This switch is used to select all chapters.
  1361.  
  1362.         When it is used with the LIST command, ARJ displays all chapters.
  1363.  
  1364.         ARJ l archive -jb*     displays all chapters
  1365.  
  1366.         This switch can be used with the DELETE command to remove all
  1367.         chapters of selected file(s).
  1368.  
  1369.         ARJ d archive -jb* *.bak *.tmp
  1370.  
  1371.  
  1372.      "-jo" switch
  1373.  
  1374.         New to this release, the "-jo" option during extraction works along
  1375.         with the "-f" and "-u" type options.  In other words, if you want to
  1376.         freshen a set of files from an archive, the use of the "-jo" option
  1377.         will generate unique names for any files extracted.
  1378.  
  1379.         Example:  ARJ x archive *.* -u -jo
  1380.  
  1381.  
  1382.      "-js" switch
  1383.  
  1384.         The "-js" option by itself is the same as:
  1385.         -js.ARJ.ZIP.PAK.ARC.RAR.J.UC2.LZH.ZOO
  1386.  
  1387.  
  1388.      "-jt1" switch
  1389.  
  1390.         When used during a chapter add, the "-jt1" option will compare only
  1391.         the files of the added chapter.  Previous chapters will only be
  1392.         CRC tested.
  1393.  
  1394.         Example: ARJ ac archive c:\dir\*.* -jt1
  1395.  
  1396.  
  1397.      "-jyv" switch
  1398.  
  1399.         As a clarification of older documentation, the "-jyv" option will
  1400.         disable the next volume prompt EVEN with removable media.  The
  1401.         global "-y" option does not disable the next volume prompt with
  1402.         removable media.
  1403.  
  1404.  
  1405.      end document
  1406.  
  1407.