home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1992 / TheOrigSharewareV1.cdr / 25 / arj200.exe / arj / UPDATE.DOC < prev    next >
Text File  |  1991-04-10  |  21KB  |  538 lines
  1.  
  2.    UPDATE.DOC, ARJ 2.00               April 1991
  3.  
  4.  
  5.    This documents new or updated information since ARJ 1.00.
  6.  
  7.  
  8.    ***IMPORTANT CHANGES*****************************************************
  9.  
  10.       At 2.00, ARJ methods 1 and 2 compression have been greatly improved
  11.       in compression speed.  Method 1 speed and compression is better than
  12.       LHA 2.12.  Method 2 speed is similar to PKZIP (slower on some files
  13.       and faster on other files) and always with better compression.
  14.       Methods 3 and 4 are only slightly faster than 1 and 2 now.  Method 2
  15.       is aimed at those who want PKZIP-like speed and better compression.
  16.  
  17.       The options "-l", "-ji", "-z" will now prompt for file overwrite
  18.       situations.  If you choose not to overwrite, ARJ will abort with an
  19.       error.
  20.  
  21.       If you created archives with the "-jf" option to store full paths,
  22.       then you will need to use the "-jf" option with the "x" command to
  23.       restore to the full path.
  24.  
  25.       Example:   ARJ a backup C:\DOS\*.* -jf
  26.                  ARJ x backup -jf
  27.                  ARJ x backup C:\        (also works)
  28.  
  29.       At 1.10,  ARJ no longer supports the older version of method 4
  30.       compression used by ARJ 0.13 and 0.14.  ARJ cannot extract files
  31.       compressed with the older version of method 4.  However, ARJ supports
  32.       the version of method 4 used by ARJ 0.15 and up.    It is suggested
  33.       that any files compressed with the older method 4 be extracted and
  34.       rearchived.  Never by default does ARJ select method 4 compression.
  35.       You can determine ARJ support with the command "ARJ t *.ARJ".
  36.       Corrupted older method 4 files could crash older versions of ARJ.
  37.  
  38.       The way ARJ handles specified filenames with paths has been changed
  39.       at 1.10.    For non-update commands, ARJ will match the full pathname
  40.       of filenames with paths.    To force an exact match for filenames
  41.       consisting of a filespec (*.EXE), you should use the "-p" option.
  42.  
  43.       ARJ.EXE is now released in a standard uncompressed EXE format.  You
  44.       can use LZEXE, DIET, etc., to compress ARJ.EXE to save space.  Older
  45.       versions of ARJ.EXE were compressed by LZEXE.  The ARJ "i" command
  46.       can not check the program integrity of a compressed ARJ.EXE.
  47.  
  48.    *************************************************************************
  49.  
  50.  
  51.    CONVERTING OTHER ARCHIVE FORMATS TO THE ARJ FORMAT
  52.  
  53.       The ARJ software now comes with REARJ, an archive conversion utility.
  54.       This utility can convert all of the non-ARJ archives on your disk or
  55.       diskette to ARJ archives with only ONE command.  A log file option is
  56.       available to store on disk the ARJ conversion savings.  See the
  57.       REARJ.DOC for more information on this utility.
  58.  
  59.  
  60.    COMMON PROBLEMS USING ARJ
  61.  
  62.       ARJ by default stores the pathname specified by the user and not just
  63.       the filespec as is the manner of other archivers such as LHARC.  You
  64.       can exclude the path portion of the filename by specifying the "-e"
  65.       option as in "ARJ a -e archive temp\*.*".  You can also remove the
  66.       path information from an already built archive with the command
  67.       "ARJ r archive".
  68.  
  69.       The "f"reshen command in ARJ works differently from the "f"reshen
  70.       command in LHARC.  In LHARC, the "f" command always assumes the same
  71.       directory structure as that of the archive.  In other words, if the
  72.       LHARC archive contains the "TEMP\*.*" files, you can only freshen the
  73.       archive from the same directory.    To emulate that function in ARJ,
  74.       you must specify the "-r -p" options as in "ARJ f -r -p archive".
  75.  
  76.       When updating archives containing paths, you will need to use the
  77.       "-p" option if there are duplicate filespecs and you want to update
  78.       only one of them.
  79.  
  80.  
  81.    THE FILESPEC "..."
  82.  
  83.       Several times in the ARJ.DOC and UPDATE.DOC files, there is mention
  84.       of the filespec "...".   This filespec is chosen so as to not match
  85.       any existing filename.  ARJ will NOT generate an error or warning for
  86.       not matching "..." specifically.
  87.  
  88.  
  89.    HOW TO CREATE AN EXECUTABLE SELF-EXTRACTING ARJ ARCHIVE
  90.  
  91.       The command "ARJ f archive ... -je" will create a full featured
  92.       self-extracting archive from an already built archive.  At ARJ 1.10
  93.       no error message will be displayed concerning not finding "...".
  94.  
  95.       The command "ARJ f archive ... -je1" will create a smaller
  96.       self-extracting archive.
  97.  
  98.       Syntax:  ARJ f archive ... -je        produces archive.exe
  99.  
  100.       Under DOS systems other than 2.11, 3.2, 3.3, 4,0, you may have to
  101.       rename the self-extract module to ARJSFX.EXE to do the extraction.
  102.  
  103.  
  104.    ARJ now supports several errorlevels for DOS errorlevel testing.
  105.  
  106.       0 ->   success
  107.       1 ->   warning (specified file to add to archive not found or
  108.               specified file to list, extract, etc., not found)
  109.       2 ->   fatal error
  110.       3 ->   CRC error (header or file CRC error)
  111.       4 ->   ARJ-SECURITY error or attempt to update an ARJ-SECURED archive
  112.       5 ->   disk full or write error
  113.       6 ->   can't open archive or file
  114.       7 ->   simple user error (bad parameters)
  115.       8 ->   not enough memory
  116.  
  117.  
  118.    UNARJ C source code
  119.  
  120.       Now included is the ANSI C source code for a simple UNARJ extractor
  121.       program.  This UNARJ is NOT meant for use as a production quality ARJ
  122.       extractor.  It is meant for the use of 3rd party developers who want
  123.       to build file readers, etc., for ARJ.  The source code has been built
  124.       and tested under Turbo C++ 1.0 and Quick C 2.5 IDE.  No executables
  125.       have been included.
  126.  
  127.       Syntax:  UNARJ archive        (extract all files to full path)
  128.            UNARJ archive NUL    (test all files)
  129.  
  130.  
  131.    "c" command
  132.  
  133.       The "c" command is used to comment ARJ archives.    You can specify
  134.       that ARJ only prompt for the archive header comment by the following
  135.       command:
  136.  
  137.       Syntax:  ARJ c archive -z
  138.  
  139.       You can erase a comment by entering a single blank followed by a
  140.       carriage return.
  141.  
  142.  
  143.    "i" command
  144.  
  145.       The "i" command allows the user to check the integrity of the ARJ
  146.       program.    ARJ will report CRC ERROR! if the tested ARJ program does
  147.       not pass its integrity check.  This indicates that the program is
  148.       probably corrupted.  Please note that the "i" command should not be
  149.       used on a compressed ARJ executable (DIETed, LZEXEd, etc.), since the
  150.       "i" command will then ALWAYS report a CRC error.    If the program name
  151.       is not specified, then ARJ will check the current program being
  152.       executed.
  153.  
  154.       Syntax:  ARJ i ARJ.EXE
  155.            ARJ i        at DOS 3.0 and up
  156.  
  157.  
  158.    "j" command
  159.  
  160.       The "j" command allows the user to merge multiple ARJ archives. At
  161.       2.00, ARJ is able to handled merged multiple volume ARJ archives.  At
  162.       1.10, ARJ would not be able to access entries after the first split
  163.       file.  In any case, you should not use the "o" command to reorder a
  164.       merged multiple volume archive.  ARJ expects to find the pieces of a
  165.       split file in consecutive order.
  166.  
  167.       Syntax:  ARJ j archive archive1.arj archive2.arj
  168.            ARJ j archive *.arj -r
  169.  
  170.       Some switches NOT supported by the "j" command are:  -o, -ob, -f, -u,
  171.       -c, -d.
  172.  
  173.       Note that switches that do work like "-x" select the archives to be
  174.       merged and NOT the contents of the archives.
  175.  
  176.  
  177.    "l" command
  178.  
  179.       The "l" and "v" command date displays have been slightly modified to
  180.       handle 21st century dates (2000+).  The column before the year field
  181.       will be blank for 1900 dates and will contain a "+" sign for 2000
  182.       dates.  There are a number of utilities that will mistakenly set
  183.       dates as 2080 instead of 1980.
  184.  
  185.  
  186.    ARJ SWITCHES
  187.  
  188.       ARJ switches works similarly to those of LHARC and LHA.  Many
  189.       switches have toggle functionality.  The options -k -k negate
  190.       themselves because of the toggling functionality.  The options -k -k+
  191.       turns on the "-k" option because of the "+" sign.  This is important
  192.       if you use the SET ARJ_SW= command to preset certain ARJ options.  In
  193.       this case, you should use the "+" modifier to force ON the options
  194.       that you want to use.
  195.  
  196.  
  197.    "-!" switch
  198.  
  199.       This option allows the user to set the character used for list files.
  200.       The option "-!" with no specified character toggles (turns off) the
  201.       current list file character (default "!").
  202.  
  203.       Syntax:  ARJ a archive -!@ @list.fil
  204.            ARJ a archive -! !.bat
  205.  
  206.       The first example above sets the list file character to the one used
  207.       by LHA and PKZIP.
  208.  
  209.  
  210.    "-a1" switch
  211.  
  212.       This switch causes ARJ to add any directories in the selected set of
  213.       matching filespecs to the archive being built.  This switch also
  214.       selects hidden and system files as in the "-a" switch.  Even empty
  215.       directories will be added.  The "l" command will display such
  216.       directories with a "D" under the "T" (file type) header.
  217.  
  218.       This option can create an archive that is NOT compatible with earlier
  219.       releases of ARJ.    Older releases of ARJ will skip over empty
  220.       directory entries.  At 1.10, ARJSFX and ARJSFXJR modules CAN process
  221.       empty directory entries.    Your comments on this option are welcome.
  222.  
  223.       This option is useful for saving software directories with needed
  224.       empty directories.
  225.  
  226.  
  227.    "-m" switch
  228.  
  229.       Method 0 = storing   (no compression)
  230.       Method 1 = maximum compression (default compression method)
  231.                (requires 282,000 plus bytes memory)
  232.       Method 2 = slightly less compression and faster
  233.                (requires 282,000 plus bytes memory)
  234.       Method 3 = less compression and less memory
  235.                (requires 249,000 plus bytes memory)
  236.       Method 4 = fastest compression
  237.                            (requires 235,000 plus bytes memory)
  238.       Method 1 or 2 with "-jm" option
  239.                (requires 300,000 plus bytes memory)
  240.  
  241.       Syntax:  ARJ a archive *.* -m2
  242.  
  243.  
  244.    "-p" switch
  245.  
  246.       At 1.10, this switch is not needed when using non-update commands
  247.       and specifying filenames with paths (filenames with "\" symbols).
  248.  
  249.       For example, "ARJ e archive dir\*.exe" will work as it appears.  All
  250.       of the dir\*.exe files will be extracted.
  251.  
  252.       If you wish to extract files with no path with an exact match such as
  253.       "*.EXE", you must specify the "-p" switch.
  254.  
  255.  
  256.    "-s1" switch
  257.  
  258.       The "-s1" switch is used to keep the old archive date-time stamp.
  259.       The new archive will have the same timestamp as the original archive.
  260.       The "-s" switch is used to set the archive timestamp to the same as
  261.       the newest file within the archive.
  262.  
  263.  
  264.    "-t1" switch
  265.  
  266.       The "-t1" option for text mode compression is designed for
  267.       compressing 7-bit ASCII text files.  These are files without
  268.       graphics, printer control characters, or binary data.  Any 8-bit
  269.       symbols will be truncated to 7-bit symbols during compression.
  270.  
  271.       The original file size reported by the "l" and "v" commands is the
  272.       actual number of bytes input during text mode compression.  This is
  273.       usually the MS-DOS file size minus the number of carriage returns in the
  274.       file, since C text mode strips a file of carriage returns.
  275.  
  276.  
  277.    "-v" switch
  278.  
  279.       During ARJ operation in non-update commands, ARJ will not abort when
  280.       it cannot open the correct sequential ARJ volume archive.  It will
  281.       report the open error and proceed to the "Ok to process the next
  282.       volume?" prompt.  At this point it is possible to swap diskettes to
  283.       put the correct volume in place.    This feature is disabled if the
  284.       "-y" option has been specified.
  285.  
  286.       For those who have enough free hard disk space, the -v option can be
  287.       used to make backing up the hard disk fairly easy.  ARJ can be set to
  288.       create multiple floppy sized volumes on the hard disk for later copy
  289.       to diskettes.  So even if ARJ is slow, you can fire up an ARJ backup
  290.       and some time later, you can quickly copy the volumes to floppies.
  291.       Below is are sample backup commands:
  292.  
  293.       arj a backup *.* -b2 -r -v360 -y -jt -js         full backup
  294.       arj a backup *.* -b1 -r -v360 -y -jt -js         incremental backup
  295.  
  296.  
  297.    "-x" switch
  298.  
  299.       This switch is used to exclude filespecs or pathspecs from being
  300.       selected for processing by ARJ.  A new feature allows you to exclude
  301.       an entire path including subdirectories from being selected for
  302.       processing.
  303.  
  304.       Syntax:  ARJ a archive C:\*.* -xC:\TEMP\
  305.  
  306.       The "\" after C:\TEMP indicates to ARJ that everything below
  307.       C:\TEMP\ is to be excluded.
  308.  
  309.       Note that the exclude directory option requires that the directory be
  310.       specified in the same relative path that the selected files use.
  311.  
  312.       Example:
  313.  
  314.       arj a archive \temp\*.* -x\temp\firstdir       is correct usage
  315.       arj a archive \temp\*.* -xC:\temp\firstdir   is NOT correct because
  316.                            of the C:
  317.  
  318.       The "-x" switch has been modified to work for non-update commands
  319.       like "e"xtract and "l"ist.
  320.  
  321.       Examples:
  322.  
  323.       arj e archive -x*.exe          extract all files except *.exe files
  324.       arj l archive -x*.exe -x*.obj   list all files except *.exe and *.obj
  325.  
  326.  
  327.    "-z" switch
  328.  
  329.       The "-z" switch has been provided to facilitate batch commenting of
  330.       ARJ archives.  When the "-z" option has been specified with or
  331.       without a comment file, ARJ will only process the archive header
  332.       comment and will skip any file commenting unless the "-jz" switch has
  333.       been specified.
  334.  
  335.       A comment file containing only a single blank can be used to erase
  336.       comments from ARJ archives.
  337.  
  338.       Syntax:  arj c archive -z
  339.            arj c archive -zcomment.txt
  340.  
  341.       New at ARJ 2.00 is the facility to dump the ARJ archive header
  342.       comment to a file.  This will only extract the main archive comment
  343.       and not the individual file comments.
  344.  
  345.       Syntax:  arj e archive ... -zcomment.txt       dumps only the comment
  346.            arj x archive -zcomment.txt       dumps comment and files
  347.  
  348.  
  349.    "-jd" switch
  350.  
  351.       WARNING!  The disk space checking routine in ARJ appears to have
  352.       problems with some disk partitions over 120 megabytes in size.  ARJ
  353.       uses the getdfree() function from Turbo C++ to calculate free disk
  354.       space.
  355.  
  356.  
  357.    "-je1" switch
  358.  
  359.       The ARJSFXJR self-extraction module has been fixed to display
  360.       multiple comments lines correctly.  The -je and -je1 switches create
  361.       self-extracting executable archives.  The ARJSFXJR module now
  362.       supports automatic directory creation.  If you build the ARJSFXJR
  363.       module with directory paths, then the module will extract with the
  364.       directory paths.
  365.  
  366.  
  367.    "-jf" switch
  368.  
  369.      The "-jf" switch in add mode allows you to save the full user
  370.      specified pathname in the archive.  With this option, you can save the
  371.      drive letter and root symbol in the archive.  However, on extraction,
  372.      ARJ will not extract to the full path (with drive and root) with the
  373.      "x" command unless the "-jf" option is also specified.
  374.  
  375.      Example:   ARJ a backup C:\DOS\*.* -jf       (saves C:\)
  376.                 ARJ x backup -jf                  (extracts to C:\)
  377.                 ARJ x backup C:\                  (also works)
  378.  
  379.  
  380.    "-ji" switch
  381.  
  382.       The "-ji" switch is used to create an index file containing the
  383.       filenames archived.  This is especially helpful when using ARJ to do
  384.       multiple floppy type archives.  This file SHOULD NOT be created on
  385.       the floppy diskette if the floppy diskette is changed during the
  386.       archival process.
  387.  
  388.       The index file contains two types of text lines.    The first type is
  389.       the volume name record.  It contains the date, time, starting file
  390.       position, and the archive name.  The second type is the filename
  391.       record.  It contains only the filename.
  392.  
  393.       This information is also useful for restarting "-v" multiple volume
  394.       archives.  You need the filename and the starting file position.
  395.  
  396.  
  397.    "-jm" switch
  398.  
  399.       The "-jm" switch sets the maximum compression mode.  This mode
  400.       changes both method 1 and method 2 to the maximum compression for
  401.       those methods.  This will increase compression time significantly.
  402.  
  403.  
  404.    "-jn" switch
  405.  
  406.       The "-jn" switch is used to restart interrupted multiple volume
  407.       archives in conjunction with the "-jx" switch.  All selected files
  408.       are skipped up to but not including the named file.
  409.  
  410.       Example:    ARJ a volume -v360 -r -jn\BIN\TREE.COM -jx1230
  411.  
  412.       In the above example, all files scanned up to \BIN\TREE.COM are
  413.       skipped.    Archival will start at file position 1230 of file
  414.       \BIN\TREE.COM.
  415.  
  416.       IMPORTANT!!!  The exact name of the starting file must be specified
  417.       according to the wildnames/filespecs specified.  This name is the
  418.       same as displayed by the Adding filename display and the same as
  419.       written to the "-ji" index file.  Please note that \DOS\TREE.COM is
  420.       not considered the same as DOS\TREE.COM with this option.
  421.  
  422.  
  423.    "-jz" switch
  424.  
  425.       The "-jz" switch has been provided to facilitate batch commenting of
  426.       one or more files within an ARJ archive.    Only one comment file can
  427.       be specified.  That file will be used to comment each file specified
  428.       on the command line.
  429.  
  430.       A comment file containing only a single blank can be used to erase
  431.       comments from ARJ archives.
  432.  
  433.       Syntax:  arj c archive file1 -jzcomment.txt
  434.            arj c archive file1 -zheader.cmt -jzfile.cmt
  435.  
  436.  
  437.    THIRD PARTY PROGRAMS THAT SUPPORT ARJ DIRECTLY OR INDIRECTLY
  438.  
  439.       The following are programs that I have briefly tested that work with
  440.       ARJ and ARJ archives.  This is not a comprehensive list nor guarantee
  441.       of compatibility with ARJ.
  442.  
  443.       2ALL 2.10  - archive file converter (handles any archiver, free)
  444.  
  445.       ZZAP 6.2A  - archive file converter (handles any archiver)
  446.  
  447.       ZAP2ARJ     - archive to ARJ converter (automation and batch options)
  448.  
  449.       SHEZ 6.0C  - archive menu shell (handles conversions, too)
  450.  
  451.       ZGEN 1.37  - archive menu shell (configurable ARJ options)
  452.  
  453.  
  454.    ARJ TECHNICAL SUPPORT:
  455.  
  456.       I will try to resolve software problems with ARJ as they are made
  457.       known to me.  Please notify me of any ARJ problems by mail, email
  458.       or via the ARJ support BBSes mentioned below.  Despite the fact that
  459.       ARJ is free for many users, I will strive to make ARJ a robust,
  460.       stable and useful product for all users.
  461.  
  462.       To ensure a reply when using the postal system, please enclose a
  463.       stamped self-addressed envelope with your correspondence.  Keeping up
  464.       with the ARJ mail has become expensive.  Foreign corresponders should
  465.       include currency instead of stamps.
  466.  
  467.       As of this ARJ version, only users who have provided financial
  468.       support to ARJ may request technical support.
  469.  
  470.       Your financial support is needed for the ARJ archiver and format to
  471.       succeed.
  472.  
  473.  
  474.       I can be reached at:
  475.  
  476.       Robert Jung at Wonderland BBS        (508) 663-6220
  477.  
  478.       Robert Jung at Dimensional Crossroads BBS (508) 427-5379
  479.  
  480.       Robert Jung at Bay State BBS        (617) 598-6646
  481.  
  482.       Robert Jung in the COMPRESS (ILINK), or LHARC / COMPRESSIONS
  483.       (SMARTNET) echo conferences.
  484.  
  485.       2606 Village Road West
  486.       Norwood, Massachusetts 02062
  487.  
  488.       Internet address:  robjung@world.std.com    (Checked daily)
  489.  
  490.       Compuserver users can enter   >INTERNET: robjung@world.std.com
  491.       at the "Send to" prompt.    I prefer CompuServe users to send mail
  492.       to this address as opposed to my CompuServe userid below.
  493.  
  494.       CompuServe userid: 72077,445  (Checked infrequently)
  495.  
  496.  
  497.    ARJ SUPPORT BBSes:
  498.  
  499.       The latest version of ARJ can be obtained from the following
  500.       ARJ SUPPORT BBSes:
  501.  
  502.       Wonderland BBS, Billerica, MA, BBS (508) 663-6220
  503.  
  504.       Bay State BBS, Beverly, MA, BBS (617) 598-6646
  505.  
  506.       Dimensional Crossroads BBS, Brockton, MA, BBS (508) 427-5379
  507.  
  508.       The Cutting Edge BBS, CT, BBS (203) 233-8993
  509.  
  510.       Tunnels of Vesarius BBS       (San Diego, California)
  511.      Node I  (619) 587-9825, USRobotics HST/V32, 1:202/202 Fidonet
  512.      Node II (619) 453-1781, Compucom 9600, 1:202/208 Fidonet
  513.  
  514.       Data Express BBS           (AUSTRALIA)
  515.      61 2 564 2172 (V.32), 3:712/607 Fidonet
  516.  
  517.       Crystal Circuitry BBS       (AUSTRALIA)
  518.      61 2 868 4490 (300-9600)
  519.  
  520.       CBBS CANAL VIP BBS       (BRAZIL)
  521.      (011) 853-5333
  522.      Paulo Cesar Breim
  523.      Rua Fradique Coutinho 266
  524.      Sao Paulo     SP
  525.      CEP: 05416
  526.      Fone: (011) 64-7199
  527.  
  528.       C.A.T. Kommunikations-System (GERMANY)
  529.      49-6192-42054 (1200-2400)
  530.      49-6192-42057 (19200 PEP)
  531.      Packet switching networks: 45619270055
  532.  
  533.       B-Catel BBS           (THE NETHERLANDS)
  534.      +31,33,612819
  535.  
  536.    end of document
  537.  
  538.