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