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