home *** CD-ROM | disk | FTP | other *** search
/ Doom 1 & 2 Add-On Levels (Alt) / Doom_I_and_II_add-ons_levels.iso / pkzip / addendum.doc next >
Text File  |  1993-01-31  |  19KB  |  518 lines

  1.  
  2.     ADDENDUM to PKZIP 2 Manual
  3.     --------------------------
  4.  
  5.     This file contains the most up-to-date information, additions and
  6.     changes to the PKZIP version 2 manual.
  7.  
  8.  
  9.       AUTHENTICITY VERIFICATION FEATURE
  10.       ---------------------------------
  11.  
  12.     The Authenticity Verification information you receive from PKWARE
  13.     will include two AV Serial Numbers and one checksum.  The Serial
  14.     Numbers and checksum include BOTH letters and numbers.  ALL 
  15.     LETTERS are LOWER CASE, with the exception of the letter L.  The 
  16.     letter L will be printed in upper case to avoid confusion with 
  17.     the number one.
  18.  
  19.     After both Serial Numbers are entered using the PUTAV.EXE, the
  20.     program will return a checksum value.  This checksum must match
  21.     the one provided by PKWARE.  If the checksums do not match, then
  22.     the installation was not performed correctly and PUTAV.EXE should
  23.     be run again to ensure that the Serial Numbers and Name were
  24.     entered correctly.
  25.  
  26.     If you run PUTAV.EXE and you encounter the error, "WRONG VERSION
  27.     OF PKZIP.EXE", verify that you are running PUTAV on the
  28.     REGISTERED version of PKZIP.EXE.
  29.     
  30.  
  31.       AVEXTRA.TXT
  32.       -----------
  33.  
  34.     With the PKZIP 2 Authenticity Verification feature, additional
  35.     text can be displayed on subsequent lines following the
  36.     verification message.  An ASCII text file named AVEXTRA.TXT is
  37.     created containing the additional text you want displayed.  When
  38.     the AVEXTRA.TXT file is in the current directory when you use the
  39.     "PKZIP -!" option, PKZIP will add this text to the .ZIP file and
  40.     PKUNZIP will display it after the normal Authenticity
  41.     Verification message.  The Authenticity Verification feature is
  42.     available only to registered users of PKZIP.
  43.  
  44.  
  45.       SELF-EXTRACTING FILES ACROSS MULTIPLE DISKETTES
  46.       -----------------------------------------------
  47.  
  48.     PKZIP 2 has the ability to compress a large .ZIP file across
  49.     multiple diskettes.
  50.  
  51.     Self-extracting files CAN NOT span multiple disks.  This would
  52.     make the PKSFX code extremely large.
  53.  
  54.  
  55.     A simple batch file can be created that would uncompress across
  56.     multiple diskettes.  All that would be required is to have the
  57.     batch file follow this procedure:
  58.  
  59.  
  60.     1.  Create a batch file called install.bat
  61.     2.  Edit install.bat and in that file have the following line:
  62.  
  63.           pkunzip -d a:program c:\test
  64.  
  65.     This batch file would create the directory C:\TEST on your
  66.     computer and then unzip the file called PROGRAM.ZIP into the c:\test
  67.     directory.  PKUNZIP will prompt the user to enter the diskettes
  68.     in the extraction order.
  69.  
  70.  
  71.       PKCFG.EXE
  72.       ---------
  73.  
  74.       * PKCFG.EXE is only included in the registered version of PKZIP.
  75.  
  76.     PKZIP.EXE can have many of its features configured with a
  77.     configuration file called PKZIP.CFG.  This configuration file can
  78.     be located in either your current directory, a directory
  79.     specified with the environment variable PKZIP.CFG, or in the
  80.     directory that PKZIP.EXE is located.  PKZIP.EXE will search for the
  81.     configuration in each location in the order listed above.  This
  82.     means that you may have a default configuration file that is
  83.     easily overridden by using a configuration file in either of the
  84.     first two locations.  Any option that is set in the configuration
  85.     file may be overridden from the command line.  The configuration
  86.     file may be created manually with a text editor.
  87.  
  88.     The PKCFG.EXE program will look for an existing configuration file
  89.     in the same locations and order that PKZIP.EXE would look.  If the
  90.     PKCFG.EXE program finds an existing configuration file it will load
  91.     it. The existing configuration values will be shown in the place of
  92.     the defaults.  A list of options will be displayed on the screen,
  93.     and a highlighted cursor indicates the option that you can
  94.     modify.
  95.  
  96.  
  97.       PK SAFE ANSI
  98.       -----------
  99.  
  100.       * PKSFANSI.COM is only included in the registered version of PKZIP.
  101.     
  102.     Another program included with registration of PKZIP 2 is called
  103.     PKSFANSI.COM.  PKSFANSI is a terminate and stay resident program
  104.     that disables ANSI keyboard key Reassignments, thereby preventing
  105.     ANSI "bombs" embedded in any text file (such as README files) or
  106.     output by any program.  Normally, ANSI sequences that redefine
  107.     the keyboard could be hidden inside ANY text file or program, and
  108.     could be executed completely unnoticed until it is too late.
  109.     PKSFANSI intercepts calls to the ANSI.SYS or other ANSI device
  110.     drivers, and filters out any keyboard reassignments, while
  111.     allowing other ANSI sequences through unaltered.  If a keyboard
  112.     reassignment is attempted, PKSFANSI will intercept the sequence
  113.     and discard it.  PKSFANSI will also BEEP to alert you that a
  114.     reassignment was attempted.
  115.  
  116.  
  117.     PKSFANSI requires less than 1K bytes resident RAM, and should
  118.     work with any ANSI driver, such as the standard ANSI.SYS driver,
  119.     NANSI, ZANSI, DVANSI, etc.  Note that if you use a memory
  120.     resident ANSI driver, such as the DESQview DVANSI.COM driver,
  121.     PKSFANSI should be loaded after the ANSI driver is loaded.
  122.  
  123.  
  124.       Using PKZIP and DPMI
  125.       --------------------
  126.  
  127.     If you experience difficulties when using PKZIP in a DOS window
  128.     under Windows, use the -) option to disable DPMI support.  If
  129.     this eliminates the problem, you may default this option for
  130.     PKZIP by using the configuration file (see manual for details).
  131.     With PKUNZIP, this option may be set as an environment variable
  132.     (see below for details).
  133.  
  134.  
  135.       PKUNZIP as an Environment Variable
  136.       ----------------------------------
  137.  
  138.     PKUNZIP includes the ability to use an environment variable as a 
  139.     continuation of the command line.  An option, or number of options 
  140.     may be specified by an environment variable.  PKUNZIP will treat 
  141.     the variables as if they were passed on the command line.
  142.  
  143.          example: set PKUNZIP=-)
  144.  
  145.       This example would disable DPMI usage.
  146.  
  147.     Note that since the PKUNZIP environment variable is a 
  148.     continuation of the command line; it will supersede any 
  149.     preceding option on the command line.
  150.  
  151.  
  152.       Minimum DOS Requirements for SPANNING & FORMATTING
  153.       --------------------------------------------------
  154.  
  155.     For PKZIP 2 to span multiple disks with a .ZIP file, DOS 3.0 or
  156.     greater is required.
  157.  
  158.     To be able to format diskettes on-the-fly, DOS 3.2 or greater is
  159.     required.
  160.  
  161.  
  162.       PKUNZJR.COM & PKSFX Junior
  163.       --------------------------
  164.  
  165.     When using PKUNZJR or PKSFX Junior, remember to end your output
  166.     path with a : or a \.  Because the PKUNZJR and PKSFX Junior were
  167.     designed to be as small as possible, please note that they
  168.     perform minimal error checking.
  169.  
  170.  
  171.       CHANGE TO "MOVE" OPTION
  172.       -----------------------
  173.  
  174.     When using the -m option in PKZIP.EXE PKZIP will now remove the
  175.     directories and subdirectories after the compression process has
  176.     been completed. This feature is turned on by default. If you
  177.     wish PKZIP not to remove the directories/subdirectories, use a
  178.     -m- option to disable this feature.
  179.  
  180.  
  181.       PKNOFASTCHAR= Environment Variable
  182.       ---------------------------------
  183.  
  184.     This tells PKZIP/PKUNZIP to use the slow DOS 1.x/2.x character
  185.     output function calls rather than the 'DOS Fast Character
  186.     Output' function.  This option is designed for compatability with
  187.     TSR's or BBS doors etc. that do not intercept the DOS Fast
  188.     Character Output function.
  189.  
  190.  
  191.       ERROR MESSAGES
  192.       --------------
  193.  
  194.     This is an addendum to the ERROR MESSAGES found in the manual.
  195.  
  196.     PKZIP: (E[19-23] and E29) Insufficient Memory
  197.  
  198.     PKZIP: (E26) DOS 3.0 or later needed to span disks
  199.     PKZIP: (E26) DOS 3.2 or later needed to format disks
  200.  
  201.     PKZIP: (E28) Destination for .ZIP file is same as temporary file
  202.     PKZIP: (E28) Source and destination is the same
  203.  
  204.     PKZIP: (W07) Warning! Bad System Track
  205.  
  206.     PKZIP: (W08) Warning! Can't write FAT
  207.  
  208.     PKZIP: (W09) Warning! Can't write root directory
  209.  
  210.     PKZIP: (W10) Warning! Can't write boot sector
  211.  
  212.     ZIP2EXE: (E09) Can't create ouput file
  213.  
  214.     ZIP2EXE: (W01) Warning! The file already exists, overwrite (y/n)?
  215.  
  216.     PKSFX: Warnings numbers are the same as PKUNZIP 
  217.            [9-18,20,21,23,24]
  218.  
  219.     PKSFX: (E02,E03) Error in .EXE file
  220.  
  221.  
  222.     PKSFXJR: No numbers are printed by PKSFXJR. The manual states
  223.          that PKSFXJR will report error numbers, but this is
  224.          incorrect. It will print only a message, no number
  225.          is printed. The errorlevel will be returned to DOS
  226.          however.
  227.  
  228.  
  229.                 SUMMARY
  230.                 -------
  231.     PKZIP:
  232.  
  233.     0       No Error
  234.     1       Bad file name or file specification
  235.     2,3     Error in .ZIP file
  236.     4-11    Insufficient Memory
  237.     12      No files were found to add to the .ZIP, or no files
  238.         were specified for deletion
  239.     13      File not found. The specified .ZIP file or list file
  240.         was not found
  241.     14      Insufficient disk space for .ZIP comment
  242.           or
  243.         Insufficient disk space for update file
  244.           or
  245.         Disk Full, file XXXXX
  246.     15      .ZIP file is read-only and can not be modified
  247.     16      Bad or illegal parameters specified. (help screen displayed)
  248.     17      Too many files
  249.     18      Could not open file
  250.     19-23,29 Insufficient Memory
  251.     26      DOS 3.2 or later needed to span disks
  252.     28      Destination for .ZIP is same as temporary file
  253.           or
  254.         Source and destination is the same
  255.     255     User pressed control-c or control-break
  256.  
  257.     ZIP2EXE:
  258.  
  259.     0       No error
  260.     1       Error in .ZIP file
  261.     2       Error in .ZIP file, use PKZIPFIX
  262.     3-4     Insufficient memory to process file
  263.     6       Bad or illegal parameters specified. (help screen displayed)
  264.     7       Can't open Source file
  265.     8       Error in .ZIP file
  266.     9       Disk full writing target file during EXE to ZIP process
  267.     11      Disk full writing target file during ZIP to EXE process
  268.     12      .ZIP file being converted contains a file compressed with
  269.         a method not supported by the version of PKSFX being
  270.         attached by ZIP2EXE
  271.     13      User answered "No" in response to an "overwrite(y/n)?" prompt
  272.  
  273.  
  274.     PKSFX:
  275.  
  276.     1       Warning error such as:
  277.         File fails CRC check, Unknown compression method.
  278.     2,3     Can't find .EXE file
  279.     4-8     Insufficient memory
  280.     9       Unable to locate listfile
  281.     10      Bad or illegal parameters specified. (help screen displayed)
  282.     12      User aborted at comment pausing, "Extract now (y/n)?" prompt
  283.     2,3,13  Error in .EXE file
  284.     50      Disk full
  285.  
  286.  
  287.       NOTES
  288.       -----
  289.  
  290.     Note, the -x option in PKUNZIP now is used to specify files
  291.           to eXclude.  As stated in the PKUNZIP 1.1 documenation, use
  292.           of '-x' to mean eXtract would not be supported in future
  293.           versions of PKUNZIP.  The -e option of PKUNZIP specifies
  294.           extraction.
  295.  
  296.     Note, the -o and -k, as well as the ZIPDATE= options in the
  297.           pkzip.cfg file, will be ignored when used with the -& option.
  298.  
  299.     Note, PKZIP requires 206K of memory if no EMS or XMS is available,
  300.           and 108K if enough EMS/XMS is available.
  301.  
  302.     Note, In the PKZIP manual, it states that the -o option will set
  303.           .ZIP file date to oldest file in .ZIP file. This should read
  304.           set .ZIP file date to latest, not oldest.
  305.  
  306.     Note, Page 76 of the PKZIP manual incorrectly lists the default 
  307.           value of view as Long. The default value of view is normal.
  308.  
  309.     Note, When using either the -&l or -&u, both of these options 
  310.           will format the destination diskette(s).
  311.  
  312.  
  313.       PKZIP BACKUP GUIDE
  314.       ------------------
  315.  
  316.     PKZIP can now create .ZIP files that exceed the size of a floppy
  317.     disk.  You can use PKZIP to backup your entire hard disk and
  318.     unlike most backup programs, PKZIP can use disks formatted by
  319.     DOS, or it can format the disk for you.  PKZIP can optionally
  320.     erase all files on the destination disk(s), or leave those files
  321.     intact.  PKZIP can optionally quick format the destination
  322.     disk(s), or do a normal (unconditional) format.  A quick format
  323.     erases the information on the disk without formatting each
  324.     track, greatly reducing the time required to format a disk.
  325.  
  326.  
  327.     Option    Description
  328.     --------------------------------------------------------------------
  329.       -&      Span disks if necessary.
  330.  
  331.     You must specify this option if you wish to create a .ZIP file
  332.     on multiple disks.  If this option is not specified and you
  333.     exceed the capacity of a floppy disk, a DISK FULL error message
  334.     will result.
  335.  
  336.       -&f     Format the destination disk.
  337.  
  338.     PKZIP will format the destination disk(s) if you specify this
  339.     option.  If the disk has been formatted previously, a quick
  340.     format will be performed, otherwise a full format will be
  341.     performed.
  342.  
  343.       -&fl    The destination disk is to be formatted to low density.
  344.  
  345.     If you plan to use low density disks in a high density disk
  346.     drive, this option is required.  For example, if you have a 1.44
  347.     meg floppy disk drive, and plan to zip to 720K disks and your
  348.     disks are not formatted, you must specify this option.  If your
  349.     disk drive is a 360K or 720K drive, this option is not required.
  350.     If any information was previously contained on the disk, it will
  351.     be erased.
  352.  
  353.  
  354.       -&u     Unconditionally (always) format the disk.
  355.  
  356.     Always format the disk before being used.  A full format will be
  357.     used, a quick format will never be performed.  If any information
  358.     was previously contained on the disk, it will be erased.
  359.  
  360.       -&ul    Unconditionally (always) format a low density disk in a
  361.           high density disk drive.
  362.  
  363.  
  364.     Always format the disk before being used.  A full format will be
  365.     used, a quick format will never be performed. If any information
  366.     was previously contained on the disk, it will be erased.
  367.  
  368.       -&w     Wipe the disk.  (Erase all files and subdirectories)
  369.  
  370.     This is similar to -&f, except the files are deleted, rather than
  371.     formatting the disk.  This is for usage with non floppy removable
  372.     devices, such as Bernoulli boxes.
  373.  
  374.       -&s[d:] Include subdirectories in zipping process (similar to
  375.           -rp \*.*).
  376.  
  377.       -&v     Turn on DOS verify when spanning. This may also be set
  378.           by using BACKUP=verify in the pkzip.cfg file.
  379.  
  380.  
  381.     This option tells PKZIP that you wish to backup the entire disk
  382.     drive.  The current disk drive will be used if no disk drive is
  383.     specifed.  You do not need to specify the -rp option (recurse and
  384.     store pathnames).  If you also specify files on another disk
  385.     drive, these files will be compressed, as well as all files on the
  386.     default drive.  (Please see following examples.)
  387.  
  388.     All options are case insensitive, but this may change in future
  389.     versions.  We suggest you USE LOWER CASE LETTERS FOR FUTURE
  390.     COMPATIBILITY.  The -&l option must be specified with -&u or -&f.
  391.  
  392.     * Note:   If you create a .ZIP file with the same name as exists
  393.       on a disk set, you do not need to use the WIPE or FORMAT
  394.       options.  PKZIP will create a new .ZIP file with the same name;
  395.       this method is faster.
  396.  
  397.     * Note:   All the PKZIP Configuration File options can be
  398.       overridden on the command line by specifying the option and a
  399.       '-'.  For example, -&f- will override "BACKUP=FORMAT" in the
  400.       Configuration File and turn off formatting.
  401.  
  402.     * Note:   When using PKUNZIP.EXE to restore a from a spanned
  403.       backup set, it is most efficient to start by inserting the
  404.       last diskette.
  405.  
  406.     * Note:   If you would like to use PKZIP.EXE for full and
  407.           incremental backups, use the -a+ for the full backup.
  408.           This will turn off the archive attribute after the
  409.           files have been compressed.  Then to perform a
  410.           incremental backup, use the -i option.  This will
  411.           compress only files that have changed since they
  412.           were last backed up.
  413.  
  414.  
  415.     Examples
  416.     --------
  417.  
  418.     Command Line              Description
  419.     -----------------------------------------------------------------
  420.     pkzip a:zipfile -&        Zip the current directory to drive A:, and
  421.                   span disks if necessary.  The files
  422.                   currently on drive A: will not be affected.
  423.  
  424.     C:\>pkzip a:zipfile -&s   Zip all files on drive C: to the A: drive.
  425.  
  426.     C:\>pkzip b:zipfile -&s d:\sd\*.*  Zip all files on drive C:
  427.                        (the current drive), and all files
  428.                        in the D:\SD directory to the B:
  429.                        drive.
  430.  
  431.     C:\>pkzip a:zipfile -&s d:\*.BAT   Zip all the files on drive C: and
  432.                        all .BAT files on drive D: to the
  433.                        A: drive.
  434.  
  435.  
  436.     pkzip a:zipfile -&f -rp            Zip the current directory and its
  437.                        subdirectories to drive A:, and
  438.                        format each disk.  A quick format
  439.                        will be performed if possible,
  440.                        which is much faster than a
  441.                        unconditional format.
  442.  
  443.     pkzip a:zipfile -&u -rp            Same as above, except the disk
  444.                        will be unconditionally formatted.
  445.  
  446.     pkzip a:zipfile -&fl               Zip the current directory to drive
  447.                        A:, and format each disk to low
  448.                        density.  This option only applies
  449.                        to users using a 360K floppy disk
  450.                        in a 1.2 meg drive, or users using
  451.                        a 720K floppy disk in a 1.44 meg
  452.                        drive.  A quick format will be
  453.                        performed if possible, which is
  454.                        much faster than a unconditional
  455.                        format.
  456.  
  457.     pkzip a:zipfile -&ul               Same as above, except the disk
  458.                        will be unconditionally formatted
  459.                        (do not quick format).
  460.  
  461.     pkzip a:zipfile -&w -rp            Zip the current directory and its
  462.                        subdirectories to drive A:, and
  463.                        wipe each disk.  All files and
  464.                        subdirectories will be erased from
  465.                        the A: drive.  The disk will not
  466.                        be formatted or quick formatted.
  467.  
  468.  
  469.     pkzip a:zipfile -&fs               Zip the current disk drive
  470.                        (including subdirectories) to drive
  471.                        A:, and format each disk.  If the
  472.                        destination disk has previously
  473.                        been formatted, a quick format will
  474.                        be performed.  Otherwise, an
  475.                        unconditional format will be
  476.                        performed.
  477.  
  478.  
  479.       New Options For the PKZIP.CFG Configuration File
  480.       ------------------------------------------------
  481.     The keyword BACKUP=  can be followed by the following keywords:
  482.  
  483.       SPAN            The -& option is enabled.  If this keyword is not
  484.               specified, the following options will only be
  485.               enabled when -& is specified on the command line.
  486.               Same as -&.
  487.  
  488.       UNCONDITIONAL   Format the disk unconditionally.  Same as -&u.
  489.  
  490.  
  491.       LOW             Using low density disks.  Same as -&l
  492.  
  493.       FORMAT          Format the disks.  Same as -&f.
  494.  
  495.       WIPE            Wipe the disks.  Same as -&w.
  496.  
  497.       FULL            Do a full backup.  Same as -&s.
  498.  
  499.       VERIFY          Turn on DOS verify when spanning. Same as -&v
  500.  
  501.     Examples                             Same as
  502.     --------------------------------------------------------
  503.       BACKUP=SPAN FORMAT                   -&f
  504.       BACKUP=SPAN FORMAT UNCONDITIONAL     -&u
  505.       BACKUP=LOW VERIFY SPAN               -&lv
  506.       BACKUP=FORMAT WIPE         Illegal -- WIPE and FORMAT are exclusive.
  507.       BACKUP=FULL                          -&s
  508.       BACKUP=FULL  WIPE                    -&sw
  509.  
  510.  
  511.  
  512.     PKWARE, PKZIP, PKUNZIP and PKSFX are registered trademarks of PKWARE,
  513.     Inc. PKSFANSI and PKCFG are trademarks of PKWARE, Inc.
  514.  
  515.     Trademarks of other companies mentioned appear for identification
  516.     purposes only and are the property of their respective companies.
  517.  
  518.