home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / COMPRESS / ZT251.ZIP / ZIPTOOL.DOC < prev    next >
Text File  |  1992-11-04  |  27KB  |  472 lines
  1.  
  2.  
  3.  
  4.  
  5.                       ╔════════════════════════════════╗
  6.                       ║   Z  I  P  T  O  O  L          ║
  7.                       ║      Version 2.51              ║
  8.                       ║     (November 4, 1992)         ║
  9.                       ╠════════════════════════════════╣
  10.                       ║ Written by Russell Pool        ║
  11.                       ║            106 Holly St        ║
  12.                       ║            Rome, Ga 30161-6930 ║
  13.  ═════════════════════╩════════════════════════════════╩═══════════════
  14.     Purpose:  1. To break down ZIP files into smaller ZIP files leaving
  15.                  the data in ZIP format without UNZIPPING the files.
  16.  
  17.               2. Combine the numerous ZIP files back together as one
  18.                  ZIPfile without UNZIPPING.
  19.  
  20.               3. Selectivly view any file within the ZIPfile without
  21.                  UNZIPPING all the other files.
  22.               
  23.               4. Copy tagged or untagged files out of a selected ZIPfile
  24.                  to another ZIPFile without unzipping.
  25.         
  26.               5. Deletion of tagged or utagged files within a ZIPfile.
  27.  
  28.               6. Move files tagged or untagged from within a ZIPfile to
  29.                  another ZIPfile without unzipping.
  30.  
  31.               7. Extract tagged or untagged files withing a ZIPfile.
  32. ╔═════════════════════════════════════════════════════════════════════════╗
  33. ║   Command Line Format: <D:><Path>ZIPTOOL <options> <switches>           ║
  34. ╚═════════════════════════════════════════════════════════════════════════╝
  35.        Options:
  36.         HELP
  37.             List ALL Command line options and Environment
  38.           parameters that ZiPtool uses. Quick Reference
  39.  
  40.         REGISTER
  41.           (Example: ZIPTOOL REGISTER)
  42.             This will allow you to register ZIPTOOL. It will
  43.             ask for your Name, Address, City State and ZIP, then
  44.             it will ask for your registration number. If your
  45.             registration number doesnt match the information you
  46.             sent to me, then ZIPTOOL will not install the registration
  47.             information.
  48.  
  49.           UNREGISTER
  50.             (Example: ZIPTOOL UNREGISTER)
  51.           This will allow you to remove your registration information
  52.           from Ziptool if you want to give it to a friend. Please note
  53.           that it is ILLEGAL to distribute REGISTERED copies of ZIPTOOL.
  54.  
  55.         EDITOR
  56.           (Example: ZIPTOOL EDITOR)
  57.           This option will install a CUSTOM Editor that you have
  58.           in your path. All you have to do is tell it the filename
  59.           (IE:LIST.COM) and Ziptool will attach your editor to itself
  60.           and run it when you view files within ZIPTOOL. The only
  61.           requirements is the editor must be able to view binary files
  62.           and to accept filenames to view on the DOS command line.
  63.  
  64.         NOEDITOR
  65.           (Example: ZIPTOOL NOEDITOR)
  66.           This option will remove the Custom installed Editor if
  67.           one was installed. Very helpful in installing a new editor
  68.           or returning ZIPTOOL to the orginal editor.
  69.  
  70.         VIEWREG
  71.           (Example: ZIPTOOL VIEWREG)
  72.           This option will allow you to view the registration of
  73.           ZipTool. This is quite handy for upgrading your old
  74.           version of ZipTool and installing your registration
  75.           information into.
  76.  
  77. ╔══════════════════════════════════════════════════════════════════════════╗
  78. ║       ZipTool now supports environment parameters.                       ║
  79. ║             ENVIRONMENT OPTIONS:                                         ║
  80. ║                    ZTMOUSE=OFF                                           ║
  81. ║                        Turns MOUSE off. To set Environment Parameter,    ║
  82. ║                        type SET ZTMOUSE=OFF at the DOS Prompt. To        ║
  83. ║                        remove parameter, type SET ZTMOUSE=               ║
  84. ╚══════════════════════════════════════════════════════════════════════════╝
  85.  
  86.               ZIPTOOL Switches:
  87.                  /M = Turn off Mouse support (If available)
  88.  
  89.                  /NC = No Color Mode - For Monochrome. ZIPTOOL
  90.                        should autodetect if you have a MONO
  91.                        monitor
  92.  
  93.                  /CO = Force Color Mode - Helpful if ZIPTOOL
  94.                        has a problem detecting you monitor
  95.  
  96.                  /DEBUG = For Debuging ZipTool. For Author use.
  97.                           Great for finding memory allocation problems
  98.                           that ZipTool sometimes has.
  99.  
  100.               Once ZIPTOOL is loaded, F1 help is availble at almost every
  101.               location.
  102.  
  103.  ╔═════════════════════════════════════════════════════════════════════╗
  104.  ║ <<< WARNING >>>                                                     ║
  105.  ║     DO NOT USE PKLITE ON ANY VERSION OF ZIPTOOL. Ziptool saves its  ║
  106.  ║     configuration and registration information to itself. If it is  ║
  107.  ║     PKLITED, then Ziptool will be unable to find the places within  ║
  108.  ║     itself to write the information.                                ║
  109.  ╚═════════════════════════════════════════════════════════════════════╝
  110.  ╔════════════════════════════════════════════════════════════════════╗
  111.  ║ **** NOTE ****                                                     ║
  112.  ║   Subdirectories are displayed with a Down Arrow in of             ║
  113.  ║    the directory name and the previous path is an UP Arrow         ║
  114.  ║    symbol. Press enter (When Selection Bar is on Directory Name)   ║
  115.  ║    to change subdirectories                                        ║
  116.  ╚════════════════════════════════════════════════════════════════════╝
  117.     Keys to remember:
  118.               F1     Help (Globally)
  119.               F2     From file selection menu, Split selected ZIPfile
  120.               F3     From file selection menu, Merge selected ZIPfiles
  121.               F4     From file selection menu, Change to another Hard Drive.
  122.               F10    Registration Menus
  123.                         Install Registration (After you have recieved
  124.                           your registration number by mailing $10.00
  125.                           to the Author.)
  126.                         Print a Registration Form (To LPT1: ONLY)
  127.                         List BBS that carry Current Versions of ZipTool
  128.  
  129.               Enter  From file selection menu, View indivudial files in
  130.                      the ZIPfile.
  131.  
  132.               Enter  From the Viewing menu, Unzip and View the selected
  133.                      file. Handy for viewing DOC files.
  134.  
  135.               ESC    Back out of any menu or Screen.
  136.                      If at file selection menu, then ESC terminates
  137.                      ZIPTOOL.
  138.  
  139.          Arrow Keys  Move the selection bar up or down
  140. ╔═══════════════════════════════════════════════════════════════════════╗
  141. ║     Registering ZIPTOOL:                                              ║
  142. ║             If you want to register ZIPTOOL, then send $10.00 to:     ║
  143. ║                                                                       ║
  144. ║                                 Russell Pool                          ║
  145. ║                                 106 Holly St                          ║
  146. ║                                 Rome, Ga 30161                        ║
  147. ║                                                                       ║
  148. ║             Please make sure to enclose the following:                ║
  149. ║                                                                       ║
  150. ║               Your Name                                               ║
  151. ║               Your Address                                            ║
  152. ║               Your City, State and ZIPcode                            ║
  153. ║               Daytime Phone Number (If you wish me to call you)       ║
  154. ║                                                                       ║
  155. ║            These are used in the generation of a registration number. ║
  156. ╠═══════════════════════════════════════════════════════════════════════╣
  157. ║     Why do I want to register ZIPTOOL:                                ║
  158. ║                                                                       ║
  159. ║             There is only one reason for registering ZIPTOOL. The     ║
  160. ║             unregistered copy of ZIPTOOL will only split,merge        ║
  161. ║             copy or delete ZIP files that have less than 20 files     ║
  162. ║             in the ZIPfile. If you try to process a file with more    ║
  163. ║             than 20, it will refuse to process it. However you can    ║
  164. ║             still use the VIEW portion.                               ║
  165. ╠═══════════════════════════════════════════════════════════════════════╣
  166. ║             Please send comments and suggestions for this program     ║
  167. ║             to Russell Pool. Russell may be reached through his BBS   ║
  168. ║             (The Pool Hall - 404/235/7235 (300/1200/2400 baud) or     ║
  169. ║             through Compuserve (ID: 76276,36).                        ║
  170. ║             Please send ANY suggestions you might have. If possible   ║
  171. ║             I will try to incorporate them in. I would like ZIPTOOL   ║
  172. ║             to be the BEST ZIP management tool around.                ║
  173. ╚═══════════════════════════════════════════════════════════════════════╩
  174. ╔═════════════════════════════════════════════════════════════════════════════╗
  175. ║                  Error Codes and Possible Meanings                          ║
  176. ║                                                                             ║
  177. ║ If you get and error with ZipTool, In order for me to find the problem      ║
  178. ║and fix it, I need the following information. If I dont get this information,║
  179. ║I have NO WAY of finding the bug.                                            ║
  180. ║                                                                             ║
  181. ║   1. - I need the Error Code that ZipTool caused. This tells me what        ║
  182. ║        error occured and what to look for.                                  ║
  183. ║                                                                             ║
  184. ║   2. - Version Number. I keep last 3 versions of ZipTool available at       ║
  185. ║        all times to fix bugs. If I find a bug in a older version, I check   ║
  186. ║        the most recent version for the bug and fix it if is there.          ║
  187. ║                                                                             ║
  188. ║   3. - Program Counter. Version number and Program Counter are the MOST     ║
  189. ║        valuable pieces of information you can give. By going to the version,║
  190. ║        and giving my compiler the Program Counter, the compiler will take   ║
  191. ║        me DIRECTLY to the statement that caused the error and it speeds     ║
  192. ║        debugging. Since the program counters are different for each version,║
  193. ║        I need the version you are having problems with so the program       ║
  194. ║        counter will match the source code.                                  ║
  195. ║                                                                             ║
  196. ║   4. - I need to know what you were trying to do when it caused the error.  ║
  197. ║        An example would be Splitting, Merging, Copying a file or Exiting    ║
  198. ║        ZipTool. It allows me to trace down the problem better.              ║
  199. ╚═════════════════════════════════════════════════════════════════════════════╝
  200.  
  201.         --------------------------------------------
  202.          History of Modifications
  203.        --------------------------------------------
  204.          Date   |   Description
  205.         --------------------------------------------
  206.          4/5/91 | View files within the ZIP file
  207.         (V1.10) | (PC magazines BROWSE.COM is included in this Program)
  208.                 |
  209.                 | Added Pause for Diskette Swapping in ZIPPACK
  210.                 |
  211.                 | Let ZIPPACK create files that are as big as the freespace
  212.                 | left on the floppy drive
  213.                 |
  214.                 | Fixed Path problems in ZIPPACK
  215.                 |
  216.                 | Temporary files in ZIPPACK are stored on Both Destination
  217.                 | and Default drive
  218.                 |
  219.                 | Added ability to turn off mouse with /M Parameter
  220.                 |
  221.                 | ZipMerge now makes the file in the Current Directory
  222.  ---------------|-------------------------------------------------------
  223.         4/17/91 | Stored the Browse Program as 1 string instead of data
  224.          v1.2   |  statements, thus it Browses it out faster.
  225.                 |
  226.                 | Fixed problems with finding the END of the ZIPfile.
  227.                 |  This problem usually happened with ZIPfiles less than
  228.                 |  500 bytes in length. Solved.
  229.                 |
  230.                 | Added display to reading Subdirectories and Files
  231.  ---------------|-------------------------------------------------------
  232.        4/18/91  | Added ability to change drive. Only Hard Drives.
  233.          V1.21  |   The reason floppies were not added was you would never
  234.                 |   split or merge files on floppies. Floppies are too slow
  235.                 |   and most of the users of Ziptool have at least a 20mb
  236.                 |   Hard Drive. If you really wanted to split or merge ZIP
  237.                 |   files on a floppy, then you could start Ziptool on the
  238.                 |   floppy drive.
  239.  ---------------|-------------------------------------------------------
  240.     5/01/91     | Added more list options to viewing of Zipfile.
  241.       v1.30     |   Press TAB to cycle through.
  242.                 |
  243.                 | Button 1 on Mouse while viewing now Unzips and views
  244.                 |  selected file (Enter also Views)
  245.                 |
  246.                 | Button 2 is for Tagging (Though not in use, it will be
  247.                 |  used in future versions. Spacebar also Taggs)
  248.                 |
  249.                 | Help screen on Viewing ZIPfile has been modified
  250.                 |
  251.  ---------------+------------------------------------------------------
  252.       05/03/91  | Fixed a problem when exiting VIEW ZIPFILE and selecting
  253.          V1.31  |  another file, then ZIPFILE was not closed off before
  254.                 |  opening another file. Added a CLOSE to the exiting
  255.                 |  part of the VIEW ZIPFILE routine.
  256.                 |
  257.                 | Added "Total Files" to VIEW Zipfile for More Information
  258.                 |
  259.                 | Fixed Path error when viewing Files within ZIPfiles
  260.                 |  that contained paths.
  261.                 |
  262.  ---------------+------------------------------------------------------
  263.        05/06/91 | Fixed an error with returning back to previous path
  264.           v1.40 |  when viewing a file within a ZIP File. Bug only happened
  265.                 |  if you started ZIPTOOL from the Root Directory.
  266.                 |
  267.                 |  Added some MONOCHROME support in request to a
  268.                 |  Registered User s Request.
  269.                 |  Ziptool should AutoDetect if you have MONOCHROME, but
  270.                 |  if it doesnt, you should be able to use a /NC parameter
  271.                 |  to force NO COLOR mode.
  272.                 |
  273.  ---------------+------------------------------------------------------
  274.        5/7/91   |  Fixed very minor Mouse problem when viewing file
  275.         v1.405  |  Mouse was resetting to off screen. Fixed. Now it is
  276.                 |  resetting to Column 1, Row 1 (Upper Left of Screen)
  277.  ---------------+------------------------------------------------------
  278.         5/10/91 | Fixed a problem with Autodetect of COLOR or Monochrome
  279.         v 1.5   |  display. You can override the selection with the
  280.                 |  command line switch /NC for NO COLOR or /CO for Color
  281.                 |
  282.                 | Added the ability for the user to select the size
  283.                 |  of the output ZIP file if the user wanted something
  284.                 |  other than the standard 360kb, 720kb, 1.2meg or 1.44meg
  285.                 |  sizes.
  286.  ---------------+------------------------------------------------------
  287.                 | Redid routine for finding end of ZipFile. Much Faster
  288.        V1.55    | Not released.
  289.  ---------------+------------------------------------------------------
  290.       V1.60     | Added Copy File(s) within Zipfile to another ZipFile
  291.     6/05/91     |  Added Delete files within ZipFile
  292.  ---------------+------------------------------------------------------
  293.       V1.61     | Cosmetic fixes
  294.      6/26/91    |
  295.                 | Fixed problem in estimating # of parts while Splitting
  296.                 | (Could cause an Error 9)
  297.  ---------------+------------------------------------------------------
  298.      V1.62      | Fixed an Error 76 in Copying Routines
  299.     07/01/91    |
  300.  ---------------+------------------------------------------------------
  301.      V1.63      | Added Version Number to Error Code.
  302.      7/4/91     |
  303.  ---------------+------------------------------------------------------
  304.      V1.64      | Fixed a bug that would cause a lockup with some Zipfiles
  305.      7/22/91    |  (Reading End of Zipfile)
  306.  ---------------+------------------------------------------------------
  307.      V1.70      | Added ability to Add a User-Installed Ascii Viewer
  308.      7/23/91    | (ZIPTOOL EDITOR)
  309.                 |
  310.                 | Added Ability to remove the Installed-Ascii Viewer
  311.                 | (ZIPTOOL NOEDITOR)
  312.                 |
  313.                 | Added Ability to UNREGISTER Ziptool
  314.                 | (ZIPTOOL UNREGISTER)
  315.  ---------------+------------------------------------------------------
  316.      V1.71      | Fixed a bug with Registering ZipTool.
  317.     8/29/91     |
  318.  ---------------+------------------------------------------------------
  319.      V1.72      | Added the ability to view Registration of ZipTool
  320.                 | (ZIPTOOL VIEWREG)
  321.  ---------------+------------------------------------------------------
  322.      V1.73      | Fixed an error (I hope) with the file display menu
  323.     09/11/91    | when viewing a large file (68megs or so).
  324.                 |
  325.                 | Redid the Search for EOF of Zipfile in ZIPMERGE routine.
  326.  ---------------+------------------------------------------------------
  327.      V1.74      | Added "OUT OF MEMORY" Error
  328.      9/14/91    | Added ability to quickly go to selected file by pressing
  329.                 |  first letter or number of filename
  330.  ---------------+------------------------------------------------------
  331.      V1.80      | ZipFile Names are now Sorted alphabetically
  332.      9/20/91    |
  333.          | Cosmetic changes (Windowing routines employed)
  334.                 |
  335.                 | Deletion of Zipfile with Confirmation
  336.                 |
  337.                 | Added Compression Totals while Viewing Zipfile
  338.                 |
  339.                 | Display File Attributes while Viewing ZipFile
  340.                 |
  341.                 | Added Error Checking for trying to Unzip and viewing
  342.                 |  files within a Zipfile that have 1 or more of the
  343.                 |  following attributes: Read Only, System, Hidden,
  344.                 |  or Volume Label
  345.                 |
  346.                 | I wish to thank ED GUZIS (Compuserve 76304,3137)
  347.                 | for all of his suggestions. All but one of his
  348.                 | were implemented in this version. On of his suggestions
  349.                 | was not implemented because PKZIP didnt support the
  350.                 | feature, and ZipTool cant if PKZIP doesnt.
  351.  -----------------------------------------------------------------------
  352.     v1.81       | Increased the number of Zipfiles in a directory maximum
  353.       9/23/91   |  from 200 to 400 files.
  354.  -----------------------------------------------------------------------
  355.     v2.00       | Added ability to turn off sorting (*)
  356.       10/21/91  | Added percent sorted to sorting window
  357.                 | Added ability to turn off advertising comments (*)
  358.                 | Added ability to insert own Comments (*)
  359.                 | Fixed problem with viewing files with Read-Only, System
  360.                 |  and/or Hidden Attribute
  361.                 | Moved main functions to a single window for
  362.                 |  future addition of commands
  363.                 |
  364.                 | (*) Valid for Registered versions ONLY
  365.                 |-----------------------------------------------------------
  366.                 | Added mouse functions to VIEW ZIPFILE (Click on Words
  367.                 |  such as <TAB><PGUP><PGDN> etc)
  368.                 |-----------------------------------------------------------
  369.                 | Added F6 - Move Zipfile from one directory to another.
  370.                 |  NOTE *** This feature will only move the file if BOTH
  371.                 |           of the following conditions are true:
  372.                 |  1. The file cannot exist in the destination directory.
  373.                 |  2. The destination path MUST exist and be valid.
  374.                 |  3. Destination must be on the same PHYSICAL source drive.
  375.                 |        (Cannot move between PHYSICAL drives, but can
  376.                 |         move between Logical Drives. IE: SUBST'ed Drive)
  377.  -----------------------------------------------------------------------
  378.    11/26/91     |  Added ability to turn off MOUSE via Environment Parameter
  379.       V2.10     |  (SET ZTMOUSE=OFF)
  380.                 |----------------------------------------------------------
  381.                 |  Fixed Mouse functions so that Arrow Keys affect the Mouse
  382.                 |----------------------------------------------------------
  383.                 |  Prevented bombout when viewing a Zipfile with more than
  384.                 |    200 files. Still can view ZIPfile, but only 200 files
  385.                 |    will show up.
  386.                 |----------------------------------------------------------
  387.                 | Fixed problem with freeing up unused Memory
  388.                 |  (Enhanced Stability of ZiPTool)
  389.                 |----------------------------------------------------------
  390.                 | Added Viewing Support to READ-ONLY ZipFiles
  391.                 |----------------------------------------------------------
  392.                 | Added Registration Form to Menu
  393.                 |----------------------------------------------------------
  394.                 | Added ability to Register ZiPTool from Menus
  395.                 |----------------------------------------------------------
  396.                 | Redid the BYTESEARCH Algorithm to find EOF of ZipFile and
  397.                 |  Installations/Registrations. Much more Accurate than
  398.                 |  before.
  399.                 |----------------------------------------------------------
  400.                 | Added "Where to Get ZipTool under Registration Options
  401.                 |----------------------------------------------------------
  402.                 | Changed Zipfile Advertisement to reflect Pool Hall BBS
  403.                 |  changes (Purchase of US Robotics Dual Standard Modem)
  404. ----------------------------------------------------------------------------
  405. 4/1/92 - 4/2/92 |Fixed Bug with not closing off ZipFile if it didnt find
  406. v2.20 & v2.20a  |the EOF of the ZiPfile on the first Pass. (Ziptool will
  407.                 | attempt to find the EOF of the ZiPfile 10 times)
  408.                 |----------------------------------------------------------
  409.                 | Fixed a problem (I Hope) with reporting freespace
  410.                 | for Large Hard Drives (>1 GIG).
  411. ---------------------------------------------------------------------------
  412.     6/12/92     | Added Compression Version to VIEW ZIPFILE Screens
  413.       v2.30     |----------------------------------------------------------
  414.                 | Added New Compression Types For V2.0 (Actually v1.93a)
  415.                 |----------------------------------------------------------
  416.                 | Added HELP option: ZIPTOOL HELP
  417.                 | Displays All ZipTool Options
  418.                 |----------------------------------------------------------
  419.                 | You can now press a letter, and ZipTool will take you the
  420.                 | filename that starts with that letter. Press it again, and
  421.                 | ZipTool will take you to the NEXT file that starts with that
  422.                 | letter.
  423.                 |----------------------------------------------------------
  424.                 | Now, After viewing a ZipFile (Pressing Enter on the
  425.                 | Zipfile name, Ziptool will return you to the Filename
  426.                 | instead of going back to the top of the file list. I cant
  427.                 | do it after merging or while Splitting because of memory
  428.                 | constraints and the number of variables used in Splitting.
  429.                 |-----------------------------------------------------------
  430.                 | If viewing a ZipFile, Ziptool now detects if the ZIP file
  431.                 | uses authentic testing. If detected, Ziptool will warn you
  432.                 | about modifying or altering the ZIP.
  433. -----------------------------------------------------------------------------
  434.     6/24/92     | Fixed minor functionallity problems
  435.       2.31      | Fixed a bug with registration installation.
  436.                 |
  437. -----------------------------------------------------------------------------
  438.     8/24/92     | Spelling Fixes
  439.       2.40      | Splitting Routine had ability to create a file that
  440.                 |     DOS would not identify. Fixed (Hopefully).
  441.                 | When Ziptool viewes a file within a ZIP, it creates a temp
  442.                 |     directory called ZTW#. If ZipTool crashes and leaves that
  443.                 |     temporary directory, ZipTool will crash again because It
  444.                 |     it tried to create the directory again. Fixed (Hopefully).
  445.                 |Fixed Authentication Testing
  446.                 |
  447.                 |Fixed problem with finding PKUNZIP for UNZIPPING to View
  448. ----------------------------------------------------------------------------
  449.     9/10/92     | If you try to view a file within a ZIP file that begins
  450.       2.50      |  with a "-" such as "-README.1ST", Ziptool v2.40 and earlier
  451.                 |  would have trouble unzipping the file. Fixed problem
  452.                 |
  453.                 | Added MOVE function while viewing ZIP file
  454.                 |
  455.                 | Added Extract function while viewing ZIP
  456.                 |
  457.                 | When Tagging files (While Viewing), Shows Total files,
  458.                 |  total uncompressed bytes, and total compressed Bytes
  459.                 |
  460.                 | When a file is tagged, the selection bar automatically
  461.                 | drops down to the next line
  462.                 |
  463.                 | I wish to acknowledge David Vales for most of the
  464.                 | additions for this version.
  465. -----------------------------------------------------------------------------
  466.     11/4/92     | On Novell Networks, the Parent directory (..) isnt available
  467.      V2.51      | in any of the subdirectory listings. This was manually added
  468.                 | into the file list that Ziptool reads. This will prevent
  469.                 | an error 75 or error 76.
  470. -----------------------------------------------------------------------------
  471.  
  472.