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