home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 February / Chip_2002-02_cd2.bin / sw / 287 / arj281.exe / ARJ.TXT < prev    next >
Text File  |  2001-11-11  |  263KB  |  5,783 lines

  1.  
  2.      User's Manual for the ARJ/ARJ32 archiver program,       November 2001
  3.  
  4.  
  5.  
  6.         ARJ/ARJ32 software and manual are copyright (c) 1990-2001 by ARJ
  7.         Software, Inc. All rights reserved.
  8.  
  9.  
  10.  
  11.      ** IMPORTANT NEWS ****************************************************
  12.  
  13.         Users of ARJ should read the WHATSNEW.TXT and UPDATE.TXT files
  14.         that contain information about the latest improvements to ARJ.
  15.  
  16.         For ARJ32 users, please refer to the UPDATE32.TXT for the
  17.         differences from ARJ.
  18.  
  19.      **********************************************************************
  20.  
  21.  
  22.  
  23.      TOPICS COVERED IN THIS DOCUMENT
  24.      -------------------------------
  25.  
  26.      DEDICATION
  27.      INTRODUCTION
  28.      NEW USERS
  29.      TERMINOLOGY
  30.      MAJOR FEATURES OF ARJ
  31.      ARCHIVER BENCHMARKS
  32.      RELEASE NOTES
  33.      YEAR 2000 COMPLIANCE STATEMENT
  34.      WINZIP COMPATIBILITY
  35.      TECHNICAL NOTES
  36.      DEARJ AND REARJ PROGRAMS
  37.      SYSTEM REQUIREMENTS
  38.      INSTALLATION
  39.      REGISTER STAMPING ARJ
  40.      QUICK START TO USING ARJ
  41.      HOW TO CREATE AN EXECUTABLE SELF-EXTRACTING ARJ ARCHIVE
  42.      HOW TO CUSTOMIZE AN EXECUTABLE SELF-EXTRACTING ARJ ARCHIVE
  43.      CONVERTING OTHER ARCHIVE FILES TO ARJ FORMAT
  44.      HOW TO USE ARJ
  45.      ARJ LIMITATIONS
  46.      IMPORTANT NOTES
  47.      TIPS TO USING ARJ EFFICIENTLY
  48.      USING ARJ WITHIN OTHER PROGRAMS
  49.      ARJMENU PROGRAM
  50.      USING ARJ AS A BACKUP PROGRAM
  51.      BACKUP TYPE ARCHIVES AND BACKUP FILES
  52.      CHAPTER ARCHIVES
  53.      WINDOWS 95 LONG FILENAME SUPPORT
  54.      WINDOWS NT AND 2000 SUPPORT
  55.      UNIVERSAL NAMING CONVENTION (UNC)
  56.      ARJ-PROTECT DATA PROTECTION FEATURE
  57.      ARJ ANSI COMMENT HANDLING
  58.      THE FILESPEC "..."
  59.      ARJ ERROR SITUATIONS
  60.      ARJ DOS ERRORLEVELS
  61.      ARJ USER ACTION PROMPTS
  62.      ARJ ENVIRONMENT VARIABLE/CONFIGURATION FILE
  63.      ARJ COMMAND LINE SYNTAX
  64.      ARJ RESPONSE FILE SYNTAX
  65.      ARCHIVE NAME WILDCARDING
  66.      ARJ COMMANDS
  67.      ARJ SWITCH OPTIONS
  68.      ARJ COMMAND OPTIONS
  69.      SAMPLE ARJ COMMANDS
  70.      ARJ_SECURITY ENVELOPE
  71.      KNOWN ARJ ISSUES/PROBLEMS
  72.      ARJ ERROR MESSAGES
  73.      COMMONLY ASKED QUESTIONS
  74.      ARJ TECHNICAL SUPPORT
  75.      ARJ AVAILABILITY
  76.      ARJ INTERNET MAILING LIST
  77.      ARJ WEB SUPPORT
  78.      SDN EXTENSION FILES
  79.      DISTRIBUTORS
  80.      ACKNOWLEDGEMENTS
  81.      USAGE AND DISTRIBUTION POLICY
  82.      BRIEF BIOGRAPHY OF ARJ AUTHOR
  83.      FINAL COMMENTS
  84.  
  85.  
  86.  
  87.      DEDICATION:
  88.  
  89.         The ARJ program is dedicated to God and to my family.  From the
  90.         beginning, our family decided that God would be the senior partner
  91.         in our company and that our business practices would strive to
  92.         reflect the principles that He has so graciously provided to the
  93.         world in His Word.
  94.  
  95.  
  96.      INTRODUCTION:
  97.  
  98.         ARJ is the result of a desire to use my interest in compression
  99.         technology to produce an archiver for personal use on PCs and on
  100.         minicomputers that provides power and excellent flexibility.
  101.  
  102.         This document is designed as an ARJ program reference manual and
  103.         is not appropriate for novices to ARJ.  The file named INTRO.TXT
  104.         is intended for novices.
  105.  
  106.         Please note that the shareware versions of the ARJ programs may be
  107.         slightly limited in functionality.  See the UPDATE.TXT for more
  108.         information.
  109.  
  110.  
  111.      NEW USERS:
  112.  
  113.         Users new to the ARJ archiver should start reading the INTRO.TXT
  114.         file instead of this document file.
  115.  
  116.  
  117.      TERMINOLOGY:
  118.  
  119.         The following terms are used through this manual.
  120.  
  121.         ARCHIVE - This is a file containing one or more files in a
  122.         compressed or non-compressed state and containing file related
  123.         information such as filename and date-time last modified, etc.
  124.  
  125.         ARJ32 - Windows 32 bit console mode version of ARJ.  ARJ32 supports
  126.         the Win32 environment of Windows 95/98/NT/2000.
  127.  
  128.         ARJ FILE - This is an archive created by ARJ.
  129.  
  130.         BACKUP TYPE ARCHIVE - This is an ARJ archive that has the internal
  131.         backup flag turned on.  This feature is obsolete after ARJ version
  132.         2.50a.  Current and future versions of ARJ will ignore the special
  133.         flag set on file backups.  Replacing this backup archive scheme is
  134.         the chapter archive scheme.
  135.  
  136.         CHAPTER ARCHIVE - This is an ARJ archive that contains one or more
  137.         backup chapters.  A chapter archive stores a full backup and a
  138.         series of incremental backups in a manner that saves disk space by
  139.         not storing duplicate files.  A chapter archive allows the user to
  140.         recover a directory of files as they were when the backup chapter
  141.         was made.  In other words, if daily backup chapters of a source
  142.         directory were made from Monday to Friday, one could recover the
  143.         source directory as it was on Wednesday.  Files that did not exist
  144.         for the specified chapter backup will NOT be restored even if they
  145.         existed in previous chapter backups.  Other forms of backup and
  146.         restore often restore files in a directory that had been deleted
  147.         and are not wanted.
  148.  
  149.         COMPRESSION - The process of encoding redundant information into
  150.         data requiring less storage space.
  151.  
  152.         COMPRESSION PERCENTAGE/RATIO - The percentage compression reported
  153.         by ARJ is a variation of one of the TWO standard methods of
  154.         expressing compression ratio in the technical literature.  ARJ uses
  155.         the compressed size / original size ratio.  The other method is the
  156.         inverse ratio.  When ARJ reports 96% as the compression ratio, which
  157.         means that the compressed file is 96 percent of the original size
  158.         (very little compression).  Other archivers use their own methods.
  159.         LHARC uses the same ratio as ARJ.
  160.  
  161.         EXTRACTION or UNCOMPRESSION - The processing of recreating the
  162.         exact information that was previously compressed.
  163.  
  164.         MARKING and UNMARKING - ARJ is indicating that the specified file
  165.         is already in the archive and does not need to be updated in terms
  166.         of file contents but only needs to have its chapter settings 
  167.         modified.  Marking means that a new chapter is being added to the
  168.         file's chapter range.  Unmarking means that one or more chapters
  169.         are being removed from a file's chapter range.
  170.         
  171.         SELF-EXTRACTION MODULE (SFX) - This is an archive that is an
  172.         executable file that is capable of extracting self-contained files.
  173.  
  174.         TEXT MODE - In text mode, ARJ inputs the file using the C library
  175.         text mode which translates the carriage return, linefeed control
  176.         characters of MS-DOS to a single linefeed character.  This saves
  177.         space and provides the option for cross platform file extraction.
  178.         On another platform, the host C library would change the single
  179.         linefeed to the host text newline separator sequence.  In addition,
  180.         for platforms such as PRIMOS which set bit 8 in ASCII text
  181.         characters, ARJ sets/resets bit 8 according to the platform
  182.         extracted to.  When extracting a text mode file to the same type
  183.         of platform archived from, ARJ will NOT strip the 8-bit text to
  184.         7-bit text.
  185.  
  186.         VOLUMES - These are ARJ archives that are in sequence and have been
  187.         created by a single ARJ command.  Files in the volumes may span
  188.         volumes in a split format.  These volumes are usable archives.
  189.  
  190.         WINDOWS 9x - All versions of Windows 95, Windows 98, and Windows
  191.         Millenium (ME).
  192.  
  193.         WINDOWS 2K - Windows 2000
  194.  
  195.         WINNT - Windows NT
  196.  
  197.  
  198.      MAJOR FEATURES OF ARJ:
  199.  
  200.         Currently provides excellent compression in terms of size reduction
  201.         compared to the leading archivers including PKZIP 1.10, PKZIP 2.04,
  202.         LHARC 1.13c, and LHA 2.13.
  203.  
  204.         ARJ is particularly effective with database files and documents.
  205.  
  206.         The ability to process and archive up to 50,000 files at one time.
  207.         The registered version of ARJ32 can archive over 2,000,000 files at
  208.         one time.  The registered version of ARJ can archive up to 260,000
  209.         files at one time.
  210.  
  211.         The ability to select files for archival by type and/or attribute.
  212.  
  213.         Support for Windows 9x long filenames in the Windows 9x/ME GUI DOS
  214.         environment.  ARJ32 also supports long filenames in Windows NT/2K.
  215.  
  216.         The ability to repair small amounts of archive damage (headers and 
  217.         file data) of an ARJ-PROTECTED archive.
  218.         
  219.         Archive and individual file comments with the option of inputting
  220.         comments from a file.
  221.  
  222.         ARJ has MS-DOS 3.x international language support for the proper
  223.         casing of filenames and text.
  224.  
  225.         The ability to put the entire ARJ command line in a response type
  226.         file as in "ARJ @command.rsp".
  227.  
  228.         32 bit CRC file integrity check.
  229.  
  230.         DOS volume label support.
  231.  
  232.         Default storing of specified pathnames to allow recovery of a
  233.         directory structure.
  234.  
  235.         Empty directory support.
  236.  
  237.         Backup support in the chapter archive scheme which allows a series
  238.         of backups to be included in a single archive so that one can
  239.         recover any one of the backups.  The advantage of chapters is that
  240.         files that have not changed are saved only once in the archive.
  241.  
  242.         Test new archive before overwriting the original archive option.
  243.  
  244.         Archives that can span diskettes.  This allows the user to backup a
  245.         full hard disk drive to multiple floppies.  Recovery of individual
  246.         files is convenient because each diskette archive is an individual
  247.         archive except for the split file portion.  No need to use SLICE
  248.         with ARJ.  In addition, ARJ in disk spanning mode can support the
  249.         use of 3.5 HD diskettes formatted at higher capacities than 1.44
  250.         MBytes.  Moreover, ARJ can build these disk spanning archives on
  251.         the hard disk drive for later transfer to diskettes.
  252.  
  253.         Archive file re-ordering facility with the option of sorting by
  254.         file size, file extension, CRC value, date-time modified, filename,
  255.         pathname, compression ratio, file attribute and more.
  256.  
  257.         String searching with context display within archive files.
  258.  
  259.         Built-in facility to recover files from broken archives.
  260.  
  261.         Self-extraction feature that is internal to the ARJ runfile.  The
  262.         SFX module is full-featured with a built-in help screen.  ARJ also
  263.         includes a smaller SFXJR module with fewer features.
  264.  
  265.         Multiple volume self-extracting archives.
  266.  
  267.         The ability to embed command line type options inside
  268.         self-extracting archives and to execute a command after extraction.
  269.  
  270.         Internal string data integrity check in ARJ to resist hacking a la
  271.         LHARC to ICE.
  272.  
  273.         Archive security envelope "seal" feature to resist tampering with
  274.         secured archives.  This feature disallows ANY changes to a secured
  275.         archive. Even the archive comments can NOT be changed without
  276.         removing the "seal".
  277.  
  278.         Password option to encrypt archived files.
  279.  
  280.         Text mode data compression option to enable movement of text files
  281.         from one host machine to another.  Text mode also results in
  282.         slightly greater file size reduction on MS-DOS machines.
  283.  
  284.         File extraction to screen in a paged mode to permit browsing
  285.         through an archive.
  286.  
  287.         Specification of the files to be added to or exclude from an
  288.         archive via one or more list files.  In addition, ARJ can generate
  289.         a list file.
  290.  
  291.         Specification of files to be excluded from processing by ARJ.
  292.  
  293.         Sub-directory recursion during compression and extraction.
  294.  
  295.  
  296.      ARCHIVER BENCHMARKING:
  297.  
  298.         This is information for those who plan to publish benchmark test
  299.         results comparing ARJ with other file archivers.
  300.  
  301.         The ARJ "-jm" compression is intended to demonstrate the best that
  302.         ARJ can do in terms of size reduction.  However, the ARJ "-jm1"
  303.         compression is almost as good in terms of size reduction and is
  304.         faster.
  305.  
  306.         The ARJ "-e" option is necessary during size benchmarks because 
  307.         ARJ by default stores the entire specified pathname in the archive 
  308.         as opposed to other archivers which strip path specifications.
  309.  
  310.         Example command:  ARJ a benchmrk -e -jm1 files\*.*
  311.  
  312.         The very size of the ARJ runfile adds significantly to the
  313.         compression and extraction times when testing smaller archives.
  314.  
  315.  
  316.      RELEASE NOTES:
  317.  
  318.         The use of ARJ/ARJ32 in a business, commercial, institutional, or
  319.         government environment requires a license.  However, business,
  320.         commercial, institutional and government users may use ARJ for
  321.         evaluation purposes for a period of 30 days.  See the LICENSE.TXT
  322.         for full details.  A government agency may NOT require others to
  323.         use ARJ without obtaining a license.
  324.  
  325.         The inclusion of any of the ARJ software (ARJ, ARJ32, DEARJ,
  326.         ARJSFX, ARJSFXV, ARJSFXJR, ARJSFX32, REARJ, REARJ32) with software
  327.         and/or hardware for distribution requires a license.  There is an
  328.         exception for freeware/shareware software collections.  See the
  329.         file LICENSE.TXT for details.
  330.  
  331.         While evaluating ARJ, you should use the "-jt" (test archive)
  332.         option to verify new ARJ archives of your data.
  333.  
  334.         This version has been tested under DOS 2.11, 3.3, 4.01, 5.0, 6.0,
  335.         and 6.2x.  It also runs under the MSDOS prompts of Windows 3.x,
  336.         Windows 95/98/Millenium, Windows NT, Windows 2000, OS/2 2.0, Warp
  337.         3, and Warp 4.
  338.  
  339.         ARJ32 has been tested under Windows NT 4.0 service pack 3, Windows
  340.         95, Windows 98, Windows Millenium, and Windows 2000.  Preliminary
  341.         testing under Windows XP has been successful.
  342.  
  343.         Here is a suggested command that will test ARJ on all of your files:
  344.  
  345.         ARJ a testvol c:\ -v360dtestvol.* -xtestvol.* -y -jf -jt1 -r
  346.  
  347.  
  348.      YEAR 2000 COMPLIANCE STATEMENT:
  349.  
  350.         See the file YEAR2000.TXT.
  351.  
  352.         This version of ARJ has been modified to allow the specification
  353.         of the century for the ARJ date options "-o" and "-ob".  Prior to
  354.         this version, the ARJ date options would accept a date in the form
  355.         of YYMMDD.  With this version, ARJ will accept dates in both
  356.         YYMMDD and YYYYMMDD formats.  ARJ will presume that any year
  357.         specifications beginning with 19, 20, and 21 are YYYY type
  358.         specifications and any year specifications beginning with 80, 81,
  359.         82 .... 99, 00, 01 .... 18 are YY type specifications.
  360.  
  361.         Example:  -o980105         -> on or after Jan 5, 1998
  362.                   -o19980105       -> on or after Jan 5, 1998
  363.                   -o100105         -> on or after Jan 5, 2010
  364.                   -o20100105       -> on or after Jan 5, 2010
  365.                   -o201001051200   -> on or after Jan 5, 2010 12:00 P.M.
  366.                   -o100105         -> on or after Jan 5, 2010 12:00 A.M.
  367.  
  368.  
  369.      WINZIP COMPATIBILITY:
  370.  
  371.         Winzip 7.0 has compatibility issues with the copyright header of
  372.         ARJ 2.70 and 2.71.  With this release, the header was modified to
  373.         allow compatibility with Winzip 7.0.  Winzip 8.0 does NOT have this
  374.         compatibility issue with ARJ 2.70 and 2.71.
  375.  
  376.         ARJ32.EXE is not supported by Winzip at this time.  However, if you
  377.         rename ARJ32.EXE to ARJ.EXE, Winzip may support it.
  378.  
  379.  
  380.      TECHNICAL NOTES:
  381.  
  382.         A detailed technical description of the ARJ archive format is
  383.         available in the UNARJ distribution archive.  This archive
  384.         contains a description of the archive header formats as well as C
  385.         source code for an ARJ archive extractor and lister program.  This
  386.         UNARJ source code has been made portable to several platforms 
  387.         including UNIX, NEXT, DOS, and AMIGA.  However, we only distribute
  388.         and support the PC versions.
  389.  
  390.  
  391.      DEARJ and REARJ PROGRAMS:
  392.  
  393.         DEARJ is the ARJ program without the archive creation/modification 
  394.         functions, the "w" command, the self-extractors, and the "-jt1" 
  395.         and "-jt2" switches.
  396.  
  397.         The UNREGISTERED version of DEARJ CANNOT handle multiple volume
  398.         archives.
  399.  
  400.         DEARJ is normally not needed because ARJ now has a multiple volume 
  401.         self-extractor which provides the same functions.
  402.  
  403.         Registration of REARJ will enable a number of additional 
  404.         enhancements including environment variable usage, !listfile 
  405.         capability and selection by file date-time.
  406.  
  407.         See the LICENSE.TXT and ORDERFRM.TXT for more information.
  408.  
  409.         ARJR is no longer available.
  410.  
  411.         UNARJ and DEARJ are NOT the same program.
  412.  
  413.         ARJ32 does not have a DEARJ32.EXE.
  414.  
  415.  
  416.      SYSTEM REQUIREMENTS:
  417.  
  418.         The ARJ software package is designed to work under DOS versions and
  419.         DOS boxes from 2.11 and above.  However, certain features have an
  420.         OS limitation under DOS versions prior to DOS 3.0 as in access to 
  421.         the self-extractors and to the built-in help information.  To get 
  422.         the ARJ help screens and the ARJ self-extraction creation to work, 
  423.         ARJ.EXE MUST be located in the CURRENT directory.  This limitation 
  424.         exist only in newer versions of ARJ to save on memory usage.
  425.  
  426.         Within the Windows 9x/Me DOS box environment, ARJ supports the use 
  427.         of Windows 9x/ME long filenames.  This feature ONLY works in the 
  428.         Windows 9x DOS box.  It does not work under DOS 6.x nor does it 
  429.         work under Windows NT/2000.
  430.  
  431.         ARJ32 runs only under Windows 95/98/ME/NT/2K graphical environment.
  432.  
  433.  
  434.      INSTALLATION:
  435.  
  436.         We assume that you have a copy of the self-extracting ARJ module
  437.         named ARJ###.EXE where "###" represents the ARJ version number.
  438.         Typing ARJ### [RETURN] at the DOS command prompt will initiate the
  439.         self-extraction feature.  ARJ### will by default extract its files
  440.         to the "C:\ARJ" directory.  When ARJ### starts, you will see 
  441.         several lines of text describing ARJ and then a line asking if you
  442.         wish to continue extraction.  Entering "yes" or "y" will continue 
  443.         the extraction.  If there are any duplicate filenames in the 
  444.         destination directory, the program will prompt you for 
  445.         overwriting. You can enter "yes", "no", or "quit".
  446.  
  447.         To complete the installation, you will need to add the destination
  448.         directory ("C:\ARJ" is the default) to the PATH statement in your
  449.         AUTOEXEC.BAT file.  For Windows 95/98/ME, you should add the 
  450.         statement
  451.         
  452.         set path=%path%;c:\arj
  453.  
  454.         to the end of the AUTOEXEC.BAT file.  Do NOT insert any spaces for 
  455.         added clarity.
  456.  
  457.         ARJCRYPT.COM is an ARJ accessory encryption module for USA users
  458.         only.  It is available on the ARJ website.
  459.         
  460.         ARJ32_C.DLL is an ARJ32 accessory encryption module for USA users 
  461.         only.  It is available on the ARJ website.
  462.  
  463.         You may, of course, prefer to use ARJ 1.00 or higher to extract
  464.         the contents of ARJ###.EXE file manually.
  465.  
  466.         Example:  ARJ e ARJ###.EXE C:\ARJ\
  467.  
  468.  
  469.      REGISTER STAMPING ARJ:
  470.  
  471.         *** THIS RELEASE HAS A SHORT RANDOM TIME DELAY AT THE START
  472.         *** OF EXECUTION.  THE REGISTERED VERSION DOES NOT HAVE THIS 
  473.         *** DELAY.  THIS DELAY MAY BECOME LENGTHY IN A YEAR OR SO.   
  474.  
  475.         *** REMINDER: ARJ 2.7x uses a new registration scheme which 
  476.         *** obsoletes all previous registration keys.
  477.      
  478.         *** Register stamping ARJ removes the startup time delay and
  479.         *** enables the enhanced features.  At this release, the
  480.         *** enhanced features include the support for archiving a
  481.         *** large number of files (ARJ -> 260,000, ARJ32 -> 2,000,000),
  482.         *** as well as enhancing REARJ.
  483.    
  484.         If, when you purchase an ARJ license, you choose to receive your 
  485.         ARJ key by email, you will need to put the emailed key data into a 
  486.         file named REGISTER.DAT in the same directory as the ARJ software 
  487.         programs.  Then you need to execute REGISTER.EXE with either the 
  488.         -ARJ option or the -ARJ32 option depending upon your software.  
  489.         Please note that the registration key for ARJ does not work with 
  490.         ARJ32 and vice-versa. 
  491.  
  492.         A more detailed explanation can be found in the file REGISTER.TXT.
  493.  
  494.  
  495.      QUICK START TO USING ARJ:
  496.  
  497.         See the document INTRO.TXT.
  498.  
  499.  
  500.      HOW TO CREATE AN EXECUTABLE SELF-EXTRACTING ARJ ARCHIVE:
  501.  
  502.         The command "ARJ y -je archive" will create a full featured
  503.         self-extracting archive from an already built archive.
  504.  
  505.         The command "ARJ y -je1 archive" will create a smaller
  506.         self-extracting archive.
  507.  
  508.         Syntax:  ARJ y -je archive      produces archive.EXE
  509.  
  510.         ARJ lets users create multiple volume self-extracting archives.
  511.  
  512.         Syntax:  ARJ y -je archive -v360K     produces archive.EXE,
  513.                                               archive.e01, archive.e02 ....
  514.  
  515.         An alternative mode (-ve option) lets you create a multiple volume 
  516.         self-extracting archive where the volumes all end in .EXE.  Only
  517.         the first volume is the extractor module.  The other volumes end 
  518.         in .EXE for use on an Internet download website.  Netscape and
  519.         Explorer will properly download .EXE files.
  520.  
  521.         Syntax:  ARJ y -je archive -ve360K    produces archive.EXE,
  522.                                               arch001.EXE, arch002.EXE ....
  523.  
  524.         Under DOS systems other than 2.11, 3.2, 3.3, 4.0, 5.0, 6.x, and
  525.         7.0, you may have to rename the self-extract module to ARJSFX.EXE
  526.         to do the extraction.
  527.  
  528.         See the file SFX.TXT for more information.
  529.  
  530.  
  531.      HOW TO CUSTOMIZE AN EXECUTABLE SELF-EXTRACTING ARJ ARCHIVE:
  532.  
  533.         It is possible to customize an ARJ self-extracting archive to
  534.         execute command line options as if the user typed in the options.
  535.  
  536.         Upon execution, an ARJ self-extractor checks its DOS command line
  537.         for any options that the user might have entered (ARJSFX -t).  If
  538.         the self-extractor does not find any options, it will look for the 
  539.         self-extractor archive comment.  If the first line of the comment
  540.         begins with two right parentheses, the self-extractor will execute
  541.         any command options following the two right parentheses.
  542.  
  543.         See the file SFX.TXT for more information.
  544.  
  545.  
  546.      CONVERTING OTHER ARCHIVE FILES TO ARJ FORMAT:
  547.  
  548.         Included with this software is the program REARJ.  This program can
  549.         be used to individually or collectively convert archive files from
  550.         other formats to the ARJ format.
  551.  
  552.         The command "REARJ *.ZIP *.ARC *.LZH" will convert all ZIP, ARC,
  553.         and LZH archives in the current directory to the ARJ format.  See
  554.         the REARJ.TXT for more information about REARJ.
  555.  
  556.  
  557.      HOW TO USE ARJ:
  558.  
  559.         If you type ARJ [return], you will see a simple help screen.
  560.  
  561.         If you type ARJ -? [return], you will see more detailed help
  562.         information.
  563.  
  564.  
  565.      ARJ LIMITATIONS:
  566.  
  567.         ARJ will accept up to:     64 filenames/wildnames on command line
  568.                                50,000 filenames resulting from wildnames
  569.                                (see below for registered versions)
  570.                                50,000 filenames/wildnames to exclude
  571.                                16,000 filenames to sort
  572.                                16,000 ARJ filenames resulting from wildnames
  573.                                 2,048 character comments
  574.                                       (up to 25 lines or 1 file)
  575.  
  576.         The registered version of ARJ32 will accept over 2,000,000
  577.         filenames. The registered version of ARJ will accept up to 260,000
  578.         filenames.  However, for evaluation purposes, ARJ/ARJ32 will
  579.         process up to the larger limit when using the -j#1 option.
  580.  
  581.         Example:  ARJ a archive c:\*.* d:\*.* -r -j#1
  582.  
  583.         Note that using the option "-j#1" does not store any of the
  584.         contents of the files.  Only the name, date, and size is stored.
  585.  
  586.         For compressing, ARJ requires approximately 300,000 bytes plus the
  587.         memory necessary to store all of the pathnames to be archived when
  588.         using the default compression method (-m1).
  589.  
  590.         For extracting, ARJ requires approximately 175,000 bytes plus.
  591.         The program DEARJ requires approximately 125,000 bytes plus.
  592.  
  593.  
  594.         *** ARJ will accept files with sizes up to 2 gigabytes in size.
  595.  
  596.  
  597.         There is no limitation on the number of files that can be stored in
  598.         one archive.  However, when archiving a large number of files, ARJ
  599.         will use additional disk space to manage its internal list of those
  600.         filenames.
  601.  
  602.         Example:  ARJ a -r archive \*.* -hm
  603.  
  604.         ARJ currently does not see that wildnames like "C:*.*" and "C:\*.*"
  605.         can actually represent the same thing.  ARJ would expand each of
  606.         those two wildnames into a list that could be up to twice as long
  607.         as necessary.
  608.  
  609.         When updating an archive, ARJ creates a temporary file named
  610.         ARJTEMP.$nn in the current directory or special work directory if
  611.         specified (-hm!F:\).
  612.  
  613.         While ARJ is scanning a wildcard filespec, ARJ will change the name
  614.         of the target archive to ARJTEMP.$nn while the scan is proceeding
  615.         to avoid including the archive itself in an add or move command.
  616.         Also, as a result, you cannot add a file named ARJTEMP.$nn to an
  617.         ARJ archive.  Please note that the name of this temporary file may
  618.         change at a future revision of ARJ.
  619.  
  620.         In this release, ARJ will not use memory for filenames that it does
  621.         not select by name or by file attribute (archive bit, file type).
  622.  
  623.  
  624.      IMPORTANT NOTES:
  625.  
  626.         When using the "-w" working directory switch, ARJ does not check
  627.         on space availability before overwriting the original archive if
  628.         it exists.  Be sure that you have enough disk space for the new
  629.         archive before using the "-w" switch.  If ARJ aborts in this
  630.         situation because of disk space, ARJ will keep the temporary
  631.         archive.
  632.  
  633.         By default, ARJ does not see hidden or system files.  ARJ will
  634.         process system and hidden files when you either specify the "-a"
  635.         switch or use the new "-hb" switch.
  636.  
  637.         Like LHARC and PKZIP, ARJ requires extra disk space to UPDATE an
  638.         archive file.  ARJ will backup the original archive while it
  639.         creates the new archive, so enough room must be available for both
  640.         archives at the same time.
  641.  
  642.         Unlike PKZIP, ARJ does not require additional work space when
  643.         CREATING a new archive.
  644.  
  645.         Currently, ARJ will not extract overwriting a readonly file unless
  646.         the "-ha" option is specified.
  647.  
  648.  
  649.      TIPS TO USING ARJ EFFICIENTLY:
  650.  
  651.         You should use a software or hardware disk cache to speed up ARJ
  652.         access.  Diskette drives should NOT be write-delay enabled.
  653.         Write-delay would prevent ARJ from truly verifying diskette
  654.         writes.
  655.  
  656.         When archiving to diskettes, you should use the "-w" option to set
  657.         a working directory on your RAMDRIVE or hard disk drive to speed
  658.         up building the archive.
  659.  
  660.         You should use the "-jt" or "-jt1" option when archiving to
  661.         diskettes or when you really want to be sure that ARJ will be able
  662.         to extract what you have archived.  There are cases where your
  663.         hardware or memory resident software will corrupt your work, so
  664.         the "-jt" options are excellent insurance.  If you have bad
  665.         sectors on your diskettes and verify is turned off, DOS will not
  666.         tell you about diskette errors until it is too late.  These errors
  667.         are NOT RECOVERABLE.
  668.  
  669.         In the news are reports that many floppy disk drives are capable
  670.         of corrupting data on a random basis especially when the computer
  671.         is busy with many tasks at once.  It is said that this problem is
  672.         due to faulty floppy drive chip design.  We recommend that no
  673.         other disk intensive tasks be run while using the diskette drive.
  674.  
  675.         Using the "-js" option saves time by not compressing archives of
  676.         PKZIP, LHA, ARC, ZOO, ARJ, etc.
  677.  
  678.         You should use the "-e" option whenever you do not need to store
  679.         pathnames in an archive that you are creating.  This will save
  680.         space.
  681.  
  682.         Convert an ARJ archive into a self-extracting archive with a
  683.         command like the following:  ARJ y archive -je
  684.  
  685.         To capture a comment from an ARJ archive, use the following
  686.         command:  ARJ e archive ... -zcomment.txt  (the "..." is
  687.         significant).
  688.  
  689.         ARJ has several compression methods that provide size/time
  690.         tradeoffs.  Method 4 "-m4" is about twice as fast as method 1.  The
  691.         "-jm1" and "-jm" options modify the "-m1" option to provide even
  692.         greater compression at a cost in time.
  693.  
  694.  
  695.      USING ARJ WITHIN OTHER PROGRAMS:
  696.  
  697.         Since ARJ uses over 300,000 bytes of memory during compression, it
  698.         is difficult to use ARJ in a large application program unless that
  699.         program swaps itself out of memory when it executes DOS commands
  700.         like ARJ.  However, there is at least one shareware program
  701.         available that will automatically swap your large application
  702.         program out of memory whenever it shells out to DOS to execute a
  703.         command.  The program SHROOM by Davis Augustine should be able to
  704.         solve this memory problem for you.  The latest version as of
  705.         03/11/92 is named SHROM19C.ZIP on Channel One BBS.
  706.  
  707.         This is not an endorsement of the product SHROOM.
  708.  
  709.         The easiest way we have found to use this product is to type:
  710.         SHROOM COMMAND.COM
  711.  
  712.         SHROOM -v COMMAND.COM will let you see SHROOM in action when you
  713.         shell out to execute a DOS command.
  714.  
  715.         ARJ32 does not have this memory limitation.
  716.  
  717.  
  718.      ARJ HELP HYPERTEXT PROGRAM:
  719.  
  720.         ARJ-Help is an electronic book (brand named Window Book (TM)) that
  721.         allows the user to discover easily how to use ARJ.  It runs under
  722.         DOS.  It is very fast and has a rich set of features which include
  723.         full-text search, hypertext links, a table of contents that can be
  724.         reorganized to your needs, a complete index, and much more. The
  725.         current version can be found on some BBSes as ARJHLP24.EXE.
  726.  
  727.             Window Book, Inc.
  728.             P.O. Box 390697
  729.             Cambridge MA 02139
  730.             USA
  731.  
  732.             TEL:   617-661-9515 or 800-524-0380.
  733.             FAX:   617-354-3961
  734.  
  735.  
  736.      ARCHIVER UTILITIES THAT SUPPORT THE ARJ FORMAT:
  737.  
  738.         The following are some other utilities that facilitate the use of
  739.         ARJ.  This list is not all inclusive nor is it meant as a personal
  740.         recommendation.
  741.  
  742.         ARCHIVE MANAGER PRO - Archiver shell
  743.         ARJMENU             - ARJ shell
  744.         SHEZ                - Archiver shell
  745.         ARCMASTER           - Archiver shell
  746.         ZGEN                - Archiver shell
  747.         ACZAR               - Archiver shell
  748.         ARJVIEW             - ARJ shell
  749.         AVIEW               - BBS archive viewer
  750.         WINZIP              - Windows archiver shell
  751.  
  752.         WINDOWS COMMANDER   - Windows archiver shell, file manager
  753.         ARJ Folder          - Windows Explorer Shell Extension
  754.  
  755.         A particularly useful ARJ support utility is SARJ by Frederic
  756.         Taes.  It improves upon ARJ compression by using ARJ to build
  757.         "solid" archives.
  758.  
  759.         Windows interface recommendation:
  760.  
  761.         The author of ARJ personally uses Windows Commander for his
  762.         Windows work with ARJ currently.  Windows Commander is especially
  763.         useful because it supports many popular archivers and is designed
  764.         as a file management tool.  It treats archives like directories.
  765.         This is especially handy for ARJ users who archive whole directory
  766.         trees.  And since it is a file manager, one can delete, move,
  767.         copy, view, edit, and modify files in archives and not in
  768.         archives.  It even has FTP file transfer support.
  769.  
  770.         You can find Windows Commander at http://www.ghisler.com
  771.  
  772.  
  773.      USING ARJ AS A BACKUP PROGRAM:
  774.  
  775.         ARJ can be used as a substitute for a backup program.  Now ARJ
  776.         includes an error recovery option (-hk) to help protect against
  777.         many kinds of data errors.  Please note this option must be
  778.         applied before data errors occur.  It is STRONGLY recommended
  779.         that you use the "-hk" option when archiving important files and
  780.         when archiving to diskettes.
  781.  
  782.         The most common cause of failure is bad diskettes.  You should let
  783.         ARJ test the archives ON the diskettes.  Testing the archives
  784.         before copying them to diskettes is not enough.  Critical data
  785.         should always be backed up two or more times.  Please keep in mind
  786.         that damage to compressed data is many times more serious than
  787.         damage to uncompressed data.
  788.  
  789.         WARNING:  It is our recommendation that you should NOT update
  790.         multiple volume ARJ archives of critical data especially backup
  791.         archives.  A system error could cause the current set of volumes
  792.         being updated to be damaged.  Use a separate set of diskettes to do
  793.         an incremental backup.
  794.  
  795.         The following partial command lines illustrate a full backup
  796.         command, an incremental backup command, and a restore command.  The
  797.         only parts missing are the names of the files to backup/restore.
  798.  
  799.         ARJ a A:backup -r -vvas -a1 -b2 -hk -js -jt -jiC:\backup.inx -wC:\ -m3
  800.  
  801.         ARJ a A:backup -r -vvas -a1 -b1 -hk -js -jt -jiC:\backup.inx -wC:\ -m3
  802.  
  803.         ARJ x A:backup -vv -y
  804.  
  805.         You should familiarize yourself with the above switches so that you
  806.         can modify the above command lines as needed.
  807.  
  808.         If you have a RAMDRIVE large enough, you should change the "-w"
  809.         option to point to the RAMDRIVE.
  810.  
  811.         If you have enough free hard disk space, you can build all of the
  812.         diskette volumes on the hard disk for future transfer to diskette.
  813.         In this case, you will need to change the name of the archive to
  814.         "C:backup" or similar.  The "-vvas" option should be changed to
  815.         "-v360", "-v720" or whatever is appropriate for your diskette size.
  816.         Please note that 360, 720, 1200, and 1440 are abbreviations for the
  817.         standard diskette sizes.  Other sizes will require your entering
  818.         the entire number.  Another change is to add the option "-y" which
  819.         will turn off the "Ok to proceed ...." prompt.  Lastly, if the "-w"
  820.         option is pointing to the hard disk, you should remove the "-w"
  821.         option entirely.
  822.  
  823.         ARJ a C:backup -r -v360  <other options>   -m3 -y
  824.  
  825.         At this release, ARJ will automatically roll-over the file
  826.         extension from .A99 to .100 and so on.
  827.  
  828.         Both backup commands will pause for a "system command".  You can
  829.         execute DOS commands at this point.  This is a suitable place to do
  830.         a "dir a:" to make sure that your disk is formatted and has enough
  831.         free space on it.  You may need to execute "format a:" or "del
  832.         a:\".  A very useful command might be "QDR A:".  QDR is a utility
  833.         from Vernon Buerg.  You will need to type "exit" to allow ARJ to
  834.         continue.
  835.  
  836.         If the backup fails after completing one or more diskettes, you
  837.         can restart at the next archive after the last successful volume
  838.         if you have specified an INDEX file with the "-ji" option during
  839.         the backup.  You can restart by retyping the EXACT SAME command
  840.         line as before and adding the "-jn" option.  This will cause ARJ
  841.         to scan the previously written index file for the proper restart
  842.         information. ARJ will automatically set the correct volume name.
  843.  
  844.         Example:  ARJ a a:backup c:\ -r -vvas -jiINDEX.FIL
  845.                   ARJ a a:backup c:\ -r -vvas -jiINDEX.FIL -jn
  846.  
  847.         If a RESTORE operation fails after one or more diskettes, simply
  848.         retype the same command as before but add the right ".Ann" suffix
  849.         to the archive name.  If ARJ has aborted because of a disk full on
  850.         a file split between volumes, you will have to restart at the
  851.         first volume that contains that file.
  852.  
  853.  
  854.      BACKUP TYPE ARCHIVES AND BACKUP FILES:
  855.  
  856.         This type of archive is obsolete after ARJ version 2.50a.  It is
  857.         replaced by the chapter archive.
  858.  
  859.  
  860.      CHAPTER ARCHIVES:
  861.  
  862.         This feature is useful when backing up frequently modified files.
  863.         This new feature is designed to make the backup management of a
  864.         directory or application easier.  It allows the taking of a
  865.         sequence of backup "snapshots" of a changing application or
  866.         directory.  A chapter archive can provide major space savings over
  867.         using many separate archives for backup.
  868.  
  869.         For example, a chapter archive could be used to keep track of the
  870.         state of a Windows 3.1 directory.  An initial chapter backup could
  871.         be made of the original Windows 3.1 installation.  Then, whenever
  872.         a new software package is installed, a new chapter snapshot could
  873.         be taken.
  874.  
  875.         ARJ ac winback c:\windows\*.* -r -a1 -jt1
  876.  
  877.         If a Windows problem develops, one can restore Windows back to
  878.         any particular chapter for testing.
  879.  
  880.         ARJ x winback c:\ -y -jb5           restore chapter 5
  881.  
  882.         This chapter feature is especially useful for software developers.
  883.         Since a chapter archive can contain up to 250 chapters, the change
  884.         history of a software source directory for a period of weeks can be
  885.         maintained in a single archive.  You could take four chapter
  886.         snapshots per day for over two months to a single archive.  This
  887.         would allow you to restore your source directory to one or more
  888.         points in time to help you track the appearance of software
  889.         problems.
  890.  
  891.         See the "-jb" option for more details.
  892.  
  893.         The limitation on the maximum number of chapters is an internal
  894.         resource issue as well as a "recommendation" to build a new
  895.         archive.  Making thousands of modifications to important backup
  896.         data is a somewhat risky activity.
  897.  
  898.         Please note that deleting files or purging old chapters from a
  899.         multiple volume archive is not recommended.  With a multiple
  900.         volume archive, deletions do not save space, so deletions are not
  901.         useful.
  902.  
  903.  
  904.      WINDOWS 9x LONG FILENAME SUPPORT:
  905.  
  906.         This version of ARJ supports the use of long filenames under the
  907.         Windows 9x GUI in the MS-DOS Prompt environment.  It does not
  908.         support long filenames under MS-DOS 6.22 and below or in Windows
  909.         NT/2000.  It supports long filenames ONLY when the Windows 9x GUI
  910.         (graphical user interface) is running.  In other words, there is
  911.         no long filename support in Windows 9x MS-DOS mode (accessed from
  912.         the Win9x shutdown menu).  Moreover, there is NO long filename
  913.         support in ARJ for Windows NT/2000.
  914.  
  915.         Windows 9x DOS support (and therefore ARJ) do not support access
  916.         to long filenames containing certain characters.  For example, a
  917.         filename containing the copyright symbol or the trademark symbol
  918.         cannot be accessed in a Win9x DOS window with the COPY command
  919.         or with ARJ.  These type of filenames can only be accessed via
  920.         their short names.  The Win9x system normally stores filename
  921.         characters as two bytes per symbol allowing an alphabet of 65536
  922.         possible symbols.  Because Win9x DOS only uses one byte per
  923.         character position allowing only a 256 symbol alphabet, many
  924.         characters are displayed by Win9x DOS as "_".
  925.  
  926.         In addition, ARJ does not support files over 2 GB in size.
  927.  
  928.         The small ARJ self-extractor (-je1) does NOT support the handling
  929.         of long filenames.
  930.  
  931.         The ARJSFX and ARJSFXV modules (-je) support long filename
  932.         handling.  However, they will only extract archived Win9x long
  933.         filename files under Win9x.  If long filename files are being
  934.         extracted to plain DOS, an error message will be displayed.  They
  935.         can be forced to extract the Win9x archived files with the "-j"
  936.         option.
  937.  
  938.         For compatibility with MS-DOS and older versions of ARJ, ARJ can
  939.         create a dual-name compatibility ARJ archive.  This is an archive
  940.         with both shortnames and longnames stored in it.  The longnames are
  941.         stored in the file comment field.  New versions of ARJ will treat
  942.         the dual-name archive according to the operating system
  943.         environment.  In other words, under MS-DOS, a dual-name archive
  944.         will look like a shortname archive.  Under Win9x, a dual-name
  945.         archive will look like a longname archive.  This is also true of
  946.         the ARJSFX and ARJSFXV/32 modules (-je).
  947.  
  948.         For efficiency reasons ARJ does not repeatedly check for file
  949.         system support of long filenames.  ARJ only tests the "C:" file
  950.         system.  An error may occur if ARJ under Win9x tries to access a
  951.         disk drive that does not support long filename handling.  The "-hf"
  952.         option can be used to force ARJ to use the standard 8.3 filename
  953.         APIs instead of the longname APIs.
  954.  
  955.         On a more technical note, ARJ detects long filename support by two
  956.         tests.  The first is that the OS is 7.0 or higher.  The second is
  957.         via the "Get volume information" api.
  958.  
  959.         There are five new options "-hf", "-hf1", "-hf2", "-hf3", and
  960.         "-hf4" that provide choices in the handling of long filenames.
  961.         See the discussion of those options below for more information.
  962.  
  963.         ARJ will save Win9x long filenames in the letter case they are
  964.         stored on disk; however, all filename matching is done without
  965.         regard to case.  In other words, "ThisName.Ext" matches
  966.         "thisNAME.ext".
  967.  
  968.         When archiving files under Windows 9x, be sure to EXCLUDE files
  969.         from processing that are OPEN such as WIN386.SWP.
  970.  
  971.         REMINDER: When specifying filenames with embedded blanks or
  972.         symbols like ">", "<", or "|" on the command line, you MUST
  973.         quote the filenames.
  974.  
  975.         Examples:  ARJ a archive "C:\Program Files\*.*" -r
  976.                    ARJ c archive "<<<*" -jz -jb
  977.  
  978.         When specifying a target directory name that contains spaces, you
  979.         must quote the directory name.  If the name specification ends in
  980.         a "\" backslash (needed for a non-existent directory), you must
  981.         insert a space after the "\".  Alternatively, you can use the
  982.         "-ht" option.  The built-in C run-time library uses the "\" as a
  983.         character escape symbol.
  984.  
  985.         Example:  ARJ x archive "C:\Program Files\ "    or
  986.                   ARJ x archive "-htC:\Program Files"
  987.  
  988.         For Windows 9x disaster recovery, we make use of the program
  989.         DOSLFNBK.EXE 2.3 by D. J. Murdoch.  With this program while in
  990.         plain DOS, you can save all of the long filenames to BACKUP.LFN.
  991.         Then you can use ARJ or any other DOS backup scheme to backup
  992.         your system including the BACKUP.LFN.
  993.  
  994.         CAUTION: Please check the version of DOSLFNBK you are using.  Some
  995.         versions do not support FAT32 partitions.
  996.  
  997.         Here is a brief list of steps to backup and restore:
  998.  
  999.         1) Make a Win9x startup diskette.
  1000.         2) Shutdown to MS DOS mode.
  1001.         3) While you are on the C: drive, execute "DOSLFNBK C:\".
  1002.            Change to the D: drive (if any) and execute "DOSLFNBK D:\".
  1003.            Execute DOSLFNBK for each drive on each drive.
  1004.         4) Use ARJ or other DOS backup program to backup ALL of the files.
  1005.            Example:  ARJ a A:backup C:\*.* D:\*.* -r -a1 -jt1 -va -jf
  1006.            CAUTION: For important backups, we always make TWO BACKUPS of
  1007.            our system.  All too often, one or more files will not restore
  1008.            correctly because of some data error (MURPHY'S LAW in action).
  1009.         5) Save ARJ.EXE or your backup program to diskettes in a
  1010.            restorable form.
  1011.         6) Backup finished.
  1012.  
  1013.  
  1014.         1) Boot from your Win9x startup diskette.
  1015.         2) Execute "SYS C:" from the A: drive to re-install the boot.
  1016.         3) Install ARJ.EXE or your backup program on the hard drive.
  1017.         4) Restore all of the files.
  1018.            Example:  ARJ x A:backup -v -jf -y -ha
  1019.         5) On each drive, execute "DOSLFNBK /r" to restore the long
  1020.            filenames.
  1021.         6) Restore finished.
  1022.  
  1023.  
  1024.      WINDOWS NT AND 2000 SUPPORT
  1025.  
  1026.         ARJ will run in a command prompt window in NT and 2000.  Please 
  1027.         note that ARJ does not support long filenames in Windows NT or
  1028.         Windows 2000.  However, there is a option "-h$" that forces ARJ
  1029.         to use long filenames in Windows 2000.  ARJ uses an undocumented
  1030.         feature of Windows 2000 to do this.
  1031.  
  1032.         ARJ32 fully supports long filename use in Windows NT and Windows
  1033.         2000.  In addition, ARJ32 supports restoration of directory 
  1034.         date-time stamps only in Windows NT and 2000.  Windows 9x/Me do
  1035.         not provide support for this type of directory access.
  1036.  
  1037.  
  1038.      UNIVERSAL NAMING CONVENTION (UNC)
  1039.  
  1040.         ARJ supports archiving filenames using UNC paths.  By default, ARJ
  1041.         will remove the leading "\\" symbols to allow ARJ to treat the
  1042.         pathname as a relative pathname.  The use of the "-jf" option will
  1043.         set ARJ to keep the "\\" symbols.  The "-jf1" will remove the
  1044.         leading "\\" symbols.  UNC pathnames stripped of the "\\" can be
  1045.         restored to their network paths with "ARJ x archive \\".
  1046.  
  1047.  
  1048.      ARJ VOLUME NAMING OPTIONS
  1049.  
  1050.         By default, ARJ has been naming subsequent volumes in a multiple
  1051.         volume archive by using a numeric file extension (archive.ARJ,
  1052.         archive.A01, archive.A02, and so on).  Because the file extension
  1053.         changes, this naming scheme may not be appropriate in an Internet
  1054.         environment.  Some browsers will not properly download an ARJ
  1055.         archive with the normal LEFT mouse click.  Most browsers will
  1056.         properly download an EXE file with a LEFT mouse click.
  1057.  
  1058.         New to ARJ 2.71 and ARJ32 3.04 is an OPTIONAL naming scheme that
  1059.         maintains the initial file extension (EXE or ARJ) and numbers the
  1060.         filenames.  This option is set with the "e" option for "-v".
  1061.  
  1062.         Examples:  ARJ a archive -ve1440        =>
  1063.                        archive.ARJ, arch001.ARJ, arch002.ARJ, ....
  1064.                    ARJ a archive -je -ve1440    =>
  1065.                        archive.EXE, arch001.EXE, arch003.EXE, ....
  1066.                    ARJ a name001 -je -ve1440    =>
  1067.                        name001.EXE, name002.EXE, name003.EXE, ....
  1068.  
  1069.         If the base archive name ends with a number, ARJ will use that
  1070.         number as the base volume number.
  1071.  
  1072.         When building a multiple volume self-extractor using the "-ve"
  1073.         option, ARJ will put the self-extractor ONLY in the first volume.
  1074.         Subsequent EXE volumes include an EXE stub that displays a usage
  1075.         message.
  1076.  
  1077.         Versions of ARJ before 2.71 and ARJ32 before 3.04 will not be
  1078.         able to process this alternately named multiple volume archive.
  1079.  
  1080.  
  1081.      ARJ-PROTECT DATA PROTECTION FEATURE:
  1082.  
  1083.         With this version, ARJ can repair "protected" archives that suffer
  1084.         from slight amounts of data damage (CRC error, bad header, etc).
  1085.         An ARJ archive is "protected" with the "-hk" option.  With the
  1086.         "-hk" option, ARJ will generate ARJ damage protection data.  This
  1087.         data is appended to the protected archive.  This data is REQUIRED
  1088.         in order to repair damaged ARJ archives.  The size of this data
  1089.         ranges from a minimum of 4K bytes and larger.  For larger
  1090.         archives, the protection data size is typically less than one
  1091.         percent of the archive file size.  Before this release, the
  1092.         ARJ-PROTECT was saved in a separate .XRJ file.
  1093.  
  1094.         At this release, ARJ sets an AUTO ARJ-PROTECT flag within a
  1095.         protected archive (except for ARJ-SECURED archives), so that
  1096.         future updates to the archive will include ARJ-PROTECTION.  "ARJ y
  1097.         archive -hk" can be used to clear that flag.
  1098.  
  1099.         This protection feature is sector based and allows repair due to
  1100.         typical types of disk corruption (bad sector, virus damage, cross
  1101.         links, etc).  This type of sector protection is NOT effective for
  1102.         most data transmission problems where data is missing from the
  1103.         middle of a transmission.
  1104.  
  1105.         It is STRONGLY recommended that ARJ-PROTECT be used on archives of
  1106.         important data and on archives on diskettes.  The majority of
  1107.         reports of archive damage is due to diskette errors.
  1108.  
  1109.         Technically, this protection feature uses a series of XOR sums and
  1110.         checksums in order to allow repairs.  Larger archives are
  1111.         logically treated as several streams of data.  ARJ can protect
  1112.         each "stream" from one or two damaged sections 1024 bytes in size.
  1113.         However, for large archives (1 MB or larger) ARJ can sometimes
  1114.         repair up to four damaged sections per MByte.  The "-hk1, "-hk2"
  1115.         .... "-hk20" options can offer more data protection at the cost
  1116.         of a proportionately larger protection data.
  1117.  
  1118.         The "-hk" option sets ARJ to build a protected archive.  The "q"
  1119.         command is used to repair a damaged archive.  The repaired archive
  1120.         is named ARJFIXED.ARJ.  The original damaged archive is not
  1121.         modified.
  1122.  
  1123.         Example:  ARJ a archive -hk       ARJ-PROTECTED
  1124.                   ARJ q archive           repairs archive.ARJ
  1125.  
  1126.         If ARJ detects slightly damaged ARJ-PROTECT recovery data, it will
  1127.         display a warning.  The archive should be re-protected
  1128.  
  1129.         Example:  ARJ y archive -hk      remove ARJ-PROTECT
  1130.                   ARJ t archive -hk      restore ARJ-PROTECT
  1131.  
  1132.  
  1133.      ARJ ANSI COMMENT HANDLING:
  1134.  
  1135.         As of version 2.55, ARJ will use its own ANSI sequence display
  1136.         handler to display ARJ comments.  In previous versions, ARJ
  1137.         depended upon the "-ja" option and an installed ANSI.SYS driver to
  1138.         handle the ANSI escape sequences.  The "-ja" option has a new
  1139.         function now. The "-ja" option will set the "P" command to display
  1140.         files using the new ANSI sequence display handler.
  1141.  
  1142.         The ARJSFXV module (-je -v) also will display ANSI comments now.
  1143.  
  1144.         Please note that the ARJ comment field size is limited to about 2K
  1145.         bytes.
  1146.  
  1147.  
  1148.      THE FILESPEC "...":
  1149.  
  1150.         Several times in this document and the UPDATE.TXT file, there is
  1151.         mention of the filespec "..." (not to be confused with my use of
  1152.         "...." in this document to mean "and so on").  This filespec is
  1153.         chosen so as not to match any existing filename.  ARJ will NOT
  1154.         generate an error or warning for not matching "..." specifically.
  1155.  
  1156.         This is a problem when using ARJ on a NOVELL network as the
  1157.         filespec "..." is a valid directory name.  A partial workaround
  1158.         is to specify a non-existent filespec such as "@@@" in place of
  1159.         "...".  Or you may use the "-hn" option to specify a name that is
  1160.         not to match any filename.
  1161.  
  1162.  
  1163.      ARJ ERROR SITUATIONS:
  1164.  
  1165.         ADD:
  1166.  
  1167.         If a user specified file is not found during an add, ARJ will
  1168.         continue processing, and will keep the archive and terminate with
  1169.         an error condition.  Note that files specified within an ARJ
  1170.         listfile that are not found during an add will NOT trigger an error
  1171.         unless the "-hl" option is also specified.
  1172.  
  1173.         In a disk full condition or any other file i/o error, ARJ will
  1174.         promptly terminate with an error condition and delete the temporary
  1175.         archive file unless the user has specified the "-jk" switch.
  1176.  
  1177.  
  1178.         MOVE:
  1179.  
  1180.         ARJ will only delete files that have been successfully added to the
  1181.         archive.  If you have specified the "-jt" (test) switch, ARJ will
  1182.         abort on any error.  If you specify the "-jk" switch, ARJ will keep
  1183.         the temporary archive upon an abort.
  1184.  
  1185.  
  1186.         EXTRACT:
  1187.  
  1188.         In a disk full condition or any other file i/o error, ARJ will
  1189.         promptly terminate with an error condition and delete the current
  1190.         output file.
  1191.  
  1192.  
  1193.         CRC ERRORS OR BAD FILE DATA:
  1194.  
  1195.         In the case where an ARJ archive has been corrupted, ARJ will
  1196.         report a CRC error or a Bad file data error.  These corruptions can
  1197.         be the result of an unreliable diskette, a computer memory problem,
  1198.         a file transfer glitch, or incompatible CACHING software. Most of
  1199.         these errors are the result of file transfer glitches and bad
  1200.         diskettes.  A few are the result of an incompatible interaction
  1201.         with SUPER PCKWIK 3.3 advanced diskette support or Windows 3.x.
  1202.  
  1203.         Individual files in an archive that are affected by the CRC or Bad
  1204.         file data errors CANNOT be recovered in an undamaged state.  Other
  1205.         files in a damaged archive can be recovered by extracting them
  1206.         using the "-jr" option.
  1207.  
  1208.         However, with some preventative action as in the use of the "-hk"
  1209.         option to generate a data damage protected archive, slightly
  1210.         corrupted ARJ archives can be fully repaired and all damaged files
  1211.         recovered in an undamaged state.
  1212.  
  1213.  
  1214.         CRITICAL ERROR HANDLER:
  1215.  
  1216.         ARJ sets up an interactive critical error handler to handle DOS
  1217.         critical errors like "sector not found" and "drive not ready". When
  1218.         a critical error occurs, ARJ will prompt the user with the message
  1219.         "Retry Y/N?".  The user may retry the failed operation by pressing
  1220.         "Y".  Pressing "N" will fail the operation or abort to DOS
  1221.         depending upon the version of DOS.  The user can press Control
  1222.         BREAK to abort to DOS.
  1223.  
  1224.  
  1225.      ARJ DOS ERRORLEVELS:
  1226.  
  1227.         ARJ returns a number of DOS errorlevels for different situations.
  1228.  
  1229.         0 ->   success
  1230.         1 ->   warning (specified file to add to archive not found,
  1231.                         specified file to list, extract, etc., not found,
  1232.                         or answering negatively to "OK to proceed to next
  1233.                         volume...." prompt)
  1234.         2 ->   fatal error
  1235.         3 ->   CRC error (header or file CRC error)
  1236.         4 ->   ARJ-SECURITY error or attempt to update an ARJ-SECURED archive
  1237.         5 ->   disk full or write error
  1238.         6 ->   cannot open archive or file
  1239.         7 ->   simple user error (bad parameters)
  1240.         8 ->   not enough memory
  1241.         9 ->   not an ARJ archive
  1242.        10 ->   XMS memory error (read or write)
  1243.        11 ->   user control break
  1244.        12 ->   too many chapters in archive
  1245.  
  1246.         Please note that DOS batchfiles have a unique method of testing
  1247.         for a DOS errorlevel.  The batch statement IF ERRORLEVEL 0 ....
  1248.         means if the errorlevel is EQUAL TO or GREATER THAN 0.  Generally,
  1249.         one should test for the highest possible errorlevels first and
  1250.         proceed lower as in:
  1251.  
  1252.         ARJ a archive *.*
  1253.         if errorlevel 9 goto not_arj
  1254.         if errorlevel 8 goto no_memory
  1255.         .
  1256.         .
  1257.         .
  1258.         if errorlevel 1 goto minor_error
  1259.         type ARJ command successful
  1260.  
  1261.  
  1262.      ARJ USER ACTION PROMPTS:
  1263.  
  1264.         ARJ prompts the user for action at certain times.  There are
  1265.         several types of prompts.  One is for yes/no permission, another is
  1266.         for a new filename, another is for archive comments, and one other
  1267.         is for search strings.
  1268.  
  1269.         The ARJ yes/no user prompts provide a lot of flexibility.  In
  1270.         addition to the normal yes and no responses, ARJ also accepts the
  1271.         following responses: quit, always, skip, global, and command.
  1272.  
  1273.         "Global" sets ARJ to inhibit all subsequent user prompts by assuming
  1274.         YES for all queries as if "-y" were specified.
  1275.  
  1276.         "Always" sets ARJ to assume YES for subsequent queries of the same
  1277.         class.  For example, answering ALWAYS to the overwrite query will
  1278.         assume YES for ALL subsequent overwrite queries.
  1279.  
  1280.         "Skip" sets ARJ to assume NO for ALL subsequent queries of the same
  1281.         class.
  1282.  
  1283.         After "always" or "skip" responses, subsequent user prompt
  1284.         messages will still be output to the screen but no user response
  1285.         will be accepted.
  1286.  
  1287.         "Command" prompts for one DOS command and then executes it.  ARJ
  1288.         then returns to expect an answer to the current yes/no query.  You
  1289.         should keep the query in mind as ARJ does NOT always redisplay
  1290.         the full query message.
  1291.  
  1292.         Since ARJ uses STDIN for user input, be careful about typing ahead
  1293.         anticipating prompts.  ARJ may prompt you for an unexpected action
  1294.         and use your earlier input.
  1295.  
  1296.         The "-jyy" option lets you change the prompting modes to single
  1297.         character query mode.  See the section on "-jy" for more
  1298.         information.
  1299.  
  1300.  
  1301.      ARJ ENVIRONMENT VARIABLE/CONFIGURATION FILE:
  1302.  
  1303.         ARJ will first look for an environment variable named ARJ_SW and
  1304.         use its value as switch options for ARJ.  If ARJ finds such an
  1305.         environment variable, it will display a message to that effect.
  1306.  
  1307.         You can inhibit ARJ from using this environment variable by using
  1308.         the "-+" option.  You can also set the name of the environment
  1309.         variable with the "-+" option as in ARJ a -+ARJ_SW2 archive.
  1310.  
  1311.         SET ARJ_SW=<switches>
  1312.  
  1313.         Example:  SET ARJ_SW=-w\temp -k -e
  1314.  
  1315.         Do NOT add any blanks after the variable name ARJ_SW.  As in LHARC,
  1316.         command line switches can be selected to override ARJ_SW settings.
  1317.  
  1318.         ARJ32 uses ARJ32_SW as its default variable.
  1319.  
  1320.         ARJ will allow you to use a different switch character "-" or "/"
  1321.         in ARJ_SW and in the command line except when using the "-ju"
  1322.         (unix) option.
  1323.  
  1324.         If the ARJ_SW environment variable specifies a filename (text not
  1325.         beginning with a switch character), ARJ will open that filename and
  1326.         scan it looking for a line of text that begins in column 1 with the
  1327.         same letter as the ARJ command being executed.  The following text
  1328.         is processed as the ARJ_SW switches.  This allows each ARJ command
  1329.         to have its own switch settings.  In addition, ARJ will also look
  1330.         for the "+" (plus) symbol in column 1 to use as a miscellaneous
  1331.         switch string.  This string will be added to any command switch
  1332.         string found if any.  If no command switch string is found, ARJ
  1333.         will use the miscellaneous switch string as the ARJ_SW switch
  1334.         settings.  NOTE that the "+" switch settings will NOT be used if
  1335.         the "+" string occurs below the command switch string.
  1336.  
  1337.         New at ARJ 2.73 and ARJ32 3.06 is the "-" (minus) symbol in column
  1338.         1 to use as a miscellaneous switch string.  It works similar to the
  1339.         "+" symbol EXCEPT that the following switch string is prepended to
  1340.         any subsequent command switch string.  The "+" symbol causes its
  1341.         switch string to be appended.  This affects switch processing.
  1342.  
  1343.         SET ARJ_SW=C:\ARJ\ARJ.CFG
  1344.  
  1345.         C:\ARJ\ARJ.CFG contains:
  1346.         a -jm1 -jt -i1
  1347.         c -zcomment.txt
  1348.         + -jv
  1349.         l -jp
  1350.         e -i1
  1351.  
  1352.         AND is equivalent to:
  1353.         a -jm1 -jt -i1
  1354.         c -zcomment.txt
  1355.         l -jp -jv
  1356.         e -i1 -jv
  1357.         f -jv
  1358.         v -jv
  1359.         all other commands use -jv
  1360.  
  1361.         In the above example, any ARJ "a" commands will use "-jm1 -jt -i1"
  1362.         as the ARJ_SW switch options.
  1363.  
  1364.         C:\ARJ\ARJ.CFG contains:
  1365.         a -jm1 -jt -i1
  1366.         - -i
  1367.         l -jp
  1368.         e -i-
  1369.  
  1370.         AND is equivalent to:
  1371.         a -jm1 -jt -i1
  1372.         l -jp -i
  1373.         e -i -i-
  1374.         all other commands use -i
  1375.  
  1376.         In the above example, the "e" command switch is chosen to cancel
  1377.         the general "-i" option.  This feature would not work using the
  1378.         "+" symbol instead of the "-" symbol.  The "-" symbol is likely
  1379.         more useful than using the "+" symbol.
  1380.  
  1381.         The ARJ_SW variable or the ARJ_SW configuration file switch
  1382.         settings may NOT have quoted switches such as "-vasformat a:".
  1383.  
  1384.         As of this release, ARJ will also accept the commands "ac", "cc",
  1385.         "dc", "lc", and "vc" in the ARJ configuration file.
  1386.  
  1387.         SET ARJ_SW=C:\ARJ\ARJ.CFG
  1388.  
  1389.         C:\ARJ\ARJ.CFG contains:
  1390.         a  -jm1 -jt -i1
  1391.         ac -jm -jt
  1392.         dc -jt
  1393.  
  1394.  
  1395.      ARJ COMMAND LINE SYNTAX:
  1396.  
  1397.         ARJ <command> [-<switch>[-|+|<option>]....] <archive_name>[.ARJ]
  1398.         [<base_directory_name>\] [<!list_name>|<path_name>|<wild_name>....]
  1399.  
  1400.         or
  1401.  
  1402.         ARJ @response_filename [-&] | [-+] | [-+environment_variable] |
  1403.         [-gpassword] | [-g?]
  1404.  
  1405.  
  1406.         Commands and switches can be entered in upper or lower case.
  1407.         Switches can be placed anywhere after the command ARJ.
  1408.  
  1409.         ARJ supports the use of either "-" or "/" as the switch option
  1410.         character.  The first occurrence of either "-" or "/" that ARJ
  1411.         encounters in the ARJ_SW variable will determine the switch symbol
  1412.         for processing ARJ_SW.  The first occurrence of either "-" or "/"
  1413.         that ARJ encounters in the command line will determine the switch
  1414.         symbol for processing the command line except when the "-ju" (unix)
  1415.         option has been specified in ARJ_SW.  You may NOT mix and match
  1416.         switch symbols.  Throughout this document, the symbol "/" may be
  1417.         substituted for "-" in switch usage.
  1418.  
  1419.         Examples:  ARJ a A:archive *.* /va /r    is correct
  1420.                    ARJ a A:archive *.* /va -r    IS INCORRECT USAGE!
  1421.  
  1422.         Switches specified on the command line will either toggle or
  1423.         override switches specified with the ARJ_SW environment variable.
  1424.         Switch usage is identical to that of LHARC.
  1425.  
  1426.         "-s+"        turns on switch "s".
  1427.         "-s-"        turns off switch "s".
  1428.         "-s"         toggles the state of switch "s".
  1429.         "-sname"     provides the name argument for switch "-s".
  1430.         "--"         skip processing of any more switch options.
  1431.  
  1432.         Switch options CAN be combined to save command line length.
  1433.         However, some switch options take optional string arguments and
  1434.         therefore, must be the last option in a combined argument token
  1435.         string because ARJ accepts the rest of the argument token as the
  1436.         optional argument.  You can combine "-r" and "-i" to make "-ri".
  1437.         You can combine "-wd:\" and "-i" with "-iwd:\", because the switch
  1438.         option taking the string argument is last.  Please note that
  1439.         switches that ONLY accept the "+", "-", "0", "1", "2" modifiers can
  1440.         be combined in any order.  The following switches must be last in a
  1441.         combined switch argument:  -g, -l, -m, -o, -t, -v, -w, -x, -z,
  1442.         -!, -$, -h#, -hb, -hc, -hg, -hk, -hm, -hn, -hx, -jb, -jc, -jd,
  1443.         -jh, -ji, -jn, -jq, -jp, -js, -jw, -jx, -jy, -jz.
  1444.  
  1445.         WARNING:  The "j" in "-jX" option switches is a SHIFT symbol.
  1446.         Therefore, a combined "-jatv" is a combination of "-ja", "-jt", and
  1447.         "-jv", since the "j" shifts the meaning of subsequent symbols in
  1448.         the argument token string.  The use of more than ONE "j" shift
  1449.         symbol per argument token string is NOT supported for future
  1450.         versions.
  1451.  
  1452.         Examples:  -rijvta   <=>  -r -i -jv -jt -ja
  1453.                    -i1kwd:\  <=>  -i1 -k -wd:\
  1454.  
  1455.         ARJ will accept an ending "-" on most switches such as "-w-".  The
  1456.         "-x" switch option is one exception.  The one caveat is that for
  1457.         switches that support an optional argument such as "-wd:\" or
  1458.         "-t1", that switch option must NOT be followed by a concatenated
  1459.         switch option such as "-w-r".  An argument token string such is
  1460.         "-rikw-" is acceptable because the "-w" option is the last one. One
  1461.         special switch combination is the "-jyyr" combination.  You can
  1462.         turn off the "y" and "r" modifiers with "-jyyr-".
  1463.  
  1464.         The switch option "--" tells ARJ that there are no more switch
  1465.         options to process in the current command line.  This is useful
  1466.         when you need to enter filenames beginning with "-".
  1467.  
  1468.         Example:  ARJ a archive -- -testfile
  1469.  
  1470.         The standard ARJ file suffix is ".ARJ".  Subsequent multiple 
  1471.         volume archives end in ".A01", ".A02", etc, up to .A99, .100, .101 
  1472.         to .999. It is possible to have multiple volumes start at ".001" 
  1473.         and go up to ".999".
  1474.  
  1475.         The ARJ command must be the first non-switch argument after "ARJ".
  1476.         The ARJ archive name must be the first filename on the command
  1477.         line.  The base directory, if any, must be the second filename
  1478.         argument.  The switches and other filenames can be in any order.
  1479.         The base directory name should end with "\" (backslash) or ":"
  1480.         (colon).  However, ARJ will still accept directory names without
  1481.         the "\" character if the directory already exists.  This feature is
  1482.         limited to the add type and extract type commands.
  1483.  
  1484.         Wild_names follow MS-DOS convention.  "*.*" means all files.
  1485.         "*.DOC" means all files with an extension of ".DOC".  "?B*.*"
  1486.         means all files with a second character of "B".
  1487.  
  1488.         The default for <wild_name> for all commands except for "d" is
  1489.         "*.*".
  1490.  
  1491.         For the add, move, freshen and update commands, filename matching
  1492.         in the archive requires an exact path match depending upon the "-e"
  1493.         option.  For non-update commands, specified filenames with paths
  1494.         will force a full pathname match.
  1495.  
  1496.         You can specify one or more filenames for files containing lists of
  1497.         files to be added to an archive.  The filenames must be listed one
  1498.         per line with no leading or trailing blanks.  The list filename(s)
  1499.         must be prefixed with "!".  If you want to archive a filename
  1500.         beginning with !, you must use the "-!" option to set a new list
  1501.         file character.
  1502.  
  1503.         You can exclude filenames/wildnames from the list of filenames to
  1504.         be processed by ARJ.
  1505.  
  1506.         Example:  ARJ a software *.* -x*.exe -x*.obj   adds all files
  1507.         in the current directory except .EXE and .OBJ files.
  1508.  
  1509.         REMINDER: When specifying filenames with embedded blanks or
  1510.         symbols like ">", "<", or "|" on the command line, you MUST
  1511.         quote the filenames.
  1512.  
  1513.         Examples:  ARJ a archive "C:\Program Files\*.*" -r
  1514.                    ARJ c archive "<<<*" -jz -jb
  1515.  
  1516.  
  1517.      ARJ RESPONSE FILE SYNTAX:
  1518.  
  1519.         ARJ @response_filename [-&] | [-+] | [-+environment_variable] |
  1520.         [-gpassword] | [-g?]
  1521.  
  1522.         ARJ will accept an ARJ command line from a response file as in
  1523.         "ARJ @command.rsp".  The "@" symbol indicates that the appended
  1524.         name is the name of the response file.  In this case, the file is
  1525.         command.rsp. The response file symbol cannot be changed. Only one
  1526.         ARJ command line can be processed per response file.
  1527.  
  1528.         The response file should contain the ARJ command line minus the
  1529.         initial "ARJ".  The command line may be split over as many lines as
  1530.         necessary.  The response file feature will NOT accept QUOTED
  1531.         command line options.  Options with embedded blanks ("-vasTEST X")
  1532.         will not be processed as expected.  See the "-@" option for help on
  1533.         options with blanks.  When using the response file feature, ARJ
  1534.         will accept only the "-+", "-&", "-g" switch options on the DOS
  1535.         command line along with the response file name.  All other command
  1536.         options must be specified in the response file or in the ARJ
  1537.         environment variable.
  1538.  
  1539.         To better support long filenames, ARJ provides the "-@" option to
  1540.         handle the processing of filenames and switch options that contain
  1541.         embedded spaces.  The "-@" switch option enables the interpretation
  1542.         of a text line in an ARJ response file as a single token.  In other
  1543.         words, when ARJ scans an "-@" option, it will process the NEXT text
  1544.         line in the response file as a single token including all embedded,
  1545.         leading, and trailing blanks.  ARJ will continue to process each
  1546.         subsequent text line in the same manner.  If ARJ scans a subsequent
  1547.         "-@" option, ARJ will revert to its normal multiple tokens per line
  1548.         processing.
  1549.  
  1550.         PLEASE NOTE THAT THE ARJ COMMAND LINE WHETHER OR NOT IN THE
  1551.         RESPONSE FILE IS STILL LIMITED TO 64 FILENAMES OR WILDNAMES.  THE
  1552.         LISTFILE FEATURE SHOULD BE USED TO SPECIFY MORE THAN 64 FILENAMES
  1553.         OR WILDNAMES.
  1554.  
  1555.  
  1556.      ARCHIVE NAME WILDCARDING:
  1557.  
  1558.         You can specify a wildcard for the archive name such as "*.ARJ" for
  1559.         all ARJ commands except for the add commands (a, f, j, m, u).  If
  1560.         you also specify the "-r" switch,  ARJ will search subdirectories
  1561.         for ARJ archives (*.ARJ) also.
  1562.  
  1563.         Example:  ARJ l -r *             will list all of your *.ARJ files.
  1564.                   ARJ c *.arj -zbbs.cmt  will comment all of your archives.
  1565.  
  1566.         As of 2.55c, the list of filenames that ARJ builds internally for
  1567.         archiving is now affected by the "-o" and "-b" and "-hb" options.
  1568.  
  1569.         Prior to 2.55c, ARJ would include all matching filenames in its
  1570.         internal list regardless of the "-o" and "-b" settings.  Then
  1571.         during archival, ARJ would select from its internal list based upon
  1572.         the "-o" and "-b" and "-hb" options.
  1573.  
  1574.         Now ARJ uses the "-o" and "-b" and "-hb" options while it is
  1575.         building the internal list.  The advantage with this method is the
  1576.         need for less memory to handle fewer files.
  1577.  
  1578.         For example, when doing a full backup of the C drive, ARJ builds an
  1579.         internal list of filenames for all of the files on drive C.  When
  1580.         doing an incremental backup (-b, -b1), ARJ builds a list of
  1581.         filenames for only the files that have the archive bit set.  In
  1582.         prior versions of ARJ, ARJ would build the same list regardless of
  1583.         the "-b" setting.
  1584.  
  1585.         ARJ wildcarding can differ according to the operating system
  1586.         environment.  When scanning the file system for filenames to
  1587.         add/update an archive, ARJ uses the internal operating system
  1588.         wildcard matching functions. When scanning an ARJ archive (list,
  1589.         extract and so on), ARJ uses its own wildcard matching function.
  1590.         This internal ARJ function is identical to the standard DOS
  1591.         wildcard matching.
  1592.  
  1593.         Windows 9x and Windows NT/2K use a slightly more complex wildcard
  1594.         matching function.  In Windows 9x, it is possible to specify a
  1595.         wildcard specification of "a*d*t".  This would match ARJDISP.BAT,
  1596.         ARJDISP.TXT, and others.
  1597.  
  1598.         As of ARJ 2.81, ARJ will handle up to 50,000 filenames in its
  1599.         internal list (higher for registered versions).  Because ARJ
  1600.         checks for duplicate filenames when necessary, processing over
  1601.         20,000 filenames may slow down as the number of filenames
  1602.         processed increase.  (As of 2.81/3.10, this duplicate checking is
  1603.         disabled when processing over 65,500 filenames at one time).  ARJ
  1604.         processes wildcards most efficiently when specified as separate
  1605.         command line wildcards inclusive of drive letters.
  1606.  
  1607.         Example: ARJ a backup C:\*.* D:\*.* E:\*.* -r -a1
  1608.  
  1609.         If each drive letter is unique, ARJ will not need to check for
  1610.         duplicates and can proceed faster.  This speedup does not work when
  1611.         using listfiles.
  1612.  
  1613.  
  1614.      ARJ COMMANDS:
  1615.  
  1616.         ac: Add Chapter to archive
  1617.  
  1618.            This is a new two character command for ARJ.  It is actually an
  1619.            abbreviation for the following command and switch options: "u
  1620.            -u2 -jb".  The "ac" command will add a chapter backup to a new
  1621.            archive or add a new chapter (updating) to a chapter archive. A
  1622.            chapter backup will consists of files that are DIFFERENT
  1623.            (different date-time or size).
  1624.  
  1625.            Example:  ARJ ac archive c:\dir\*.* -r -jt
  1626.  
  1627.            Please note that this help document usually refers to the
  1628.            standard commands and not to this and the following chapter
  1629.            command abbreviations.
  1630.  
  1631.            The advantage of a chapter archive is that you can make numerous
  1632.            full backups (chapters) to a SINGLE archive.  Major space
  1633.            savings will result when some files do not change from backup to
  1634.            backup.
  1635.  
  1636.            See the "-jb" option for more details.
  1637.  
  1638.            Adding a new chapter adds a chapter label entry in the archive.
  1639.            Each volume of a chapter archive will be so labeled.
  1640.  
  1641.            There is a limit of 250 chapters per archive.
  1642.  
  1643.            Please note that the "ac" command abbreviation is dependent upon
  1644.            file sizes and file date-time stamps.  Modifying file date-time
  1645.            stamps with no relation to the system time may cause chapter
  1646.            update problems.  In addition, changing the system time
  1647.            significantly may also cause chapter update problems.
  1648.  
  1649.            If you are using chapter archives to store files in TEXT MODE
  1650.            "-t1", you should use the command and options "u -u4 -jb"
  1651.            instead of the "ac" command.
  1652.  
  1653.        cc: Convert standard archive to Chapter archive
  1654.  
  1655.            This is a new two character command for ARJ.  It is actually an
  1656.            abbreviation for the following command and switch option:
  1657.            "y -jb".  The "cc" command will convert a standard ARJ archive
  1658.            to a chapter archive.
  1659.  
  1660.            Example:  ARJ cc archive
  1661.  
  1662.            For a multiple volume archive, it is necessary to specify the
  1663.            size of the volumes with the "cc" command.
  1664.  
  1665.            Example:  ARJ cc archive -v1440
  1666.  
  1667.        dc: Delete last Chapter from archive
  1668.  
  1669.            This is a new two character command for ARJ.  It is actually an
  1670.            abbreviation for the following command and switch option:
  1671.            "d -jb".  The "dc" command will delete the last chapter in an
  1672.            archive.  The "*.*" filespec MUST be specified.
  1673.  
  1674.            Example:  ARJ dc archive *.*
  1675.  
  1676.            You should not specify other switches that may interfere with
  1677.            the complete removal of the last chapter such as the "-q"
  1678.            option.
  1679.  
  1680.        lc: List Chapter labels in archive
  1681.  
  1682.            This is a new two character command for ARJ.  It is actually an
  1683.            abbreviation for the following command and switch option:
  1684.            "l -jb* -hbc".  The "lc" command will list the chapter labels
  1685.            stored in the archive.
  1686.  
  1687.            This is a quick way to see what backup chapters are stored in the
  1688.            archive and when they were created.
  1689.  
  1690.            Example:  ARJ lc archive
  1691.  
  1692.        vc: Verbosely list Chapter labels
  1693.  
  1694.            This is a new two character command for ARJ.  It is actually an
  1695.            abbreviation for the following command and switch option:
  1696.            "v -jb* -hbc".  The "vc" command will list the chapter labels
  1697.            and comments stored in the archive.
  1698.  
  1699.            This is a quick way to see what backup chapters are stored in the
  1700.            archive and when they were created as well as any comments about
  1701.            those chapters.
  1702.  
  1703.            Example:  ARJ vc archive
  1704.  
  1705.         a: Add files to archive
  1706.  
  1707.            This is the basic command to add disk files to an ARJ archive.
  1708.            You can specify 0 to 64 filename arguments (one can be a
  1709.            destination directory).  The arguments can be wildnames.  If
  1710.            you specify the "-r" switch (recurse subdirectories), ARJ
  1711.            will add all of the files in all of the subdirectories that
  1712.            match the specified wildname.
  1713.  
  1714.            Example:  ARJ a archive subdir\*.*
  1715.                      Archive all files in directory "subdir".
  1716.  
  1717.            For maximum compression, use the "-jm" switch option.
  1718.  
  1719.         b: execute Batch or DOS command
  1720.  
  1721.            The ARJ b command allows a user to execute a DOS command on
  1722.            selected files in an archive.  The ARJ b command will prompt for a
  1723.            DOS command string to execute per selected file.  By default ARJ
  1724.            will extract the selected files to the filename ARJTEMP.$$$.  This
  1725.            filename can be changed with the "-jw" option.  The base directory
  1726.            option is ignored by the ARJ b command.  The output file will be
  1727.            deleted by ARJ after the DOS command is executed.
  1728.  
  1729.            Examples:  ARJ b archive
  1730.                       ARJ b archive file.exe -jwtemp\tempfile
  1731.  
  1732.            This option can substitute for a simple extract and run command
  1733.            where the file to be extracted is an executable.  You would specify
  1734.            a temporary executable name as the output name and use that name as
  1735.            the DOS command to be executed.
  1736.  
  1737.            Example:  ARJ b archive file.exe -jwTEMP.EXE
  1738.                      TEMP arguments
  1739.  
  1740.            You can specify the DOS command string on the command line with
  1741.            the "-jq" option.  Switch options which have embedded blanks
  1742.            must be enclosed by double quote marks.
  1743.  
  1744.            Examples:  ARJ b archive file.exe -jwTEMP.EXE -jqTEMP
  1745.                       ARJ b archive *.c "-jqgrep text ARJTEMP.$$$"
  1746.  
  1747.         c: Comment archive files
  1748.  
  1749.            This command allows you to comment the header and individual
  1750.            files.  ARJ will prompt you for each comment.  The user will be
  1751.            prompted for up to 25 lines for each comment.  A line containing
  1752.            only a [return] will terminate the comment.
  1753.  
  1754.            The user can choose to input comment data from a file by entering
  1755.            the comment filename preceded by an "!" as in "!archive.txt"
  1756.            starting in column 1 of the first comment line.  This file is
  1757.            read as a text file.  The lines in the text can be up to 2048
  1758.            bytes long.  Only the first 2048 bytes of the file will be
  1759.            accepted by ARJ.
  1760.  
  1761.            To erase a comment from an archive, type [space] [return] on the
  1762.            first comment line and [return] on the second comment line.
  1763.  
  1764.            To strip archive or file comments from an archive, you can use
  1765.            the NUL file feature of MS-DOS.
  1766.  
  1767.            Examples:  ARJ c archive -zNUL          strips archive comment
  1768.                       ARJ c archive name -jzNUL    strips comment for "name"
  1769.                       ARJ c archive -jzNUL         strips all file comments
  1770.                       ARJ c archive -zNUL -jzNUL   strips all comments
  1771.  
  1772.            To add only the archive comment and not file comments, use the
  1773.            following command:
  1774.  
  1775.            ARJ c archive -z
  1776.  
  1777.            To add only the archive comment at the command line, use the
  1778.            following command:
  1779.  
  1780.            ARJ c archive -zcomment.txt
  1781.  
  1782.            You may also comment an archive with the "a", "f", "m", "u"
  1783.            commands using the "-z" option.  The "-jz" option may not be
  1784.            used in the same manner.
  1785.  
  1786.            ARJ a -zcomment.txt archive *.txt
  1787.  
  1788.            For multiple volume archives, any comments should be brief
  1789.            unless you have reserved extra space for them.
  1790.  
  1791.         d: Delete files from archive
  1792.  
  1793.            This command allows you to delete files from the archive.  When
  1794.            wildcard selection is not suitable, you can use the "-q" switch
  1795.            to set ARJ to prompt you for deletion for each file selected.
  1796.            These deleted files are physically removed from the archive.
  1797.  
  1798.            Example:  ARJ d archive *.c
  1799.                      Delete all files in archive ending in ".c".
  1800.  
  1801.                      ARJ d -q archive *.c
  1802.                      Prompt before deleting each file ending in ".c".
  1803.  
  1804.            If specify "*.*" as the filespec, ARJ will prompt for permission
  1805.            to delete.  You can specify the "-y" or "-jyd" options to
  1806.            inhibit the delete prompt.
  1807.  
  1808.            If ARJ removes all files from an archive, it will delete the
  1809.            empty archive EXCEPT for multiple volume archives.
  1810.  
  1811.            The delete command normally only deletes files of the last 
  1812.            chapter in chapter archives.
  1813.  
  1814.            You can specify the "-n" (new) option to delete the files in the
  1815.            archive that DO NOT EXIST on the disk.  You can use the same
  1816.            "-n" option with "ARJ l" to list the files that DO NOT EXIST on
  1817.            the disk.  This is useful in synchronizing an archive to a
  1818.            directory along with an update command.
  1819.  
  1820.            Examples:  ARJ d archive *.* -n
  1821.                       ARJ l archive temp\ *.doc -n
  1822.                       ARJ d archive temp\ *.doc -n
  1823.  
  1824.         e: Extract files from archive
  1825.  
  1826.            This command will extract one or more files from the archive to
  1827.            the current directory or base directory if specified.  ARJ will
  1828.            prompt the user before overwriting existing files unless the
  1829.            user specifies the "-y" switch.  If the user gives a "no"
  1830.            answer, ARJ will prompt for a new filename.  If the user enters
  1831.            a single [return] instead of a filename, ARJ will skip the
  1832.            current file extraction.
  1833.  
  1834.            Example:  ARJ e archive soft\ *.c
  1835.                      Extract all files ending in ".c" to subdirectory
  1836.                      "soft".
  1837.  
  1838.            When extracting a file located on multiple volumes, ARJ may
  1839.            prompt the user with an "Append? " prompt.  This will usually
  1840.            occur with files split across volumes.  You will also need to
  1841.            specify the "-v" switch to set ARJ to continue to the next
  1842.            volume of a series of volumes.  When extracting from one of a
  1843.            series of multiple volumes on a diskette, it is easier to use
  1844.            the wildcard "*.*" to specify the archive as in:
  1845.  
  1846.            ARJ e archive A:*.* filespecs
  1847.  
  1848.            If you wish to extract only a portion of an archive and that
  1849.            portion is a directory containing directories, you should use
  1850.            the "-p1" switch.  See the "-p" switch for more information.
  1851.  
  1852.            The ARJ e and ARJ x commands now accept the "-d" option to
  1853.            provide an extract and delete option.  This feature requires
  1854.            that you specify the files to extract and delete.  ARJ will NOT
  1855.            default to "*.*" for this option.  This option actually uses
  1856.            more disk space than a simple extraction because of the
  1857.            temporary archive that is created during the extraction process.
  1858.  
  1859.            ARJ e archive -d file1 file2
  1860.  
  1861.            If ARJ encounters a disk full during extraction, ARJ will abort
  1862.            with an error.  You can bypass the abort by using the "-jd"
  1863.            option.  Refer to the description of "-jd" for more information.
  1864.  
  1865.            If ARJ encounters a CRC or Bad file data error during
  1866.            extraction, ARJ will delete the corrupted extracted file unless
  1867.            the "-jr" option is used.
  1868.  
  1869.            With the "-ho" and "-ho1" options, you can extract files from an
  1870.            archive based upon the success or failure of a text string
  1871.            search.  Refer to the description of the "-ho" and
  1872.            "-ho1"options for details.
  1873.  
  1874.            Examples:  ARJ e archive -ho
  1875.                       ARJ e archive -ho -jq+3+textstring
  1876.  
  1877.         f: Freshen files in archive
  1878.  
  1879.            Update matching files in the archive that are OLDER than the
  1880.            selected disk files.
  1881.  
  1882.            Example:  arj f archive *.c *.h
  1883.  
  1884.            In freshening archives, you should use the same filename
  1885.            specifications that you used to create the archive.
  1886.  
  1887.            Example:  arj a archive \temp\ *.* -r
  1888.                      arj f archive \temp\ *.* -r
  1889.  
  1890.            If no files or comments have been added to the archive, ARJ
  1891.            will not rewrite the archive at ARJ 2.20 and above.
  1892.  
  1893.            When updating a file in an archive with a file that is NOT
  1894.            newer and if the -jv option is selected, ARJ will display a
  1895.            message that there is "no change".
  1896.  
  1897.         g: Garble files in archive
  1898.  
  1899.            The ARJ "g" command allows a user to garble an already built ARJ
  1900.            archive.  Please note that only ungarbled files will be garbled
  1901.            by the ARJ "g" command.
  1902.  
  1903.            Example:  ARJ g archive -gdinosaur
  1904.  
  1905.            ARJ also includes a "-hg" option to specify the use of a special
  1906.            powerful encryption routine.  There is a "-hg!" option to specify
  1907.            the use of a 40 bit encryption module.
  1908.  
  1909.            Some archives created with earlier ARJ versions cannot be
  1910.            "g"arbled.
  1911.  
  1912.         i: check Integrity of ARJ.EXE
  1913.  
  1914.            The "i" command allows the user to check the integrity of the
  1915.            ARJ.EXE program.  ARJ will report "CRC ERROR!" if the tested ARJ
  1916.            program does not pass its integrity check.  This indicates that
  1917.            the program is probably corrupted.  Please note that the "i"
  1918.            command should not be used on a compressed ARJ executable
  1919.            (DIETed, LZEXEd, etc.), since the "i" command will then ALWAYS
  1920.            report a CRC error.  If the program name is not specified, then
  1921.            ARJ will check the current program being executed.
  1922.  
  1923.            Syntax:  ARJ i ARJ.EXE
  1924.                     ARJ i            at DOS 3.0 and up
  1925.  
  1926.         j: Join archives to archive
  1927.  
  1928.            The "j" command allows the user to merge several ARJ archives.
  1929.  
  1930.            Syntax:  ARJ j archive archive1.arj archive2.arj
  1931.                     ARJ j archive *.arj -r
  1932.  
  1933.            Some switches NOT supported by the "j" command are:  -o, -ob,
  1934.            -f, -u, -c, -v.  Note that there is no error message displayed
  1935.            by ARJ when using an unsupported switch with the "j" command.
  1936.  
  1937.            The "-d" option IS supported by the "j" command.
  1938.  
  1939.            Note that switches that do work like "-x" select the archives to
  1940.            be merged and NOT the contents of the archives.
  1941.  
  1942.            This command can be used to convert an SFX module to a regular
  1943.            ARJ archive.
  1944.  
  1945.            Example:  ARJ j new_name arjsfx.exe
  1946.  
  1947.         k: purge chapter bacKup files in archive
  1948.  
  1949.            The ARJ k command works similar to the ARJ d command except that
  1950.            the ARJ k command only deletes files that are not in the last
  1951.            chapter.  The ARJ k command requires a wildname or filespec as a
  1952.            selection option.  This command will ONLY work with chapter
  1953.            archives.
  1954.  
  1955.            Examples:  ARJ k archive *.*
  1956.                       ARJ k archive *.doc -q
  1957.  
  1958.            The "k" command can be set to purge a specific number of 
  1959.            chapters using the "-jbN" option.
  1960.  
  1961.            Example:  ARJ k archive *.* -jb3      purge the first 3 chapters
  1962.         
  1963.         l: List contents of archive
  1964.  
  1965.            List contents of archive to standard output.  The display can be
  1966.            paused after each screenful with the "-jp" switch.  The files
  1967.            are listed in stored order.  There are no sort options
  1968.            currently.
  1969.  
  1970.            The last field on the display BTPMGVX stands for:
  1971.                B -> file not contained in the last chapter (obsolete file)
  1972.                T -> text/binary/directory/chapter/label type
  1973.                P -> path information available in "V" listing
  1974.                M -> compression method used
  1975.                G -> file has been garbled (encrypted)
  1976.                V -> archive has been continued to another volume
  1977.                X -> this file is an extended portion of a larger file
  1978.  
  1979.            Example:  arj l archive *.c *.h
  1980.  
  1981.            The "B" indicator shows files that are not contained in the last
  1982.            chapter backup of a chapter archive.  These files are removed
  1983.            when a purge (K command) is executed.
  1984.  
  1985.            For text mode compression, the original file size reported by
  1986.            the "l" and "v" commands is the actual number of bytes input.
  1987.            This is usually the MS-DOS file size minus the number of
  1988.            carriage returns in the file, since C text mode strips a file of
  1989.            carriage returns.
  1990.  
  1991.            You can use the "-n" option with "ARJ l" to list the files 
  1992.            that DO NOT EXIST on the disk.
  1993.  
  1994.            Example:  ARJ l archive temp\ *.doc -n
  1995.  
  1996.            As of ARJ 2.61, ARJ will display a count of filenames processed
  1997.            that have been labeled as Windows 9x long filenames.
  1998.  
  1999.            ARJ will display the count of files selected within an archive
  2000.            that have Windows long filenames.
  2001.  
  2002.            In the space preceding the date-time field, ARJ will display a 
  2003.            " " for year 2000, a "1" for the year 2100. 
  2004.  
  2005.            The "v" command will now display Win9x file date-time accessed
  2006.            and file date-time created properties if they exist in the archive.
  2007.  
  2008.            As of ARJ 2.62d, the output under the "G" of the BTPMGUX area is
  2009.            changed.  Instead of a simple "G" to indicate that the file is
  2010.            garbled, that field may contain the values "0", "1", "2", "3", or
  2011.            "4".  
  2012.            
  2013.            "0" indicates XOR garbling (archives created before 2.60).
  2014.  
  2015.            "1" indicates XOR garbling (archives created at 2.60 and greater).
  2016.  
  2017.            "2" indicates GOST encryption with a 32 byte password limit.
  2018.  
  2019.            "3" indicates GOST encryption (ARJCRYPT.COM version 2.1).
  2020.  
  2021.            "4" indicates 40 bit encryption limit.
  2022.  
  2023.         m: Move files to archive
  2024.  
  2025.            This command is similar to specifying the "a" command with the
  2026.            "-d" switch.  The "m" command adds the selected files to the
  2027.            archive.  If the adds are successful, then the added files are
  2028.            deleted.  The move command does not ask permission before
  2029.            deleting the files.  Use the "ARJ a -d" command for that
  2030.            feature.
  2031.  
  2032.            Example:  ARJ m archive soft\*.*
  2033.  
  2034.            The "m" command when used with "-f" and "-u" will delete any
  2035.            successfully added files as well as any files that are already
  2036.            up to date in the archive.  It is STRONGLY suggested that you
  2037.            always use the "-jt" option with move commands to set ARJ to
  2038.            verify the archive before deleting the input files.
  2039.  
  2040.            At ARJ 2.30 and above, ARJ will also attempt to delete any
  2041.            directories that are added to the archive.  Directories can ONLY
  2042.            be selected by using the "-a1" option.  Directories with
  2043.            UNSELECTED files will not be deleted.
  2044.  
  2045.            Example:  ARJ m archive -a1 soft\*.* soft   deletes soft
  2046.                      ARJ m archive -a1 soft\*.*        does not delete soft
  2047.  
  2048.         n: reName files in archive
  2049.  
  2050.            This command allows you to change the names of the files stored
  2051.            in an ARJ archive.  ARJ will prompt for the new name of each
  2052.            selected file.  You can skip changing the name of a particular
  2053.            file by entering a blank line.
  2054.  
  2055.            Example:  ARJ n archive *.c
  2056.  
  2057.            In the above example, ARJ prompts for new names for all *.c
  2058.            files.
  2059.  
  2060.            CAUTION:  For dual-name archives, this command only affects the
  2061.            DOS SHORTNAME filename and not the longname filename.
  2062.  
  2063.            ARJ may not accept ANSI codepage names for renaming.
  2064.  
  2065.            As a tip, it is possible to rename chapter labels to a more
  2066.            descriptive name.
  2067.  
  2068.            Examples:  ARJ n archive -hbc
  2069.                       ARJ n archive -hbc -jb*
  2070.  
  2071.         o: Order files in archive
  2072.  
  2073.            This command allows you to re-order the files within the
  2074.            archive.  You may specify the order of files on the command line
  2075.            or you can use one or more list files.  Any files in the archive
  2076.            that are not specified on the command line or in a list file
  2077.            will be placed at the end of the archive in the same relative
  2078.            order that they were originally.  No wildcard names can be used
  2079.            as order specifications.  The filenames in the list file must be
  2080.            entered one per line.
  2081.  
  2082.            Example:  ARJ o archive file1 file2 file3
  2083.  
  2084.            In the above example, the files "file1", "file2", and "file3"
  2085.            will be ordered first in the archive.  Any remaining files will
  2086.            follow those.
  2087.  
  2088.            Example:  ARJ o archive !list
  2089.  
  2090.            In the above example, the archive will be ordered according to
  2091.            the order of the names in the file "list".
  2092.  
  2093.            *** NOTE: There is a 16,000 filename sorting limit. ***
  2094.            
  2095.            IMPORTANT:  For the "o"rder command, the list file option has
  2096.            one special feature.  If the list file is named ARJSORT.$$$, ARJ
  2097.            will expect the file to have been built with the ARJ v -jv1
  2098.            command.  This ARJSORT.$$$ list file may be specified with a
  2099.            pathspec.  See the ARJSORT.BAT batch file for an example of this
  2100.            special feature.
  2101.  
  2102.            To facilitate building list files, the "v" command in ARJ will
  2103.            produce special outputs with the "-jv" switch and the "-jv1"
  2104.            switch.
  2105.  
  2106.            The "-jv" switch will display only the pathnames stored within
  2107.            the archive.  No other listing data is displayed.  This output
  2108.            can be re-directed to a file for manual sorting into a list
  2109.            file.
  2110.  
  2111.            The "-jv1" switch will display the standard verbose display with
  2112.            a few modifications.  No sequential number field will be
  2113.            displayed.  No comment field will be displayed.  The pathname is
  2114.            appended to the archive file description data instead of being
  2115.            on a separate line.  Displayed just before the pathname field
  2116.            are the file extension and filename.  These fields are available
  2117.            so that the user can sort the text lines by date-time, file
  2118.            extension, CRC value, etc.  Text editors like Qedit and SLED
  2119.            allow the user to sort text lines via an embedded text field.
  2120.  
  2121.            At ARJ 2.20 and above, you cannot "o"rder a multiple volume
  2122.            archive and should not.
  2123.  
  2124.         p: Print files to standard output
  2125.  
  2126.            Output files to standard output.  This function works such that
  2127.            the output file will contain only the file data extracted.  This
  2128.            is important for UNIX-like usage.
  2129.  
  2130.            Example:  ARJ p archive manual.doc > output.fil
  2131.  
  2132.            In the above example, output.fil will be an exact copy of
  2133.            manual.doc.  There will be no extraneous header information in
  2134.            output.fil.  All extraction phase information is written to the
  2135.            STDERR device, which is normally the display screen.
  2136.  
  2137.            Example:  ARJ p archive manual.doc > LPT1
  2138.  
  2139.            In the above example, the standard output is redirected to the
  2140.            printer device.  This does not involve any intermediate disk
  2141.            files.  However, when redirecting to the printer, ARJ will
  2142.            translate binary files to text, causing possible loss of data.
  2143.            The ARJ command "ARJ e archive manual.doc -jwLPT1" will output a
  2144.            binary file to the printer without loss of data.
  2145.  
  2146.            ARJ sets the file date-time stamp of the output stream.  File
  2147.            viewing as in ARJ p archive name | LIST /s will display the
  2148.            correct file date and time.
  2149.  
  2150.            The "-jp" option can be used to pause the screen output as in the
  2151.            "s" command.  The "-jv" option will allow the display of IBM
  2152.            graphics characters with the "-jp" option.
  2153.  
  2154.            The "-ja2" option can be used to force the filename to be 
  2155.            displayed in the output stream.  This can be used by software
  2156.            tools for blind users.
  2157.            
  2158.            NOTE:  Because of a problem using fwrite() and STDOUT, errors
  2159.            occurring during redirection to serial and printer ports may not
  2160.            be detected.  Errors during redirection to disk files will be
  2161.            detected.
  2162.  
  2163.         q: repair a damaged ARJ-PROTECTED archive
  2164.  
  2165.            The "q" command is used to repair a damaged "protected"
  2166.            archive.  An archive is protected with the "-hk" option.  It is
  2167.            important that an archive be protected prior to the damage.
  2168.            The "q" command will attempt to repair all damages and put the
  2169.            repaired archive in a file named ARJFIXED.ARJ.  ARJFIXED.ARJ
  2170.            will also be newly ARJ-PROTECTED.
  2171.  
  2172.            Example:  ARJ q archive
  2173.  
  2174.            For older style ARJ-PROTECT archives (with accompanying .XRJ
  2175.            file), you must specify the "-hk" option along with the "q"
  2176.            command.
  2177.  
  2178.            Example:  ARJ q docs -hk                repairs archive
  2179.  
  2180.            When working with a damaged protected archive and the "Abort,
  2181.            Retry, Ignore, Fail" prompt appears, you should select the
  2182.            "Ignore" option.
  2183.  
  2184.         r: Remove paths from filenames
  2185.  
  2186.            This command sets ARJ to remove the path component from the
  2187.            specified filenames stored in the archive.  The default is all
  2188.            filenames stored in the archive.  This command is useful if you
  2189.            forgot to specify "-e" to exclude paths.
  2190.  
  2191.         s: Sample files to screen with pause
  2192.  
  2193.            This command is similar to the "p" command except that one
  2194.            screenful of data is displayed to the user and a user action is
  2195.            then requested (the default action is stop paging).  The
  2196.            action prompt can be suppressed with the "-y" switch.
  2197.  
  2198.            The "s" command filters the text to output by truncating at 79
  2199.            characters per line and displaying '?' for control characters.
  2200.            The "-jv" option will allow the display of IBM graphics
  2201.            characters.
  2202.  
  2203.            When "S"ampling output is redirected to a file, only one
  2204.            screenful of data is output per file selected.
  2205.  
  2206.            Example:  ARJ s archive *.txt > output
  2207.  
  2208.         t: Test integrity of archive
  2209.  
  2210.            Test the contents of the selected files for the correct CRC
  2211.            value.  ARJ uses a 32 bit CRC to validate the contents of the
  2212.            files.  The use of 32 bit CRCs is many times better than the
  2213.            use of 16 bit CRCs for the detection of errors.
  2214.  
  2215.            If the AUTO ARJ-PROTECT flag in the archive has been set, ARJ
  2216.            will also test the ARJ-PROTECT data at the end of the archive.
  2217.  
  2218.            When used with the "-hk" option, ARJ will test the archive and
  2219.            upon successful completion, will generate the ARJ-PROTECT file.
  2220.  
  2221.            Example:  ARJ t archive -hk
  2222.  
  2223.         u: Update files to archive
  2224.  
  2225.            Update older files in the archive and add files that are new to
  2226.            the archive.
  2227.  
  2228.            Example:  arj u software
  2229.  
  2230.            When updating a file in an archive with a file that is NOT
  2231.            newer and if the -jv option is selected, ARJ will display a
  2232.            message that there is "no change".
  2233.  
  2234.         v: Verbosely list contents of archive
  2235.  
  2236.            This command lists the full pathname and comments of the archive
  2237.            files as well as the same information as the "l" command.
  2238.  
  2239.            The "v" command now displays a sequence number preceding the
  2240.            pathname.  This number can be used with the "-#" option to
  2241.            access specific files within an archive.
  2242.  
  2243.            In addition, ARJ also displays the DTA and DTC date properties
  2244.            and physical disk file size (when saved in the header).  If the
  2245.            physical disk file size is equal to the original file size
  2246.            value, then an "=" symbol will be displayed instead.
  2247.  
  2248.            Example:  ARJ v archive
  2249.                      ARJ x archive -# 5 10
  2250.  
  2251.            Use the "-jp" switch to pause the output after each screen.
  2252.  
  2253.            The "-jv" switch will display only the pathnames to the screen.
  2254.  
  2255.            The "-jv1" switch will display the archive data in a manner
  2256.            suitable for sorting on various fields for use with the "o"
  2257.            command.
  2258.  
  2259.         w: Where are text strings in archive
  2260.  
  2261.            This command allows the user to search for text strings within
  2262.            archives.
  2263.  
  2264.            ARJ will prompt the user whether to ignore case when searching.
  2265.            This search option takes MS-DOS code pages into account so that
  2266.            casing of accented/umlauted characters will be done correctly.
  2267.  
  2268.            ARJ will also prompt the user for the number of lines of context
  2269.            of a match to display.  If a number greater than zero is chosen,
  2270.            ARJ will display the matched string and the surrounding context
  2271.            with all of the non-printable characters including newlines
  2272.            replaced by question marks.  The context lines displayed will be
  2273.            78 characters in length.  When the display context option is
  2274.            chosen, ARJ will inhibit the progress indicator.  If the "-jv"
  2275.            is set, IBM graphics characters (128 to 255) will be displayed.
  2276.  
  2277.            Then, this command will prompt the user for up to 20 text strings
  2278.            to search for within the archive.  A count of all matches will be
  2279.            displayed after each individual file is scanned.
  2280.  
  2281.            Search strings are limited to 79 characters.
  2282.  
  2283.            Matches that span archive volumes will not be detected by this
  2284.            string search.
  2285.  
  2286.            You can search multiple ARJ archives with a command like:
  2287.  
  2288.            ARJ w \docs\*.arj
  2289.  
  2290.            You may page pause the display with the "-jp" option.
  2291.  
  2292.            The "-jq" option can be used to supply the necessary parameters
  2293.            to the ARJ w command.
  2294.  
  2295.            The option string will be parsed as follows:
  2296.            1) the first character must be either "+" or "-" representing
  2297.               yes or no,
  2298.            2) the next character(s) represents the number of lines of
  2299.               context to display,
  2300.            3) the next character represents a non-digit separator,
  2301.            4) the next characters represent the search text.
  2302.  
  2303.            Examples:  ARJ w archive -jq+3+total    caseless search
  2304.                                                    display 3 context lines
  2305.                                                    search for "total"
  2306.                       ARJ w archive "-jq-2-to be"  case sensitive search
  2307.                                                    display 2 context lines
  2308.                                                    search for "to be"
  2309.  
  2310.            You can use the "-hw" options to change the way ARJ displays
  2311.            the filenames being searched.
  2312.  
  2313.         x: eXtract files with full pathname
  2314.  
  2315.            This command extracts one or more files from the archive to
  2316.            their full paths in the current directory or to the base
  2317.            directory if specified.  ARJ normally stores pathnames as if
  2318.            they were children of the target directory.  Any drive or root
  2319.            directory specifications are stripped before extracting unless
  2320.            the "-jf" switch is specified with the "x" command.
  2321.  
  2322.            Example:  arj x archive *.c
  2323.  
  2324.            If you wish to extract only a portion of an archive and that
  2325.            portion is a directory containing directories, you should use
  2326.            the "-p1" switch.  See the "-p" switch for more information.
  2327.  
  2328.            The ARJ e and ARJ x commands now accept the "-d" option to
  2329.            provide an extract and delete option.  This feature requires
  2330.            that you specify the files to extract and delete.  ARJ will NOT
  2331.            default to "*.*" for this option.
  2332.  
  2333.            Refer to the description of the "e" command for more
  2334.            information about extraction.
  2335.  
  2336.         y: copY archive with new options
  2337.  
  2338.            The ARJ y command provides an easy interface to the -je and
  2339.            -je1 options as well as to the -jb and -jb0 options.
  2340.  
  2341.            Examples:  ARJ y archive -je1  convert an archive to an SFX
  2342.                       ARJ y archive -jb   make an archive a chapter type
  2343.                       ARJ y archive -jb0  convert from a chapter type to
  2344.                                           a standard type
  2345.  
  2346.            When converting a chapter archive to a standard archive, you
  2347.            should also delete the chapter labels:
  2348.  
  2349.            Example:  ARJ d archive *.* -hbc -jb*
  2350.  
  2351.            When used with the "-g" option and optionally the "-hg" option,
  2352.            ARJ will ungarble a previously garbled archive.
  2353.  
  2354.            Example:  ARJ y archive -gpasswrd
  2355.  
  2356.            When used with the "-hk" option, ARJ will clear the ARJ-PROTECT
  2357.            flag and will also remove the ARJ-PROTECT data from the
  2358.            archive.  The "-hk!" option will be ignored.
  2359.  
  2360.            Example:  ARJ y archive -hk
  2361.  
  2362.  
  2363.      ARJ SWITCH OPTIONS:
  2364.  
  2365.         ?: Display full help screens
  2366.  
  2367.            The command "ARJ -?" displays several screens of help
  2368.            information with page pauses.  The command "ARJ -? -jp" displays
  2369.            the help screens without page pauses.  You can also redirect the
  2370.            output to a file as in:
  2371.  
  2372.            ARJ -? > help.txt
  2373.  
  2374.            ARJ may not detect network file redirection and will pause per
  2375.            screenful.
  2376.  
  2377.         -: skip any more switch options
  2378.  
  2379.            The switch option "--" will cause ARJ to stop looking for any
  2380.            more switch options on the command line.  This is useful for
  2381.            entering filenames beginning with "-".
  2382.  
  2383.            Example:  ARJ a archive -- -file
  2384.  
  2385.         +: inhibit ARJ_SW usage
  2386.  
  2387.            The switch option "-+" will inhibit ARJ from using the value of
  2388.            the ARJ_SW variable in ARJ switch processing.  It is
  2389.            recommended that this option be used when using ARJ in batch
  2390.            files.
  2391.  
  2392.            Example:  ARJ a archive -+ *.*
  2393.  
  2394.            The "-+" option can now be used to specify an environment
  2395.            variable name to use in place of the default "ARJ_SW".  This
  2396.            option can only be used on the command line.
  2397.  
  2398.            Example:  ARJ a archive -+ARJ_SW2
  2399.  
  2400.         @: set 1 token per response file line
  2401.  
  2402.            This switch sets ARJ to enable/disable the interpretation of
  2403.            text lines in an ARJ RESPONSE file as a complete single token.
  2404.            Normally, in an ARJ response file, blanks are interpreted as
  2405.            token separators.  (Tokens are commands, filenames, wildcards,
  2406.            and switch options).  However, if ARJ scans an "-@" option in a
  2407.            response file, it will process subsequent text lines as single
  2408.            tokens per line.  A subsequent "-@" option will revert ARJ to
  2409.            normal multiple tokens per line mode.
  2410.  
  2411.            Example:  ARJ @text.rsp
  2412.  
  2413.            TEXT.RSP contains:
  2414.            a c:\dir\archive -r -jt1 -@ -a1
  2415.            c:\long directory name\*.*
  2416.            c:\other directory name\*.*
  2417.            -@
  2418.            dir1\*.* dir2\*.* dir3\*.*
  2419.  
  2420.            One common error when using the "-@" option is including extraneous
  2421.            leading and/or trailing blanks.  For example, ARJ will abort with
  2422.            an invalid switch option error if the second "-@" above has one or
  2423.            more trailing blanks.
  2424.  
  2425.         &: install critical error handler
  2426.  
  2427.            By default, ARJ sets up a default interactive critical error
  2428.            handler to handle errors like "sector not found" and "drive not
  2429.            ready".  The user has the option of retrying the failed
  2430.            operation.  The user can press Control BREAK to abort to DOS.
  2431.  
  2432.            The "-&" option sets ARJ to install a non-interactive critical
  2433.            error handler.  This is designed for unattended ARJ use.  This
  2434.            handler will intercept errors that produce the "Abort, Retry ...."
  2435.            error messages like bad sector errors and file sharing
  2436.            violations.  It can be specified on the command line or via the
  2437.            environment variable.  Please note that if you specify "-&" on
  2438.            the command line, the handler is installed immediately before any
  2439.            files are processed.  If you specify "-&" in the environment, ARJ
  2440.            will not install the handler until all switches are processed.
  2441.  
  2442.         !: set list char
  2443.  
  2444.            This option allows the user to set the character used for list
  2445.            files.  The option "-!" with no specified character toggles
  2446.            (turns off) the current list file character (default "!").
  2447.  
  2448.            Syntax:  ARJ a archive -!@ @list.fil
  2449.                     ARJ a archive -! !.bat
  2450.  
  2451.            The first example above sets the list file character to the one
  2452.            used by LHA and PKZIP.
  2453.  
  2454.         $: add/extract volume label
  2455.  
  2456.            This option allows the user to store or extract DOS volume
  2457.            labels in ARJ archives.  It is possible to have multiple labels
  2458.            in one archive.  At ARJ 2.10 and above, you can only add or
  2459.            extract volumes labels at DOS 2.0 and above.  The "-$" option
  2460.            may be specified with or without a drive specification.  The
  2461.            drive can be specified by appending the letter and optionally
  2462.            the ":" to "-$".  If none is specified, ARJ assumes the current
  2463.            drive unless a specified target base directory has a drive
  2464.            specification.
  2465.  
  2466.            WARNING:  Currently, ARJ allows more than one volume label and
  2467.            duplicate volume labels in the same archive.  You can delete one
  2468.            or more duplicate labels with the "ARJ d -q archive label"
  2469.            command.  ARJ will query you on each occurrence of "label".
  2470.            This "faulty" mechanism allows a file and label of the same name
  2471.            to be added to an archive.  The capability of having duplicate
  2472.            labels in the same archive MAY NOT be present in future versions
  2473.            of ARJ.
  2474.  
  2475.            The SFX and SFXJR modules DO NOT support volume label extraction!
  2476.            The SFXV modules DOES.
  2477.  
  2478.            On the list screen, volume labels will be indicated by the "V"
  2479.            under the "T" column.
  2480.  
  2481.            Syntax:  ARJ a archive -$           add all files and the label
  2482.                                                of the current drive.
  2483.                     ARJ a archive ... -$B      add only the label of drive B
  2484.                     ARJ a archive ... -$B:     add only the label of drive B
  2485.                     ARJ u archive ... -$B:     add only the label of drive B
  2486.  
  2487.            To extract volume labels, you must select the label by setting
  2488.            "-$" and specifying a matching wildname/filename.
  2489.  
  2490.            Syntax:  ARJ e archive doslabel -$  extract the label named
  2491.                                                doslabel to the current drive.
  2492.                     ARJ e archive -$D:         extract all files to the
  2493.                                                current drive and extract the
  2494.                                                label to drive D:.
  2495.                     ARJ e archive label B:\ -$ extract all files to B:\ and
  2496.                                                the label to drive B.
  2497.  
  2498.            ARJ will display all labels over 8 characters with a "." in it
  2499.            like a normal DOS filename.  However, ARJ will not restore this
  2500.            extra "." when extracting.  ARJ will only create standard
  2501.            uppercase DOS volume labels.
  2502.  
  2503.            Volume labels created by utilities other than standard DOS
  2504.            commands like LABEL and FORMAT may cause label access problems
  2505.            for ARJ.  For example, Norton's VL.EXE can create labels with
  2506.            lowercase letters.  You will need to use LABEL.COM to delete
  2507.            these labels in order to let ARJ set a new label.  Programs that
  2508.            delete unusual labels must do absolute writes to disk or use a
  2509.            wildcard ("*.*") delete of files with the label attribute in the
  2510.            root directory.  A single bit corruption in the program can
  2511.            result in the deletion of ALL files in the root.  ARJ currently
  2512.            chooses not to take that risk.
  2513.  
  2514.         #: select files by order number
  2515.  
  2516.            The "-#" option allows the user to select files from an archive
  2517.            by their order number in the archive.  For example, the number 1
  2518.            selects the first file in the archive.  This option is useful in
  2519.            selecting files where there are duplicates in the archive.  It
  2520.            is also useful for batch type utilities that need to extract
  2521.            files sequentially from an archive for processing.  Archive menu
  2522.            programs should find this option very useful in processing
  2523.            archives with duplicate filenames.
  2524.  
  2525.            You can specify a series of files with the n1-n8 type syntax.
  2526.            No embedded spaces are allowed.
  2527.  
  2528.            ARJ e archive -# 1 4 12-25 40-100
  2529.  
  2530.            NOTE that the order number starts from 1 for each individual
  2531.            archive including multiple volume archives.  In other words, the
  2532.            first file in archive.a04 is number 1.
  2533.  
  2534.            Do NOT mix filenames with the numbers other than the base
  2535.            directory.
  2536.  
  2537.            Example:  ARJ e -# archive basedir\ 1 3 5 20 21
  2538.  
  2539.            For consistency, ARJ now interprets the file spec "10-" as 10
  2540.            to the end of the archive.
  2541.  
  2542.            Example:  ARJ l archive -# 21000-       means file 21000 to end
  2543.  
  2544.            This option does not handle split files properly.
  2545.  
  2546.         a: allow any file Attribute
  2547.  
  2548.            By default ARJ will not select system or hidden files via
  2549.            wildcarding unless the "-a" option is specified.
  2550.  
  2551.            The "-a1" switch sets ARJ to add any directories in the selected
  2552.            set of matching filespecs to the archive being built.  This
  2553.            switch also selects hidden and system files as in the "-a"
  2554.            switch.  Even empty directories will be added.  The "l" command
  2555.            will display such directories with a "D" under the "T" (file
  2556.            type) header.
  2557.  
  2558.            Older releases of ARJ will skip over empty directory entries.
  2559.            The ARJSFX and ARJSFXJR modules CAN process empty directory
  2560.            entries.
  2561.  
  2562.            This option is useful for saving software directories with
  2563.            needed empty directories.
  2564.  
  2565.            See the "-hb" option for a newer way of selecting files.
  2566.  
  2567.         b: Backup changed files
  2568.  
  2569.            The "-b" switch will select only files that have the archive bit
  2570.            set.  It will NOT reset archive bits.
  2571.  
  2572.            Example:  arj a a:backup c:\*.* -b -r -va   simulates FULL BACKUP
  2573.  
  2574.            See "-hb" option for other options.
  2575.  
  2576.        b1: Backup changed files and reset archive bits
  2577.  
  2578.            If you specify the "-b1" option, files with the archive bit set
  2579.            will be selected AND the archive bits of all archived files will
  2580.            be reset after a successful archive has been built.
  2581.  
  2582.            Example:  arj a a:backup c:\*.* -b1 -r -va   simulates BACKUP
  2583.  
  2584.            Under Windows 9x, the use of the "-b" type switch options to
  2585.            reset the archive bit may result in a sharing violation error.
  2586.            ARJ will display the error and then proceed ignoring the error.
  2587.  
  2588.        b2: Only reset archive bits
  2589.  
  2590.            The "-b2" switch does NOT affect file selection.  It does cause
  2591.            ARJ to reset the archive bits of added files.  If the "-f" or
  2592.            "-u" option has been selected, ARJ will also reset the archive
  2593.            bits of files that are already duplicated in the archive.
  2594.  
  2595.            Example:  arj a e:archive c:\*.* -b2 -r    archives all files on
  2596.            the C drive and resets all archive bits.
  2597.  
  2598.        b3: reset archive bit during restore
  2599.  
  2600.            The "-b3" switch is used to reset the archive bits of files
  2601.            being extracted.  It is useful for setting the archive state so
  2602.            that a subsequent incremental backup will not backup these
  2603.            extracted files.
  2604.  
  2605.        b4: do not restore file attributes and reset archive bit
  2606.  
  2607.            The "-b4" switch is used to set ARJ to NOT restore any file
  2608.            attribute bits and to reset the archive bit of files being
  2609.            extracted.
  2610.  
  2611.            It is useful for easing the cleanup/deletion of temporarily
  2612.            extracted archive files as in a virus scanning process.  Files
  2613.            will NOT be restored as system, hidden, or readonly.
  2614.  
  2615.        b5: do not restore any file attributes
  2616.  
  2617.            The "-b5" switch is used to set ARJ to NOT restore any file
  2618.            attribute bits and to allow the archive bit to stay set of
  2619.            files being extracted.
  2620.  
  2621.         c: skip time-stamp Check
  2622.  
  2623.            Normally with the "u" and "f" commands, ARJ will only update
  2624.            newer files to an archiver.  The "-c" switch will set ARJ to
  2625.            update the archive regardless of the date-time modified time
  2626.            stamps.
  2627.  
  2628.            When extracting files from an archive with the "-y" and "-f"
  2629.            switches set, ARJ would normally skip extracting older files.
  2630.            The "-c" switch will set ARJ to extract these older files.
  2631.  
  2632.         d: with Delete (move)
  2633.  
  2634.            This switch provides the standard MOVE command.  Successfully
  2635.            added files will be deleted.  When used with the "-f" or "-u"
  2636.            option, ARJ will also delete files that are already duplicated
  2637.            in the archive.  ARJ will prompt the user before deleting the
  2638.            files unless the "-y" switch is specified.  Also, you can use
  2639.            the "m" command which does not prompt before deleting the files.
  2640.            At ARJ 2.30 and above, when using the "-a1" to specify the
  2641.            selection of directories, ARJ will also delete the selected
  2642.            directories.
  2643.  
  2644.            ARJ a archive filename -d -y       is equivalent to
  2645.  
  2646.            ARJ m archive filename             and
  2647.  
  2648.            ARJ a archive filename
  2649.            delete filename
  2650.  
  2651.            The ARJ e and ARJ x commands now accept the "-d" option to
  2652.            provide an extract and delete option.  This feature requires
  2653.            that you specify the files to extract and delete.
  2654.  
  2655.            ARJ e archive -d file1 file2
  2656.  
  2657.            Chapter archives do NOT support extraction with deletion.
  2658.  
  2659.         e: Exclude paths from filenames
  2660.  
  2661.            By default ARJ always stores the pathname of the archived file.
  2662.            This switch will set ARJ to store only the filename component.
  2663.  
  2664.            The "-e1" switch option sets ARJ to NOT store the base directory
  2665.            name with the filenames in the archive.
  2666.  
  2667.            Example:  ARJ a archive C:\SOFTWARE\ARJ\ *.* -r -e1
  2668.  
  2669.            In the above example, ARJ will NOT store the C:\SOFTWARE\ARJ\ as
  2670.            part of the filenames.
  2671.  
  2672.            When updating files within an archive, ARJ uses the full
  2673.            pathname to match against the full name of the selected files.
  2674.            The "-e" and "-e1" option affect this exact matching.  If "-e"
  2675.            is specified, only the filespecs of the selected files will be
  2676.            matched against the full pathname of the files in the archive.
  2677.            If "-e1" is specified, the full pathname minus the base
  2678.            directory of the selected files is used to match against the
  2679.            full pathname of the files in the archive.
  2680.  
  2681.            In other words, ARJ will only update a file within an archive if
  2682.            the name of the new file as stored in the archive would be
  2683.            identical to the name of the original file stored in the
  2684.            archive.
  2685.  
  2686.            This switch used during extraction will exclude the beginning
  2687.            characters of the filename.  This can be useful for shortening a
  2688.            long output pathname.
  2689.  
  2690.            Examples:  ARJ x archive -e10  will exclude the first 10
  2691.                                           characters of the output name.
  2692.  
  2693.                       ARJ x archive -e4   will exclude the first 4
  2694.                                           characters.
  2695.  
  2696.         f: Freshen existing files
  2697.  
  2698.            This switch used with the "e" or "x" commands sets ARJ to only
  2699.            extract newer files from the archive.
  2700.  
  2701.            This switch used with the "m" command sets ARJ to update only
  2702.            input files with newer dates than the ones in the archive.
  2703.            After the archive has been updated, all updated selected files
  2704.            and all up to date selected files will be deleted.
  2705.  
  2706.            The ARJ m -f command is very similar to the LHARC m command.
  2707.  
  2708.            The freshen options when used with the "u"pdate command are
  2709.            interpreted as "-u" options instead.
  2710.  
  2711.        f1: Freshen existing files (OLDER)
  2712.  
  2713.            This switch used with the "e" or "x" commands sets ARJ to only
  2714.            extract OLDER files from the archive or to add OLDER files to
  2715.            the archive.
  2716.  
  2717.        f2: Freshen different files
  2718.  
  2719.            This switch used with the "e" and "x" commands causes ARJ to
  2720.            add/extract CHANGED (different date-time or different size).
  2721.  
  2722.            There is a slight limitation to this switch.  When processing
  2723.            files that are split across volumes, the size test is skipped
  2724.            and the file is updated regardless.  This limitation does not
  2725.            exist when using versions of ARJ greater than 2.80 and ARJ32
  2726.            greater than 3.09.
  2727.  
  2728.        f3: Freshen files that are CRC mismatches
  2729.  
  2730.            This switch is used to select files that are CRC mismatches or
  2731.            different sizes for extracting or adding.  The 32 bit CRC
  2732.            (checksum) of the file is matched against the CRC of the file in
  2733.            the archive.
  2734.  
  2735.            There is a slight limitation to this switch.  When processing
  2736.            files that are split across volumes, the CRC test is skipped
  2737.            and the file is updated regardless.
  2738.  
  2739.        f4: Freshen files that different based upon text mode file sizes
  2740.  
  2741.            This switch works like the "-f2" switch except that ARJ will
  2742.            use the text mode file size instead of the physical disk file
  2743.            size.
  2744.  
  2745.            This is useful when updating archives with text files on a PC
  2746.            and on a network drive from a Unix system.
  2747.  
  2748.         g: Garble with password
  2749.  
  2750.            This switch followed by a password "-gpassword" will encrypt or
  2751.            decrypt an archived file.  During a "l" or "v" command, a
  2752.            garbled file will display a "G" after the method number.
  2753.  
  2754.            Example:  ARJ e archive -gpassword
  2755.  
  2756.            If the "-g" option is followed by a question mark "?", ARJ will
  2757.            prompt the user for the password without displaying the password
  2758.            input.  The backspace key can be used to erase characters.
  2759.  
  2760.            Example:  ARJ a archive -g?
  2761.  
  2762.            Using the wrong password during extraction will result in a
  2763.            "Bad file data" or "CRC error" error message.
  2764.  
  2765.            Use the "g" command to garble an already existing ARJ archive.
  2766.  
  2767.            Please save your password in a safe place.  It may be nearly
  2768.            impossible to retrieve your garbled files if you forget your
  2769.            password.  There is NO TRICK to recovering a lost password.
  2770.  
  2771.            The garble option in this version of ARJ has three versions. One
  2772.            is the original version found in earlier ARJ releases.  It is
  2773.            compatible with older versions and works like those versions.
  2774.  
  2775.            The second garble version uses a separate encryption module.
  2776.  
  2777.            This version of ARJ provides a new encryption scheme based upon
  2778.            the Russian encryption algorithm (GOST 28147-89 cipher).  This
  2779.            algorithm is similar in design to DES; however, GOST is designed
  2780.            for software implementation.  GOST 28147-89 uses a 256 bit key
  2781.            and 32 rounds of encryption.  This implementation uses the 64
  2782.            bit cipher feedback mode.
  2783.  
  2784.            This new option is accessed by using the new "-hg" option.  This
  2785.            option sets ARJ to use the separate encryption module to encrypt
  2786.            the data.  By default, ARJ will look for the file "ARJCRYPT.COM"
  2787.            in the same directory where the ARJ.EXE being executed is found.
  2788.            The user may specify the pathname of the module to use.
  2789.  
  2790.            Examples:  ARJ a archive *.doc -gThis_is_a_password -hg
  2791.                       ARJ a archive *.doc -gpassword -hgc:\dir\enc.com
  2792.  
  2793.            This separate module feature has the advantage of saving space
  2794.            with the ARJSFXV module and the DEARJ.EXE module when encryption
  2795.            is not needed.  You simply do not include the encryption module
  2796.            in the archive when not using encryption.  This feature works
  2797.            in ARJ 2.76/ARJ32 3.09 and above.
  2798.  
  2799.            The encryption overlay module is not included with this version
  2800.            of ARJ.  Because of USA export regulations, ARJ Software, Inc 
  2801.            may not export the encryption overlay module from the USA.  It
  2802.            is available on the ARJ website for USA users only.
  2803.  
  2804.            The new garble option accepts a password key up to 64 characters 
  2805.            long.  Excess characters are ignored.  Garble passwords ARE CASE
  2806.            SENSITIVE!  
  2807.            
  2808.            If you need compatibility with ARJ 2.60 "-hg" encryption, you
  2809.            must limit your passwords to 32 characters or less.
  2810.  
  2811.            DO NOT LOSE your password!  There is no known method to recover
  2812.            the password other than by brute force, which could take a very
  2813.            long time.  The longer the password, the longer it would take
  2814.            to "guess" it.  ARJ Software, Inc. cannot provide help in
  2815.            finding lost passwords.
  2816.  
  2817.            This new encryption scheme is not compatible with the "-g"
  2818.            option of pre-2.55 versions of ARJ.  If you want to maintain
  2819.            compatibility with pre-2.55 versions of ARJ, you should NOT use
  2820.            the "-hg" option.
  2821.  
  2822.            Only the multiple volume self-extractors (ARJSFXV/ARJSFX32)
  2823.            supports the new encryption module.  See the SFX.TXT for details
  2824.            about creating an encrypted self-extracting archive.
  2825.  
  2826.            A variation of the "-hg" option is "-hg!".  This "-hg!" option
  2827.            accesses a built-in version of GOST (no
  2828.            ARJCRYPT.COM/ARJ32_C.DLL needed) that is limited to a 40 bit
  2829.            key size.  Only the first 32 characters of a user password are
  2830.            accepted and crunched into a 40 bit key.  This algorithm is
  2831.            designed to meet USA encryption export rules.  Of the
  2832.            self-extractors, only the multiple volume self-extractors
  2833.            support "-hg!".
  2834.  
  2835.            When garbling or ungarbling an existing archive, ARJ will
  2836.            detect the method of encryption previously used and select that
  2837.            same method without the need to specify the type of encryption.
  2838.            However, if you specify a type of encryption that is not
  2839.            compatible, ARJ will abort with an error message.
  2840.  
  2841.         i: with no progress Indicator
  2842.  
  2843.            Do not display the percentage progress indicator.  The progress
  2844.            indicator appears during the add, extract, search, and test
  2845.            operations.
  2846.  
  2847.            The "-i1" option provides a bar type graphical progress
  2848.            indicator for the compression, extraction, and testing type
  2849.            commands of ARJ.  This provides an alternative to the simple
  2850.            numeric increasing percentage progress indicator.
  2851.  
  2852.            The "-i2" option provides a combined percentage and bar progress
  2853.            display.
  2854.  
  2855.            The "-i3" switch shows the percentage progress of the WHOLE
  2856.            archive build. This switch is only operative during adds.
  2857.  
  2858.            The "-i4" switch shows the percentage progress as a bar graph of
  2859.            the WHOLE archive build. This switch is only operative during
  2860.            adds.
  2861.  
  2862.            The "-i5" switch shows the percentage progress including a bar
  2863.            graph of the WHOLE archive build. This switch is only operative
  2864.            during adds.
  2865.  
  2866.            The "-i6" switch shows the percentage progress of the WHOLE
  2867.            archive build along with a progress bar graph for the current
  2868.            file. This switch is only operative during adds.
  2869.  
  2870.         j: selects alternate set of switch characters.
  2871.  
  2872.            This switch toggles the set of switch characters.  The toggle is
  2873.            reset at end at of each separate switch sequence back to the
  2874.            main set of switch characters.
  2875.  
  2876.            For example, "-ja" is not the same function as "-a".  However,
  2877.            "-jja" is the same as "-a" because of the double toggle.  Also,
  2878.            "-jaje" is NOT the same as "-ja -je".  The switch sequence
  2879.            "-jae" is the same as "-ja -je".
  2880.  
  2881.         k: Keep a .BAK of ARJ archive
  2882.  
  2883.            Create a ".BAK" of the original archive file during an update.
  2884.            The original archive will be suffixed with ".BAK".  Any existing
  2885.            ".BAK" file will be overwritten.
  2886.  
  2887.            This has no relation to "backup type" ARJ archives.
  2888.  
  2889.            This option does not work for multiple volume archives.
  2890.  
  2891.         l: create List_name file
  2892.  
  2893.            This switch will set ARJ to dump to the filename specified after
  2894.            the "-l" switch all of the filenames to be processed by this ARJ
  2895.            command.  For add type commands, this list contains all files
  2896.            that matched the file wildnames given on the command line.  For
  2897.            other commands, the file will contain only the original
  2898.            filenames and/or wildcard names.  Other options do NOT affect
  2899.            the output of filenames to this list file.  To get an index file
  2900.            for backup purposes, use the "-ji" option.
  2901.  
  2902.            This list file can be used as a listfile on the command line.
  2903.  
  2904.            Example:  ARJ a -lname.lst archive *.exe
  2905.  
  2906.            This example will create a file named "name.lst" with all *.exe
  2907.            files.
  2908.  
  2909.            The "-l!" switch forces ARJ to append the list of filenames to 
  2910.            be archived to the specified filename instead of overwriting
  2911.            it.
  2912.  
  2913.            Example:  ARJ a archive c:\*.* -r -l!names.lst
  2914.  
  2915.         m: with Method 0, 1, 2, 3, 4
  2916.  
  2917.            Method 0 = storing   (no compression)
  2918.            Method 1 = best compression for general use
  2919.                                 (default compression method)
  2920.                                 (requires 300,000 plus bytes memory)
  2921.            Method 2 = slightly less compression and faster
  2922.                                 (requires 282,000 plus bytes memory)
  2923.            Method 3 = less compression and less memory and faster
  2924.                                 (requires 250,000 plus bytes memory)
  2925.            Method 4 = fastest compression
  2926.                                 (requires 235,000 plus bytes memory)
  2927.  
  2928.            Example:  ARJ a archive *.exe -m2
  2929.  
  2930.            The "-jm" option will usually improve the size reduction of
  2931.            method 1 at the cost of speed and memory.  The behavior of
  2932.            "-jm" with -m2, -m3 and -m4 is UNDEFINED.
  2933.  
  2934.            Method 4 uses a different decoder than 1 to 3.  Method 4 is
  2935.            almost twice as fast as method 1.
  2936.  
  2937.            During extraction, ARJ uses less memory than during compression.
  2938.            See the section on ARJ LIMITATIONS for more memory usage
  2939.            information.
  2940.  
  2941.         n: only New files (not exist)
  2942.  
  2943.            With the "e" or "x" commands, extract files that do not exist in
  2944.            the target directory.
  2945.  
  2946.            With the "a" or "m" commands, archive files that do not exist in
  2947.            the target archive.
  2948.  
  2949.            With the "d" or "l" commands, specify files that do not exist in
  2950.            the target directory.
  2951.  
  2952.         o: On or after date YYMMDDHHMMSS or YYYYMMDDHHMMSS
  2953.  
  2954.            The switch "-o" by itself means select files modified today.  If
  2955.            "-o" is followed by a date and optionally a time, ARJ will only
  2956.            select files modified on or after that date-time.
  2957.  
  2958.            Year specifications come in three variations to provide backward
  2959.            compatibility and year 2000 compliance.
  2960.  
  2961.            Year specifications that begin with "80" to "99" are interpreted
  2962.            as the years 1980 to 1999.
  2963.  
  2964.            Example:  ARJ a test -o9001021700   -> select files modified
  2965.            on or after Jan 2, 1990, 5:00 PM.
  2966.  
  2967.            Year specifications that begin with "19", "20", or "21" are 
  2968.            interpreted as FOUR digit year numbers.
  2969.  
  2970.            Example:  ARJ a test -o20020101     -> select files modified 
  2971.            on or after Jan 1, 2002, 12:00 AM.
  2972.  
  2973.            Year specifications that begin with "00" to "18" are interpreted
  2974.            as the years 2000 to 2018.
  2975.  
  2976.            Example:  ARJ a test -o1001021700   -> select files modified
  2977.            on or after Jan 2, 2010, 5:00 PM.
  2978.  
  2979.            There is no option for using other date-time formats.
  2980.  
  2981.            The switch "-ob" selects files modified before today.  If "-ob"
  2982.            is followed by a date and optionally a time, ARJ will only
  2983.            select files modified before that date-time.
  2984.  
  2985.            ARJ now accepts the use of "-o" and "-ob" options simultaneously
  2986.            to specify a range of selected dates.  This is useful for
  2987.            selecting files on a specific date.
  2988.  
  2989.            Example:  ARJ a archive *.* -o910101 -ob910102
  2990.  
  2991.            The "-o" option and/or the "-ob" option will default to today's
  2992.            date at midnight (0000 hrs) when specified without dates.
  2993.  
  2994.            The "-od" and "-odb" switches allow the user to select files
  2995.            based upon the number of days from today.  The "-od" switch
  2996.            allows the user to select files modified on or after the
  2997.            specified number of days from today.  The "-odb" switch selects
  2998.            files before.  You CAN combine the "-od" and "-odb" switches.
  2999.            The days are calculated from midnight.
  3000.  
  3001.            Examples:  ARJ a archive -od0    select files modified today
  3002.                       ARJ a archive -od1    select files modified yesterday
  3003.                                             and today
  3004.                       ARJ a archive -odb1   select files modified before
  3005.                                             yesterday
  3006.  
  3007.        oa: Accessed on or after date YYMMDDHHMMSS or YYYYMMDDHHMMSS
  3008.  
  3009.            The "-oa" and "-oab" switches allow the user to select files
  3010.            under Windows 9x based upon file date-time last accessed.  "-oa"
  3011.            selects files after the date value, "-oab" selects files before.
  3012.  
  3013.            This ARJ version does NOT support combining "-o", "-oa", "-oc"
  3014.            with one another.  You CAN combine "-oa" with "-oab".
  3015.  
  3016.            Archived files without the stored DTA attribute (-j$) will not
  3017.            be selected.
  3018.  
  3019.        oc: Created on or after date YYMMDDHHMMSS or YYYYMMDDHHMMSS
  3020.  
  3021.            The "-oc" and "-ocb" switches allow the user to select files
  3022.            under Windows 9x based upon file date-time created.  "-oc"
  3023.            selects files after the date value, "-ocb" selects files before.
  3024.  
  3025.            You can combine "-oc" with "-ocb".
  3026.  
  3027.            Archived files without the stored DTC attribute (-j$) will not
  3028.            be selected.
  3029.  
  3030.        od: Modified on or after specified number of days before today
  3031.  
  3032.            The "-od" and "-odb" switches allow the user to select files
  3033.            based upon the number of days before today.  The "-od" switch
  3034.            allows the user to select files modified on or after the
  3035.            specified number of days before today.  The "-odb" selects
  3036.            files before the specified number of days.  You CAN combine the
  3037.            "-od" and "-odb" switches.
  3038.  
  3039.            Example:  ARJ a archive -od5    5 days old or less
  3040.  
  3041.        os: Greater or equal to the specified file size
  3042.  
  3043.            The "-os" and "-osb" switches allow the user to select files
  3044.            based upon the file size.  The "-os" switch allows the user to
  3045.            select files greater than or equal to the specified file size.
  3046.            The "-osb" switch is used to select files smaller than the
  3047.            specified file size.  These two switches can be combined.  They
  3048.            can also be combined with any one set of date selection
  3049.            switches.
  3050.  
  3051.            Examples:  ARJ a archive -os100K -osb100M   Files >= 100K and < 100M
  3052.                       ARJ l archive -osb10K            Files < 10K
  3053.  
  3054.            NOTE: With multiple volume archives created by versions of ARJ
  3055.            before ARJ 2.81 and ARJ32 3.10 or created with the "-j$" option,
  3056.            ARJ will not select any split files based upon size.
  3057.  
  3058.         p: match using full Pathnames
  3059.  
  3060.            When "-p" is specified, ARJ looks for an exact pathname match.
  3061.            This can be modified by the "-e" option.
  3062.  
  3063.            For non-update commands and specified filenames with paths, ARJ
  3064.            will match the full path with or without the "-p" switch.
  3065.  
  3066.            To match directory paths that contain subdirectories, you should
  3067.            use the "-p1" switch.  This switch sets ARJ to match only the
  3068.            initial portion of the pathnames against the wildnames
  3069.            specified.  For example, if your archive contains the TURBOC++
  3070.            directory named TC and you wish to extract the INCLUDE
  3071.            subdirectory along with the subdirectory INCLUDE\SYS, you can
  3072.            use the following command:
  3073.  
  3074.            ARJ e archive TC\INCLUDE\*.* -p1
  3075.  
  3076.            If you wanted to extract all of the INCLUDE\S*.* files including
  3077.            the contents of the SYS subdirectory, you can use the following
  3078.            command:
  3079.  
  3080.            ARJ e archive TC\INCLUDE\S*.* -p1
  3081.  
  3082.         q: Query on each file
  3083.  
  3084.            This switch causes ARJ to prompt the user prior to acting upon
  3085.            each archived file for following commands: "a", "c", "d", "e",
  3086.            "f", "g", "p", "r", "u", "x".
  3087.  
  3088.            This allows you selectively to delete, add, etc.
  3089.  
  3090.            Split files across volumes will cause repeated queries.
  3091.  
  3092.            Note: As of ARJ 2.81 and ARJ32 3.10, ARJ will try to limit its
  3093.            queries for subsequent portions of a file split across volumes
  3094.            for add and extract operations.
  3095.  
  3096.         r: Recurse subdirectories
  3097.  
  3098.            This switch will set ARJ to recurse any wildcards specified on
  3099.            the command line including ARJ archive filenames by traversing
  3100.            all subdirectories scanning for matches.
  3101.  
  3102.            ARJ will also recurse non-wildcard filenames as in:
  3103.            ARJ a archive FILE.BBS -r
  3104.  
  3105.         s: set archive time-Stamp
  3106.  
  3107.            This switch causes ARJ to set the date-time stamp of the archive
  3108.            to that of the newest file in the archive.
  3109.  
  3110.            This option will also work with non-update commands as in:
  3111.            ARJ l archive -s ....
  3112.  
  3113.            The "-s1" switch is used to keep the old archive date-time
  3114.            stamp.  The new archive will have the same timestamp as the
  3115.            original archive.
  3116.  
  3117.            The "-s2" switch is like the "-s" switch except that it only
  3118.            works for archive modification commands.  This makes it more
  3119.            suitable for use in the ARJ_SW environment variable.
  3120.  
  3121.            The "-s3" switch sets ARJ to keep both the original archive file
  3122.            time-stamp as well as the original internal archive modified
  3123.            time-stamp when modifying the archive.
  3124.  
  3125.         t: set file Type
  3126.  
  3127.            This switch causes ARJ to open and read the file to be archived
  3128.            in binary or text mode.  The default is binary mode (-t0).  To
  3129.            archive in text mode, use the -t1 switch.  The "-t" switch is
  3130.            equivalent to "-t0".
  3131.  
  3132.            If you specify the switch "-t0", ARJ will always use the binary
  3133.            mode even for freshening text mode files already in the archive.
  3134.  
  3135.            The file type "text" is only needed for future cross platform
  3136.            transfers of ARJ archives.  It enables ARJ to extract text files
  3137.            to the host file system with the text newline sequence that is
  3138.            correct for that operating system.
  3139.  
  3140.            It is STRONGLY recommended that the "-t1" switch only be used
  3141.            for cross platform use and NOT for normal archiving activities.
  3142.            A number of testing features will not work properly with this
  3143.            type of lossy compression.
  3144.  
  3145.            You should not use the "-t1" switch while archiving in multiple
  3146.            volume mode.
  3147.  
  3148.            ****************************************************************
  3149.  
  3150.            DO NOT USE THE TEXT MODE ON NON-TEXT FILES!!!  Word processor
  3151.            format files are NOT TEXT FILES!  Text files are files like
  3152.            those created by EDLIN, EDIT, QEDIT, NOTEPAD, and BRIEF.  On
  3153.            non-text files ARJ will prematurely stop input if it finds an
  3154.            embedded EOF character (CTL Z).  This will produce a LOSS of
  3155.            data on binary files.  As of ARJ 2.30 and UNARJ 2.30, ARJ will
  3156.            extract text mode data in 8-bit format when extracted to the
  3157.            original type of platform. Only when the text file is extracted
  3158.            to a different type of platform will the 8-bit text be stripped
  3159.            to 7-bit text.
  3160.  
  3161.            ****************************************************************
  3162.  
  3163.            In "-t1" text mode, ARJ will look at the first 4096 bytes of the
  3164.            input file looking for non-text characters.  In "-t1g" text with
  3165.            graphics mode, ARJ will look at the first 4096 bytes of the
  3166.            input file looking for too many byte values over hex 7F.  If ARJ
  3167.            finds either condition it will automatically backtrack and
  3168.            switch to "-t0" (default) binary mode for that particular file.
  3169.            In addition at the end of compressing the input file, if ARJ
  3170.            finds that the input file size is not greater than 80 percent of
  3171.            the binary file size (size on disk), ARJ will backtrack and
  3172.            re-archive that file in binary mode.  This should help to avoid
  3173.            the problem of accidentally compressing executable files with
  3174.            the "-t1" option which results in lost data.  These tests are
  3175.            not foolproof.
  3176.  
  3177.            The original file size reported by the "l" and "v" commands is
  3178.            the actual number of bytes input during text mode compression.
  3179.            This is usually the MS-DOS file size minus the number of
  3180.            carriage returns in the file, since C text mode strips a file of
  3181.            carriage returns.  There can be problems with the file size
  3182.            because compressing in TEXT mode can be LOSSY (unnecessary
  3183.            characters may be lost).  This can cause problems for some
  3184.            archive conversion programs that check file sizes.
  3185.  
  3186.            The "-t" option has been modified to allow setting file type by
  3187.            suffix similar to "-js" option.  If you want to set the file type
  3188.            to text mode for .ASM and .C files, you would specify the option
  3189.            "-t1.asm.c".
  3190.  
  3191.            ARJ a archive *.* -t1.asm.c.h.doc
  3192.            ARJ a archive *.* -t1g.txt.doc
  3193.  
  3194.            Note that in the switch sequence "-t1f -t1f.doc.asm", the second
  3195.            switch does not override the first switch which specifies that
  3196.            all files are to archived in text mode.
  3197.  
  3198.            If you want to specify the binary file type by suffix, you must
  3199.            specify the default file type to text and then specify the type
  3200.            by suffix, because the default file type is normally binary.
  3201.  
  3202.            ARJ a archive *.* -t1 -t0.com.exe.obj
  3203.  
  3204.            Because of the way ARJ checks all files to be archived in text
  3205.            mode, some true text files will not pass the test.  In this
  3206.            case, you can specify the "f" modifier to force text mode.  This
  3207.            modifier can be combined with the "-t1." suffix option.  The "f"
  3208.            modifier must follow the "g" modifier if any.
  3209.  
  3210.            ARJ a archive *.bat -t1f
  3211.            ARJ a archive *.txt -t1gf
  3212.            ARJ a archive *.* -t1f.bat.asm.doc
  3213.  
  3214.            One trick that you can do with the -t1 option is to convert UNIX
  3215.            text files to MS-DOS text files.  If you have extracted the
  3216.            files out of the ZOO 2.10 archive and need to convert the
  3217.            linefeeds to carriage return/linefeed, you can use the following
  3218.            commands:
  3219.  
  3220.            ARJ a archive *.* -m0 -t1
  3221.            ARJ e archive *.* -y
  3222.  
  3223.         u: Update files (new and newer)
  3224.  
  3225.            This switch used with the "e" and "x" commands causes ARJ to
  3226.            extract newer and non-existing files.
  3227.  
  3228.            This switch used with the "m" command causes ARJ to update only
  3229.            input files with newer dates than the ones in the archive and
  3230.            add new files to the archive.  After the archive has been
  3231.            updated, all added files and updated selected files and all up
  3232.            to date selected files will be deleted.
  3233.  
  3234.        u1: Update files (non-existing and OLDER)
  3235.  
  3236.            This switch used with the "e" and "x" commands causes ARJ to
  3237.            extract OLDER and non-existing files from an archive or to add
  3238.            OLDER and non-existing files to an archive.
  3239.  
  3240.        u2: Update different files
  3241.  
  3242.            This switch used with the "e" and "x" commands causes ARJ to
  3243.            add/extract CHANGED (different date-time or different size) and
  3244.            non-existing files.
  3245.  
  3246.            There is a slight limitation to this switch.  When processing
  3247.            files that are split across volumes, the size test is skipped
  3248.            and the file is updated regardless.  This limitation does not
  3249.            exist when using versions of ARJ greater than 2.80 and ARJ32
  3250.            greater than 3.09.
  3251.  
  3252.        u3: Update CRC mismatched files
  3253.  
  3254.            This switch is used to select files that are CRC mismatches or
  3255.            NEW for extracting or adding.  The 32 bit CRC (checksum) of the
  3256.            file is matched against the CRC of the file in the archive.
  3257.  
  3258.            There is a slight limitation to this switch.  When processing
  3259.            files that are split across volumes, the CRC test is skipped
  3260.            and the file is updated regardless.
  3261.  
  3262.        u4: Update files that different based upon text mode file sizes
  3263.  
  3264.            This switch works like the "-u2" switch except that ARJ will
  3265.            use the text mode file size instead of the physical disk file
  3266.            size.
  3267.  
  3268.            This is useful when updating archives with text files on a PC
  3269.            and on a network drive from a Unix system.
  3270.  
  3271.         v: enable multiple Volumes
  3272.  
  3273.            This switch is required to put ARJ into multiple volume mode.
  3274.  
  3275.            This switch allows the creation of multiple volumes in the ADD
  3276.            mode.  The command "arj a a:arjvol \*.* -b -r -v360000" allows
  3277.            a user to backup up all files changed since the last backup to
  3278.            multiple floppy disks.  ARJ will pause between volumes to allow
  3279.            changing disks.  The volume filenames will be suffixed .ARJ,
  3280.            .A01, .A02, .A03, .... , .A99, .100, .101, .102, and so on up
  3281.            to .999 for a thousand volumes.  Before this release, the
  3282.            volumes would overlap after volumes .A99 and .A00.  You can
  3283.            start the volume series at .A01 or .001 by specifying the full
  3284.            name of the starting archive as "name.A01" or "name.001".
  3285.  
  3286.            Example:  ARJ a a:archive.a01 -v
  3287.                      ARJ a a:archive.001 -v
  3288.  
  3289.            After the pause to change diskettes, ARJ will check to make sure
  3290.            that the diskette has been changed.  However, this check is
  3291.            limited to 3 retries for the same volume.  This test can be
  3292.            inhibited with the "i" modifier.
  3293.  
  3294.            Example:  ARJ x a:archive -vi
  3295.  
  3296.            Archived files can be split across volumes.  ARJ will try to
  3297.            fill each volume to within 200 to 1000 bytes of the specified
  3298.            maximum size.
  3299.  
  3300.            The modifier "w" specifies to ARJ that files are NOT to be split
  3301.            across volumes except for one case.  That case is where the
  3302.            archived file would not fit in ONE whole volume.  This feature
  3303.            does not optimize the use of space in these type of volumes.
  3304.            With this feature, it is possible to have a volume of only 100
  3305.            or less bytes.
  3306.  
  3307.            The command "arj x a:arjvol -v" would restore files starting
  3308.            from arjvol.ARJ.  You must specify the entire ARJ volume name
  3309.            including the .Ann suffix when starting from the middle of a
  3310.            series of volumes or when the series starts with ".A01" or
  3311.            ".000", etc.
  3312.            
  3313.            The global "-y" option will disable the next volume prompt for
  3314.            multiple volume archives EXCEPT when the archives are located
  3315.            on removable media.  The "-jyv" option will disable the next
  3316.            volume prompt even when using removable media.
  3317.  
  3318.            At DOS versions before 3.0, only drives A and B are considered
  3319.            removable.
  3320.  
  3321.            ARJ x a:arjvol -v -jyco
  3322.  
  3323.            The above example extracts in multiple volume mode and
  3324.            suppresses prompting for permission to create directories and to
  3325.            overwrite existing files.  ARJ will assume yes in these cases.
  3326.  
  3327.            Because of the splitting process, archived split files with a
  3328.            size of zero bytes are possible.  This is not an error.
  3329.  
  3330.            If you comment your archives with long comments, you should take
  3331.            that into account when specifying volume size.  You should
  3332.            specify a smaller volume size during the "a" command before
  3333.            adding the comments.
  3334.  
  3335.            The "-v" switch will accept the abbreviations 360, 720, 1200,
  3336.            and 1440.  These will be translated to 362,000, 730,000,
  3337.            1,213,000, and 1,457,000 bytes, respectively.  Please note that
  3338.            if the available disk space is less than the requested amount,
  3339.            ARJ will prompt the user for permission to continue.
  3340.  
  3341.            You can use the "K" modifier as a shortcut for "000".  For
  3342.            example, 100K means 100000.  "K" does NOT mean 1024.
  3343.  
  3344.            ARJ will accept the "M" modifier to multiply by 1,000,000 (one
  3345.            million).
  3346.  
  3347.            The "-vv" switch turns on the next volume beep option.  When you
  3348.            select this option, ARJ will sound a beep prior to the next
  3349.            volume.
  3350.  
  3351.            The "-va" switch sets the disk space auto-detect option.  ARJ
  3352.            will check for the disk space available on the target directory
  3353.            and try to use all or most of it.  This option is aimed at
  3354.            diskette usage.  Please note that this switch option detects
  3355.            free disk space.  It does not detect formatted disk space.
  3356.            If the space available is less than 10,000 bytes, ARJ will
  3357.            prompt the user for permission to continue.  Please note that
  3358.            ARJ can support the use of diskettes formatted at higher than
  3359.            normal capacities such as 3.5 inch HD diskettes formatted at
  3360.            1.6 MB.
  3361.  
  3362.            Examples:  ARJ a A:backup -b -va
  3363.                       ARJ a backup -v360
  3364.  
  3365.            The "r" modifier allows the reservation of disk space on the
  3366.            first volume.  The number after the "r" specifies the space to
  3367.            reserve.  This is useful for software installation volumes.
  3368.  
  3369.            Example:  ARJ a install -v360r50K   make first volume 50000
  3370.                                                bytes smaller than 360K.
  3371.  
  3372.            New to ARJ 2.81/ARJ32 3.10 is the "rr" modifier.  This reserves
  3373.            disk space on all volumes.  The number after the "rr" specifies
  3374.            the space to reserve.  You can use the "r" and "rr" modifiers
  3375.            at the same time.
  3376.  
  3377.            Example:  ARJ a install -varr50K    save 50k bytes on all volumes
  3378.  
  3379.            New to ARJ 2.61 is a simple delete option "D" when creating
  3380.            volume archives.  For SAFETY REASONS, this delete option is
  3381.            limited in scope and specification.  The exact file or files
  3382.            (via wildcard) must be specified. A directory name is not
  3383.            sufficient (A:\ or C:\TEMP).  A filename or wildspec is
  3384.            required (A:\*.* or C:\TEMP\*.TXT).  In addition, this delete
  3385.            option does not delete through (recurse) subdirectories. In
  3386.            other words, this delete function works similar to the DOS DEL
  3387.            command except that a filespec is required.  ARJ accepts all
  3388.            characters after the "D" option as the filespec.
  3389.  
  3390.            Examples:  ARJ a a:archive -vada:\*.*
  3391.                       ARJ a testvol -v1440dtestvol.a*
  3392.  
  3393.            At ARJ release 2.71 and ARJ32 release 3.04 is an "E" option to
  3394.            set an alternate naming scheme for multiple volume archives.
  3395.            Instead of naming succeeding volumes with a numeric file
  3396.            extension, ARJ can overlay the three digit numeric sequences
  3397.            before the DOT file extension.
  3398.  
  3399.            Examples:  ARJ a archive -ve1440        =>
  3400.                           archive.ARJ, arch001.ARJ, arch002.ARJ, ....
  3401.                       ARJ a archive -je -ve1440    =>
  3402.                           archive.EXE, arch001.EXE, arch003.EXE, ....
  3403.                       ARJ a name001 -je -ve1440    =>
  3404.                           name001.EXE, name002.EXE, name003.EXE, ....
  3405.                                                            
  3406.            The switch modifier "s" can be used to make ARJ execute one
  3407.            specified system command prior to each volume or make ARJ pause
  3408.            for manual execution of system commands.  This is useful for
  3409.            purging target diskettes before ARJ writes to them.  Please note
  3410.            that when processing a large number of files, ARJ may not have
  3411.            enough free memory left to properly execute the system commands.
  3412.  
  3413.            The switch modifier "z" is identical to the "s" modifier except
  3414.            that the system command is NOT echoed to the screen.
  3415.  
  3416.            Optionally, after the "s" modifier, you can specify a system
  3417.            command or batch filename.  ARJ will automatically execute the
  3418.            command or batch file before each volume.  If the command has
  3419.            embedded blanks, then the entire switch option must be
  3420.            surrounded by double quotes.  The system command is executed
  3421.            before ARJ executes the auto-detect space option.
  3422.  
  3423.            Examples:  ARJ a A:backup -vas
  3424.                       ARJ a A:backup -vvas
  3425.                       ARJ a A:backup -v360s
  3426.                       ARJ a A:backup -vvw360s
  3427.                       ARJ a A:backup -vaspurge.bat
  3428.                       ARJ a A:backup -v360sdelete.bat
  3429.                       ARJ a A:backup -v1440da\:*.*
  3430.                       ARJ a A:backup "-vasFORMAT A:"
  3431.                       ARJ a A:backup "-vasDIR C:\ "
  3432.  
  3433.            Note that the last example has a space before the last double
  3434.            quote mark.  If the last space is missing, the internal command
  3435.            line parser will make the double quote mark part of the DIR
  3436.            command.
  3437.  
  3438.            The "-v" switch now accepts its modifiers in any order.  The "s"
  3439.            and "z" modifiers must be last because any succeeding text is
  3440.            considered the system command to execute.
  3441.  
  3442.            Examples:  ARJ a volume -vavw        beep, autosize, whole files
  3443.                       ARJ a volume -vavsDIR     beep, autosize, execute DIR
  3444.  
  3445.            Volume archives can be used as stand-alone archives for non-update
  3446.            commands except for the files that are split across volumes.
  3447.  
  3448.            It is recommended that the "-jt" (test archive) option be used
  3449.            with the "-v" switch to ensure perfectly built volumes as it is
  3450.            tedious to retest volumes after they are built.
  3451.  
  3452.            During ARJ operation in non-update commands, ARJ will not abort
  3453.            when it cannot open the correct sequential ARJ volume archive.
  3454.            It will report the open error and proceed to the "Ok to process
  3455.            the next volume?" prompt.  At this point it is possible to swap
  3456.            diskettes to put the correct volume in place.  This feature is
  3457.            disabled if the "next volume" prompt has been disabled.
  3458.  
  3459.            For those who have enough free hard disk space, the -v option
  3460.            can be used to make backing up the hard disk fairly easy.  ARJ
  3461.            can be set to create multiple floppy sized volumes on the hard
  3462.            disk for later copy to diskettes.  So even if ARJ is slow, you
  3463.            can fire up an ARJ backup and some time later, you can quickly
  3464.            copy the volumes to floppies.  Below are sample backup commands:
  3465.  
  3466.            arj a backup *.* -b2 -r -v360 -y -jt -js     full backup
  3467.            arj a backup *.* -b1 -r -v360 -y -jt -js     incremental backup
  3468.  
  3469.            *****************************************************************
  3470.  
  3471.            See the "-jn" and "-jx" options to see how to recover from an
  3472.            abort in the middle of a backup type operation.  ARJ will allow
  3473.            a restart in the middle of an aborted backup at the disk where
  3474.            the failure occurred.
  3475.  
  3476.            *****************************************************************
  3477.  
  3478.            To go along with the new CHAPTER feature, ARJ now supports the
  3479.            UPDATE of multiple volume archives.  To implement this feature
  3480.            reliably in multiple volumes, all new or changed files are added
  3481.            at the END of the LAST volume.  This re-arrangement only occurs
  3482.            with multiple volume archives.  This prevents the diskette
  3483.            overflow that would occur with earlier versions of ARJ.
  3484.            However, certain file attributes such as TEXT MODE may not be
  3485.            carried over to the updated file.
  3486.  
  3487.            *****************************************************************
  3488.  
  3489.            TIP:
  3490.  
  3491.            To pre-determine the number of diskettes required to archive a
  3492.            set of data, you can take advantage of the "s" option of the
  3493.            "-v" switch.  The "s" option lets you execute a DOS command
  3494.            prior to each volume.  You can specify a command that deletes
  3495.            the previously created archive volume.  This lets you use the
  3496.            same floppy diskette/hard disk space to build the multiple
  3497.            volumes.
  3498.  
  3499.            Example:  ARJ a a:volume -r -vada:volume.* -y c:\*.*
  3500.  
  3501.         w: assign Work directory
  3502.  
  3503.            This switch option is HIGHLY recommended if you are archiving
  3504.            directly to diskettes or if you have a sufficient RAMDISK space.
  3505.  
  3506.            By default, ARJ builds a new ARJ archive file in the same
  3507.            directory as the old archive file.  By specifying the "-w"
  3508.            switch, you can specify the working directory where the
  3509.            temporary archive file will be built.  After the temporary
  3510.            archive file is built, it is copied over the original one and
  3511.            deleted.
  3512.  
  3513.            Normally ARJ requires enough disk space for the original archive
  3514.            and the new temporary archive.  Specifying the "-w" switch
  3515.            allows you to move some of that disk space requirement to
  3516.            another directory.
  3517.  
  3518.            When using the "-w" switch while archiving to multiple volumes,
  3519.            ARJ will check the available disk space in the work directory.
  3520.            If there is not enough space, ARJ will prompt for permission to
  3521.            continue.  This prompt can be suppressed with the "-y" and
  3522.            "-jyk" switches.
  3523.  
  3524.            If the copy of the temporary archive on top of the original
  3525.            archive aborts, you will have to do the copy manually.  ARJ will
  3526.            not delete the temporary archive in this error situation. If you
  3527.            press CTL BREAK during the copy process, ARJ will delete both
  3528.            the temporary archive and the target archive unless this was a
  3529.            modification of an existing archive.
  3530.  
  3531.            Example:  ARJ a -we:\temp\ archive *.c
  3532.  
  3533.            For speed reasons, you should always use the "-w" option when
  3534.            creating or modifying archives on diskettes.  You should specify
  3535.            a work directory on your hard disk or ramdrive.
  3536.  
  3537.            Example:  ARJ a -we:\ b:archive *.c
  3538.  
  3539.            The "-w!" option will force ARJ to use a temporary work 
  3540.            directory ONLY when archiving to removable media such as a 
  3541.            diskette.  Otherwise, ARJ will ignore this option.
  3542.  
  3543.            Example:  ARJ a a:archive -w!c:\temp *.* -jt
  3544.  
  3545.            Typically, this option would be used in an ARJ configuration
  3546.            file or batch file.
  3547.  
  3548.         x: Exclude filenames
  3549.  
  3550.            This switch is used to exclude filenames or wildnames from the
  3551.            list of filenames to be processed.
  3552.  
  3553.            Example:  ARJ a archive soft\*.* -r -x*.exe -x*.obj -xtest
  3554.  
  3555.            This example will archive all files in the soft directory and
  3556.            subdirectories with the exception of any files named "test"
  3557.            or ending in ".exe" and ".obj".
  3558.  
  3559.            You can also specify an exclude file list by preceding the
  3560.            filename with the list character "!".  The exclude file list
  3561.            must contain a list of filenames/wildnames one per line with no
  3562.            leading or trailing blanks.
  3563.  
  3564.            Example:  ARJ a archive soft\*.* -r -x!exclude.lst
  3565.  
  3566.            You can specify a pathname to exclude as in:
  3567.  
  3568.            ARJ a archive \dir\*.* -r -x\dir\*.*
  3569.  
  3570.            In the above example, ARJ will exclude all files in \dir
  3571.            but not the subdirectories in \dir.
  3572.  
  3573.            The "-x" option also allows you to exclude an entire path
  3574.            including subdirectories from being selected for processing.
  3575.  
  3576.            Syntax:  ARJ a archive C:\*.* -xC:\TEMP\
  3577.  
  3578.            The "\" after C:\TEMP indicates to ARJ that everything below
  3579.            C:\TEMP\ is to be excluded.
  3580.  
  3581.            Note that the exclude directory option requires that the
  3582.            directory be specified in the same relative path that the
  3583.            selected files use.
  3584.  
  3585.            Example:
  3586.  
  3587.            arj a archive \temp\*.* -x\temp\firstdir     is correct usage
  3588.            arj a archive \temp\*.* -xC:\temp\firstdir   is NOT correct because
  3589.                                                         of the C:
  3590.  
  3591.            The "-x" switch also works for non-update commands like
  3592.            "e"xtract and "l"ist.
  3593.  
  3594.            Examples:
  3595.  
  3596.            arj e archive -x*.exe           extract all files except *.exe files
  3597.            arj l archive -x*.exe -x*.obj   list all files except *.exe and *.obj
  3598.  
  3599.            A maximum of 8000 filenames or wildnames can be excluded.
  3600.  
  3601.            Note that the "-x" option is unaffected by the "-p" option.
  3602.  
  3603.         y: assume Yes on all queries
  3604.  
  3605.            Use this switch for batch type uses of ARJ.  This switch
  3606.            disables most of the normal user queries during ARJ execution.
  3607.            Use this switch to suppress overwrite queries in the "e" and "x"
  3608.            commands, to suppress the make new directory query in the "e"
  3609.            and "x" commands, to suppress the new filename prompt when an
  3610.            open file operation fails in the "e" and "x" commands, to
  3611.            suppress the pause during the "s" command and to suppress the
  3612.            next volume pause using the "-v" option to create volumes on the
  3613.            hard disk.
  3614.  
  3615.            The "-y" switch will NOT suppress the "-v" next volume prompt
  3616.            when the archive is located on a drive with removable media
  3617.            such as a diskette drive.
  3618.  
  3619.            Use this option with due caution, especially during extraction
  3620.            as this sets ARJ to overwrite files.  However, the "-n" option
  3621.            can be used to avoid any overwriting.
  3622.  
  3623.            As an alternative, you can use the "-jy" option which lets you
  3624.            suppress individual types of user queries.
  3625.  
  3626.         z: specify file for archive comment
  3627.  
  3628.            The "-z" switch has been provided to facilitate batch commenting
  3629.            of ARJ archives with the "c" command.  When the "-z" option has
  3630.            been specified with or without a comment file, ARJ will only
  3631.            process the archive header comment and will skip any file
  3632.            commenting unless the "-jz" switch has been specified.
  3633.  
  3634.            A comment file containing only a single blank can be used to
  3635.            erase comments from ARJ archives.
  3636.  
  3637.            Syntax:  arj c archive -z
  3638.                     arj c archive -zcomment.txt
  3639.                     arj a archive -zcomment.txt
  3640.  
  3641.            The "-z" option also allows one to dump the ARJ archive header
  3642.            comment to a file.  This will only extract the main archive
  3643.            comment and not the individual file comments.
  3644.  
  3645.            Syntax:  arj e archive ... -zcomment.txt  dumps only the comment
  3646.                     arj x archive -zcomment.txt      dumps comment and files
  3647.  
  3648.        j#: store only the file CRC and not the file contents
  3649.  
  3650.            This switch allows the building and testing of a special ARJ
  3651.            "HOLLOW" archive that is missing the actual compressed file
  3652.            contents.  This allows the creation of small archives for CRC
  3653.            testing against the CRCs of actual files.  This is suited for
  3654.            special applications. Please take note that NO actual file data
  3655.            can be extracted from these "HOLLOW" archives.
  3656.  
  3657.            For example, a user has transported a directory of files from
  3658.            one PC to another PC.  At a later time, that user would like to
  3659.            determine which files have actually changed their contents
  3660.            regardless of the date-time stamps.  That user could archive the
  3661.            original directory using the -j# switch which builds the ARJ
  3662.            "hollow" archive with the sole exception that no compressed data
  3663.            is stored with the archive.  This allows the rapid building of a
  3664.            much smaller archive.  The file CRC is computed and stored in
  3665.            the archive.  This new "hollow" archive is transported to the
  3666.            other PC. A simple ARJ test command with the "-jt1" option on
  3667.            the other PC would point out files whose content's CRC do not
  3668.            match.
  3669.  
  3670.            Another use of this "hollow" archive is for FILE INTEGRITY
  3671.            checking.  You can create this "hollow" CRC archive and use it
  3672.            at a later time to determine if any files have been corrupted or
  3673.            damaged by VIRUS or system problems.
  3674.  
  3675.            Please note that there is a VERY SMALL possibility that a file
  3676.            has been changed and its new 32 bit CRC still matches.  That
  3677.            possibility is approximately one in four billion.
  3678.  
  3679.            The -j# option during an ARJ archive build will set the
  3680.            compression method to 9.  The only change is that the file
  3681.            header will indicate that the compressed file size is ZERO.
  3682.            Otherwise, the file header is the same as in an archive where
  3683.            the file was actually compressed and stored.
  3684.  
  3685.            To use this "hollow" archive to test CRCs against actual file
  3686.            CRCs, use the following syntax:
  3687.  
  3688.            Syntax:  ARJ t archive_name -jt1
  3689.                     ARJ t archive_name target_dir\ -jt1
  3690.  
  3691.            The second command above is used where the relative pathnames
  3692.            stored in the archive do not match up with the current
  3693.            directory. See the discussion in ARJ.TXT for more information on
  3694.            the option "-jt".
  3695.  
  3696.            When ARJ displays "NOT matched" for a "hollow" archive, it means
  3697.            the file size in the archive and the size of the actual file do
  3698.            NOT match.
  3699.  
  3700.       j#1: do not store file data or file CRC
  3701.  
  3702.            This option differs from the "-j#" option in that the 32 bit CRC
  3703.            is NOT stored.  The compression method is set to 8.
  3704.  
  3705.       j#2: restore file attributes
  3706.  
  3707.            This switch will set ARJ to restore the file attributes to the
  3708.            selected files.  No file will be extracted.  Archives created
  3709.            with the "-j#" and "-j#1" options can also be used.
  3710.  
  3711.       j#3: restore file dates
  3712.  
  3713.            This switch will set ARJ to restore the file dates (written,
  3714.            accessed, created) to the selected files.  No file will be
  3715.            extracted.
  3716.  
  3717.       j#4: restore file attributes and dates
  3718.  
  3719.            This switch will set ARJ to restore the file attributes and the
  3720.            file dates (written, accessed, created) to the selected files.  
  3721.            No file will be extracted.
  3722.  
  3723.        j$: do not process file DTA and DTC and physical disk file size
  3724.  
  3725.            This switch will set ARJ to NOT save the file properties
  3726.            date-time accessed and date-time created and physical disk file
  3727.            size.  This will save header size and result in a slightly
  3728.            smaller archive.  During extraction, this switch will set ARJ
  3729.            to NOT restore the file properties date-time accessed and
  3730.            date-time created.
  3731.  
  3732.            It is recommended that this switch not be enabled for multiple
  3733.            volume operations as ARJ stores the physical size of split files
  3734.            in the larger header for improved operation.
  3735.  
  3736.        ja: show ANSI comments
  3737.  
  3738.            This switch has acquired NEW functionality.  Its OLD function
  3739.            was to set ARJ to fully display ANSI escape sequences.  It now
  3740.            is used with the "ARJ p" command to display files using ARJ's
  3741.            own ANSI display handler.  ANSI.SYS is no longer needed.
  3742.  
  3743.            Example:  ARJ p ansifile -ja -q
  3744.  
  3745.       ja1: inhibit the display of the archive comment
  3746.  
  3747.            The "-ja1" switch will suppress the display of the archive
  3748.            comment.
  3749.  
  3750.       ja2: display filename
  3751.       
  3752.            The "-ja2" switch will force the "ARJ P" command is force the
  3753.            filename to be displayed with the output display.  This feature
  3754.            is intended for use with software tools for blind users.
  3755.        
  3756.            ARJ will generate a display similar to the following:
  3757.            Extracting BKC.BAT                    to STDOUT
  3758.  
  3759.        jb: set archive Backup type
  3760.  
  3761.            This switch sets ARJ to build a chapter archive.  Once an
  3762.            archive is set to a chapter archive, all subsequent processing
  3763.            will continue to treat it as a chapter archive.
  3764.  
  3765.            The advantage of a chapter archive over a series of separate
  3766.            archives of the same set of files is that space can be saved
  3767.            when archived files do not change.  A single chapter archive can
  3768.            produce the same results as one hundred standard archive
  3769.            backups.  In other words, one can update a chapter archive one
  3770.            hundred times and fully recover any one of those updates.
  3771.  
  3772.            Technically speaking, each file in a chapter archive has a
  3773.            chapter lifespan range.  When a file is backed up and has not
  3774.            changed since the last backup, only the lifespan range is
  3775.            changed.  A copy of the file is NOT added to the archive since a
  3776.            copy already exists in the archive.  If the backed up file is
  3777.            different from the previous version, then that file is added to
  3778.            the archive with an appropriate chapter range. The previous
  3779.            version of the file is still kept in the chapter archive.  When
  3780.            a particular chapter is restored, ARJ selects only the files
  3781.            whose lifespan includes the chapter number requested.
  3782.  
  3783.            As an example, suppose one made a series of daily chapter
  3784.            backups of a document directory where only one document out of
  3785.            the one hundred documents changes on a daily basis.  The chapter
  3786.            archive would contain the original one hundred documents plus a
  3787.            copy of each day's changed document.
  3788.  
  3789.            When processing chapter archives, all ARJ add type commands
  3790.            (A,M,F,U) will create a new chapter in the chapter archive.  Up
  3791.            to a maximum of 250 chapters can be stored in a single archive.
  3792.            The proper way to build and update a chapter archive is with the
  3793.            "ac" command.  You should use the same command line arguments
  3794.            for each chapter update.  If you fail to select the same files
  3795.            as before, the chapter archive will not update the lifespan
  3796.            ranges properly and those unselected files will "appear" to have
  3797.            been deleted for the current chapter.  By default, the "ac"
  3798.            command will update a chapter archive with files that are
  3799.            DIFFERENT from the previous chapter (different size or date-time
  3800.            stamp).  The "ac" command is actually an abbreviation for the
  3801.            following command and options: "u -u2 -jb", so you CANNOT use
  3802.            the "-u" or "-jb" options with the "ac" command.
  3803.  
  3804.            ARJ ac archive dir\  *.txt *.doc *.wri      initial build
  3805.            ARJ ac archive dir\  *.txt *.doc *.wri      second chapter
  3806.            ARJ ac archive dir\  *.txt *.doc *.wri      third chapter
  3807.            ARJ ac archive dir\  *.txt *.doc *.wri      fourth chapter
  3808.            ARJ ac archive dir\  *.txt *.doc            fifth chapter will be
  3809.                                                        missing all *.wri files
  3810.  
  3811.            An expert with ARJ may want to use the actual commands and
  3812.            switches instead of the "ac" command.
  3813.  
  3814.            ARJ u -u2 -jb archive dir\ *.txt
  3815.  
  3816.            It is possible to change a standard ARJ archive to a chapter
  3817.            archive with the "y" command and the "-jb" option.  The opposite
  3818.            is possible with the "-jb0" option.
  3819.  
  3820.            ARJ y archive -jb      converts archive to chapter archive
  3821.            ARJ y archive -jb0     converts chapter archive to standard archive
  3822.  
  3823.            The "cc" command is an abbreviation for the "y -jb" option.
  3824.  
  3825.            ARJ cc archive
  3826.  
  3827.            You can restore a specific chapter as in:
  3828.  
  3829.            ARJ x archive -jb10    restores chapter 10
  3830.            ARJ x archive -jb20    restores chapter 20
  3831.  
  3832.            You can restore a range of chapters as in:
  3833.  
  3834.            ARJ x archive -jb2-5   extracts chapters 2 to 5
  3835.            ARJ x archive -jb2-    extracts chapters 2 to the last chapter
  3836.  
  3837.            Please note that when restoring a range of chapters, ARJ will
  3838.            segregate each chapter's set of files in a numbered directory
  3839.            based upon the chapter number.  Files whose lifespans range over
  3840.            a series of chapters will be located in the first of that
  3841.            series.
  3842.  
  3843.            This feature is useful for looking over the changes that have
  3844.            occurred over a series of chapters.
  3845.  
  3846.            The "-jbn*", "-jbN-N*", "-jbN-*" options allow a user to
  3847.            extract only files that were newly added/updated to a chapter
  3848.            archive at the specified chapter or chapter range.  With this
  3849.            option, ARJ will NOT extract other files that are present in
  3850.            the specified chapter or chapter range but were not newly
  3851.            added/updated in the chapter or range.
  3852.  
  3853.            Example:  ARJ e archive *.* -jb5*
  3854.  
  3855.            In the above example, ARJ will only extract files that were 
  3856.            newly added/updated in chapter 5.  Other files in chapter 5 
  3857.            will NOT be extracted.  This will let the user see what was 
  3858.            updated in chapter 5.
  3859.            
  3860.            Example:  ARJ e archive *.* -jb4-7*
  3861.  
  3862.            In the above example, ARJ will only extract files that were 
  3863.            newly added/updated in chapters 4, 5, 6, and 7.
  3864.  
  3865.            List only files that were added after chapter 5.
  3866.  
  3867.            Example:  ARJ l archive *.* -jb6-*
  3868.  
  3869.            You can also list the files that were newly added/updated in a
  3870.            chapter or range.
  3871.  
  3872.            Examples:  ARJ l archive -jb4*
  3873.                       ARJ l archive -jb3-7*
  3874.  
  3875.            You can list the date and times of all of the chapter backups in
  3876.            an archive with the following command:
  3877.  
  3878.            ARJ lc archive
  3879.  
  3880.            This command is an abbreviation for ARJ l archive -jb* -hbc and
  3881.            lists the chapter labels in an archive.
  3882.            
  3883.            You can list a specific chapter or chapter range as in:
  3884.  
  3885.            ARJ l archive -jb10    lists chapter 10
  3886.            ARJ l archive -jb2-5   lists chapters 2 to 5
  3887.            ARJ l archive -jb2-    lists chapters 2 to the last chapter
  3888.            ARJ l archive          lists the most recent chapter
  3889.  
  3890.            You can see the chapter ranges for each file in the archive with
  3891.            the following command:
  3892.  
  3893.            ARJ l archive -jb* -jv
  3894.  
  3895.            When ARJ tries to modify a chapter archive that already has 250
  3896.            chapters in it, ARJ will return a DOS errorlevel of 12.  A batch
  3897.            program can take subsequent action by changing the name of the
  3898.            chapter archive to a backup name and then re-executing the
  3899.            failed ARJ command.
  3900.  
  3901.            To start all over again with a chapter archive, you can purge
  3902.            all of the previous chapters, convert the archive to a standard
  3903.            archive, and then back to an archive chapter.
  3904.  
  3905.            Example:  ARJ k archive *.*
  3906.                      ARJ y archive -jb0
  3907.                      ARJ d archive *.* -hbc       remove chapter labels
  3908.                      ARJ cc archive
  3909.  
  3910.            You cannot modify specific chapters other than the most recent
  3911.            chapter in terms of deleting files.
  3912.  
  3913.            You can remove the most recent chapter with one of the following
  3914.            commands:
  3915.  
  3916.            ARJ d archive *.* -jb
  3917.            ARJ dc archive *.*
  3918.  
  3919.            If you do not specify the "-jb" with a delete command, the
  3920.            archive chapter label will not be deleted.  See the "-jb*"
  3921.            option to remove file(s) in all chapters.
  3922.  
  3923.            You can comment the chapter labels as a way of identifying each
  3924.            chapter backup.
  3925.  
  3926.            ARJ c archive -hbc -jz         comments the last chapter label
  3927.            ARJ c archive "<<*" -jz        comments the last chapter label
  3928.            ARJ c archive -hbc -jz -jb*    comments all chapter labels
  3929.            ARJ c archive -hbc -jz -jb5    comments the label for chapter 5
  3930.  
  3931.            ARJ supports the "-jt1" compare testing of older chapters.
  3932.  
  3933.            Examples:  ARJ t chapters -jt1 -jb*    compare all chapters
  3934.                       ARJ t chapters -jt1 -jb9    compare only chapter 9
  3935.                       ARJ t chapters -jt1 -jb9*   compare only updated files in
  3936.                                                   chapter 9
  3937.                       ARJ t chapters -jt1 -jb2-4  compare files in chapters 
  3938.                                                   2 to 4
  3939.  
  3940.       jb0: clear chapter archive status
  3941.  
  3942.            This switch is used with the "y" command to convert a
  3943.            standard archive to a chapter archive.
  3944.  
  3945.            ARJ y archive -jb0   converts chapter archive to standard archive
  3946.  
  3947.       jb*: select all chapter backup files
  3948.  
  3949.            This switch is used to select all chapters.
  3950.  
  3951.            When it is used with the LIST command, ARJ displays all chapters.
  3952.  
  3953.            ARJ l archive -jb*     displays all files in all chapters
  3954.  
  3955.            It is possible to delete a file or files from ALL chapters.
  3956.  
  3957.            ARJ d archive -jb* vers.txt   deletes all copies of vers.txt
  3958.            ARJ d archive -jb* *.exe      deletes all copies of EXE files
  3959.  
  3960.            It is also possible to garble all chapter files.
  3961.  
  3962.            ARJ g archive -jb* -gpassword
  3963.  
  3964.        jc: exit after Count of files
  3965.  
  3966.            The "-jc" option sets ARJ to exit early from an archive scan
  3967.            when the specified number of files have been extracted, listed,
  3968.            printed, etc.  If no number has been specified, ARJ will set
  3969.            that number to the number of filename arguments.
  3970.  
  3971.            Examples:  ARJ e -jc archive file1 file2 file3
  3972.                       ARJ e -jc5 archive *.bat
  3973.  
  3974.            Note that "*.*" is considered a count of ONE argument.
  3975.  
  3976.            This option does NOT WORK when modifying an archive.
  3977.  
  3978.        jd: ensure free Disk space
  3979.  
  3980.            In extraction mode, this option causes ARJ always to ensure that
  3981.            it will leave the user specified amount of disk space available.
  3982.            ARJ will skip files that would exceed the disk space available
  3983.            limit.  Each file that is skipped will count as an error.  The
  3984.            default free space is zero bytes.
  3985.  
  3986.            Example:  ARJ e archive basedir\ *.doc -jd100K
  3987.  
  3988.            In the above example, ARJ will not extract any files that will
  3989.            cause the disk free space to be less than 100,000 bytes.  The
  3990.            "K" is a synonym for "000".  For example, 100K means 100000.
  3991.  
  3992.            In "l"ist or "v"erbose list mode, this option sets an error
  3993.            check at the end of the listing screen based upon the total of
  3994.            the original sizes of the files selected.  If the total size
  3995.            would exceed the user specified free space limit, ARJ will
  3996.            report an error at the end of the listing screen.
  3997.  
  3998.            Example:  ARJ l archive *.doc -jd10000
  3999.  
  4000.            In this example, ARJ will report an error if the current
  4001.            available disk space minus the total of the *.doc files is less
  4002.            than the specified minimum of 10,000 bytes.
  4003.  
  4004.            Example:  ARJ e archive *.* -jd0
  4005.  
  4006.            In this example, ARJ will skip extraction of any files that
  4007.            would result in a disk full error.
  4008.  
  4009.        je: create self-Extracting archive
  4010.  
  4011.            This option causes ARJ/ARJ32 to create a self-extracting .EXE 
  4012.            file instead of an .ARJ file. 
  4013.  
  4014.            NOTE:  A distribution license is required to distribute ARJ and 
  4015.            ARJ32 self-extracting archives.  A standard registration is not
  4016.            sufficient.
  4017.  
  4018.            See the file SFX.TXT for more information.
  4019.            
  4020.        jf: store/use Full specified path
  4021.  
  4022.            Normally, ARJ will strip all pathnames of drive letter and root
  4023.            symbol.  This switch disables this action.  When extracting 
  4024.            with the "x" command from an archive that was built with this 
  4025.            switch, ARJ will normally strip any drive letter and root
  4026.            symbol, unless the "-jf" option is specified again.  ARJ will 
  4027.            also strip the leading "\\" symbols from a UNC pathname
  4028.            (\\servername\filename) unless the "-jf" option is specified.
  4029.  
  4030.            Example: ARJ x archive -jf f:\data\1995\report.*
  4031.  
  4032.            The "-jf1" option will strip only the drive spec and NOT the
  4033.            root symbol.  You can use either the "-jf" or "-jf1" option
  4034.            during extraction to force use of the root directory.
  4035.  
  4036.            As of ARJ 2.42a, ARJ will always filename match using the full
  4037.            pathname even for extraction.
  4038.  
  4039.            Example: ARJ x archive d:\temp f:\data\1995\report.*
  4040.  
  4041.        jh: set Huffman buffer size
  4042.  
  4043.            ARJ has a default static Huffman buffer size of 16,384 bytes.
  4044.            This buffer size is better for compressing executable files.
  4045.  
  4046.            The buffer size in ARJ 0.15 and earlier was set to 65,500 bytes.
  4047.            That size is better for large text files.  You may specify a
  4048.            buffer size from 2,048 to 65,535 bytes.
  4049.  
  4050.            Example:  ARJ a archive *.txt -jh65500
  4051.  
  4052.            If you specify a Huffman buffer size, ARJ will use that size for
  4053.            all types of files specified by the archive command.
  4054.  
  4055.        ji: set Index filename
  4056.  
  4057.            The "-ji" switch is used to create an index file containing the
  4058.            filenames archived or meeting certain criteria.  This is
  4059.            especially helpful when using ARJ to do multiple floppy type
  4060.            archives.  This file SHOULD NOT be created on the floppy
  4061.            diskette if the floppy diskette is changed during the archival
  4062.            process.
  4063.  
  4064.            If the index file already exists, ARJ will append data to it.
  4065.  
  4066.            The index file contains three types of text lines.  The first
  4067.            type is the volume name record.  It contains the date, time,
  4068.            starting file position, and the archive name.  The second type
  4069.            is the filename record.  It contains only the filename.  The
  4070.            third type only occurs during archival with testing "-jt".  It
  4071.            is a line containing "Testing " and the archive name.
  4072.  
  4073.            This information is also useful for restarting "-v" multiple
  4074.            volume archives.  You need the filename and the starting file
  4075.            position.
  4076.  
  4077.            The "-ji" switch will log the following events:
  4078.  
  4079.            a, f, m, u - Log actual filenames added to archive and if testing
  4080.                         is enabled, the actual filenames that failed testing.
  4081.            d          - Log archived filenames deleted.
  4082.            e, x       - Log archived filenames successfully extracted.
  4083.                         Extracted files with CRC errors are NOT logged.
  4084.            j          - Log archived filenames added to archive.
  4085.            l, v       - Log archived filenames listed.
  4086.            t          - Log archived filenames that failed testing.
  4087.            w          - Log archived filenames that contain string matches.
  4088.  
  4089.            This logging function is especially helpful when testing and
  4090.            searching archives.  Extraction errors are logged to the index
  4091.            file.
  4092.  
  4093.            The "-hi" option will set ARJ to write more details to the index
  4094.            file.
  4095.  
  4096.            At ARJ 2.61, ARJ will also log extraction errors to the index
  4097.            file.
  4098.  
  4099.        jk: Keep temp archive on error
  4100.  
  4101.            When the "-jk" switch has been specified, ARJ will keep the
  4102.            temporary archive during an aborted archive build/update.
  4103.            During a failed build, ARJ will modify the temporary archive to
  4104.            make it usable by removing the broken portion.
  4105.  
  4106.        jl: display only filespecs
  4107.  
  4108.            The "-jl" option sets ARJ to display only the filespec of a
  4109.            filename instead of the full specified pathname during the 
  4110.            progress displays.  This will simplify the display output.
  4111.  
  4112.        jm: set Maximum compression
  4113.  
  4114.            The "-jm" switch sets the maximum compression mode.  This mode
  4115.            is used with method 1 "-m1" to increase its compression.  This
  4116.            may increase compression time significantly.
  4117.  
  4118.            You can get a 1 to 5 percent improvement in compression with
  4119.            ARJ -m1 -jm.
  4120.  
  4121.            The "-jm1" option provides slightly less compression than "-jm"
  4122.            at a faster speed.  This can range from slightly faster to much
  4123.            faster.
  4124.  
  4125.            Use of "-jm" with "-m2", "-m3", or "-m4" is NOT SUPPORTED.
  4126.  
  4127.        jn: set restart Name
  4128.  
  4129.            The "-jn" switch is used to restart interrupted multiple volume
  4130.            archive backups in conjunction with the "-jx" switch.  All
  4131.            selected files are skipped up to but not including the named
  4132.            file.  This feature works only when creating new archives.  It
  4133.            will not work properly when updating multiple volume archives.
  4134.  
  4135.            Example:  ARJ a volume -v360 -r -jn\BIN\TREE.COM -jx1230
  4136.  
  4137.            In the above example, all files scanned up to \BIN\TREE.COM are
  4138.            skipped.  Archiving will start at file position 1230 of file
  4139.            \BIN\TREE.COM.
  4140.  
  4141.            IMPORTANT!!!  The exact name of the starting file must be
  4142.            specified according to the wildnames/filespecs specified.  This
  4143.            name is the same as displayed by the Adding filename display and
  4144.            the same as written to the "-ji" index file.  Please note that
  4145.            \DOS\TREE.COM is not considered the same as DOS\TREE.COM with
  4146.            this option.
  4147.  
  4148.            New at ARJ 2.39 is the feature where ARJ will automatically
  4149.            scan the previously written index file ("-ji") to get the
  4150.            necessary restart information.  You only need append "-jn" to
  4151.            the previous backup command line.  This option will not work
  4152.            without the index file.  ARJ will automatically set the correct
  4153.            volume name.
  4154.  
  4155.            Example:  ARJ a a:backup c:\*.* -r -vvas -jiINDEX.FIL
  4156.                      ARJ a a:backup c:\*.* -r -vvas -jiINDEX.FIL -jn
  4157.  
  4158.        jo: query when updating an archive file
  4159.  
  4160.            The "-jo" option has two flavors.
  4161.  
  4162.            The "-jo" switch is used to query the user when using the ARJ
  4163.            "a" or "m" commands to add files to an archive.  Before ARJ
  4164.            overwrites an existing internal archive file when using "-jo",
  4165.            ARJ will query the user with "Update <filename>? ".  Without
  4166.            this option, ARJ will overwrite the internal archive file
  4167.            without querying.
  4168.  
  4169.        jo: extract to unique Output names
  4170.  
  4171.            The "-jo" switch during extraction allows automated handling of
  4172.            duplicate filenames.
  4173.  
  4174.            On extraction with the "-jo" switch where the output file
  4175.            already exists in the target directory, ARJ will attempt to
  4176.            generate a unique filename by changing the file extension to a 3
  4177.            digit number from .000 to .999.  If ARJ cannot generate a unique
  4178.            name, it will skip extracting the file.
  4179.  
  4180.            Do not try to extract multiple volume split files in separate
  4181.            extraction sessions using the "-jo" option.  ARJ will not be
  4182.            able to determine the correct output filename.
  4183.  
  4184.            New to this release, the "-jo" option during extraction works
  4185.            along with the "-f" and "-u" type options.  In other words, if
  4186.            you want to freshen a set of files from an archive, the use of
  4187.            the "-jo" option will generate unique names for any files
  4188.            extracted.
  4189.  
  4190.            Example:  ARJ x archive *.* -u -jo
  4191.  
  4192.       jo1: extract to unique Output names keeping file extension
  4193.  
  4194.            This switch will set ARJ on extraction to generate unique 
  4195.            output filenames AND keep the current file extension.
  4196.  
  4197.            Example: NOTE.TXT will generate NOTE.001.TXT and so on.
  4198.  
  4199.        jp: Pause after each screenful
  4200.  
  4201.            This switch will cause ARJ to pause after listing each screenful
  4202.            of data for the "l", "p", "v", "w" commands.  Press the ENTER
  4203.            key to continue the listing.  You can also enter "quit" to exit
  4204.            ARJ.  
  4205.            
  4206.            Only for the "p" command, ARJ will automatically zero out the 
  4207.            line count at the beginning of each file displayed. This will 
  4208.            cause any ARJ copyright or ARJ comment display to scroll off 
  4209.            the screen for the first file.
  4210.  
  4211.            In one special case, "ARJ -? -jp", the use of the -jp switch
  4212.            toggles page pauses off, because by default in help mode,
  4213.            pausing is on.
  4214.  
  4215.            You can specify the page size with the "-jp" option as in
  4216.            "-jp50".  This also turns on the pause mode.  If you wish to use
  4217.            this in ARJ_SW, it is suggested that you use "-jp50 -jp-" to set
  4218.            the page size and to turn off the pause mode.
  4219.  
  4220.            If the output of ARJ is being redirected to a file or other 
  4221.            device, the "-jp" option is ignored.
  4222.  
  4223.            Example:  ARJ l archive -jp  >  save.txt
  4224.  
  4225.        jq: set string parameter
  4226.  
  4227.            The "-jq" option is used to supply additional parameters to the ARJ
  4228.            w and ARJ b commands.  If the parameters contain blanks, then the
  4229.            entire "-jq" option must be enclosed by two double quote marks.
  4230.  
  4231.            See the "w" and "b" commands for the correct "-jq" syntax.
  4232.  
  4233.        jr: Recover broken archive files
  4234.  
  4235.            This switch is used to access headers and files in an archive
  4236.            that has been corrupted either with bad data or missing data.
  4237.            This switch lets ARJ find the next valid header for listing,
  4238.            extraction or testing.  ARJ will continue to look for headers
  4239.            until it finds the end of archive marker.  If the archive is
  4240.            damaged, ARJ may display a message stating that it encountered
  4241.            the end of file unexpectedly.
  4242.  
  4243.            This switch also will allow extraction of files with CRC or
  4244.            Bad file data errors.  Normally, ARJ will delete such extracted
  4245.            files.
  4246.  
  4247.            If file header data has been corrupted, ARJ will be unable to
  4248.            recover any file data associated with that header.  As of ARJ
  4249.            2.30, "Bad file data" errors will not abort the recovery
  4250.            process.
  4251.  
  4252.            Example:  ARJ e archive -jr
  4253.  
  4254.            The "-jr1" version of this switch allows processing of damaged
  4255.            ARJ archives that have an end of archive mark in the middle of
  4256.            the archive.  However, the use of this switch will always cause
  4257.            ARJ to display an "unexpected end of file" error message and to
  4258.            return a non-zero errorlevel.
  4259.  
  4260.            Refer to the section on ARJ-PROTECT data protection for a 
  4261.            better recovery scheme.
  4262.  
  4263.        js: Store archives by suffix
  4264.  
  4265.            This switch is used to set ARJ to store and not compress files
  4266.            with the following extensions: .ARJ, .ZIP, .LZH, .PAK, .ARC,
  4267.            .J, .RAR, .UC2, .ZOO
  4268.  
  4269.            The file extensions can be specified as follows:
  4270.  
  4271.            ARJ a archive -js.zoo.ice.gif
  4272.  
  4273.            The above command will store files with extensions ending in
  4274.            .ZOO, .ICE, and .GIF.  This overrides the defaults.
  4275.  
  4276.            You can use the environment variable ARJ_SW to set up your own
  4277.            defaults as follows:
  4278.  
  4279.            set arj_sw=-js.arj.zip.lzh -js-
  4280.  
  4281.            The "-js-" turns off the option by default so that when you
  4282.            specify the "-js" switch on the command line, ARJ will already
  4283.            know what extensions you want to store.
  4284.  
  4285.            The "-js" switch will recognize "." alone as a file extension
  4286.            indicating no file extension as in "-js." and "-js..arc"
  4287.  
  4288.        jt: Test temporary archive
  4289.  
  4290.            The "-jt" switch can used to set ARJ to execute an archive
  4291.            integrity check on an intermediate temporary archive before
  4292.            overwriting any pre-existing original archive.  If any error
  4293.            occurs, ARJ will not overwrite the original archive.  When used
  4294.            with the "-w" switch option, ARJ will also test the final
  4295.            archive file as well as the temporary archive before deleting
  4296.            any input files.  If no archive update occurs, no testing will 
  4297.            be done.
  4298.  
  4299.            Example:  ARJ m archive *.c -jt
  4300.  
  4301.            The "-jt" switch can be used with extract type commands to set
  4302.            ARJ to verify the archive before doing any extraction of files.
  4303.            If the archive fails verification, the extraction is NOT
  4304.            attempted.  This is useful for handling MAIL packets where
  4305.            archive corruption due to a bad file transfer is a fairly
  4306.            frequent event.
  4307.  
  4308.            Example:  ARJ e archive -jt
  4309.  
  4310.            The "-jt1" switch allows an actual file contents comparison in
  4311.            addition to the normal file CRC calculation check.  This option
  4312.            can also be used with the ARJ t (test) command.
  4313.  
  4314.            When used with the ARJ t command, ARJ "-jt1" will use the
  4315.            base_directory option and the filename stored in the archive to
  4316.            locate the original file.
  4317.  
  4318.            When used with the ARJ add/move/update type commands, ARJ will
  4319.            use only the filename stored in the archive to locate the
  4320.            original file.  Therefore, the "-jt1" option does NOT work with
  4321.            the "-e" option or when the original filename has a drive letter
  4322.            or root directory in it and you did not specify "-jf".
  4323.  
  4324.            Examples:  ARJ t -jt1 archive dir\
  4325.                       ARJ a -jt1 archive e:\temp\*.*  -jf
  4326.  
  4327.            When used during a chapter add, the "-jt1" option will compare
  4328.            only the files of the added chapter.  Previous chapters will
  4329.            only be CRC tested.
  4330.  
  4331.            Example:  ARJ ac archive c:\dir\*.* -jt1
  4332.  
  4333.            However, when the "-jt1" option is used during an archive "T"
  4334.            test command, ARJ will compare the selected chapter files to
  4335.            the files on disk.
  4336.  
  4337.            Example:  ARJ t archive -jt1 -jb9  compare chapter 9 files
  4338.  
  4339.            The "-jt2" switch allows the same features as "-jt1" except that
  4340.            the file compares are only done for the newly added/updated
  4341.            files.  This avoids the situation where the some of original
  4342.            input files are missing or have changed.  NOTE that a problem
  4343.            can occur with the "f" and "u" commands when files in the
  4344.            archive are NEWER than the files being added.  ARJ will
  4345.            considered the file up-to-date and added and will do a file
  4346.            compare.  
  4347.  
  4348.            For a chapter archive, the "-jt2" option will only compare files
  4349.            that are physically added to the archive.  Other files in the
  4350.            latest chapter will be CRC checked only.
  4351.  
  4352.            Example:  ARJ u -jt2 archive dir\
  4353.  
  4354.            When "-jt2" is used with the "t"est command, ARJ will skip
  4355.            comparing files that do NOT exist on disk.  ARJ will only do
  4356.            a CRC check for those files.
  4357.  
  4358.            Example:  ARJ t -jt2 archive *.*
  4359.            
  4360.            The "-jt3" switch allows one to do a quick compare of files
  4361.            within an archive and on disk.  ARJ will only compare the
  4362.            date-time stamps and the size of the files.
  4363.  
  4364.            For a chapter archive, the "-jt3" sets ARJ to compare only the
  4365.            files of the last chapter.
  4366.  
  4367.            Example:  ARJ ac -jt3 archive *.*
  4368.                      ARJ t -jt3 archive 
  4369.  
  4370.            There is a limitation in that multiple volume archives may
  4371.            generate (size) errors for the files split over volumes.  The
  4372.            use of the "-t1" options may cause size mismatch errors because
  4373.            of the lossy text compression.
  4374.  
  4375.            In DOS and Windows 9x when using removable media (diskettes), 
  4376.            ARJ will flush and invalidate cached diskette data from memory, 
  4377.            so that testing is done on the actual data on the diskette.  A 
  4378.            side effect of this improvement in reliability is longer 
  4379.            diskette testing times.
  4380.        
  4381.        ju: translate UNIX style paths
  4382.  
  4383.            This switch causes ARJ to translate any subsequently encountered
  4384.            pathnames to MS-DOS style from UNIX style.  This switch also
  4385.            causes translation of filenames entered as a result of ARJ
  4386.            prompts such as in comment filenames.
  4387.  
  4388.            Example:  ARJ a archive -ju /soft/*.c
  4389.  
  4390.        jv: set Verbose display
  4391.  
  4392.            This switch sets ARJ to display more information during the
  4393.            "t"est, "l"ist, and "ex"tract commands.
  4394.  
  4395.            Example:  ARJ t archive -jv
  4396.  
  4397.            The "-jv" switch causes the "v" command to display only the
  4398.            pathnames to the screen.
  4399.  
  4400.            The "-jv switch causes the "l" command to display chapter
  4401.            range numbers instead of the CRC value.
  4402.  
  4403.            The "-jv1" switch causes the "v" command to display the archive
  4404.            data in manner suitable for sorting on various fields.
  4405.  
  4406.            The "-jv" switch will set the "p", "s", and "w" commands to
  4407.            display IBM graphics characters (128 to 255).
  4408.  
  4409.            When updating a file in an archive with a file that is NOT
  4410.            newer and if the -jv option is selected, ARJ will display a
  4411.            message that there is "no change".
  4412.  
  4413.        jw: set extract output filename
  4414.  
  4415.            The "-jw" option allows you to specify the name of the
  4416.            extraction output file.  You should only select one file to
  4417.            extract when using this option.
  4418.  
  4419.            This is similar but not exactly the same as using the "p"
  4420.            command with DOS output redirection.  Using DOS redirection would
  4421.            cause all of the output of the extraction to be put into the
  4422.            output file.  Using "-jw" would set ARJ to prompt for
  4423.            overwrite permission per each file extracted to the output file.
  4424.  
  4425.            This option may be needed when trying to output binary data to
  4426.            a printer.
  4427.  
  4428.            Example:  ARJ e archive printer.dat -jwLPT1
  4429.  
  4430.        jx: start at eXtended position
  4431.  
  4432.            This switch is used to continue a file onto a new archive
  4433.            manually.  This switch is normally for use when a multiple
  4434.            volume "a" command has aborted.
  4435.  
  4436.            Example:  ARJ a arjvol.a01 manual.doc -jx100000
  4437.  
  4438.            This example archives manual.doc starting from file byte
  4439.            position 100,000 and on.
  4440.  
  4441.            In extraction mode, this sets ARJ to extract a file to an output
  4442.            file at a specified starting position.
  4443.  
  4444.            Example:  ARJ e -jx2000000 archive file1
  4445.  
  4446.            This example extracts the file "file1" to file1 starting at
  4447.            position 2,000,000 or at the end of the file.
  4448.  
  4449.            This is similar to using the command "ARJ p archive >> output".
  4450.            To duplicate this redirection with ARJ would require the
  4451.            following:
  4452.  
  4453.            ARJ e -jx2000K -jwoutput archive
  4454.  
  4455.            NOTE that the -jx option is NOT functional when adding a file to
  4456.            an archive that already contains one or more files.
  4457.  
  4458.            As a recovery technique, you can use the -jx option to force 
  4459.            the extraction of a file split across volumes when the starting 
  4460.            volume is lost or damaged.
  4461.  
  4462.            Example:  ARJ e archive.a01 splitfilename -jx0 
  4463.  
  4464.        jy: suppress queries assuming YES
  4465.  
  4466.            This switch is used to suppress individual ARJ user prompts.
  4467.  
  4468.            Syntax:  ARJ e archive -jy<flags>
  4469.  
  4470.            where <flags> is one or more of the following characters: a, c,
  4471.            d, k, n, o, s, v.  For each flag selected, ARJ will act as if
  4472.            you had answered YES to the suppressed question.
  4473.  
  4474.            A - skip append query during a multi-volume extraction
  4475.            C - skip create directory query
  4476.            D - skip delete files query
  4477.            K - skip disk space availability query
  4478.            N - skip new filename prompt
  4479.            O - skip overwriting existing file query
  4480.            R - erase all typeahead before prompting
  4481.            S - skip scanned enough text query
  4482.            V - skip ok to proceed to next volume query
  4483.            W - skip ok to proceed to next volume query except for
  4484.                removable media
  4485.            Y - accept single character Y/N/A/Q inputs
  4486.  
  4487.            Example:  ARJ x volume -v -jyaco
  4488.                      suppress append, create, and overwrite prompts.
  4489.  
  4490.            ARJ will allow you to specify individual "jy" options in
  4491.            separate switch strings as in "-jyy -jyr".  You may inhibit a
  4492.            switch as in "-jyr-".  As with other switches, the "jy"
  4493.            switches toggle as in "-jyr -jyr".
  4494.  
  4495.            As a clarification of older documentation, the "-jyv" option
  4496.            will disable the next volume prompt EVEN with removable media.
  4497.            The global "-y" option does not disable the next volume prompt
  4498.            with removable media.  The "jyw" option will disable the next
  4499.            volume prompt except when the volume is on removable media such
  4500.            as a diskette.  The "-jyw" option would typically be used in an
  4501.            ARJ configuration file or batch file.
  4502.  
  4503.        jz: specify file for file comment
  4504.  
  4505.            The "-jz" switch has been provided to facilitate batch
  4506.            commenting of one or more files within an ARJ archive.  Only one
  4507.            comment file can be specified.  That file will be used to
  4508.            comment each file specified on the command line.
  4509.  
  4510.            A comment file containing only a single blank can be used to
  4511.            erase comments from ARJ archives.
  4512.  
  4513.            Syntax:  ARJ c archive file1 -jzcomment.txt
  4514.                     ARJ c archive file1 -zheader.cmt -jzfile.cmt
  4515.  
  4516.            ARJ does not support the use of the -jz option with ARJ
  4517.            commands other than "c" as in ARJ c archive -jz.
  4518.  
  4519.        h#: append current date/time string
  4520.  
  4521.            The "-h#" switch sets ARJ to append the current date string in
  4522.            the form YYMMDD to the current archive name while keeping the
  4523.            file extension the same.
  4524.  
  4525.            The "-h#1" switch sets ARJ to append the current time string in
  4526.            the form HHMMSS to the current archive name while keeping the
  4527.            file extension the same.
  4528.  
  4529.            The "-h#2" switch sets ARJ to append the current date-time
  4530.            string in the form DHHMMSS to the current archive name while
  4531.            keeping the file extension the same.  In a ten day period, this
  4532.            option can be used to generate unique archive names.
  4533.  
  4534.            Examples:  ARJ a XX -h# *.c    creates archive name XX931209.ARJ
  4535.                       ARJ a YY -h#1       creates archive name YY123000.ARJ
  4536.                       ARJ a Y -h#2        creates archive name Y8123000.ARJ
  4537.  
  4538.            This function does NO checking for exceeding the proper filename
  4539.            length.  There are no options for rearranging the date/time
  4540.            formats.
  4541.  
  4542.            This feature has been modified to use only the last two digits
  4543.            of the year.  So the year 2010 will be represented by "10".
  4544.            This will still provide "uniqueness" for filename generation.
  4545.            Daily created archives will not collide name-wise for 100 years.
  4546.  
  4547.        h$: try to use long filenames (Windows 2000)
  4548.  
  4549.            This feature forces ARJ to attempt to use Win95 DOS long
  4550.            filename support functions under other operating systems such
  4551.            as Windows 2000.
  4552.  
  4553.            Apparently, Windows 2000 provides some of the DOS program
  4554.            longname functionality that Windows 95/98 provides.  This
  4555.            switch option forces ARJ to try to access Windows 2000 long
  4556.            filenames.
  4557.  
  4558.            Windows NT does not provide these DOS long filename functions.
  4559.  
  4560.            ARJ Software provides this option as a result of user requests.
  4561.            However, since this DOS access hook is not an official Windows
  4562.            2000 feature, we cannot provide technical support for this
  4563.            feature.  We do provide the program ARJ32 to fully support the
  4564.            Windows 32 bit environment (including long filenames) in
  4565.            Windows 95, 98, NT, ME, and 2000.
  4566.  
  4567.        ha: ignore readonly Attribute
  4568.  
  4569.            The "-ha" switch sets ARJ to reset the attributes of a file or a
  4570.            directory to be overwritten or a file to be deleted.  This
  4571.            allows the overwrite or delete operation to proceed.
  4572.  
  4573.            A slight performance degradation may result from using this
  4574.            option.
  4575.  
  4576.            Examples:  ARJ e archive -ha
  4577.                       ARJ m archive -ha dir\*.*
  4578.  
  4579.        hb: select by file attribute or type
  4580.  
  4581.            This switch is used to select by file attribute or file type.
  4582.  
  4583.            The "-hb" option can be used to select files by their attributes
  4584.            (normal, readonly, hidden, system, directory, and archive bit).
  4585.            "Normal" is defined as files that are NOT the following:
  4586.            readonly, hidden, system, label, chapter header, or directory.
  4587.            For extract/list operations, you can also select chapter labels
  4588.            and volume labels.  By default, the "-hb" option by itself
  4589.            selects all types of files.  If you specify a letter symbol
  4590.            representing a file type, you are selecting ONLY that type of
  4591.            file.  You can specify a series of letters representing all of
  4592.            the file types that you want to select.  For example, the
  4593.            "-hbdr" option selects both directories and readonly files.
  4594.            Selections are additive.
  4595.  
  4596.            Example: -hbnr   select only normal and readonly files
  4597.  
  4598.            Single letters represent each attribute or type.
  4599.              a - archive bit set
  4600.              b - archive bit clear
  4601.              h - hidden
  4602.              r - readonly
  4603.              s - system
  4604.              d - directory
  4605.              n - normal files (not d, h, r, s, l, c)
  4606.              l - volume label
  4607.              c - chapter label
  4608.              f - abbreviation for "ndhrs"
  4609.              w - Windows 9x long filenames
  4610.  
  4611.            The archive bit selection ("a" or "b") is a special case.  If
  4612.            you have selected no types of files EXCEPT files with the
  4613.            archive bit set, ARJ will select from the set of all file types.
  4614.            If you have selected one or more file types, ARJ will select
  4615.            based upon the archive bit from the selected set of files types.
  4616.  
  4617.            Examples: -hbhrsa      select hidden, readonly, system files with
  4618.                                   archive bit set
  4619.                      -hba         select all files with archive bit set
  4620.  
  4621.            Add/update options  :  f, d, r, h, s, n, a, b.
  4622.  
  4623.            Extract/list options:  f, d, r, h, s, n, a, b, c, l, w.
  4624.  
  4625.            Examples:  ARJ a archive *.* -r -hbrs   select only readonly
  4626.                                                    and system files
  4627.                       ARJ a archive *.* -r -hbd    store only directories
  4628.                       ARJ l archive *.* -hbr       list only readonly files
  4629.                       ARJ l archive -jb* -hbc      list chapter headers
  4630.  
  4631.            Notes:  The option "-hb" with no letter options is an
  4632.            abbreviation for "-hbndhrslc" (all types).
  4633.  
  4634.        hc: execute DOS Command at ARJ start
  4635.  
  4636.            The "-hc" switch sets ARJ to execute a DOS command at the start
  4637.            of the execution of ARJ immediately after the command line switch
  4638.            options have been processed, but before the wildcard search is
  4639.            started.  This can be used to clear the screen to hide the
  4640.            command line or to provide a pause option to allow swapping
  4641.            diskettes.
  4642.  
  4643.            Examples:  ARJ a -hcCLS archive -gpassword
  4644.                       ARJ a -hcPAUSE archive *.*
  4645.  
  4646.        he: skip test of security Envelope
  4647.  
  4648.            The "-he" switch sets ARJ to skip the verification step when
  4649.            accessing an ARJ-SECURED ARJ archive.  If an ARJ archive has
  4650.            a damaged ARJ-SECURITY envelope, you will have to use the "-he"
  4651.            option to extract the archive.
  4652.  
  4653.       he1: set error on security Envelopes
  4654.  
  4655.            The "-he1" switch sets ARJ to abort with an error code of 4 when
  4656.            processing a possibly ARJ-SECURED archive.  This is useful as a
  4657.            REARJ.CFG option for ARJ.  This will prevent REARJ from
  4658.            converting an ARJ-SECURED archive to the same or another format.
  4659.  
  4660.            Examples:  ARJ l secured.arj -he1
  4661.  
  4662.        hf: set short filenames only
  4663.  
  4664.            This switch disables Windows 9x long filename handling.  ARJ
  4665.            will use the standard DOS 8.3 APIs (DOS shortnames) to do its
  4666.            processing.  Files so archived with this switch can be extracted
  4667.            under Windows 9x and DOS.
  4668.  
  4669.            This switch can be used while listing a dual-name archive under
  4670.            Win9x to list/process the shortnames.
  4671.  
  4672.       hf1: set longnames in file comment or extract with W95LNAME.nnn name
  4673.  
  4674.            This switch in Win9x during archival sets ARJ to build a
  4675.            dual-name compatibility archive by storing the shortname in the
  4676.            filename field and the longname in the file comment field, so
  4677.            that both long filenames and short filenames are stored in the
  4678.            archive.
  4679.  
  4680.            Such a dual-name archive is compatible with older versions of
  4681.            ARJ. New versions of ARJ process such an archive according to
  4682.            the current operating system environment.  Under Win9x, the long
  4683.            filenames in the archive are used.  Under MS-DOS, the short
  4684.            filenames are used.  This processing is automatic for this
  4685.            release of ARJ.
  4686.  
  4687.            The "-e1" option does not affect the short name that is stored.
  4688.  
  4689.            During extraction this switch sets ARJ to extract files from a
  4690.            Win9x archive (built without "-hf" option) by using generated
  4691.            names.  ARJ will generate a short name based upon "W95LNAME.000"
  4692.            and its sequence number in the archive.
  4693.  
  4694.            Specifying the "-ji" option with an index filename along with
  4695.            "-hf1" will generate an index file with the W95LNAME.000 names
  4696.            and the associated long filenames.  The long filenames are
  4697.            quoted.
  4698.  
  4699.            Example:  ARJ x archive -hf1 -jiindex.log
  4700.  
  4701.            This option with "-ji" can be useful when trying restore long
  4702.            filenames on a system that allows long filenames such as
  4703.            OS/2, WinNT, or Linux.
  4704.  
  4705.            Please note that modifying a dual-name archive outside of
  4706.            Windows 9x is possible but it may produce an archive with some
  4707.            dual-names and some not.
  4708.  
  4709.            The "-hf1" option has no effect on a dual-name archive during
  4710.            extraction.
  4711.  
  4712.            Please note the shortname stored may be an absolute pathname.
  4713.  
  4714.       hf2: use long filenames in DOS
  4715.  
  4716.            This switch sets ARJ to attempt to extract using the long
  4717.            filenames stored in the archive.  No modification is done to the
  4718.            long filenames except by DOS itself.  This switch also sets ARJ
  4719.            to use the standard DOS 8.3 APIs for processing.  Because of the
  4720.            shortening of the filenames by DOS, duplicate filenames may
  4721.            result.
  4722.  
  4723.       hf3: set longnames in file comment and wildcard using shortnames
  4724.  
  4725.            This switch in Win9x during archival sets ARJ to build a
  4726.            dual-name compatibility archive by storing the shortname in the
  4727.            filename field and the longname in the file comment field, so
  4728.            that both long filenames and short filenames are stored in the
  4729.            archive.
  4730.  
  4731.            This is similar to the "-hf1" switch functionality EXCEPT that
  4732.            ARJ wildcard scans the file system using shortname wildcards.
  4733.  
  4734.            This switch provides a way of archiving files that have Win9x
  4735.            DOS inaccessible symbols in them like the copyright and
  4736.            trademark symbols.  Win9x DOS displays those filenames with the
  4737.            "_" character.  ARJ will store the long filename with the "_"
  4738.            character as is.  However, this means that a restore of the
  4739.            archive will not restore the filename as it was with the
  4740.            inaccessible copyright or trademark symbol.  It will be restored
  4741.            with a "_" symbol.
  4742.  
  4743.            Please note the longname stored may be an absolute pathname.
  4744.            
  4745.            When building a dual-name archive, ARJ will now check for files
  4746.            that have long filenames inaccessible through MS-DOS.  These 
  4747.            are filenames that contain symbols that WIN9x/MS-DOS translates
  4748.            into the underscore "_" symbol.  ARJ will display the "Can't 
  4749.            open ..." error message for each such file encountered.
  4750.  
  4751.       hf4: set ARJ to label all files as Windows 9x long filenames.
  4752.      
  4753.            This switch sets ARJ to label all files archived under Windows 9x
  4754.            as Windows 9x long filenames.  ARJ at 2.61 will by default
  4755.            label as Windows 9x long filenames only those files whose Windows
  4756.            9x long filename is different from its MS-DOS filename.
  4757.      
  4758.        hg: specify garble module filename
  4759.  
  4760.            This switch is used to specify the filename of the encryption
  4761.            module to be used when encrypting a new archive.  The default
  4762.            filename is "ARJCRYPT.COM".  ARJCRYPT.COM contains a new 
  4763.            encryption scheme that is partly incompatible with earlier 
  4764.            releases of ARJ.  This new scheme will accept passwords up to 64 
  4765.            characters.  The old scheme accepted only the first 32 characters
  4766.            of a password.  As long as your passwords are 32 characters or 
  4767.            less, your archives will be compatible with ARJ 2.60 encryption.
  4768.            
  4769.            ARJ will look for the encryption module in the directory that 
  4770.            contains the copy ARJ.EXE that is being executed unless the
  4771.            specified module name contains a path symbol "\" as in 
  4772.            "ARJ\OLDCRYPT.COM".  If you want to use a module in the current
  4773.            directory, you should specify the name as in ".\ARJCRYPT.COM".  
  4774.            The "." indicates the current directory.
  4775.  
  4776.            With an existing archive, ARJ detects the encryption scheme
  4777.            that was used to encrypt the archive and uses the same scheme
  4778.            without the need to specify the type of encryption. However, if
  4779.            you encrypted with a non-default ARJCRYPT.COM, you must specify
  4780.            the pathname with the "-hg" option.
  4781.  
  4782.       hg!: set ARJ to use the 40 bit garble algorithm
  4783.  
  4784.            This switch is used to specify the use of a built-in 40 bit
  4785.            version of the Russian GOST encryption algorithm.  This 
  4786.            algorithm is limited to a 40 bit key to meet USA encryption 
  4787.            export rules. Any password input to this function will be
  4788.            crunched down to a 40 bit size.  Only the first 32 characters 
  4789.            of the password will be accepted.
  4790.  
  4791.        hi: full detail display in Index files
  4792.  
  4793.            The "-hi" switch when used with the "-ji" switch sets ARJ to
  4794.            include the file date-time stamp, the original file size, the
  4795.            compressed file size, the compression ratio, and the filename in
  4796.            the index file.
  4797.  
  4798.            Example:  ARJ a a:backup c:\*.* -r -va -jiINDEX -hi
  4799.  
  4800.        hk: enable ARJ-PROTECT data damage protection
  4801.  
  4802.            The "-hk" switch sets ARJ to create ARJ-PROTECT damage
  4803.            protection data which is appended to the archive.  This
  4804.            ARJ-PROTECT data contains necessary information to repair
  4805.            damage to the protected archive.  The "-hk1", "-hk2" ....
  4806.            "-hk20" options will generate more ARJ-PROTECT data affording
  4807.            a higher probability of a successful repair at the cost of a
  4808.            larger archive.  Please note that ARJ may not accept larger
  4809.            "-hkX" numbers with smaller volume sizes.
  4810.  
  4811.            The "-hk!" switch sets ARJ to enable ARJ-PROTECT ONLY when
  4812.            archiving to removable media.  Otherwise, this switch is
  4813.            ignored.  Typically, this switch would be used in an ARJ
  4814.            configuration file or batch file.  When used in an ARJ
  4815.            configuration file, the "-hk!" option should be limited to
  4816.            specific commands.
  4817.  
  4818.            Examples:  ARJ a a:archive -hk
  4819.                       ARJ a a:archive -hk4
  4820.                       ARJ a a:archive -hk!5
  4821.  
  4822.            This protection feature is sector based and allows repair due
  4823.            to typical types of disk corruption (bad sector, virus damage,
  4824.            cross links, etc).  This type of sector protection is NOT
  4825.            effective for most data transmission problems where data is
  4826.            missing from the middle of a transmission.
  4827.  
  4828.            If an archive already exists, the archive can be ARJ-PROTECTED
  4829.            via the "t" command.  If the archive is already protected, ARJ
  4830.            will not protect it again.
  4831.  
  4832.            Example:  ARJ t archive -hk             appends ARJ-PROTECT data
  4833.  
  4834.            Please note that you CANNOT ARJ-PROTECT an existing unprotected
  4835.            multiple volume archive on removable media.  Doing so would
  4836.            cause the volume sizes to overflow.
  4837.  
  4838.            If you choose to ARJ-PROTECT an existing unprotected multiple
  4839.            volume archive on your hard drive during an archive
  4840.            modification, ARJ will ARJ-PROTECT all volumes even unmodified
  4841.            volumes.
  4842.  
  4843.            Example:  ARJ f archive -v1000K d:\*.* -hk
  4844.  
  4845.            Repair of a damaged ARJ-PROTECTED archive is done with the "Q"
  4846.            command.  The repaired archive is named ARJFIXED.ARJ.  The
  4847.            original damaged archive is not modified.  In addition,
  4848.            ARJFIXED.ARJ is newly ARJ-PROTECTED.
  4849.  
  4850.            Example:  ARJ q docs                    repairs archive
  4851.  
  4852.            For older style ARJ-PROTECTED archives (with accompanying .XRJ
  4853.            file), you must specify the "-hk" option along with the "q"
  4854.            command.
  4855.  
  4856.            Example:  ARJ q docs -hk                repairs archive
  4857.  
  4858.            Once an archive has been ARJ-PROTECTED, future archive updates
  4859.            will automatically include ARJ-PROTECTION.  That feature can be
  4860.            disabled with the "y" command.
  4861.  
  4862.            Example:  ARJ y docs -hk
  4863.  
  4864.            The "-hkX" protection factor stored in the ARJ-PROTECTED archive
  4865.            is used when updating the archive.
  4866.  
  4867.        hl: return error for Listfile error
  4868.  
  4869.            The "-hl" switch sets ARJ to report the "file not found" type
  4870.            of errors when processing the filenames in an ARJ listfile
  4871.            during an "add" type command (a, f, m, u).  ARJ will
  4872.            subsequently return a non-zero DOS errorlevel when such an
  4873.            error has been found.  Previous versions of ARJ ignored these
  4874.            types of errors.
  4875.  
  4876.            Example:  ARJ a a:backup !listfile -va -hl
  4877.  
  4878.        hm: increase filename capacity
  4879.  
  4880.            The "-hm" switch sets ARJ to transfer the list of filenames to
  4881.            be archived from the limited conventional memory to file
  4882.            storage. This allows a much larger number of files to be
  4883.            processed.  This option is ignored for all ARJ commands except
  4884.            "a", "f", "j", "m", "u".  ARJ32 ignores this option.
  4885.            Registered ARJ32 can handle over 2,000,000 files at one time.
  4886.            Registered ARJ can handle up to 260,000 files at one time.
  4887.  
  4888.            Normally, this switch sets ARJ to wait until it is out of memory
  4889.            storing filenames into a list before transferring that list to a
  4890.            temporary file.  That temporary file is put in the current
  4891.            directory or the special work directory if specified (-hm!F:\)
  4892.            or XMS memory is specified (-hm!).
  4893.  
  4894.            At ARJ 2.62c, ARJ will by default set -hm3000.  This means that
  4895.            if you are archiving over 3000 filenames, ARJ will use a disk
  4896.            file to manage the list of filenames.
  4897.  
  4898.            However, there may be a few cases where ARJ will run out of
  4899.            memory doing other tasks while it is storing this list.  In
  4900.            these cases, ARJ will abort.  The user can specify a numeric
  4901.            argument of "1" to this switch to force ARJ to transfer the list
  4902.            to file storage immediately.
  4903.  
  4904.            The "-hm" work directory is specified by appending a "!" to the
  4905.            "-hm" or "-hm1" options and then appending the filename to the
  4906.            option.  See below.
  4907.  
  4908.            Examples:  ARJ a archive c:\*.* -r -hm
  4909.                       ARJ a archive c:\*.* -r -hm1
  4910.                       ARJ a a:archive c:\*.* -r -va -hm500!F:\
  4911.                       ARJ a a:archive c:\*.* -r -hm!G:\temp\
  4912.  
  4913.            The use of a RAMDISK directory will provide the fastest
  4914.            operation.
  4915.  
  4916.       hm!: increase filename capacity with XMS memory
  4917.  
  4918.            The "-hm!" option with no pathname appended to it will set ARJ
  4919.            to store its list of filenames in XMS memory.  List processing
  4920.            will be faster using XMS memory as opposed to using disk space.
  4921.            If no XMS memory is available, ARJ will use conventional memory
  4922.            and then disk space if needed.
  4923.  
  4924.            If there is not enough XMS memory available for the internal
  4925.            list, ARJ will abort.  The XMS accelerator in Hurricane 2.0 for
  4926.            Windows MAY interfere with this switch while in Windows.
  4927.  
  4928.        hn: specify non-existent filespec
  4929.  
  4930.            The "-hn" switch sets the filespec that does NOT match any file.
  4931.            The default filespec is "...".  However, on some systems like
  4932.            using NOVELL, there is a valid filespec "...".  Since ARJ
  4933.            sometimes needs a filespec that is strictly a placeholder, this
  4934.            option should be used to specify some name that does not exist
  4935.            on disk.
  4936.  
  4937.            This option must be specified prior to any use of the
  4938.            non-matching filespec.  Setting it via the ARJ_SW variable is an
  4939.            excellent choice.
  4940.  
  4941.            Examples:  ARJ e -hn#### archive #### -zcomment.txt
  4942.                       SET ARJ_SW=-hn####
  4943.  
  4944.        ho: Only extract files with matches
  4945.  
  4946.            The "-ho" switch used with the "e" or "x" extract commands allows
  4947.            file extraction based upon a text search.  ARJ will prompt the
  4948.            user for text strings to search unless the "-jq" option has been
  4949.            specified.  See the "-jq" option in ARJ.TXT for detailed use
  4950.            information.  ARJ will extract a file within an archive if the
  4951.            file contains at least one occurrence of any of the specified
  4952.            search strings.
  4953.  
  4954.            Examples:  ARJ e archive -ho
  4955.                       ARJ e archive -ho -jq+3+textstring
  4956.  
  4957.            This option may not work properly with multiple volume split
  4958.            files.
  4959.  
  4960.       ho1: Only extract files without any matches
  4961.  
  4962.            The "-ho1" switch used with the "e" or "x" extract commands
  4963.            allows file extraction based upon a text search.  ARJ will
  4964.            prompt the user for text strings to search unless the "-jq"
  4965.            option has been specified.  See the "-jq" option in ARJ.TXT for
  4966.            detailed use information.  ARJ will extract a file within an
  4967.            archive if the file contain NO occurrences of any of the
  4968.            specified search strings.
  4969.  
  4970.            Examples:  ARJ e archive -ho1
  4971.  
  4972.            This option may not work properly with multiple volume split
  4973.            files.
  4974.  
  4975.        hq: ignore open access error on adds
  4976.  
  4977.            This switch sets ARJ to ignore the error that occurs when ARJ
  4978.            cannot open a file for lack of permitted access during an
  4979.            add-type command and/or a compare command.  This is DOS error
  4980.            code 5. This option applies only to files being added to a new
  4981.            archive and/or being compared.  For an existing archive, this
  4982.            option will be ignored during the add operation, but NOT during
  4983.            a subsequent compare operation.
  4984.  
  4985.            Typically, this switch would be used during network access or in
  4986.            Windows 9x where a file is open for exclusive use by another
  4987.            process.  Normally, in this situation, ARJ would return a
  4988.            non-zero DOS error level.  However, if this switch is specified,
  4989.            ARJ will NOT return a non-zero error level due to this specific
  4990.            open failure.
  4991.  
  4992.            If you use the "-ji" option to set up an index file, ARJ will
  4993.            log any file that it cannot open.
  4994.  
  4995.       hq1: ignore open not found error on adds
  4996.  
  4997.            This switch sets ARJ to ignore the error that occurs when ARJ
  4998.            cannot open a file because it cannot be found during an add-type
  4999.            command and/or a compare command.  This is DOS error code 2.
  5000.            This option applies only to files being added to a new archive
  5001.            and/or being compared.  For an existing archive, this option
  5002.            will be ignored during the add operation, but NOT during a
  5003.            subsequent compare operation.
  5004.  
  5005.            This open error typically happens when a temporary file that ARJ
  5006.            has found to archive is purged by another process before ARJ can
  5007.            actually open and compress/compare it.  This is not the same
  5008.            error as when a user specifies a filename on the command line
  5009.            and ARJ cannot find it.
  5010.  
  5011.            This error also occurs in Windows 9x when trying to archive 
  5012.            files with filenames that contain "unusual" symbols.  These are 
  5013.            the symbols that have no equivalent in MS-DOS.  MS-DOS displays 
  5014.            those symbols as "_" underscore.
  5015.            
  5016.            If you use the "-ji" option to set up an index file, ARJ will
  5017.            log any file that it cannot open.
  5018.  
  5019.       hq2: ignore open access error and not found error on adds
  5020.  
  5021.            This switch sets ARJ to ignore both the no access error and the
  5022.            not found error during an add-type command for new archives as
  5023.            above.
  5024.  
  5025.        hr: force processing of successive archives through errors.
  5026.  
  5027.            The "-hr" switch sets ARJ to attempt to continue processing
  5028.            successive archives even when they contains errors.  This option
  5029.            is aimed at ARJ wildcard use such as in the "ARJ t *.ARJ -hr"
  5030.            command.
  5031.  
  5032.        hs: disable file Sharing
  5033.  
  5034.            The "-hs" switch sets ARJ to disable its file sharing feature.
  5035.            This may be necessary for some unusual applications.
  5036.  
  5037.            It may also be necessary to use this option in network 
  5038.            applications.
  5039.  
  5040.        ht: specify Target directory
  5041.  
  5042.            This switch is provided as an alternative to the standard method
  5043.            of specifying a target directory.  This new option can be
  5044.            specified in the ARJ configuration file or in the ARJ_SW
  5045.            environment variable as well as on the command line.
  5046.  
  5047.            Examples:  ARJ x archive *.* -htD:\DESTDIR
  5048.                       SET ARJ_SW=-hf -htD:\DESTDIR
  5049.  
  5050.            The "-ht-" option will erase any target directory set in a
  5051.            configuration file.
  5052.  
  5053.        hu: allow the Updating of multiple volume archives
  5054.  
  5055.            The "-hu" switch sets ARJ to allow the updating of multiple
  5056.            volume archives.  This switch is obsolete as of ARJ 2.55.  ARJ
  5057.            now supports the update of multiple volumes.
  5058.  
  5059.        hv: verify the ARJ version number
  5060.  
  5061.            The "-hv" switch is used to verify the ARJ version number and/or
  5062.            whether the ARJ program is registered.  If the "-hv" option is
  5063.            specified by itself or with an appended "R", an unregistered ARJ
  5064.            will abort with an errorlevel of 1.  If a version number string
  5065.            is appended to the "-hv" option, a lower version numbered ARJ
  5066.            will abort with with an errorlevel of 1.
  5067.  
  5068.            Examples:  ARJ a archive -hv         check if registered
  5069.                       ARJ a archive -hvr        check if registered
  5070.                       ARJ a archive -hv2.50     check for version >= 2.50
  5071.                       ARJ a archive -hvr2.50    check if registered and
  5072.                                                 version 2.50 or greater
  5073.  
  5074.        hw: modify search filename display
  5075.  
  5076.            The "-hw" switch sets the ARJ w command to display the
  5077.            "Searching ...." filenames messages in a scroll saving format.
  5078.            Filenames of files that do not contain string matches will be
  5079.            overwritten on the screen.
  5080.  
  5081.            The "-hw1" switch sets the ARJ w command to display ONLY the
  5082.            "Searching ...." filenames messages for files that contain string
  5083.            messages.
  5084.  
  5085.            You should disable the progress indicator with the "-i" option.
  5086.  
  5087.        hx: specify archive file extensions
  5088.  
  5089.            The "-hx" switch allows the user to specify what the default
  5090.            file extension or extensions that are to be used by ARJ to
  5091.            access archive names that are not specified with file
  5092.            extensions.  ARJ will assume that the first extension specified
  5093.            will be the main default extension.
  5094.  
  5095.            Examples:  ARJ a archive *.* -hx.SDN   assumes default .SDN
  5096.                                                   file extension
  5097.                       ARJ l archive -hx.SDN.ARJ   looks for archive.SDN and
  5098.                                                   if not found, then looks
  5099.                                                   for archive.ARJ
  5100.  
  5101.        hy: set ARJ to extract using ANSI codepage
  5102.  
  5103.            This switch will set ARJ to allow the extraction of ARJ32 
  5104.            created archives containing ANSI codepage filenames.  ARJ for 
  5105.            DOS always uses the OEM codepage which may translate ANSI 
  5106.            codepage filenames incorrectly or not at all.  Filenames 
  5107.            containing only alphanumeric characters and the DOT symbol 
  5108.            should be translated correctly.
  5109.  
  5110.        hy: set ARJ32 to archive using ANSI codepage
  5111.  
  5112.            For typical English language use, this option is not necessary.
  5113.            
  5114.            The default for ARJ32 is the OEM codepage.
  5115.  
  5116.            When processing an archive, ARJ32 selects the codepage that was
  5117.            set when making the archive.
  5118.  
  5119.            ARJ32 provides the "-hy1" and the "-hy2" option to override the
  5120.            setting in the archive.  The "-hy1" option selects the OEM
  5121.            codepage.  The "-hy2" option selects the ANSI codepage.  On
  5122.            some systems with pathnames with special symbols, it may be
  5123.            necessary to use the "-hy2" option to force extraction using
  5124.            the ANSI codepage.
  5125.  
  5126.        hz: specify ARJ-SECURE feature (requires ARJ-SECURE key)
  5127.  
  5128.  
  5129.  
  5130.      SAMPLE ARJ COMMANDS:
  5131.  
  5132.         a: Add files to archive
  5133.  
  5134.            ARJ a archive
  5135.            ARJ a archive -n
  5136.            ARJ a archive -f
  5137.            ARJ a archive -jt
  5138.            ARJ a archive -jt1
  5139.            ARJ a archive -jt2
  5140.            ARJ a archive -q
  5141.            ARJ a archive -r -hk
  5142.            ARJ a archive dir\ -o
  5143.            ARJ a archive dir\
  5144.            ARJ a archive dir\ *.doc *.exe
  5145.            ARJ a archive !names.lst
  5146.            ARJ a archive -- -name-.txt
  5147.            ARJ a archive name1 name2 name3
  5148.            ARJ a a:archive -we:\ -vas c:\ -r -b2
  5149.            ARJ a a:archive.001 -we:\ -vvw360 c:\ -r -b1
  5150.            ARJ a archive -vw360 c:\ -r -y
  5151.            ARJ a archive c:\ *.* -r -jt1 -jf
  5152.  
  5153.  
  5154.         b: execute Batch or DOS command
  5155.  
  5156.            ARJ b archive name.txt
  5157.            ARJ b archive -jwOUT.NAM
  5158.            ARJ b archive SHEZ.EXE -jwSHEZ.EXE
  5159.            ARJ b archive *.exe -jwTEMP.EXE "-jqTEMP -help"
  5160.  
  5161.  
  5162.         c: Comment archive files
  5163.  
  5164.            ARJ c archive
  5165.            ARJ c archive -z
  5166.            ARJ c archive -zcomment.txt
  5167.            ARJ c archive -zNUL
  5168.            ARJ c archive file1 -jzcomment.txt
  5169.            ARJ c archive *.doc -jzNUL
  5170.  
  5171.  
  5172.         d: Delete files from archive
  5173.  
  5174.            ARJ d archive *.doc
  5175.            ARJ d archive *.* -n
  5176.            ARJ d archive *.* -y
  5177.            ARJ d archive !names.lst
  5178.  
  5179.  
  5180.         e: Extract files from archive
  5181.  
  5182.            ARJ e archive *.doc
  5183.            ARJ e archive *.doc -d
  5184.            ARJ e archive -jd50000
  5185.            ARJ e archive -jo
  5186.            ARJ e archive -c
  5187.            ARJ e archive dir\ *.doc -jt
  5188.            ARJ e archive *.doc -y
  5189.            ARJ e archive -# 10 15 20-40
  5190.            ARJ e archive -jb10*
  5191.  
  5192.  
  5193.         f: Freshen files in archive
  5194.  
  5195.            ARJ f archive
  5196.            ARJ f archive -r
  5197.            ARJ f archive dir\ -r
  5198.            ARJ f archive dir\ *.doc -r
  5199.            ARJ f archive dir\ -r -jt2
  5200.  
  5201.  
  5202.         g: Garble files in archive
  5203.  
  5204.            ARJ g archive -gpassword
  5205.            ARJ g archive *.doc -gpassword
  5206.            ARJ g archive -g?
  5207.            ARJ g archive -gpassword -hg
  5208.  
  5209.  
  5210.         i: check Integrity of ARJ.EXE
  5211.  
  5212.            ARJ i
  5213.            ARJ i c:\bin\arj.exe
  5214.  
  5215.  
  5216.         j: Join archives to archive
  5217.  
  5218.            ARJ j archive name1.arj name2.arj name3.arj
  5219.            ARJ j archive *.arj
  5220.            ARJ j archive arjsfx.exe
  5221.            ARJ j archive *.arj -o911201
  5222.            ARJ j archive *.arj -r
  5223.  
  5224.  
  5225.         k: purge bacKup files in archive
  5226.  
  5227.            ARJ k archive *.*
  5228.            ARJ k archive *.* -y
  5229.            ARJ k archive *.doc -n
  5230.  
  5231.  
  5232.         l: List contents of archive
  5233.  
  5234.            ARJ l archive
  5235.            ARJ l archive *.doc
  5236.            ARJ l archive -o911201
  5237.            ARJ l archive -o911201 -ob911231
  5238.            ARJ l archive -n
  5239.            ARJ l archive -jp
  5240.  
  5241.  
  5242.         m: Move files to archive
  5243.  
  5244.            ARJ m archive
  5245.            ARJ m archive *.doc
  5246.            ARJ m archive dir\ *.doc
  5247.            ARJ m archive dir\ *.doc -o
  5248.            ARJ m a:archive.001 dir\ -r -vvwas -jt2
  5249.  
  5250.  
  5251.         n: reName files in archive
  5252.  
  5253.            ARJ n archive
  5254.            ARJ n archive *.doc
  5255.            ARJ n archive !names.lst
  5256.            ARJ n archive -o911201
  5257.  
  5258.  
  5259.         o: Order files in archive
  5260.  
  5261.            ARJ o archive !names.lst
  5262.            ARJ o archive *.bat *.exe *.doc
  5263.            ARJ o archive file1 file2 file3
  5264.  
  5265.  
  5266.         p: Print files to standard output
  5267.  
  5268.            ARJ p archive
  5269.            ARJ p archive -jp
  5270.            ARJ p archive *.doc
  5271.            ARJ p archive -o911201
  5272.            ARJ p archive name.txt > PRN
  5273.  
  5274.  
  5275.         r: Remove paths from filenames
  5276.  
  5277.            ARJ r archive
  5278.            ARJ r archive *.doc
  5279.            ARJ r archive -o911201 -ob911231
  5280.  
  5281.  
  5282.         s: Sample files to screen with pause
  5283.  
  5284.            ARJ s archive
  5285.            ARJ s archive *.doc -y
  5286.            ARJ s *.arj -y -r
  5287.  
  5288.  
  5289.         t: Test integrity of archive
  5290.  
  5291.            ARJ t archive
  5292.            ARJ t archive *.exe
  5293.            ARJ t archive !names.lst
  5294.            ARJ t archive -jt1
  5295.  
  5296.  
  5297.         u: Update files to archive
  5298.  
  5299.            ARJ u archive *.doc
  5300.            ARJ u archive *.doc -jo
  5301.  
  5302.  
  5303.         v: Verbosely list contents of archive
  5304.  
  5305.            ARJ v archive
  5306.            ARJ v archive *.doc
  5307.            ARJ v archive -jv
  5308.            ARJ v archive -jv1
  5309.            ARJ v archive -jp
  5310.  
  5311.  
  5312.         w: Where are text strings in archive
  5313.  
  5314.            ARJ w archive
  5315.            ARJ w archive -hw
  5316.            ARJ w archive -jp
  5317.            ARJ w *.arj -jp
  5318.            ARJ w *.arj *.doc
  5319.            ARJ w *.arj *.txt -jq+5+string
  5320.            ARJ w archive "-jq-3-to be or not"
  5321.  
  5322.  
  5323.         x: eXtract files with full pathname
  5324.  
  5325.            ARJ x archive *.doc
  5326.            ARJ x archive *.doc -d
  5327.            ARJ x archive -jd50000
  5328.            ARJ x archive -jo
  5329.            ARJ x archive -c
  5330.            ARJ x archive dir\ *.doc
  5331.            ARJ x archive -jf
  5332.            ARJ x archive *.doc -jyc
  5333.  
  5334.  
  5335.         y: copY archive with new options
  5336.  
  5337.            ARJ y archive -je
  5338.            ARJ y archive -je1
  5339.            ARJ y archive -jb
  5340.            ARJ y archive -jb0
  5341.            ARJ y archive -gpassword
  5342.  
  5343.  
  5344.      ARJ_SECURITY ENVELOPE:
  5345.  
  5346.         The ARJ-SECURITY ENVELOPE feature provides a facility similar to
  5347.         other archivers.  This feature disallows any type of modification,
  5348.         even commenting, to an ARJ-SECURE sealed archive by ARJ.  Moreover,
  5349.         there are additional internal checks to determine if the ARJ-SECURE
  5350.         sealed archive has been modified in any way.  This EXTRA cost
  5351.         feature is intended for use by software developers who distribute
  5352.         their software in archived format and is only available for a
  5353.         special fee.  However, there can be no guarantee that this
  5354.         mechanism cannot be defeated.
  5355.  
  5356.         When accessing an ARJ-SECURED archive, ARJ will display a message
  5357.         indicating that ARJ is verifying the security envelope.  If the
  5358.         envelope is damaged, a message will be displayed indicating so. If
  5359.         the envelope is intact, then the ARJ-SECURITY signature of the user
  5360.         "sealing" the archive will be displayed.
  5361.  
  5362.         If the security envelope has been tampered with or the archive has
  5363.         suffered data corruption, ARJ will display a message stating that
  5364.         the security envelope has been damaged.  In addition, ARJ will
  5365.         abort processing the archive.  The ARJ "-he" option and the ARJSFX
  5366.         "-s" option will skip the envelope verification.  The most likely
  5367.         causes of an invalid envelope are that the file was corrupted in
  5368.         transmission or that the archive was tampered with.
  5369.  
  5370.         You may ARJ-PROTECT an ARJ-SECURED archive, but ARJ will not set 
  5371.         the AUTO ARJ-PROTECT flag within the archive because of the
  5372.         ARJ-SECURITY.
  5373.  
  5374.         CAUTION:  ARJ32 and ARJ versions 2.39 and above are NOT compatible 
  5375.         with ARJ-SECURED archives made by older versions of ARJ 
  5376.         (pre-2.39).  Please note that ARJ-SECURED archives are designed to
  5377.         "break" if modified.  Normally, ARJ will not modify an ARJ-SECURED
  5378.         archive, but if such an archive is modified, that archive may be
  5379.         unusable.
  5380.  
  5381.  
  5382.      KNOWN ARJ ISSUES/PROBLEMS:
  5383.  
  5384.         Apparently ARJ.EXE and LHA.EXE (possibly other archivers) will NOT
  5385.         function properly in a WINDOWS DOS box while the REMOVEIT Smart
  5386.         Custodian (July 7, 1995, Vertisoft) is running.  
  5387.  
  5388.         The -hm! option may not work in a WINDOWS DOS box while the XMS
  5389.         accelerator option of Hurricane 2.0 is enabled.
  5390.  
  5391.         Under MS-DOS 4.01, ARJ may not extract LARGE (greater than 32MB)
  5392.         files from multiple volume archives properly.  The "dir" reported
  5393.         size may be incorrect.  A simple "CHKDSK /f" will correct the size.
  5394.         This problem is due to a BUG in MS-DOS 4.01.  Microsoft Corp. has
  5395.         fixes available for several DOS 4.01 bugs including this one.
  5396.  
  5397.         Due to the inner workings of the Turbo C++ runtime library, ARJ
  5398.         may run out of memory if your computer is configured with 
  5399.         thousands of bytes of environment variables.
  5400.  
  5401.         The "-vs" option of ARJ may not function properly when ARJ is
  5402.         trying to archive several thousands of files.  This is due to a
  5403.         lack of free memory to execute any external commands.  The use of
  5404.         the "-hm" option will free up memory.
  5405.  
  5406.         When using a working directory, ARJ does not check for disk space
  5407.         before overwriting the original archive.  Be sure you have enough
  5408.         space before updating an archive using the "-w" switch.
  5409.  
  5410.         Because of a bug with extended archive header processing, you
  5411.         should convert to ARJ 2.10 and above as soon as practical.  This
  5412.         bug is NOT a current problem because no version of ARJ supports the
  5413.         use of the extended header.
  5414.  
  5415.         If you have garbled (-g) ARJ archives that were created by ARJ 2.21
  5416.         and the garbled files were stored (-m0) by ARJ, you may need to
  5417.         refer to ARJ 2.30 to extract those files without getting a CRC
  5418.         error.
  5419.  
  5420.         TSRs that activate via HOT KEYS may be inhibited by ARJ during user
  5421.         keyboard input.  This is a "feature" of the Turbo C++ getc()
  5422.         function.  A partial workaround is to use the ARJ "-jyry" option to
  5423.         go to single key query mode.
  5424.  
  5425.         A similar problem occurs with HYPERDISK and staged writes.
  5426.         HYPERDISK's timer delay appears to be inhibited during ARJ user
  5427.         keyboard input such as during "Ok to .... volume/diskette?".  This
  5428.         causes an error when you swap to the next diskette.  The workaround
  5429.         is to use the ARJ "-jyry" option to go to single key query mode.
  5430.  
  5431.         There is a reported problem using ARJ and floppy disk drives when
  5432.         using the disk cache program SUPER PCKWIK 3.30 with advanced
  5433.         diskette support (/D+).  The system may occasionally hang when ARJ
  5434.         attempts to read/write the diskette.  You may also get CRC or Bad
  5435.         file data errors.  Disabling the SUPER PCKWIK option with /D-
  5436.         appears to remove this problem.  Other programs have similar
  5437.         problems with this feature of SUPER PCKWIK.
  5438.  
  5439.         The "-jn" option does not work properly WHEN updating a multiple
  5440.         volume archive.  The "-jn" option was designed for restarting a
  5441.         new multiple volume archive build after a halt.  A fix is being
  5442.         considered.
  5443.  
  5444.         Selecting a large ARJ-PROTECT factor "-hkX" for a multiple volume
  5445.         build with very small volumes may result in a malfunction due to
  5446.         the size of the ARJ-PROTECT recovery data relative to the volume
  5447.         size.  But this is a very uncommon situation.  A fix is planned.
  5448.  
  5449.  
  5450.      ARJ ERROR MESSAGES:
  5451.  
  5452.         See the document ERRORS.TXT.
  5453.  
  5454.  
  5455.      COMMONLY ASKED QUESTIONS:
  5456.  
  5457.         1) I have forgotten my password to an important garbled ARJ
  5458.         archive.  Is there an easy way to recover my lost files?
  5459.  
  5460.         ANSWER:  Sorry.  Generally speaking, there is no easy way.  There
  5461.         is brute force trial and error.  ARJ does not have any publicly
  5462.         known or secret backdoor access to passwords.  The password is not
  5463.         stored in the archive in any form nor is any hint stored.
  5464.  
  5465.         2) During extraction, ARJ aborts with a "Bad header" or "Bad file
  5466.         data" error message.  How do I recover my files?
  5467.  
  5468.         ANSWER:  Using the -jr option of ARJ, you should be able to recover
  5469.         the uncorrupted files in the archive.  The corrupted files are
  5470.         unrecoverable.  As a preventative, you can use the -hk option to
  5471.         build an error correction recovery file that will allow you to
  5472.         correct minor data corruption problems.
  5473.  
  5474.         3) How do I backup a directory and its subdirectories and files to
  5475.         multiple diskettes?
  5476.  
  5477.         ANSWER:  You should use a command as follows:
  5478.         ARJ a a:archive c:\dir\*.* -va -r -a1
  5479.         The -va option assumes that you are using formatted blank
  5480.         diskettes.  The -r option sets ARJ to recurse subdirectories. The
  5481.         -a1 option sets ARJ to store empty directories.
  5482.  
  5483.         4) Do I have to register ARJ if I use it at home for my personal
  5484.         computer activities (BBSing, backup, sharing files)?
  5485.  
  5486.         ANSWER:  No, you do not have to register ARJ for such activities.
  5487.         Instead, please share ARJ with a friend as a way of showing your
  5488.         appreciation.
  5489.  
  5490.         5) Can I distribute ARJ self-extracting archives or ARJ.EXE without
  5491.         a license?
  5492.  
  5493.         ANSWER:  You may share these files with others for personal use.
  5494.         However, you cannot distribute self-extracting files publicly
  5495.         without a license.  You cannot distribute ARJ.EXE to install
  5496.         software without a license.  The UNARJ.EXE program is freely
  5497.         available to install software.
  5498.  
  5499.         6) Can I distribute ARJ archives freely?
  5500.  
  5501.         ANSWER:  Any ARJ archives (not self-extracting) can be distributed
  5502.         freely.  Commercial users must have a registered ARJ to make the
  5503.         ARJ archives.
  5504.  
  5505.         7) ARJ displayed an error message indicating it ran out of memory
  5506.         backing up my disk with 20,000 files on it.  How can I proceed?
  5507.  
  5508.         ANSWER:  You should specify the -hm option to set ARJ to use disk
  5509.         space to handle all of the filenames.  ARJ automatically uses
  5510.         this option.
  5511.  
  5512.         8) I am trying to extract a multiple volume archive.  How do I get
  5513.         ARJ to prompt for the second diskette?
  5514.  
  5515.         ANSWER:  You need to specify the -v option to set ARJ to prompt for
  5516.         subsequent diskettes.
  5517.  
  5518.         9) How do I extract an ARJ archive recovering the original
  5519.         pathnames?
  5520.  
  5521.         ANSWER:  Use the "x" command as in "ARJ x archive".
  5522.  
  5523.         10) How do I create a self-extracting archive?
  5524.  
  5525.         ANSWER:  Use the -je or -je1 options as in "ARJ a archive *.* -je".
  5526.  
  5527.         11) How do I save empty directories in an archive?
  5528.  
  5529.         ANSWER:  Use the -a1 or -hb option along with -r.
  5530.  
  5531.         12) Can I include ARJ.EXE in my CD-ROM collection of unregistered
  5532.         shareware/freeware?
  5533.  
  5534.         ANSWER:  Any person or publisher may freely use and/or include
  5535.         ARJ.EXE in a CD-ROM collection of unregistered shareware/freeware
  5536.         provided the full shareware version of ARJ is included on the
  5537.         CD-ROM.
  5538.  
  5539.         13) How do I extract an ARJ archive created under Windows 9x to
  5540.         a DOS only PC or to a Windows NT/2000 PC?
  5541.  
  5542.         ANSWER:  You have two options.  The easiest is to use the "-hf2"
  5543.         option to force ARJ to attempt to restore the long filenames that
  5544.         are in the Win9x ARJ archive.  ARJ will try to use DOS to create
  5545.         the appropriate filenames.  DOS only allows the standard 8.3 name
  5546.         format.  Example:  ARJ x archive -hf2
  5547.  
  5548.         The other option uses the "-hf1" option and the "-ji" option. The
  5549.         "-hf1" option sets ARJ to extract files as "W95LNAME.000" names
  5550.         with the file extension indicating the sequence number.  The "-ji"
  5551.         option is used to create a log file with the "W95LNAME.000" names
  5552.         and their equivalent long filenames.  This log file can be edited
  5553.         into a batch file that can be used to recreate the original names.
  5554.         Example:  ARJ x archive -hf1 -jiNAME.LOG
  5555.  
  5556.         14) How do I extract files to the directory C:\Program Files?
  5557.  
  5558.         ANSWER:  When specifying filenames with embedded blanks, they 
  5559.         should be quoted.  If the last symbol before the last double quote 
  5560.         mark is a backslash, a space must be inserted before the double 
  5561.         quote. You may alternatively use the "-ht" option.
  5562.  
  5563.         Example:  ARJ x archive "C:\Program Files"    or
  5564.                   ARJ x archive "C:\Program Files\ "  or
  5565.                   ARJ x archive "-htC:\Program Files" 
  5566.  
  5567.         15) Can I specify a volume size other than 360K, 720K, 1200K, or
  5568.         1440K?
  5569.  
  5570.         ANSWER:  Yes, you can by specifying the exact byte size.  You can
  5571.         use "K" and "M" as modifiers.
  5572.  
  5573.         Examples:  ARJ a f:archive -v100000000 c:\*.* -r
  5574.                    ARJ a f:archive -v100M c:\*.* -r
  5575.                    ARJ a f:archive -v100000K c:\*.* -r
  5576.  
  5577.         16) How do I update diskette volume archives?  I get disk space
  5578.         error messages.
  5579.  
  5580.         ANSWER: When updating volume archives on diskettes, you need to
  5581.         specify a work directory to have enough work space.
  5582.  
  5583.         Example:  ARJ u a:archive -v1440 -wc:\temp c:\dir\*.*
  5584.  
  5585.  
  5586.      ARJ TECHNICAL SUPPORT:
  5587.  
  5588.         We have received many useful suggestions from users all over the
  5589.         world.  Many of those suggestions are in this version or will be
  5590.         incorporated in later versions of ARJ.
  5591.  
  5592.         We will try to resolve software problems with ARJ as they are made
  5593.         known to us.  Please notify us of any ARJ problems by mail, email,
  5594.         fax, or via the ARJ support BBSes mentioned below.  We will strive
  5595.         to keep ARJ a robust, stable and useful product.
  5596.  
  5597.         We will try to support unregistered users during their evaluation
  5598.         period, but please read the ARJ documentation first or visit our
  5599.         website.  Registered users will be eligible to receive technical 
  5600.         support by mail, telephone, fax, or electronic mail.
  5601.  
  5602.         Please try to limit requests for ARJ COMMAND HELP.  Refer to the
  5603.         ARJ documentation FIRST.  The time we spend answering simple
  5604.         questions is time we cannot use to IMPROVE ARJ.
  5605.  
  5606.         ***************************************************************
  5607.         DO NOT ASK FOR TECHNICAL SUPPORT IN THE CASE OF LOST PASSWORDS!
  5608.         ***************************************************************
  5609.  
  5610.  
  5611.      ARJ AVAILABILITY:
  5612.  
  5613.         The latest version of ARJ/ARJ32 can be obtained from the following
  5614.         sources:
  5615.  
  5616.         ARJ HOME PAGE:  http://WWW.ARJSOFTWARE.COM
  5617.  
  5618.         ARJ SUPPORT BBSes:  See ARJ_BBS.TXT
  5619.  
  5620.         ARJ is available from a number of other BBSes, but we can only vouch
  5621.         for the integrity of the archive if the ARJ###.EXE verifies its
  5622.         ARJ-SECURITY envelope as valid.  If no security envelope exists,
  5623.         then the data has been re-archived and there is no assurance of
  5624.         data integrity.
  5625.  
  5626.         If none of the above sources are suitable, you may order a copy of
  5627.         the latest version of ARJ directly from the author.  Send a check
  5628.         or money order for five dollars (US) to cover the costs of shipping
  5629.         and handling.  Please specify diskette size (3.5 or 5.25 inch);
  5630.         otherwise, a 3.5 inch diskette will be shipped.  Please allow a few
  5631.         weeks for delivery, longer for foreign deliveries.
  5632.  
  5633.         Our address is at the end of this document.
  5634.  
  5635.  
  5636.      ARJ WEB SUPPORT
  5637.  
  5638.         ARJ on the Internet!  You can reach ARJ support information at:
  5639.  
  5640.         http://www.ARJSOFTWARE.com                    (ARJ homepage)
  5641.  
  5642.         http://www.Dunkel.de/ARJ                      (German and English)
  5643.         http://www.tsf.be                             (French and English)
  5644.  
  5645.  
  5646.      SDN EXTENSION FILES
  5647.  
  5648.         SDN International(sm) is a FidoNet hobby organization which makes
  5649.         available for distribution author-direct shareware files to FidoNet
  5650.         capable bulletin board systems world wide.  ARJ has been chosen by
  5651.         SDN sysops' consensus as its official compression utility.
  5652.  
  5653.         Program files distributed via SDN have a copyright ".SDN"
  5654.         extension.  Files distributed by SDN after February 1993 can be
  5655.         decompressed by ARJ.  Files dated earlier can be decompressed if
  5656.         the compression utility SDN previously used is on PATH.
  5657.  
  5658.         SDN files are security sealed with their own exclusive security
  5659.         seal, FSecure, created by Pacesoft.  This security may be verified
  5660.         using the FileTest utility available at the SDN Project AuthorLine
  5661.         BBS 203-634-0370 or at most SDN participating BBS sites.
  5662.  
  5663.         Shareware authors wishing to distribute shareware by release
  5664.         through SDN may contact the same SDN Project AuthorLine BBS.
  5665.  
  5666.  
  5667.      DISTRIBUTORS:
  5668.  
  5669.         A list of authorized ARJ agent/distributors are found in the
  5670.         file AGENTS.TXT.  They provide local registration and technical
  5671.         support for ARJ.  Other distributors only provide the evaluation
  5672.         version of ARJ.
  5673.  
  5674.  
  5675.      ACKNOWLEDGEMENTS:
  5676.  
  5677.         LHARC is the name of an archiver by Haruyasu Yoshizaki.
  5678.         PKZIP and ZIP are trademarks of PKWare, Inc.
  5679.         PAK is the trademark of NoGate Consulting.
  5680.         ARJ is the trademark of ARJ Software, Inc.
  5681.  
  5682.         We wish to express my gratitude to Haruyasu Yoshizaki (Yoshi) for
  5683.         developing LHARC and distributing its source code.  LHARC gave us
  5684.         the impetus to start studying data compression.  We also wish to
  5685.         thank Haruhiko Okumura for providing additional ideas.  His AR001
  5686.         and AR002 program provided the basic design for the early versions
  5687.         of ARJ.
  5688.  
  5689.         And my thanks also go to Paul Kocher who contributed the design of
  5690.         the new ARJ SECURITY envelope mechanism.
  5691.  
  5692.         We also wish to thank Fabrice BELLARD for LZEXE which is used to
  5693.         squish the ARJSFX, ARJSFXJR, and ARJSFXV modules.
  5694.  
  5695.         We also wish to credit the following authors for providing UPX
  5696.         which was used to compress the ARJSFX32 module.
  5697.  
  5698.                     The Ultimate Packer for eXecutables
  5699.           Copyright (c) 1996-1999 Markus Oberhumer & Laszlo Molnar
  5700.                http://wildsau.idv.uni-linz.ac.at/mfx/upx.html
  5701.                           http://www.nexus.hu/upx
  5702.  
  5703.         UPX is a portable, extendable, high-performance executable packer
  5704.         for several different executable formats.
  5705.  
  5706.         We wish to thank those who have contributed significantly to the
  5707.         development of ARJ.  Those include:
  5708.  
  5709.         Etienne Joarlette
  5710.         Nico de Vries
  5711.         Frederic Taes
  5712.         Soeren Pingel Dalsgaard
  5713.         Axel Dunkel
  5714.         Jonathan Forbes
  5715.         Ron Freimuth
  5716.         Brian Godette
  5717.         Robb Hufalt
  5718.         Arkady Kleyner
  5719.         Michael Lawler
  5720.         Ken Levitt
  5721.         Eberhard Mattes
  5722.         Mike McCombs
  5723.         Alexander Pruss
  5724.         Joseph Teller
  5725.  
  5726.         And to the many others who have helped, provided messages of
  5727.         support, or provided financial support, THANKS!!!  Because of
  5728.         you, we are able to provide FULL-TIME support to ARJ!
  5729.  
  5730.         I personally wish to thank my wife, Susan, and my son, Timothy, for
  5731.         putting up with this ARJ obsession.  Their encouragement and support
  5732.         have been invaluable.
  5733.  
  5734.         Our greatest thanks goes to Almighty God for His inspiration and
  5735.         great salvation.  For apart from Him, ARJ could not have been done.
  5736.         John 15:5
  5737.  
  5738.         It is our prayer that this product not be used in any way to
  5739.         infringe or attack our freedom to worship.
  5740.  
  5741.  
  5742.      USAGE AND DISTRIBUTION POLICY:
  5743.  
  5744.         See LICENSE.TXT file for license policy.
  5745.  
  5746.  
  5747.      BRIEF BIOGRAPHY OF THE AUTHOR OF ARJ:
  5748.  
  5749.         Robert Jung grew up in Catonsville and Baltimore, Maryland.  He
  5750.         graduated from the University of Maryland in 1970.  After a short
  5751.         tour in the U.S. Army, he taught chemistry for six years.  From
  5752.         teaching he entered the computer programming profession where he
  5753.         was employed as a programmer analyst, a network analyst, and a
  5754.         software engineer.  In late 1990, he developed the ARJ archive
  5755.         format and program to meet a personal need in archiving.  In
  5756.         February of 1991, he released ARJ 1.00 as a shareware product.
  5757.         The author currently supports ARJ full-time and resides in Norwood,
  5758.         Massachusetts with his wife Susan, and son Timothy.
  5759.  
  5760.  
  5761.      FINAL COMMENTS:
  5762.  
  5763.         We do hope that you find this program as useful as we have.  We
  5764.         would appreciate any suggestions to improve this archiver.
  5765.  
  5766.         You can reach us at:
  5767.  
  5768.         Email address:  robjung@world.std.com
  5769.  
  5770.         Web site:       http://www.ARJSOFTWARE.com
  5771.  
  5772.         Fax number:     781-769-4893
  5773.  
  5774.  
  5775.         ARJ Software, Inc.
  5776.         P.O. Box 249
  5777.         Norwood MA 02062
  5778.         USA
  5779.  
  5780.  
  5781.       end of document
  5782.  
  5783.