home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / arj / update.doc < prev    next >
Text File  |  1991-09-23  |  11KB  |  327 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.21                      September 1991
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.10 (includes
  6.      ARJ 2.20 changes).  ARJ.DOC has been updated with this information.
  7.  
  8.  
  9.      ** IMPORTANT NEWS ****************************************************
  10.  
  11.     ARJ now has built-in MS-DOS 3.x international language support.
  12.  
  13.     On a very small number of large files, the use of the option
  14.     -jh65535 has resulted in system hangs and file CRC errors.  This
  15.     only occurs with the number 65535.  If you use this option
  16.     without the -jt option, you should verify your archived files.
  17.     I extend my deepest apologies to everyone so inconvenienced.
  18.     This is fixed in ARJ 2.21.
  19.  
  20.     The ARJSORT program uses the MS-DOS SORT program which cannot
  21.     handle input files larger than 64K.  Sorting ARJ archives with a
  22.     few hundred pathnames will exceed that size.  The QSORT program
  23.     by Ben Baker is a direct replacement for SORT and does not have
  24.     this size limitation.
  25.  
  26.     Previous versions of ARJ used the TurboC++ clock() function.
  27.     This function can keep the date from changing at midnight.
  28.  
  29.     The UNARJ software is now distributed separately in an archive
  30.     named UNARJnnn.EXE.
  31.  
  32.     The "-ji" index file option now appends to instead of
  33.     overwriting an existing index file.
  34.  
  35.     The second user prompt for the "w" command has been changed to
  36.     ask for the number of match context lines.
  37.  
  38.     You may now register ARJ via credit card through Public Software
  39.     Library.  See CREDIT.CRD for more information.
  40.  
  41.      **********************************************************************
  42.  
  43.  
  44.      SAMPLE BATCH FILES
  45.  
  46.     A few batch files have been included with this distribution to
  47.     demonstrate how to use ARJ and REARJ.  Three batch files show how
  48.     to backup and restore your hard disk drive.  One batch files shows
  49.     how to convert ZIP and LZH archives on your hard disk drive to ARJ
  50.     format archives.  Feel free to use and modify these batch files.
  51.  
  52.     As always, you should backup your important disk data if you plan
  53.     to make changes to it such as using REARJ.
  54.  
  55.  
  56.      USING ARJ WITHIN OTHER PROGRAMS
  57.  
  58.     Since ARJ uses over 280,000 bytes of memory during compression, it
  59.     is difficult to use ARJ in a large application program unless that
  60.     program swaps itself out of memory when it executes DOS commands
  61.     like ARJ.  However, there is at least one shareware program
  62.     available that will automatically swap your large application
  63.     program out of memory whenever it shells out to DOS to execute a
  64.     command.  The program SHROOM by Davis Augustine should be able
  65.     solve this memory problem for you.  The latest version is named
  66.     SHROM17D.ZIP on Channel1 BBS.  According to the SHROOM
  67.     documentation, you can reach the author at:
  68.  
  69.         CompuServe id 72230,3053
  70.  
  71.         Davis Augustine
  72.         P.O. Box 390178
  73.         Cambridge, MA 02139
  74.  
  75.     This is not an endorsement of the product SHROOM.
  76.  
  77.     The easiest way I have found to use this product is to type:
  78.     SHROOM COMMAND
  79.  
  80.     SHROOM -v COMMAND will let you see SHROOM in action when you shell
  81.     out to execute a DOS command.
  82.  
  83.  
  84.      ARJMENU PROGRAM
  85.  
  86.     A new program called ARJMENU by Michael McCombs will be released
  87.     shortly.  As far as I know, it is the only menu-driven interface
  88.     program that supports ALL of the features of ARJ.  This program is
  89.     aimed at users who hate command line interfaces.  ARJMENU allows
  90.     the user to pick and choose ARJ options.  The user does not have to
  91.     remember the ARJ switch syntax.  This program supports ARJ version
  92.     2.21.  You can reach the author at:
  93.  
  94.         Internet/ARPANet: mccombs@sumax.seattleu.edu
  95.  
  96.         Michael McCombs
  97.         517 Ninth Ave. #310
  98.         Seattle, WA. 98104
  99.  
  100.  
  101.      ARJR AND DEARJ PROGRAMS
  102.  
  103.     The new programs ARJR and DEARJ are available only to registered
  104.     users of ARJ.  ARJR is the ARJ program minus the help screen and
  105.     SFX modules.  DEARJ is the ARJR program minus the archive
  106.     creation/modification functions.  DEARJ is used for commercial
  107.     software distributions involving multiple volume archives.  See the
  108.     LICENSE.DOC and ORDERFRM.DOC for more information.
  109.  
  110.  
  111.      ARJ SFX MODULES
  112.  
  113.     The ARJ self-extraction modules have been improved in terms of
  114.     speed.    The "-je" module is slightly faster than ARJ in extraction
  115.     speed. The one BIOS call that the SFX modules used has been removed
  116.     to provide better compatibility with partial IBM compatibles.
  117.  
  118.     Both SFX modules have an identification string located in the first
  119.     1000 characters of the executable.  The identification string is
  120.     "aRJsfX" without the quotes.
  121.  
  122.  
  123.      ARJ COMMANDS
  124.  
  125.      "e" or "x" commands
  126.  
  127.     During the extraction display, ARJ will display only one filename
  128.     if the "from" and "to" filenames are identical.
  129.  
  130.  
  131.      "f" and "u" commands
  132.  
  133.     ARJ will not physically update an archive when no files and no
  134.     comments have been added to the archive.  In other words, the
  135.     date-time stamp both internally and externally (DOS) will remain
  136.     unchanged.
  137.  
  138.  
  139.      "o" command
  140.  
  141.     The ARJ "o" command will abort when attempted on a multiple volume
  142.     archive.
  143.  
  144.  
  145.      "p" command
  146.  
  147.     The switch option "-jp" will force the "p" command into a paged
  148.     display mode like the DOS MORE command.
  149.  
  150.  
  151.      "w" command
  152.  
  153.     A default choice of yes has been added to the caseless search
  154.     prompt.
  155.  
  156.     The context message prompt has been changed.  Instead of asking if
  157.     the user wants to display the context of any matches, ARJ asks how
  158.     many lines of context to display.  An answer of "0" (zero) will
  159.     disable the display of string match context.
  160.  
  161.  
  162.      ARJ SWITCHES
  163.  
  164.     The switch character handling has been modified to allow a
  165.     different switch character to be used in ARJ_SW and in the command
  166.     line except when the option "-ju" (unix) has been specified.  This
  167.     will prevent problems when using the ARJ_SW variable and archiver
  168.     shell programs that use a different switch character.
  169.  
  170.     If the ARJ_SW environment variable specifies a filename (text not
  171.     beginning with a switch character), ARJ will open that filename and
  172.     scan it looking for a line of text that begins in column 1 with the
  173.     same letter as the ARJ command being executed.    The following text
  174.     is processed as the ARJ_SW switches.  This allows each ARJ command
  175.     to have its own switch settings.  If no such command text is found,
  176.     then no switch settings are processed as the ARJ_SW switches.
  177.  
  178.     SET ARJ_SW=C:\ARJ\ARJ.CFG
  179.  
  180.     C:\ARJ\ARJ.CFG contains:
  181.     a -jm1 -jt -i1
  182.     l -jp
  183.     e -i1
  184.     c -zcomment.txt
  185.  
  186.  
  187.      "-+" switch
  188.  
  189.     Using this switch on the command line will inhibit the use of the
  190.     ARJ_SW environment variable.
  191.  
  192.  
  193.      "-$" switch
  194.  
  195.     Adding a non-existent volume label will NOT produce a warning or
  196.     error code.
  197.  
  198.  
  199.      "-a" switch
  200.  
  201.     ARJ will correctly scan hidden directories with the "-a" and "-a1"
  202.     options.
  203.  
  204.  
  205.      "-d" switch
  206.  
  207.     The "-d" switch option now works for the "j" command.
  208.  
  209.  
  210.      "-m" switch
  211.  
  212.     Methods 3 and 4 are significantly faster and more compressive.
  213.     Method 4 compression is almost twice as fast as the default method
  214.     1 compression.
  215.  
  216.  
  217.      "-t" switch
  218.  
  219.     The "-t" option has been modified to allow setting file type by
  220.     suffix similar to "-js" option.  If you want to set the file type
  221.     to text mode for .ASM and .C files, you would specify the option
  222.     "-t1.asm.c".
  223.  
  224.     ARJ a archive *.* -t1.asm.c.h.doc
  225.  
  226.     If you to specify the binary file type by suffix, you must specify
  227.     the default file type to text and then specify the type by suffix,
  228.     because the default file type is normally binary.
  229.  
  230.     ARJ a archive *.* -t1 -t0.com.exe.obj
  231.  
  232.     Because of the way ARJ checks all files to be archived in text
  233.     mode, some true text files will not pass the test.  In this case,
  234.     you can specify the "f" modifier to force text mode.  This modifier
  235.     can be combined with the "-t1." suffix option.    This will not force
  236.     ARJ to use text mode on a true binary file.
  237.  
  238.     ARJ a archive *.bat -t1f
  239.     ARJ a archive *.* -t1f.bat.asm.doc
  240.  
  241.  
  242.      "-v" switch
  243.  
  244.     The "-vv" option will beep after the last volume.  This may be used
  245.     on a single archive creation by using a command similar to this:
  246.  
  247.     ARJ a -vv9999K archive *.*
  248.  
  249.     When using the "-va" option, ARJ will prompt concerning disk space
  250.     when there is less than 10,000 bytes free.
  251.  
  252.  
  253.      "-z" switch
  254.  
  255.     The "-z" comment switch works with other modification functions
  256.     besides the "c" command.  This allows you to add a comment at the
  257.     same time as you add files to an archive.
  258.  
  259.     Example:  ARJ a -zcomment.txt archive *.doc
  260.  
  261.  
  262.      "-ji" switch
  263.  
  264.     The "-ji" has been changed to append the filename logging
  265.     information to an already existing file.
  266.  
  267.  
  268.      "-jl" switch
  269.  
  270.     The "-jl" switch forces ARJ to display only the filespec of
  271.     filenames for the different progress displays.
  272.  
  273.  
  274.      "-jv" switch
  275.  
  276.     When used with the "ARJ -jp p", "ARJ s", and "ARJ w" commands, the
  277.     "-jv" switch sets ARJ to display IBM graphics characters.
  278.  
  279.  
  280.      "-jw" switch
  281.  
  282.     The "-jw" switch allows you to specify the output filename for
  283.     extracted data.  When using this switch, you should only select one
  284.     file for extraction.  This is similar but not exactly the same as
  285.     using the "p" command with DOS output redirection.  Using DOS
  286.     redirection would cause all of the output of the extraction to be
  287.     put into the output file.  Using "-jw" would cause ARJ to prompt
  288.     for overwrite permission per each file extracted to the output
  289.     file.
  290.  
  291.     Example:  ARJ e -jwfile2.doc archive file1.doc
  292.  
  293.     In the above example, ARJ puts the data from "file1.doc" in the
  294.     archive into the file "file2.doc".
  295.  
  296.  
  297.      "-jx" switch
  298.  
  299.     The "-jx" switch during extraction mode allows the user to specify
  300.     the file position to start in the output file.    This can be used to
  301.     append data to an existing file.
  302.  
  303.     Example:  ARJ e -jx10000 archive file1
  304.  
  305.     This is similar to using the command "ARJ p archive >> output".
  306.     To duplicate this redirection with ARJ would require the following:
  307.  
  308.     ARJ e -jx2000K -jwoutput archive
  309.  
  310.  
  311.      "-jy" switch
  312.  
  313.     The "-jy" option allows you to specify the new option characters
  314.     "y" and "r".  The "y" option sets ARJ to use single character
  315.     Y/N/A/Q query prompts (yes, no, always, quit).    The "r" option
  316.     sets ARJ to erase all typeahead before user queries.
  317.  
  318.     Example:  ARJ e -jyyr archive      set single character query
  319.                       and erase typeahead.
  320.  
  321.     You may set the "-jyyr" option in the environment variable ARJ_SW.
  322.     There is no way to override such an option once selected.
  323.  
  324.  
  325.      end document
  326.  
  327.