home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / HIPZIP20.ZIP / HIPZIP.DOC next >
Encoding:
Text File  |  1990-07-26  |  9.0 KB  |  214 lines
  1.                                 HipZIP
  2.                                   by
  3.                               Joe Emenaker
  4.  
  5.                               Version  2.0
  6.                      "For users who ZIP from the hip!"
  7.  
  8. Have you ever wanted to ZIP half of the files in a directory, but couldn't
  9. think of a good wildcard to use to get the ones you wanted? Well, never
  10. fear, because I, Joe Emenaker, purveor of fine hacker utilities and king of
  11. the beta release, have just gotten my latest gem running!
  12.  
  13.  
  14. Contents
  15. --------
  16. How it Works.................................    I.
  17. Command-line syntax..........................   II.
  18. Once you're in...............................  III.
  19. Environment variables........................   IV.
  20. Make this obsolete!..........................    V.
  21. "There are starving kids in.....California??"   VI.
  22.  
  23. **********************************************************************
  24. I. How it works
  25.  
  26.    HipZIP takes the last wildcard or pathname out of the command line
  27. and expands it into a menu that lets you tag the files you want. When
  28. you're done, HipZIP stores all of the filenames in a file called HIPZIP.TMP
  29. and calls PKZIP. When it calls PKZIP, it passes to it, whatever command
  30. line parameters were given *minus* the wildcard. For example: If you
  31. invoked HipZIP with:
  32.                     HZ -m -r -p sample.zip *.doc
  33.    HipZIP would give you a menu of all of the .doc files in the current
  34. directory. When you've selected the ones you want, HipZIP would call PKZIP
  35. with:
  36.                     PKZIP -m -r -p sample.zip @HIPZIP.TMP
  37.    where HIPZIP.TMP contains the names of the files you want. So, whatever
  38. command lines you want passed to PKZIP are to be put on HipZIP's command
  39. line.
  40.  
  41. **********************************************************************
  42. II. Command line syntax:
  43.  
  44. ZIPMENU [options_for_PKZIP] ZIPfile [path_for_HipZIP]
  45.  
  46. [options_for_pkzip] - These are where you put the options you want sent to
  47.                       PKZIP when HipZIP calls it. For example, "-r" or
  48.                       "-ex" or "-a" or a combination of these and others.
  49.  
  50. ZIPfile             - This absolutely must be on the command line. If it
  51.                       isn't, HipZIP will tell you so and bid you good day.
  52.                       It can be an already existing ZIPfile or a new one.
  53.  
  54. [path_for_HipZIP]   - I tried to make the interpreter for this so that it
  55.                       would accept anything that was fairly intuitive. Here
  56.                       are the basic rules:
  57.                       1 - If no extension is specified, it tries to match
  58.                           anything with the same beginning. For example, if
  59.                           you give it: "C:\TEXT\WENDY", HipZIP will try to
  60.                           find anything matching: "C:\TEXT\WENDY*.*"
  61.                       2 - If no extension is specified, but the first rule
  62.                           didn't turn up anything, HipZIP assumes it's a
  63.                           directory and tries to find anything matching:
  64.                           "C:\TEXT\WENDY\*.*"
  65.                       3 - If you put a period in the filename, HipZIP
  66.                           should leave it alone. For example,
  67.                           "C:\TEXT\WENDY." will cause HipZIP to look for
  68.                           that file only. You may as well use PKZIP
  69.                           directly, for this.
  70.                       4 - Any pa1th ending in a slash is assumed to be a
  71.                           directory and HipZIP searches for all files in
  72.                           that directory.
  73.  
  74.                       Folowing are some sample command line paths and how
  75.                       HipZIP interprets them.
  76.  
  77.                       Command line path             HipZIP's interpretation
  78.                       -----------------             -----------------------
  79.                       C:                            C:*.*  (default dir)
  80.                       \                             \*.*   (default drive)
  81.                       C:\                           C:\*.*
  82.                       C:\UTIL                       C:\UTIL*.* or C:\UTIL\*.*
  83.                       C:\UTIL\                      C:\UTIL\*.*
  84.                       FOO                           FOO*.*
  85.                       C:\FOO                        C:\FOO*.*
  86.  
  87. **********************************************************************
  88. III. Once you're in
  89.  
  90.    Once you've invoked HipZIP, there are several keys that you must use to
  91. tag files and move the cursor, etc. They are:
  92.  
  93. <Up>,<Down>,<Right>,<Left> - Move the cursor one filename in their four
  94.    respective directions.
  95. <Home>,<End>  - Move cursor to the first and last filenames in the list.
  96. <PgUp>,<PgDn> - Move cursor one page to up (or to the left) and one page
  97.                 down (or to the right) respectively.
  98. <Esc>         - Aborts HipZIP and takes you back to DOS.
  99. <Return>      - Saves the filenames and runs PKZIP
  100. <+>,<->       - Tag and untag filenames, respectively
  101. <Spacebar>    - Toggles the tag of a filename.
  102. <F2>,<F3>,<F4>- Sort filenames by name, extension, and size, respectively
  103.  
  104. **********************************************************************
  105. IV. Environment variables
  106.  
  107.    If you don't like the colors I chose or you would like HipZIP to always
  108. startup with the files sorted a certain way (by default, they aren't sorted
  109. at all), you can use the two environment variables HZCOLOR and HZSORT.
  110. Here's how they work:
  111. To set the color you want, put this in your AUTOEXEC.BAT file:
  112.  
  113.                            SET HZCOLOR=#
  114.  
  115.    where the # is determined by the following table:
  116.  
  117.             Blinking..........128
  118.      Background
  119.             Black...............0
  120.             Blue...............16
  121.             Green..............32
  122.             Cyan...............48
  123.             Red................64
  124.             Magenta............80
  125.             Brown..............96
  126.             Light Grey........112
  127.      Foreground
  128.             Black...............0
  129.             Blue................1
  130.             Green...............2
  131.             Cyan................3
  132.             Red.................4
  133.             Magenta.............5
  134.             Brown...............6
  135.             White...............7
  136.             Dark Grey...........8
  137.             Light Blue..........9
  138.             Light Green........10
  139.             Light Cyan.........11
  140.             Light Red..........12
  141.             Light Magenta......13
  142.             Yellow.............14
  143.             Bright white.......15
  144.  
  145.    So, if you wanted Brown foreground on a Magenta background, you'd add
  146.    the values, like so
  147.  
  148.        Brown foreground.............   6
  149.       +Magenta background........... +80
  150.                                     -----
  151.                                      =86
  152.  
  153.          so you'd put  SET HZCOLOR=86 in your AUTOEXEC.BAT file.
  154.  
  155.    if you wanted blinking cyan on brown......
  156.  
  157.        cyan foreground..............   3
  158.        brown background............. +96
  159.        blinking.....................+128
  160.                                    ------
  161.                                     =227
  162.  
  163.    likewise, the normal white on black is just 7!!!
  164.  
  165.  
  166.  
  167. Now for sorting, you set the HZSORT variable as follows:
  168.  
  169. SET HZSORT=1  -----> Sort by filename
  170. SET HZSORT=2  -----> Sort by extension
  171. SET HZSORT=3  -----> Sort by size
  172.  
  173. **********************************************************************
  174. V. Make this obsolete
  175.  
  176.    I don't think I need to explain to you why this feature should be
  177. integrated into PKZIP itself. If integrated into the PKZIP/PKUNZIP package,
  178. you could use this same menu/tag method to: delete files from ZIPs, view
  179. text files within ZIPs, select specific files to UNZIP. It would be
  180. terrific.
  181.  
  182.    However, if this did happen, HipZIP would no longer be of any use.
  183. Doesn't that make me mad? No. I did not write HipZIP for money (although
  184. that does help to smooth out the bumps in life), I wrote it because it
  185. was needed. Sure, there are lots of big huge programs like SHEZ that have
  186. so many features that it is Cadillac of ZIP utilities. The only problem
  187. is.... it HANDLES like a Cadillac. Some of us want the Honda CRX of ZIP
  188. utilities.... something that just gets us where we want to go and is small
  189. and quick.
  190.  
  191.    For this reason, I sent a copy of HipZIP to Phil Katz, asking him to
  192. consider building this feature right into PKZIP and PKUNZIP. If you think
  193. this is a good idea, please write to Phil Katz to let him know that his
  194. users want this feature. I truly believe that this feature is basic enough
  195. and is small enough that it warrants putting it at the core.
  196.  
  197. **********************************************************************
  198. VI. "There are starving kids in.....California?"
  199.  
  200. This wasn't trivial to write. If you find of use, which I certainly
  201. do, please consider sending, say $5 to:
  202.  
  203. (Home)   <- After August, 1991
  204. Joe Emenaker
  205. 518 Richmond St.
  206. El Segundo, Ca. 90245
  207. (213)-322-7430
  208.  
  209. (School) <- Through August, 1991
  210. Joe Emenaker
  211. 1167 Atascadero St.
  212. San Luis Obispo, Ca. 93401-6501
  213. (805)-542-9230
  214.