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