home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR31 / PKPRE4B2.ZIP / PKPRESS.DOC < prev    next >
Text File  |  1994-01-16  |  12KB  |  309 lines
  1. Pkpress 4.0, Copyright 1993,1994 by Michael W. Graham
  2.  
  3.  
  4.                         Introduction:
  5.  
  6. Pkpress is a command line utility that will increase your hard drive 
  7. space.  You tell Pkpress which directories to process, and it will
  8. find all zip files, recompress them (if necessary) with PKZIP's
  9. maximal compression.  It will also process the comment (if any)
  10. on the zip file.  The recompression to maximal can save MEGABYTES of
  11. HD space if you have a lot of zip files.  It can also be run as an
  12. event, upload processor, or from a batch file.
  13.  
  14. This program will work equally well with PKZIP 1.1 or 2.04g. However,
  15. if you are using version 2.04g, you will have the added benefit of
  16. converting any 1.1 files to 2.04, which will SAVE even more DISK SPACE.
  17.  
  18.  
  19.                        Quick Setup :
  20.  
  21. Guess what?  Absolutely NOTHING has to be in your path!  Just make sure 
  22. that PKPRESS and it's associated configuration file are in the same
  23. directory.  Please erase ALL older versions of Pkpress on your system!
  24.  
  25.         I.  Put PKPRESS.EXE and PKPRESS.CNF in the same directory.
  26.  
  27.        II.  Edit the Config file (PKPRESS.CNF) for your specifications.
  28.  
  29.             Each Line must contain [THIS|THAT|<somethingelse>]
  30.                                         ^----^----OR        ^--Brackets
  31.                                                                mean replace
  32.                                                                with info
  33.                 1: [0|<registration code>]                                      
  34.                 2: [ALL|NOTMAX]
  35.                 3: [YES|NO]
  36.                 4: [NONE|DEFAULT|<location & name of comment file>]
  37.                 5: [REPLACE|APPEND|SAVE|STRIP]
  38.                 6: [<location & name of pkzip>]
  39.                 7: [<location & name of pkunzip>]
  40.                 8: [YES|NO]
  41.                 9: [YES|NO]
  42.                10: [DEFAULT|BLACK|MONOCHROME]
  43.                11: [ON:OFF]
  44.                12: [<User Name>]
  45.  
  46.             Here is the meaning of each line in the config file:
  47.  
  48.               1:  Registration code - if unregistered, leave as 0
  49.               
  50.               2:  You can either process ALL files or only files that
  51.                   do not already have maximum compression. (You may
  52.                   want to do ALL files in order to process the 
  53.                   comments, etc.)  Otherwise, it is much faster to
  54.                   skip files that already have max compression. 
  55.                   Line 2 is either ALL or NOTMAX.
  56.  
  57.               3:  If you use a 3rd party memory manager (like QEMM),
  58.                   put YES, if not put NO.
  59.  
  60.              *4:  Comment File:  Put the drive:\path\name of a comment
  61.                   file you would like to add.  This file is any text
  62.                   file that you would like to appear as a comment.
  63.                   If you use your own comment file, put it like so:
  64.                   C:\TEMP\MYCMT.TXT  (or any path\file you like).
  65.                   Alternatively, you can use the DEFAULT comment file,
  66.                   or choose NONE.
  67.                   (Unregistered version must be set to DEFAULT)
  68.  
  69.              *5:  Comment Mode:  Do you want to REPLACE the existing 
  70.                   comment with a new one, APPEND the new one to the
  71.                   end of the existing one, SAVE the existing comment
  72.                   unchanged, or STRIP all comments from the zip file.
  73.                   (Unregistered version must be set to APPEND)
  74.  
  75.               6:  Drive:\Path\Name   Location of PKZIP
  76.                   (Ex:  E:\ZIP\PKZIP.EXE)
  77.  
  78.               7:  Drive:\Path\Name   Location of PKUNZIP
  79.  
  80.               8:  Do you want to record a Logfile (YES or NO)
  81.                   The logfile will be created as a text file in the
  82.                   directory that pkpress.exe is located as LOGFILE.TXT
  83.  
  84.              *9:  If the zip file has a FILE_ID.DIZ description file,
  85.                   do you want to insert that description into the
  86.                   comment?  (YES or NO)
  87.                   (Unregistered version must be set to NO)
  88.  
  89.              10:  Color Scheme :  Default has blue background,
  90.                                   Black has black background,
  91.                                   Monochrome for Mono monitors
  92.  
  93.              11:  ZIP file errorlevel testing   ON or OFF
  94.                   It is STRONGLY RECOMMENDED that you leave this ON
  95.  
  96.              12:  Your Name here  Format:  FIRST LAST
  97.  
  98.  
  99.               * - can only alter with registered version
  100.               
  101.               Please see the sample PKPRESS.CNF file to see how it looks.
  102.  
  103.  
  104.         III.  Now you are ready to process (for one directory)
  105.                 
  106.                 1. Switch to the directory that pkpress is in.
  107.  
  108.                 2.  Type PKPRESS and the drive & directory you wish to
  109.                     process.
  110.  
  111.                 
  112.  
  113.              ---------------------------------------------------------------
  114.                         
  115.                         To process all zip files in C:\TEMP, type:
  116.  
  117.                         
  118.                         pkpress c:\temp      
  119.  
  120.  
  121.              ---------------------------------------------------------------
  122.                 
  123.         IV.  If you would like to process multiple directories:
  124.  
  125.                 edit the file named DIRECT.LST
  126.                         
  127.                 the first line will be the drive you wish to process:
  128.  
  129.                 C:
  130.  
  131.                 the remaining lines are any directories you want processed:
  132.  
  133.                 \TEMP
  134.                 \TEMP\TEST
  135.                 \ZIPS
  136.                 \OLDZIPS
  137.                 \DOS\ARCS\OLD
  138.                 \KEEP
  139.  
  140.                 You may put as many directories as you like in this file,
  141.                 one on each line, and preceded by a "\"  (without quotes)
  142.  
  143.  
  144.                 This file DIRECT.LST must be in the same directory
  145.                 as PKPRESS.EXE and PKPRESS.CNF.
  146.  
  147.       ----------------------------------------------------------------
  148.  
  149.                 Now, to process all zip files in the directories
  150.                 in the Direct.Lst file, type:
  151.  
  152.                 
  153.                 pkpress direct.lst
  154.  
  155.         -------------------------------------------------------------
  156.                 Please see the sample DIRECT.LST file.
  157.  
  158.  
  159.  
  160.  
  161.         
  162.                         Some Recommendations:
  163.  
  164.         
  165.         Test Pkpress on a sample directory before processing
  166.         a full directory to ensure system compatibility.
  167.         
  168.         
  169.         Use common sense when setting comment processing features
  170.         in the config file  (just to save time):
  171.  
  172.         For example:
  173.  
  174.                 If STRIPping comments, use comment file type NONE
  175.  
  176.                 If SAVEing comments, use comment file type NONE
  177.  
  178.                 If comment file type is NONE, don't set the mode
  179.                 to APPEND, just use SAVE.
  180.  
  181.                 If comment file type is NONE, don't set the mode
  182.                 to REPLACE, just put STRIP.
  183.  
  184.  
  185.                 Since existing comments may already have the File
  186.                 Id description in them, I suggest only setting the
  187.                 insert file_id diz description in commment to YES
  188.                 if you are REPLACEing comments.
  189.  
  190.  
  191.         
  192.         The more comments you add to each zip file, the LESS space 
  193.         you will save.  
  194.  
  195.         FOR MAXIMUM SPACE AND SPEED set comment file to NONE and
  196.         comment mode to STRIP.
  197.  
  198.         If you choose to use pkzip 1.1 and pkpress comes across a
  199.         2.04 file, it cannot process it.  A message about "too high
  200.         a version" will be on the status line and in the log file.
  201.  
  202.         Pkpress will remove authentic verification from a zip file
  203.         if it processes it. It will not hurt the file in any way,
  204.         but you may wish not to include -AV files in processing.
  205.  
  206.                         TroubleShooting:
  207.   
  208.   
  209.   ***   For general errors or any other weird problems, try setting
  210.         line 2 (using a 3rd party memory manager) to YES, even if you
  211.         are not.
  212.  
  213.  
  214.         Only use pkpress on Fixed Local drives; that is don't use on
  215.         floppy drives or network drives.
  216.  
  217.         Press <ESC> at anytime to abort processing.
  218.  
  219.         If you have a registered version of pkzip, it is possible that
  220.         the pkzip configuration file is confusing pkpress.  Temporarily
  221.         remove the pkzip config file.  Pkpress should not have a problem
  222.         but it could be possible.
  223.  
  224.  
  225.         If you have a message about CRC errors, try running Pkpress
  226.         from the directory it resides in (not from a path statement,
  227.         or from another directory as c:\pkp\pkpress.exe) first switch
  228.         to that directory.  If you continue to get this message, the
  229.         code you have may have been tampered with - call the Guild
  230.         BBS for a clean copy.
  231.  
  232.         If you are getting Not enough Disk Space messages often, try
  233.         making some room before starting to process a lot of large
  234.         ZIP files.
  235.  
  236.         The elapsed time does not "tick" while pkzip is working in the
  237.         background - do not be alarmed, the program is NOT locked up.
  238.  
  239.         If you are having problems and you are using DR DOS, 4DOS,
  240.         and older version of MS DOS (under 5.0), try setting line
  241.         #11 in the CNF file (Zip file errorlevel testing) to OFF.
  242.         If this does not work, immediately put it back to ON.
  243.  
  244.                         Files you should have:
  245.  
  246.  
  247.                 PKPRESS.EXE             The program executable
  248.                 PKPRESS.DOC             This file
  249.                 PKPRESS.CNF             Configuration file
  250.                 DIRECT.LST              Multi-directory control file
  251.                 LOGFILE.TXT             Sample Log File
  252.                 FILE_ID.DIZ             Description file
  253.                 ORDER.FRM               Order form for registration
  254.                 VENDINFO.DIZ            Vend Info Description File
  255.  
  256. Credits:
  257.  
  258.         PKZIP is (c) 1993 by PKWARE, Inc.
  259.         Routines from Tom Hanlin's PBCLONE were used.
  260.         PBCLONE is (c) 1993 by Tom Hanlin
  261.         PKPRESS is (c) 1993 by Michael Graham
  262.  
  263.  
  264.  
  265.  
  266.  This program is fully functional.  If you use it, please register it. 
  267.  
  268.  Registration is ONLY  $20.00 (US) - help support shareware authors!
  269.  
  270.  Registration will also give you extended access to our support BBS, and
  271.  enable MANY features in the program (please see the ORDER.FRM)
  272.                         
  273.                         
  274.                                 The Guild BBS
  275.                                 (804) 739-9315
  276.  
  277.                                 Michael Graham
  278.                                 PO Box 1846
  279.                                 Midlothian, VA 23113
  280.  
  281.  
  282.  To register, please send check or money order to the above address. You
  283.  will receive access to the Guild and a registration code.
  284.  Please include the program name, version number, along with your pertinent
  285.  information : (name, address, phone, etc.).  Please use the order form,
  286.  ORDER.FRM for faster processing on your registration.
  287.  
  288.  ** Registration will remove the pkpress "ad" appended to comments in each
  289.  ** zip file and the processed zip file will have the file date of the most  
  290.  ** recent internal file.  Unregistered versions use today's date on all
  291.  ** processed files.   You will also receive support via our BBS. In addition,
  292.  ** registration will enable full use of the pkpress config file, allowing
  293.  ** you to fully process comments and other valuable features you can "unlock"
  294.  
  295.  
  296.  DISCLAIMER:
  297.  
  298.  We ("Maritime Computer" or "Michael W. Graham") are not responsible 
  299.  for any damages of any kind, including profit losses and data losses, 
  300.  that relate directly or indirectly to these programs and files.  
  301.  You may distribute this program, as long as it is in unmodified form 
  302.  with all the files originally included.  Do not "reverse engineer" or 
  303.  unassemble this program. Please do not attempt to generate registration
  304.  codes.
  305.  
  306.  This program and associated files may not be distributed for a fee
  307.  without express written consent from the author.
  308.  
  309.