home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / comp / 011 / update.doc < prev    next >
Encoding:
Text File  |  1991-05-30  |  9.3 KB  |  262 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.10                    May 1991
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.00.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.     ARJ utility developers should refer to UNARJ.DOC in UNARJ.ARJ
  11.     concerning a bug in extended header processing in UNARJ.C and an
  12.     ambiguous statement in DECODE.C.
  13.  
  14.     ARJ and UNARJ versions prior to ARJ 2.10 will NOT properly handle
  15.     ARJ archives with extended headers.  Please note that NO current
  16.     version of ARJ creates archives with extended headers.
  17.  
  18.     ARJ is now released as a non-commercial use version.  Commercial
  19.     users MUST purchase a site license to get a registered version of
  20.     ARJ.  Commercial users may use the unregistered version of ARJ for
  21.     evaluation purposes for a period of 30 days.  Current SITE
  22.     LICENSED ARJ users will automatically receive a free registration
  23.     kit.  Please allow a few weeks for delivery.
  24.  
  25.     The ARJ SFX (-je) and SFXJR (-je1) modules have been modified
  26.     because of an undesirable interaction with TSR DIET 1.02b.  TSR DIET
  27.     truncates ARJ SFX and SFXJR modules.  You SHOULD REDO any ARJ SFX
  28.     type archives with ARJ 2.10!!!    Here is a fast way to do it without
  29.     recompressing:
  30.  
  31.     ARJ j newsfx oldsfx.exe -je   OR   ARJ j newsfxjr oldsfxjr.exe -je1
  32.  
  33.     The ARJ SFX (-je) module has been changed so that the default
  34.     command is "-x" extract files with pathnames.
  35.  
  36.     If the first filename after the archive name specifies a directory,
  37.     ARJ will treat it as the base directory whether or not the filename
  38.     has an appended "\".  This has an impact upon the "-p1" option.
  39.     You can avoid a problem with the "-p1" option by specifying the
  40.     path to extract with an appended "*.*" or "\*.*".
  41.  
  42.     The matching of selected filenames has been changed to cause fewer
  43.     user problems when modifying an existing archive.  When updating an
  44.     existing archive, the ARJ modified pathname of the selected input
  45.     file MUST MATCH EXACTLY the pathname of the file in the archive.  An
  46.     ARJ modified pathname is the resulting pathname that ARJ actually
  47.     stores in an archive.
  48.  
  49.     The temporary "-jg" option to extract certain encrypted files
  50.     archived with the "-g" garble option with older test versions of ARJ
  51.     (0.15 and earlier) has been removed.
  52.  
  53.     The ARJ m -f and ARJ m -u commands delete added files and files that
  54.     are already update to date in the archive.  This also applies to
  55.     archives bits and the "-b2" option.
  56.  
  57.      **********************************************************************
  58.  
  59.  
  60.      COMMON PROBLEMS USING ARJ
  61.  
  62.     DO NOT use the "-t1" option with binary files!!!
  63.  
  64.     ARJ by default stores the pathname specified by the user and not just
  65.     the filespec as is the manner of other archivers such as LHARC.  You
  66.     can exclude the path portion of the filename by specifying the "-e"
  67.     option as in "ARJ a -e archive temp\*.*".  You can also remove the
  68.     path information from an already built archive with the command
  69.     "ARJ r archive".
  70.  
  71.     The "f"reshen command in ARJ works slightly differently from the
  72.     "f"reshen command in LHARC.  If the ARJ archive was created using the
  73.     "-r" option, the ARJ freshen command requires the "-r" option.
  74.  
  75.  
  76.      ARJR and DEARJ programs
  77.  
  78.     The new programs ARJR and DEARJ are available only to registered
  79.     users of ARJ.  ARJR is the ARJ program minus the help screen and
  80.     SFX modules.  DEARJ is the ARJR program minus the archive
  81.     creation/modification functions.  See the LICENSE.DOC and
  82.     ORDERFRM.DOC for more information.
  83.  
  84.  
  85.      REARJ archive convertor
  86.  
  87.     REARJ has been revised to allow a virus checking program to be
  88.     executed during each archive conversion.  See REARJ.DOC for more
  89.     information.
  90.  
  91.  
  92.      UNARJ Portable C source code
  93.  
  94.     A couple of potentially SERIOUS bugs have been fixed.  See the
  95.     UNARJ.DOC for more information.
  96.  
  97.     Now included is the C source code for a simple UNARJ extractor
  98.     program.  It has been portabilized courtesy of Mark Adler for
  99.     platforms that do not support ANSI C.  This new version of UNARJ
  100.     replaces the old AV program by supporting the "e", "l", "t", and "x"
  101.     commands.  However, this UNARJ is NOT meant to be a production
  102.     quality ARJ extractor.    It is meant for the use of 3rd party
  103.     developers who want to build file readers, etc., for ARJ.
  104.  
  105.     See UNARJ.DOC in UNARJ.ARJ for more information.
  106.  
  107.  
  108.      ARJ COMMAND LINE
  109.  
  110.     ARJ a archive base_directory
  111.  
  112.     The base_directory no longer requires an appended "\".    ARJ will
  113.     interpret the first filename after the archive name as a directory
  114.     if it exists as a directory.
  115.  
  116.  
  117.      ARJ COMMANDS
  118.  
  119.      "m" command and "-f or -u" option
  120.  
  121.     The ARJ m -f and ARJ m -u commands now purge all selected files
  122.     duplicated in the archive including ones that did not need to be
  123.     updated because they were already up to date.
  124.  
  125.  
  126.      "w" command
  127.  
  128.     The "w" command will prompt for two additional queries before
  129.     requesting the search strings.    The first query is whether to ignore
  130.     case when searching.  The second query asks whether to display the
  131.     matched string in context.  This command uses the "-jv" option to
  132.     display more lines of context text.
  133.  
  134.     -jv = 6 lines, -jv1 = 12 lines, -jv2 = 18 lines, -jv3 = 24 lines
  135.  
  136.  
  137.      ARJ SWITCHES
  138.  
  139.      "-?" switch
  140.  
  141.     This option displays more detailed help screen.  You may suppress the
  142.     screen pauses by specifying "ARJ -? -jp" or by redirecting the output to
  143.     a file as in "ARJ -? > filename".
  144.  
  145.  
  146.      "-$" switch
  147.  
  148.     This option allows the user to store or extract DOS volume labels in
  149.     ARJ archives.  You can only add or extract volume labels
  150.     at DOS 2.0 and above.  The "-$" option may be specified with or
  151.     without a drive specification.    The drive can be specified by
  152.     appending the letter and optionally the ":" to "-$".  If none is
  153.     specified, ARJ assumes the current drive unless a specified target
  154.     base directory ha a drive specification.
  155.  
  156.     Only standard DOS labels are supported by ARJ.
  157.  
  158.     Syntax:  ARJ a archive -$         add all files and the label of
  159.                          the current drive.
  160.          ARJ a archive ... -$B         add only the label of drive B
  161.          ARJ a archive ... -$B:      add only the label of drive B
  162.  
  163.     To extract volume labels, you must select the label by setting "-$"
  164.     and specifying a matching wildname/filename.
  165.  
  166.     Syntax:  ARJ e archive doslabel -$   extract the label named doslabel
  167.                          to the current drive.
  168.          ARJ e archive -$D:         extract all files to the current
  169.                          drive and extract the label to
  170.                          drive D:.
  171.          ARJ e archive label B:\ -$  extract all files to B:\ and the
  172.                          label to drive B.
  173.  
  174.  
  175.      "-e1" switch
  176.  
  177.     When using the "-e1" and "-p" options at the same time, ARJ will not
  178.     include the specified base directory in the pathname comparison.
  179.  
  180.  
  181.      "-i1" switch
  182.  
  183.     This option provides a bar type graphical progress indicator for the
  184.     compression, extraction, and testing type commands of ARJ.  This
  185.     provides an alternative to the simple numeric increasing percentage
  186.     progress indicator.
  187.  
  188.  
  189.      "-p" switch
  190.  
  191.     This option is no longer needed when "f"reshening or "u"pdating
  192.     archives because that is now the default for these operations.
  193.  
  194.  
  195.      "-s2" switch
  196.  
  197.     The "-s2" option has been added for users who want to use a "-s"
  198.     type switch in the ARJ_SW environment variable.  The "-s" switch
  199.     has the side effect of always updating the date-time stamp even when
  200.     used in list or extract mode.  The "-s2" switch is ignored during
  201.     non-modification commands.
  202.  
  203.  
  204.      "-t1" switch
  205.  
  206.     ARJ will scan the first 4096 bytes of the input file looking for
  207.     8-bit non-text data.  If ARJ finds any 8-bit data, it will
  208.     automatically backtrack and switch to "-t0" (default) binary mode for
  209.     that particular file.  In addition at the end of compressing the
  210.     input file, if ARJ finds that the input file size is not greater than
  211.     75 percent of the binary file size (size on disk), ARJ will report an
  212.     error for that input file and increment the error count.  This should
  213.     help avoid the problem of accidentally compressing executable files
  214.     with the "-t1" option which results in lost data.
  215.  
  216.  
  217.      "-jf1" switch
  218.  
  219.     This switch option causes ARJ to only strip the drive spec and not
  220.     the root symbol from any pathnames.
  221.  
  222.  
  223.      "-jm1" switch
  224.  
  225.     This switch option provides slightly less compression at greater
  226.     speed than "-jm".
  227.  
  228.  
  229.      "-jo" switch
  230.  
  231.     The "-jo" switch is used to query the user when using the ARJ "a" or
  232.     "m" commands to add files to an archive.  Before ARJ overwrites an
  233.     existing internal archive file when using "-jo", ARJ will query the
  234.     user with "Update <filename>? ".  Without this option, ARJ will
  235.     overwrite the internal archive file without querying.
  236.  
  237.  
  238.      "-jy" switch
  239.  
  240.     This switch is used to suppress individual ARJ user prompts.
  241.  
  242.     Syntax:  ARJ e archive -jy<flags>
  243.  
  244.     where <flags> is one or more of the following characters:
  245.     a, c, d, k, n, o, s, v.  ARJ will assume YES for each flag selected.
  246.  
  247.     A - skip append query during a multi-volume extraction
  248.     C - skip create directory query
  249.     D - skip delete files query
  250.     K - skip disk space availability query
  251.     N - skip new filename prompt
  252.     O - skip overwriting existing file query
  253.     S - skip scanned enough text query
  254.     V - skip ok to proceed to next volume query
  255.  
  256.     Example:  ARJ x volume -v -jyaco
  257.           selected append, create, and overwrite "yes"es.
  258.  
  259.  
  260.      end document
  261.  
  262.