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

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