home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / ZIPMNUXX.ZIP / ZIPMNU.DOC < prev   
Encoding:
Text File  |  1989-12-28  |  8.5 KB  |  234 lines
  1.                         December 28, 1989
  2.  
  3.            ZIPMNU.DOC - Documentation for ZIPMENU.EXE
  4.           ---------------------------------------------
  5.      ZIPMENU - Version 1.02 (c) Copyright 1989 by Tom Grubbe
  6.                        All Rights Reserved
  7.  
  8.  
  9. TABLE OF CONTENTS
  10. -----------------
  11. 1. Overview
  12. 2. Getting Started
  13. 3. Extract
  14. 4. View
  15. 5. NewZip
  16. 6. Drive
  17. 7. Path
  18. 8. Colors
  19. 9. Disclaimer
  20.  
  21.  
  22. 1. OVERVIEW
  23. -----------
  24.      ZIPMENU.EXE is a small utility for those of us who are too
  25. lazy or just don't want to bother with command-line arguments.  I
  26. wrote this program to be used with PKUNZIP and its various
  27. command-line switches.  It doesn't utilize all of PKUNZIP's
  28. options but instead uses the ones that you probably use most
  29. often.  
  30.      
  31.      This, the second version of the program, contains many
  32. improvement over the first version.  With it you can select a
  33. .ZIP file,  view its contents,  tag/untag all or highlighted
  34. files within the .ZIP,  change drive and/or directory,  direct
  35. output of extracted files to any drive or directory, view text
  36. files within .ZIP,  and modify ZIPMENU's colors.  These options
  37. are explained in detail in the rest of this document.
  38.  
  39.      I decided to keep this list small and not overcrowd the
  40. program with seldom used functions,  as well as to keep the size
  41. of the program to a minimum.  It is designed for you to run it, 
  42. manipulate the .ZIP file(s) of your choice,  and then get out.  I
  43. use it on a daily basis and find it extremely accomodating.  
  44.  
  45.      I hope that you find this program useful enough to share it
  46. with others and to upload it to your favorite BBS's.
  47.  
  48.  
  49. 2. GETTING STARTED
  50. ------------------
  51.      Files in the archive:
  52.           ZIPMENU.EXE - The executible program file
  53.           ZIPMNU .CFG - The color configuration file
  54.           ZIPMNU .DOC - This documentation
  55.      Requirements:
  56.           IBM PC/XT/AT or compatable
  57.           256 kilobytes or greater main memory
  58.           DOS 3.0 or greater
  59.           Color monitor
  60.           PKUNZIP.EXE v1.01 or greater
  61.  
  62.      To run, Just enter ZIPMENU <Enter> at the DOS prompt.  It
  63. should be in the same directory as PKUNZIP.EXE.  If not, then the
  64. directory in which PKUNZIP is in should be listed in the DOS PATH
  65. statement. 
  66.  
  67.      ex: PATH=C:\ZIPS if pkunzip.exe is in the C:\ZIPS directory.
  68.  
  69.      That's it.  Once you start ZIPMENU, the main screen is drawn
  70. and a window is popped up listing all the .ZIP files in the
  71. current directory.  Use the up/down arrow keys to scroll through
  72. the list, press <Enter> to select the highlighted file you wish
  73. to see. If promped with a "File(s) not found" message, press
  74. <Esc> and select the "Path" or "Drive" option in the main menu to
  75. change to the desired .ZIP directory or drive.  
  76.      
  77.      Getting around within ZIPMENU should be pretty self-
  78. explanetory but pressing the F1 key will pop up a help screen
  79. listing the basic ways to get around and some additional options
  80. as well.  
  81.  
  82. The rest of this document explains the options available from the
  83. main menu.  You can skip it if you are an experienced computer
  84. user,  but please read the disclaimer section at the end.
  85.  
  86.  
  87.  
  88. 3. EXTRACT
  89. ----------
  90.      Selecting this option will pop up a menu prompting you to
  91. select extracting ALL, TAGGED, or HIGHLIGHTED files from the
  92. archive.
  93.  
  94.      Extract ALL files:
  95.           This will extract all of the files in the archive 
  96.           regardless of tagged status.
  97.      Extract TAGGED files:
  98.           Pressing the spacebar will tag or untag the individual
  99.           highlighted files for extraction.  Or you can press F10
  100.           to tag/untag all files.
  101.      Extract HIGHLIGHTED file:
  102.           This option will extract only the file under the
  103.           highlight bar.
  104.  
  105.      NOTE: Extracting TAGGED files will create a temporary list
  106. file called "ZM.000" in the current drive and directory.  It will
  107. overwrite any other file with the same name, so be forwarned.
  108.   
  109.      Once you select the extraction method,  you are asked for
  110. the directory for the extracted files to go (e.g. C:\Pathname).
  111. You can either enter the new directory name or press <Enter> to
  112. accept the directory name already listed.
  113.  
  114.      The screen will clear and PKUNZIP is invoked and the
  115. selected files are unzipped and put into the directory that you
  116. specified.
  117.  
  118.  
  119. 4. VIEW
  120. -------
  121.      Select "View" from the main menu to list the highlighted
  122. text file on the screen.  It uses the command line:
  123.  
  124.      PKUNZIP <filename.zip> -cm <filename.ext>
  125.  
  126. this uncompress the text file to the console for viewing.  If the
  127. highlighted file is not a text file you'll know it when garbage
  128. characters are displayed instead of readable text.     
  129.  
  130. 5. NEWZIP
  131. ---------
  132.      Select this option whenever you want to choose a different
  133. .ZIP file to work on.  The same pop-up window that popped up when
  134. the program started is displayed listing all of the .ZIP files in
  135. the current directory. You can either select a new .ZIP file or
  136. press <Esc> to return to the current one displayed.  This window
  137. is also displayed whenever you change to a different disk drive.
  138.  
  139.  
  140. 6. DRIVE
  141. --------
  142.      To change to a different disk drive, select this option. 
  143. You are prompted for the drive letter to change to.  It will only
  144. accept the drive letters 'A' through 'F' so if you have more than
  145. six disk drives or drive letters greater than 'F', an error will
  146. be displayed (sorry).  
  147.  
  148.      You will be logged to the disk drive you selected and the
  149. file selection window will once again be displayed. 
  150.  
  151.  
  152. 7. PATH
  153. -------
  154.      Choose this option to change to a different .ZIP directory. 
  155. You should enter the complete pathname (ex: C:\PATHNAME\PATHNAME)
  156. or press <Esc> to cancel.  
  157.  
  158.      You are then changed to the new .ZIP subdirectory that you
  159. entered.  
  160.  
  161.  
  162. 8. COLORS
  163. ---------
  164.      Selecting this option allows you to change ZIPMENU's color
  165. configuration.  
  166.  
  167.      The screen will clear and a mini ZIPMENU screen is drawn as
  168. well as a color selection grid and a little menu for selecting
  169. which colors to change.  Use the up, down, pgup, pgdn, home, end
  170. keys to scroll through options.  Press <Enter> to select which
  171. colors to change.  Depending on which selection you make, another
  172. menu may pop up and you can scroll through these options using
  173. the same keys.  
  174.  
  175.      When you select a color to change,  the box around the color
  176. selection grid will highlight and the cursor will be on the
  177. current color of the item you chose to modify.  Use the cursor
  178. keys to cycle through the different colors, press <Enter> to
  179. select the new color change.  
  180.  
  181.      You can exit the menu by selecting "Quit and save colors" to
  182. save your colors, or "Quit without saving" or <Esc> to leave the
  183. colors the same as they were without any changes.  
  184.  
  185.      I should note that the configuration file ZIPMNU.CFG is used
  186. to save these colors.  I hate configuration files and tried over
  187. and over to write the color information to ZIPMENU.EXE, but I
  188. kept crashing the system.  So I decided that I would go with the
  189. config file method for saving this information. Sorry.
  190.  
  191.      You can also change colors by modifying this file.  It's up
  192. to you.
  193.  
  194.  
  195. 9. DISCLAIMER
  196. -------------
  197.      Although ZIPMENU is shareware, it is NOT a public domain
  198. program.  It is a user-supported software product and is
  199. copyright (c) 1989 by Tom Grubbe, and the author retains all
  200. rights to distribute this program and all source code and
  201. documentation for profit.  There is absolutely no guarentee that
  202. ZIPMENU will work correctly in all situations, and in no event
  203. will the author be liable for any damages arising from the use or
  204. misuse of this program.
  205.  
  206. Please support the shareware concept:
  207.  
  208.  
  209.                              ZIPMENU
  210.          Written by Tom Grubbe in Turbo C 2.0, 12-22-89
  211.  
  212.      ZIPMENU - Version 1.02 (c) Copyright 1989 by Tom Grubbe
  213.                        All Rights Reserved
  214.  
  215.       If you use this program regularly, you are encouraged
  216.          to contribute $5 or $10 to the shareware cause.
  217.  
  218.                      Send contributions to:
  219.  
  220.                            Tom Grubbe
  221.                          575 Curie Drive
  222.                        San Jose, CA  95123
  223.  
  224.        If you decide to contribute, I will send you, free
  225.     of charge, future versions of this program along with its
  226.                       complete source code.
  227.  
  228.  
  229.      If you discover bugs in the program or if you have comments
  230. or suggestions to improve the quality of the program,  I can
  231. usually be reached at:
  232.           CRICKET Bulletin Board System - 408-373-3773
  233.  
  234.