home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / a / arj239d.zip / UPDATE.DOC < prev    next >
Text File  |  1993-03-06  |  14KB  |  429 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.39d                                  February 1993
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.30.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.         The main changes to this release compared to ARJ 2.30 are faster
  11.         compression speed, a better security envelope, and improved
  12.         backup usage features.
  13.  
  14.         ARJ uses a NEW SECURITY ENVELOPE scheme.  This version does NOT
  15.         recognize the previous envelope scheme nor will ARJ 2.39b or
  16.         before recognize the new security envelope scheme.  This is
  17.         INTENTIONAL as there exist hacks of the previous ARJ security
  18.         envelope.  You can use a previous version of ARJ to verify older
  19.         envelopes.  The previous ARJ-SECURITY codes do not work with
  20.         this new version.  New codes and software will be mailed to all
  21.         ARJ-SECURITY customers.
  22.  
  23.         The "-he" option from ARJ 2.39b has changed function.
  24.  
  25.         The self-extractor modules have been changed significantly.  The
  26.         standard ARJSFX module is 15K bytes in size.  A larger 17K
  27.         ARJSFX module supports ARJ-SECURITY.
  28.  
  29.         Various fields in the ARJ main header have been defined for use
  30.         at 2.39 and above.
  31.  
  32.         The large ARJSFX module will NOT prompt for permission to
  33.         continue the extraction if the "-e", "-x" or "-y" arguments have
  34.         been specified.
  35.  
  36.         The small ARJSFXJR module will count the skipping of files that
  37.         already exist as minor errors.  This ARJSFXJR skipping will
  38.         generate a DOS errorlevel of 1, while other errors will generate
  39.         a DOS errorlevel of 2.  However, with the new "-n" command line
  40.         option, ARJSFXJR will not count skips as an error.  The ARJSFXJR
  41.         module now supports command line options.
  42.  
  43.     To prevent novices from using ARJ to update a multiple volume
  44.     archive, ARJ will not allow a multiple volume update unless the
  45.     new "-hu" option has been specified.  Only multiple volume experts
  46.     should try updating these type of archives.
  47.  
  48.     The "-y" option no longers suppresses the multiple volume prompt
  49.     when the volume resides on a removable media drive such as a
  50.     diskette drive.  You can suppress the volume prompt with "-jyv".
  51.  
  52.         The processing of "-jy" and "v" switch options have improved to
  53.     be consistent with other switch processing.
  54.  
  55.     The ARJ yes/no query prompts have been changed to have a local
  56.     and a global effect.  See the USER PROMPTS section below.
  57.  
  58.     A new user prompt has been added just before asking for a new
  59.     filename during extraction when not overwriting.
  60.  
  61.     Whenever archiving to diskettes, it is HIGHLY recommended that the
  62.         option "-jt" be used.  This helps spot BAD diskettes or BAD
  63.         diskette drives.  It is HIGHLY recommended that the "-jt" option
  64.         be used in a multi-tasking or network environment.
  65.  
  66.     The command "ARJ e -d archive *.*" will now prompt for permission
  67.     to complete the deletion.
  68.  
  69.     Unless the "-jr" (recover) switch is used, ARJ will delete any file
  70.     extracted with a CRC or Bad file data error.
  71.  
  72.     The "m" (move) command and "-d" option will NOW delete directories
  73.     selected with the "-a1" option.
  74.  
  75.     UNERASE or UNDELETE commands do not always recover a file
  76.     correctly.  This will result in damaged archives.  This is true
  77.     for all archive types.    You should always test an archive after
  78.     unerasing it.
  79.  
  80.     If you use the software disk cache, HYPERDISK, see the KNOWN ARJ
  81.     ISSUES section in ARJ.DOC for important information.
  82.  
  83.      **********************************************************************
  84.  
  85.  
  86.      USER PROMPTS
  87.  
  88.     The ARJ user prompts have been improved to provide more
  89.     flexibility.  In addition to the normal yes and no responses, ARJ
  90.     also accepts the following responses: quit, always, skip, and
  91.     global.
  92.  
  93.     "Global" sets ARJ to inhibit all subsequent user prompts by assuming
  94.     YES for all queries as if "-y" were specified.
  95.  
  96.     The "Always" response has changed.  It now sets ARJ to assume YES
  97.     for subsequent queries of the same class.  For example, answering
  98.     YES to the overwrite query will assume YES for ALL subsequent
  99.     overwrite queries.
  100.  
  101.     "Skip" sets ARJ to assume NO for ALL subsequent queries of the same
  102.     class.
  103.  
  104.     Subsequent user prompt messages will still be output to the screen
  105.     after the "always" and "skip" responses but no user response will be
  106.     accepted.
  107.  
  108.  
  109.      ARJ ERROR LEVELS
  110.  
  111.     ARJ will now return a DOS errorlevel of 9 when trying to process
  112.     a file that is NOT an ARJ archive.
  113.  
  114.  
  115.      ARJ ARCHIVE NAME WILDCARDING
  116.  
  117.     ARJ allows the wildcarding of the archive parameter for ARJ
  118.     commands other than the add commands (a, f, j, m, u).  If the "-r"
  119.     option is specified, ARJ will scan through subdirectories looking
  120.     for ARJ archives to process.
  121.  
  122.     This feature allows a user to delete a specific file from a series
  123.     of archives.
  124.  
  125.     Example:  ARJ d *.ARJ bbs.ad
  126.  
  127.     This feature could also be used to extract a series of archives.
  128.  
  129.     Example:  ARJ e *.ARJ
  130.  
  131.  
  132.      ARJ COMMAND LINE PROCESSING
  133.  
  134.     The option "-x-" will now ignore any previous "-xfilename" options.
  135.  
  136.  
  137.      ARJSFX COMMAND LINE PROCESSING
  138.  
  139.     The larger ARJ self-extractor (-je) supports the new command line
  140.     option "-s" to allow the skipping of the ARJ-SECURITY envelope
  141.     verification test if an envelope exists.
  142.  
  143.  
  144.      ARJSFXJR COMMAND LINE PROCESSING
  145.  
  146.     The small ARJ self-extractor (-je1) supports command line
  147.     options.
  148.  
  149.     ARJSFXJR [-switch(es)] [drive:][target_dir\]
  150.  
  151.     switches:
  152.     n: set ARJSFXJR to NOT count as an error the skipping of files
  153.     o: set ARJSFXJR to overwrite existing files
  154.  
  155.     You can specify a target_directory or drive or both.  However,
  156.     you must specify the ending "\" or ":" symbol.
  157.  
  158.     ARJSFXJR -o C:\SOFT\  -> self-extract into directory "C:\SOFT\"
  159.                  in overwrite mode.
  160.  
  161.  
  162.      ARJ COMMANDS
  163.  
  164.      "a" command
  165.  
  166.     When adding files that replace files in an archive, ARJ will now
  167.     display a "Replacing " message to indicate an overwrite.
  168.  
  169.  
  170.      "e" and "x" commands
  171.  
  172.     When overwriting a file, ARJ will display file size and date-time
  173.     information concerning the ARJ file and the DISK file.
  174.  
  175.  
  176.      "p" command
  177.  
  178.     When using the ARJ "p" command to redirect output to a viewer
  179.     program such as "LIST", ARJ will now set the date-time stamp of
  180.     the intermediate temporary file to the date of the archived file
  181.     as opposed to the current date and time.
  182.  
  183.  
  184.      ARJ SWITCHES
  185.  
  186.      "-b3" switch
  187.  
  188.     The "-b3" switch is used to reset the archive bits of files being
  189.     extracted.  It is useful for setting the archive state so that a
  190.     subsequent incremental backup will not backup these extracted
  191.     files.
  192.  
  193.  
  194.      "-d" switch
  195.  
  196.     The "-d" switch when used during extraction with the wildcard "*.*"
  197.     will prompt the user for permission to delete the files.  This
  198.     prompt can be suppressed with the "-y" or "-jyd" options.
  199.  
  200.  
  201.      "-i2" switch
  202.  
  203.     The "-i2" switch sets ARJ to display a combined percentage and
  204.     bar progress display.
  205.  
  206.  
  207.      "-m" switch
  208.  
  209.     The "-m1" and "-m2" compression methods have been modified to
  210.     improve the compression ratios.
  211.  
  212.  
  213.      "-od" switch
  214.  
  215.     The "-od" switch sets ARJ to select files no older than the
  216.     specified number of days.  The days are calculated from midnight.
  217.  
  218.     Examples:  ARJ a archive -od0     select files modified today
  219.            ARJ a archive -od1     select files modified yesterday
  220.                      and today
  221.  
  222.  
  223.      "-v" switch
  224.  
  225.     When the multiple volume ARJ files to be used are located on drives
  226.     with removable media (diskette drives, etc.), ARJ will ALWAYS
  227.     PROMPT for the next diskette even with the "-y" option specified.
  228.     However, you can suppress the next volume prompt with the "-jyv"
  229.     option.  At DOS versions before 3.0, only drives A and B are
  230.     considered removable.
  231.  
  232.     After the pause to change diskettes, ARJ will check to make sure
  233.     that the diskette has been changed.  However, this check is limited
  234.         to 3 retries for the same volume.
  235.  
  236.     ARJ will not allow the updating of multiple volume archives unless
  237.     the "-hu" option is specified.
  238.  
  239.     The "r" modifier allows the reservation of disk space on the first
  240.     volume.  The number after the "r" specifies the space to reserve.
  241.     This is useful for software installation volumes built on the hard
  242.     disk.
  243.  
  244.     Example:  ARJ a install -v360r50K   make first volume 50000 bytes
  245.                         smaller than 360K.
  246.  
  247.     Example:  ARJ u archive -v360u
  248.  
  249.     The "z" modifier works like the "s" modifier except that the system
  250.     command is NOT echoed to the screen.
  251.  
  252.     The "-v" switch now accepts its modifiers in any order.  The "s"
  253.     and "z" modifiers must be last because any succeeding text is
  254.     considered the system command to execute.
  255.  
  256.     Examples:  ARJ a volume -vavw         beep, autosize, whole files
  257.            ARJ a volume -vavsDIR     beep, autosize, execute DIR
  258.  
  259.  
  260.      "-w" switch
  261.  
  262.     When using the "-w" switch while archiving to multiple volumes, ARJ
  263.     will check the available disk space in the work directory.  If
  264.     there is not enough space, ARJ will prompt for permission to
  265.     continue.  This prompt can be suppressed with the "-y" and "-jyd"
  266.     switches.
  267.  
  268.  
  269.      "-y" switch
  270.  
  271.     The "-y" switch will no longer suppress the "-v" next volume prompt
  272.     when the archive is located on a drive with removable media such as
  273.     a diskette drive.
  274.  
  275.  
  276.      "-ja1" switch
  277.  
  278.     The "-ja1" switch will suppress the display of the archive comment.
  279.  
  280.  
  281.      "-jn" switch
  282.  
  283.         The "-jn" switch is used to restart a multiple volume archive.  The
  284.         index file created by the "-ji" switch at ARJ 2.39 and above can be
  285.         used to facilitate restarting.  Please note that index files
  286.         created by older versions of ARJ will not work with this restart
  287.         method.  This method uses the "-jn" syntax without a filename.  The
  288.         previously written index file is scanned to determine the restart
  289.         information.
  290.  
  291.     To use this method of restarting, you must specify the "-ji" switch
  292.     to build an index file while archiving to multiple volumes.  To
  293.     restart an interrupted sequence, simply specify the EXACT SAME
  294.     command line as before and add "-jn".  ARJ will determine the
  295.     archive name, the restart filename, and the restart file position.
  296.  
  297.     Example:  ARJ a a:volume -va c:\*.* -r -jiINDEX.FIL
  298.           ARJ a a:volume -va c:\*.* -r -jiINDEX.FIL -jn
  299.  
  300.  
  301.      "-jp" switch
  302.  
  303.     The "-jp" switch will be ignored if the ARJ output has been
  304.     redirected as in "ARJ l archive -jp > dump".
  305.  
  306.  
  307.      "-jr" switch
  308.  
  309.     The "end of file" error message will no longer be displayed when
  310.     using the "-jr" option on a valid ARJ archive.
  311.  
  312.  
  313.      "-jr1" switch
  314.  
  315.     The "-jr1" switch should be used when "-jr" switch usage cannot
  316.     access some files in a damaged archive because of a premature end
  317.     of archive marker.
  318.  
  319.  
  320.      "-jy" switch
  321.  
  322.     The "-jy" switch options are now parsed like other switches with
  323.     regard to toggling and the "+/-" modifiers.  You can also specify
  324.     multiple occurrences of the "-jy" options.
  325.  
  326.     Examples:  -jyo -jyo    evaluates to no change
  327.            -jyo -jyo+    evaluates to suppress overwrite prompt
  328.            -jyo+c+y+    evaluates to suppress overwrite and create
  329.                 prompts and use single key input mode
  330.  
  331.  
  332.      "-ha" switch
  333.  
  334.     The "-ha" switch sets ARJ to reset the attributes of a file to be
  335.     overwritten or a file to be deleted.  This allows the overwrite or
  336.     delete operation to proceed.
  337.  
  338.     A slight performance degradation may result from using this option.
  339.  
  340.     Examples:  ARJ e archive -ha
  341.            ARJ m archive -ha dir\*.*
  342.  
  343.  
  344.      "-hc" switch
  345.  
  346.     The "-hc" switch sets ARJ to execute a DOS command at the start of
  347.     the execution of ARJ immediately after the command line switch
  348.     options have been processed, but before the wildcard search is
  349.     started.  This can be used to clear the screen to hide the command
  350.     line or to provide a pause option to allow swapping diskettes.
  351.  
  352.     Examples:  ARJ a -hcCLS archive -gpassword
  353.            ARJ a -hcPAUSE archive *.*
  354.  
  355.  
  356.      "-he" switch
  357.  
  358.     The "-he" switch sets ARJ to skip the verification procedure when
  359.     accessing an ARJ-SECURED ARJ archive.  This verification procedure
  360.     is time consuming and need only be done once to be sure of the
  361.     integrity of the archive.
  362.  
  363.  
  364.      "-he1" switch
  365.  
  366.     The "-he" switch sets ARJ to abort with an error code of 4 when
  367.     processing a possibly ARJ-SECURED archive.  This is useful as a
  368.     REARJ.CFG option for ARJ.  This will prevent REARJ from converting
  369.     an ARJ-SECURED archive to the same or another format.
  370.  
  371.     Examples:  ARJ l secured.arj -he1
  372.  
  373.  
  374.      "-hi" switch
  375.  
  376.     The "-hi" switch when used with the "-ji" switch sets ARJ to
  377.     include the file date-time stamp, the original file size, the
  378.     compressed file size, the compression ratio, and the filename in
  379.     the index file.
  380.  
  381.     Example:  ARJ a a:backup c:\*.* -r -va -jiINDEX -hi
  382.  
  383.  
  384.      "-hs" switch
  385.  
  386.     The "-hs" switch sets ARJ to disable its file sharing support.
  387.     This may be necessary for some unusual applications.
  388.  
  389.  
  390.      "-hu" switch
  391.  
  392.     The "-hu" switch sets ARJ to allow the updating of multiple volume
  393.     archives.  At this revision, by default, ARJ does not allow
  394.     updating of multiple volume archives because of the possibility of
  395.     losing data.
  396.  
  397.     Example:  ARJ c archive -hu -zcomment.txt
  398.  
  399.  
  400.      "-hw" switch
  401.  
  402.     The "-hw" switch sets the ARJ w command to display the
  403.     "Searching ..." filenames messages in a scroll saving format.
  404.     Filenames of files that do not contain string matches will be
  405.     overwritten on the screen.
  406.  
  407.     The "-hw1" switch sets the ARJ w command to ONLY display the
  408.     "Searching ..." filenames messages for files that contain string
  409.     messages.
  410.  
  411.  
  412.      "-hx" switch
  413.  
  414.     The "-hx" switch allows the user to specify what the default file
  415.     extension or extensions that are to be used by ARJ to access
  416.     archive names that are not specified with file extensions.  ARJ
  417.     will assume that the first extension specified will be the main
  418.     default extension.
  419.  
  420.     Examples:  ARJ a archive *.* -hx.SDN   assumes default .SDN
  421.                            file extension
  422.            ARJ l archive -hx.SDN.ARJ   looks for archive.SDN and
  423.                            if not found, then looks
  424.                            for archive.ARJ
  425.  
  426.  
  427.      end document
  428.  
  429.