home *** CD-ROM | disk | FTP | other *** search
/ Action Ware 9: Duke Nukem 3D / ACTWARE9.iso / actware9 / misc / arj / update.doc < prev    next >
Encoding:
Text File  |  1995-12-12  |  19.8 KB  |  504 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.50a                                    October 1995
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.41.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.         THIS VERSION OF ARJ IS AN OFFICIAL RELEASE.
  11.  
  12.         The mailing address of ARJ Software has changed as of August 1993.
  13.  
  14.         ARJ Software
  15.     Robert and Susan Jung
  16.         P.O. Box 249
  17.         Norwood MA 02062
  18.     USA
  19.  
  20.         FAX: 617-769-4893
  21.  
  22.         There is ARJ Internet mailing list and WEB site support
  23.         information added to the file ARJ.DOC.
  24.  
  25.         Beginning with this version of ARJ, full functionality of certain
  26.         ARJ software features will NOT be available in the shareware
  27.         versions of ARJ (registered or not).  These features include the
  28.         multiple volume self-extractor, the ARJSFX embedded command line
  29.         feature, and the inhibit display messages option.  The full
  30.         featured versions will ONLY be available from ARJ Software and
  31.         its agents.  Registered ARJ users can upgrade to this version for
  32.         a small shipping/handling fee ($5).  For credit card users, the
  33.         upgrade fee will be $10 because of minimum fee charge
  34.         requirements.
  35.  
  36.         See ARJDISP.DOC for information about a new feature for software
  37.         distributors using ARJ.
  38.  
  39.         Check the WHATSNEW.DOC file for changes since ARJ 2.41a.
  40.  
  41.         The new multiple volume self-extraction function is LIMITED in the
  42.         ARJ shareware version.  Only volumes of 360K or less in size can be
  43.         created AND only such volumes will be processed by the
  44.         self-extractor.  This feature is accessed through the "-je" option
  45.         along with the "-v" option.
  46.  
  47.         The ARJ Security envelope scheme in 2.50a is the SAME as in 2.41.
  48.         In other words, ARJ-SECURE 2.50a is compatible with 2.41.  There is
  49.         no change in the envelope key files.  However, the 2.50a version
  50.         of this ARJ-SECURE is able to make an archive and "seal" it with
  51.         the same command line.  ARJ-SECURE users can upgrade to this
  52.         version for a small shipping/handling fee ($5).
  53.  
  54.         ARJ can archive up to 32,000 files at one time when the new "-hm"
  55.         option is specified.  This option enables ARJ to use disk space
  56.         instead of memory space to manage the names of the files being
  57.         archived.
  58.  
  59.         Please note that older versions of ARJ.EXE will NOT process the
  60.         new multiple volume self-extractor.  An error message will be
  61.         displayed.
  62.  
  63.         A new option "-w" sets the ARJSFX module to skip the "Continue
  64.         extraction?" message.  This is a change from the former method to
  65.         inhibit the message.
  66.  
  67.         The extraction messages of the large ARJSFX module have been
  68.         shortened in default mode.  A new "-k" option will display the
  69.         long form of the messages.
  70.  
  71.         It is now possible for registered ARJ users to control whether
  72.         the ARJSFX module will display the overwrite, create directory,
  73.         and continue extraction prompts without requiring command line
  74.         options.  It is also possible to control the ARJSFXJR overwrite
  75.         behavior.
  76.  
  77.         A diskette change test will detect the failure to swap diskettes.
  78.         This can cause a problem for those who put more than one volume
  79.         per diskette.  However, this diskette change test is limited to
  80.         three retries, so ARJ will eventually accept the non-change of
  81.         diskette.  The user can inhibit this change test with the new
  82.         "-vi" option.
  83.  
  84.     Whenever archiving to diskettes, it is HIGHLY recommended that the
  85.     option "-jt" be used.  This helps spot BAD diskettes or BAD
  86.     diskette drives.  It is HIGHLY recommended that the "-jt" option
  87.         be used in a Windows or multi-tasking or network environment.
  88.  
  89.     UNERASE or UNDELETE commands do not always recover a file
  90.     correctly.  This will result in damaged archives.  This is true
  91.     for all archive types.    You should always test an archive after
  92.     unerasing it.
  93.  
  94.     If you use the software disk cache, HYPERDISK, see the KNOWN ARJ
  95.     ISSUES section in ARJ.DOC for important information.
  96.  
  97.         CAUTION: To those who use the -t1 and/or -t1g options to save a few
  98.         extra bytes.  This option should only be used on TEXT FILES. Those
  99.         are files created by EDLIN, EDIT, QEDIT, BRIEF, NOTEPAD, and
  100.         others.  Text files typically contain only letters, numbers,
  101.         spaces, and punctuation marks.  WORD PROCESSOR format files ARE NOT
  102.         TEXT FILES!  MS WORD, Wordperfect, AMIPRO, WRITE, and similar files
  103.         ARE NOT TEXT FILES. Using the -t1 or -t1g on any other kind of file
  104.         probably will result in DATA LOSS!
  105.  
  106.      **********************************************************************
  107.  
  108.  
  109.      USER PROMPTS
  110.  
  111.     The ARJ user prompts have been improved to provide more
  112.     flexibility.  In addition to the normal yes and no responses, ARJ
  113.     also accepts the following responses: quit, always, skip, global,
  114.     and command.
  115.  
  116.     "Global" sets ARJ to inhibit all subsequent user prompts by assuming
  117.     YES for all queries as if "-y" were specified.
  118.  
  119.     The "Always" response has changed.  It now sets ARJ to assume YES
  120.     for subsequent queries of the same class.  For example, answering
  121.     YES to the overwrite query will assume YES for ALL subsequent
  122.     overwrite queries.
  123.  
  124.     "Skip" sets ARJ to assume NO for ALL subsequent queries of the same
  125.     class.
  126.  
  127.     Subsequent user prompt messages will still be output to the screen
  128.     after the "always" and "skip" responses but no user response will be
  129.     accepted.
  130.  
  131.     "Command" prompts for one DOS command and then executes it.  ARJ
  132.     then returns to expect an answer to the current yes/no query.  You
  133.     should keep the query in mind as ARJ does NOT always redisplay
  134.     the full query message.
  135.  
  136.  
  137.      ARJ ERROR LEVELS
  138.  
  139.     ARJ will now return a DOS errorlevel of 9 when trying to process a
  140.     file that is NOT an ARJ archive.
  141.  
  142.     With the new option "-hl", ARJ will return a non-zero errorlevel
  143.     when a user specified filename from within an ARJ listfile cannot
  144.     be found on disk.  Ordinarily, ARJ returns no error for such a
  145.     situation.
  146.  
  147.  
  148.      ARJ ARCHIVE NAME WILDCARDING
  149.  
  150.     ARJ allows the wildcarding of the archive parameter for ARJ
  151.     commands other than the add commands (a, f, j, m, u).  If the "-r"
  152.     option is specified, ARJ will scan through subdirectories looking
  153.     for ARJ archives to process.
  154.  
  155.     This feature allows a user to delete a specific file from a series
  156.     of archives.
  157.  
  158.     Example:  ARJ d *.ARJ bbs.ad
  159.  
  160.     This feature could also be used to extract a series of archives.
  161.  
  162.     Example:  ARJ e *.ARJ
  163.  
  164.         The new "-hr" option allows ARJ to process multiple archives that
  165.         cause errors.
  166.  
  167.  
  168.      ARJ COMMAND LINE PROCESSING
  169.  
  170.         For non-add type commands, ARJ will now always use the full
  171.         specified pathname for selecting files within an archive by
  172.         matching against the full specified pathname.
  173.  
  174.         Example:  ARJ x archive d:\temp\ f:\data\1994\report.txt
  175.  
  176.         ARJ will now accept an ARJ command line from a response file as in
  177.         "ARJ @command.rsp".  The "@" symbol indicates that the appended
  178.         name is the name of the response file.  In this case, the file is
  179.         command.rsp. The response file symbol cannot be changed.
  180.  
  181.         The response file should contain the ARJ command line minus the
  182.         initial "ARJ".  The command line may be split over as many lines
  183.         as necessary.  The response file feature will NOT accept QUOTED
  184.         command line options.  Options with embedded blanks ("-vasTEST X")
  185.         will not be processed as expected.  When using the response file
  186.         feature, ARJ will accept only the "-+", and "-&" switch options on
  187.         the DOS command line along with the response file name.  All other
  188.         command options must be specified in the response file or in the
  189.         ARJ environment variable.
  190.  
  191.  
  192.      ARJSFX COMMAND LINE PROCESSING
  193.  
  194.         All of the ARJ self-extractors feature a new option to embed any
  195.         command line options into the self-extracting archive itself.  This
  196.         helps reduce the need for extra programs or batch files.
  197.  
  198.         To implement this feature, you would insert the required command
  199.         line as the first line of the ARJ archive comment.  The beginning
  200.         of the command line must be preceded by the two characters "))".
  201.         Only the first 80 characters of the embedded command line will
  202.         be processed.
  203.  
  204.         Example:  )) C:\DIR\ -o -m
  205.  
  206.         The non-shareware version of this software will not display the
  207.         customized command line demonstration message.
  208.  
  209.         The larger ARJ self-extractor (-je) supports the new command line
  210.         option "-s" to allow the skipping of the ARJ-SECURITY envelope
  211.         verification test if an envelope exists.  ARJSFX also supports the
  212.         new "-o" option to force overwrites, the "-m" option to skip the
  213.         create directory prompt, and the "-w" option to skip the extract
  214.         prompt.  The new "-b" option prompts the user for the name of the
  215.         install directory.  The target directory on the command line is
  216.         used as the default install directory.  A new "-k" option will
  217.         display the long form of the file extraction messages.
  218.  
  219.  
  220.      ARJSFXJR COMMAND LINE PROCESSING
  221.  
  222.     The small ARJ self-extractor (-je1) supports command line
  223.     options.
  224.  
  225.     ARJSFXJR [-switch(es)] [drive:][target_dir\]
  226.  
  227.     switches:
  228.     n: set ARJSFXJR to NOT count as an error the skipping of files
  229.     o: set ARJSFXJR to overwrite existing files
  230.  
  231.     You can specify a target_directory or drive or both.  However,
  232.     you must specify the ending "\" or ":" symbol.
  233.  
  234.     ARJSFXJR -o C:\SOFT\  -> self-extract into directory "C:\SOFT\"
  235.                  in overwrite mode.
  236.  
  237.  
  238.      ARJ COMMANDS
  239.  
  240.      "d" command
  241.  
  242.         *** The following information was left out of ARJ.DOC at 2.41 ***
  243.  
  244.         If specify "*.*" as the filespec, ARJ will prompt for permission to
  245.     delete.  You can specify the "-y" or "-jyd" options to inhibit the
  246.     delete prompt.
  247.  
  248.     If ARJ removes all files from an archive, it will delete the empty
  249.     archive.
  250.  
  251.     The delete command normally only deletes non-backup files.  You
  252.     must specify the "-jg" option to select backup files, too.
  253.  
  254.     You can specify the "-n" (new) option to delete the files in the
  255.     archive that DO NOT EXIST on the disk.    You can use the same "-n"
  256.     option with "ARJ l" to list the files that DO NOT EXIST on the
  257.         disk.  This is useful in synchronising an archive to a directory.
  258.  
  259.     Examples:  ARJ d archive *.* -n
  260.                    ARJ l archive temp\ *.doc -n
  261.            ARJ d archive temp\ *.doc -n
  262.  
  263.  
  264.      "f" and "u" commands
  265.  
  266.         As of 2.42c, when updating archives with the -jv option selected,
  267.         ARJ will display a message for each file processed including
  268.         files that have not been updated.  A message indicating that
  269.         there has been "no change" will be displayed when no actual
  270.         update of a file took place.
  271.  
  272.  
  273.      ARJ SWITCHES
  274.  
  275.      "-b4" switch
  276.  
  277.         The "-b4" switch is used to set ARJ to NOT restore any file
  278.         attribute bits and to reset the archive bit of files being
  279.         extracted.  It is useful for easing the cleanup/deletion of
  280.         temporarily extracted archive files as in a virus scanning process.
  281.  
  282.  
  283.      "-b5" switch
  284.  
  285.         This switch used with the "e" or "x" commands sets ARJ to not
  286.         restore any of the original file attributes bits.  However, the
  287.         archive bit will be left set.
  288.  
  289.  
  290.      "-f1" switch
  291.  
  292.         This switch used with the "e" or "x" commands sets ARJ to only
  293.         extract OLDER files from the archive.
  294.  
  295.  
  296.      "-u1" switch
  297.  
  298.         This switch used with the "e" and "x" commands causes ARJ to
  299.         extract OLDER and non-existing files.
  300.  
  301.  
  302.      "-u2" switch
  303.  
  304.         This switch used with the "e" and "x" commands causes ARJ to
  305.         extract CHANGED (different date-time or different size) and
  306.         non-existing files.
  307.  
  308.  
  309.      "-v" switch
  310.  
  311.     When the multiple volume ARJ files to be used are located on drives
  312.     with removable media (diskette drives, etc.), ARJ will ALWAYS
  313.     PROMPT for the next diskette even with the "-y" option specified.
  314.     However, you can suppress the next volume prompt with the "-jyv"
  315.     option.  At DOS versions before 3.0, only drives A and B are
  316.     considered removable.
  317.  
  318.     After the pause to change diskettes, ARJ will check to make sure
  319.     that the diskette has been changed.  However, this check is limited
  320.         to 3 retries for the same volume.  This test can be inhibited with
  321.         the "i" modifier.
  322.  
  323.         Example:  ARJ x a:archive -vi
  324.  
  325.     ARJ will not allow the updating of multiple volume archives unless
  326.     the "-hu" option is specified.
  327.  
  328.     The "r" modifier allows the reservation of disk space on the first
  329.     volume.  The number after the "r" specifies the space to reserve.
  330.     This is useful for software installation volumes built on the hard
  331.     disk.
  332.  
  333.     Example:  ARJ a install -v360r50K   make first volume 50000 bytes
  334.                         smaller than 360K.
  335.  
  336.     Example:  ARJ u archive -v360u
  337.  
  338.     The "z" modifier works like the "s" modifier except that the system
  339.     command is NOT echoed to the screen.
  340.  
  341.     The "-v" switch now accepts its modifiers in any order.  The "s"
  342.     and "z" modifiers must be last because any succeeding text is
  343.     considered the system command to execute.
  344.  
  345.     Examples:  ARJ a volume -vavw         beep, autosize, whole files
  346.            ARJ a volume -vavsDIR     beep, autosize, execute DIR
  347.  
  348.  
  349.      "-je" switch
  350.  
  351.         This switch will create a multiple volume self-extracting archive
  352.         when used with the "-v" switch.  This option combination requires
  353.         DOS 3.0 and above.
  354.  
  355.         Example:  ARJ a a:install c:\software\*.* -je -va
  356.  
  357.  
  358.      "-jf" switch
  359.  
  360.         It is now possible to extract a file stored with an absolute path
  361.         to another directory from an archive containing similar paths
  362.         differentiated only by drive letters.
  363.  
  364.         Example: ARJ x archive d:\temp f:\data\1994\report.*
  365.  
  366.  
  367.      "-js" switch
  368.  
  369.         The "-js" switch will recognize "." alone as a file extension
  370.         indicating no file extension as in "-js." and "-js..arc"
  371.  
  372.  
  373.      "-jv" switch
  374.  
  375.         The "-jv switch will display a "no change" message when updating
  376.         an archive with files that are already up to date.
  377.  
  378.  
  379.      "-h#" switch
  380.  
  381.         The "-h#" switch sets ARJ to append the current date string in
  382.         the form YYMMDD to the current archive name while keeping the
  383.         file extension the same.
  384.  
  385.         The "-h#1" switch sets ARJ to append the current time string in
  386.         the form HHMMSS to the current archive name while keeping the
  387.         file extension the same.
  388.  
  389.         The "-h#2" switch sets ARJ to append the current date-time
  390.         string in the form DHHMMSS to the current archive name while
  391.         keeping the file extension the same.
  392.  
  393.         Examples:  ARJ a XX -h# *.c    creates archive name XX931209.ARJ
  394.                    ARJ a YY -h#1       creates archive name YY123000.ARJ
  395.                    ARJ a Y -h#2        creates archive name Y8123000.ARJ
  396.  
  397.         This function does NO checking for exceeding the proper filename
  398.         length.
  399.  
  400.  
  401.      "-hm" switch
  402.  
  403.         The "-hm" switch sets ARJ to transfer the list of filenames to be
  404.         archived from precious memory to file storage.  This allows a much
  405.         larger number of files to be processed (over 32,000).  This option
  406.         is ignored for all ARJ commands except "a", "f", "j", "m", "u".
  407.  
  408.         Normally, this switch sets ARJ to wait until it is out of memory
  409.         storing filenames into a list before transferring that list to a
  410.         temporary file.  That temporary file is put in the current
  411.         directory or the special work directory if specified (-hm!F:\).
  412.         However, there may be a few cases where ARJ will run out of memory
  413.         doing other tasks while it is storing this list.  In these cases,
  414.         ARJ will abort.  The user can specify a numeric argument to this
  415.         switch to force ARJ to transfer the list to file storage sooner.
  416.         This argument specifies the maximum number of filename entries to
  417.         store in memory.  If the list exceeds that number, the entries are
  418.         transferred from memory to a temporary file.
  419.  
  420.         The "-hm" work directory is specified by appending a "!" to the
  421.         "-hm" or "-hm5000" options and then appending the filename to the
  422.         option.  See below.
  423.  
  424.         Examples:  ARJ a archive c:\*.* -r -hm
  425.                    ARJ a a:archive c:\*.* -r -va -hm5000!F:\
  426.                    ARJ a a:archive c:\*.* -r -hm!G:\temp\
  427.  
  428.         This feature has at least two disadvantages.  The checking for
  429.         duplicate filename specifications may become disabled (ex: *.DOC
  430.         and MANUAL.* duplicates MANUAL.DOC).  Updating archives will become
  431.         slower.  Extra disk space is required for the temporary file list.
  432.         The use of a RAMDISK directory will provide the fastest operation.
  433.  
  434.  
  435.      "-hn" switch
  436.  
  437.         The "-hn" switch sets the filespec that does NOT match any file.
  438.         The default filespec is "...".  However, on some systems like
  439.         NOVELL, there is a valid filespec "...".  Since ARJ sometimes needs
  440.         a filespec that is strictly a placeholder, this option should be
  441.         used to specify some name that does not exist on disk.
  442.  
  443.         This option must be specified prior to any use of the non-matching
  444.         filespec.  Setting it via the ARJ_SW variable is an excellent
  445.         choice.
  446.  
  447.         Example:  ARJ e -hn#### archive #### -zcomment.txt
  448.                   SET ARJ_SW=-hn####
  449.  
  450.  
  451.      "-ho" switch
  452.  
  453.         The "-ho" switch used with the "e" or "x" extract commands allows
  454.         file extraction based upon a text search.  ARJ will prompt the
  455.         user for text strings to search unless the "-jq" option has been
  456.         specified.  See the "-jq" option in ARJ.DOC for detailed use
  457.         information.  ARJ will extract a file within an archive if the
  458.         file contains at least one occurrence of any of the specified
  459.         search strings.
  460.  
  461.         Examples:  ARJ e archive -ho
  462.                    ARJ e archive -ho -jq+3+textstring
  463.  
  464.  
  465.      "-ho1" switch
  466.  
  467.         The "-ho1" switch used with the "e" or "x" extract commands allows
  468.         file extraction based upon a text search.  ARJ will prompt the
  469.         user for text strings to search unless the "-jq" option has been
  470.         specified.  See the "-jq" option in ARJ.DOC for detailed use
  471.         information.  ARJ will extract a file within an archive if the
  472.         file contain NO occurrences of any of the specified search
  473.         strings.
  474.  
  475.         Examples:  ARJ e archive -ho1
  476.  
  477.  
  478.      "-hr" switch
  479.  
  480.         The "-hr" switch sets ARJ to attempt to continue processing
  481.         successive archives even when they contains errors.  This option is
  482.         intended for ARJ wildcard use such as in the "ARJ t *.ARJ -hr"
  483.         command.
  484.  
  485.  
  486.      "-hv" switch
  487.  
  488.         The "-hv" switch is used to verify the ARJ version number and/or
  489.         whether the ARJ program is registered.  If the "-hv" option is
  490.         specified by itself or with an appended "R", an unregistered ARJ
  491.         will abort with an errorlevel of 1.  If a version number string
  492.         is appended to the "-hv" option, a lower version numbered ARJ
  493.         will abort with with an errorlevel of 1.
  494.  
  495.         Examples:  ARJ a archive -hv         check if registered
  496.                    ARJ a archive -hvr        check if registered
  497.                    ARJ a archive -hv2.50     check for version 2.50 or greater
  498.                    ARJ a archive -hvr2.50    check if registered and version
  499.                                              2.50 or greater
  500.  
  501.  
  502.      end document
  503.  
  504.