home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / WUZ10A.ZIP / README.WUZ < prev    next >
Text File  |  1993-12-14  |  9KB  |  195 lines
  1. --------------------- Workplace Shell UnZip  version 1.0 ---------------------
  2. ----------------------- by: scott.maxwell@channel1.com -----------------------
  3.  
  4.  
  5. Welcome to WPS UnZip!
  6.  
  7. Actually, it does more than just unzip.  It can also handle ARC, ARJ, LZH,
  8. TAR, Z and ZOO files.  You need to have unpackers for each format but then
  9. WPS Unzip will handle the rest.  WUZ is already set up to use OS/2 versions
  10. of Zoo 2.1, Info-Zip's Unzip 5.0, UnArj 2.41, LH2 2.14, Gnu Tar and Compress.
  11. If you want to use a different dearchiver or add another archive type, you
  12. may have to make some changes to Wuz.Cmd.  See "Adding a New Archive Type" at
  13. the end of this file.  The default dearchiver is UnZip if the file extension
  14. is not recognized.  I use this to drag-and-drop QWK files when I just want to
  15. look at my bulletins.
  16.  
  17. To install, just type Inst-WUZ and select a directory for the executable files
  18. from the menu.  Then enter the name of the directory where you want temporary
  19. directories to be made.  I use E:\Download\Temp.  This will copy Wuz.Cmd,
  20. Post-Wuz.Cmd, Wuz.ICO, ZipSplit.Cmd, Open-Dir.Cmd and Kill-Dir.Cmd to the
  21. specified directory and create an icon on the desktop called WPS Unzip which
  22. is associated with *.arc, *.arj, *.lzh, *.tar, *.z, *.zip and *.zoo.
  23. To uninstall, simply rerun Inst-WUZ and answer yes when it asks you if you
  24. want to uninstall.
  25.  
  26. Now all of your archive files should have a cool zipper icon.  If you don't
  27. see the zipper right away, try clicking the right button over the file icon
  28. and it should change.
  29.  
  30. You can open an archive in one of three ways:
  31. 1) Double click on the file icon.
  32. 2) Drag the file icon to the WPS Unzip icon
  33. 3) Type WUZ <filename> from a command line
  34.  
  35. WUZ will then create a directory of the same name as the archive in whatever
  36. directory you told it to during the install, in my case E:\Download\Temp.
  37. After creating the directory, WUZ will extract the archive file into it, open
  38. the directory as a folder on the Desktop and open a separate OS/2 window
  39. set to the new directory.  This will give you easy access from both the WPS
  40. and the command line.  Also, since each archive creates its own extract
  41. directory, you can open as many archives at the same time as you like.
  42. If you are using 4OS2, the command-line window will be opened as local so
  43. it won't use any of your aliases.  WUZ needs to do this so it can create
  44. some custom keyboard aliases.
  45.  
  46. To close the archive, you can type ZClr.  ZClr -x will also close the OS/2
  47. window.  If you are using 4OS2, you can just type Alt-x.  This will delete
  48. all of the files and remove the directory.
  49. NOTE: If you double-click on ZClr.Cmd from the WPS while the command-line
  50.       window is still open and in the extract directory, OS/2 will not be
  51.       able to remove the extract directory.
  52.  
  53. If you are using ZIP archives, two other options are available: updating and
  54. refreshing.  ZUPDATE will add any new files you have added to
  55. the extract directory to the original archive and optionally remove any files
  56. that you have deleted.  For instance, rename Try.Cmd to Wuz.Cmd and do
  57. ZUPDATE and you will be asked if you want to delete Try.Cmd from the archive
  58. and then Wuz.Cmd will be added to the archive.  If you are using 4OS2, just
  59. hit Alt-u.  ZFRESH will update only those files that already exist in the
  60. archive and have changed in the extract directory.  Alt-f for 4OS2 users.
  61.  
  62. I don't like seeing ZClr.Cmd, ZFresh.Cmd and ZUpdate.Cmd all the time, so I
  63. have hidden them.  If you want to unhide them so that you can use them
  64. from the WPS, just comment out the lines in Wuz.Cmd that hide them.
  65.  
  66.  
  67. Other Goodies
  68. -------------
  69.  
  70. This archive also includes Open-Dir.Cmd which opens the specified directory
  71. as a folder on the desktop and Kill-Dir.Cmd which deletes the specified
  72. directory and all of its files.  These are pretty useful in their own right.
  73.  
  74. ZipStrip.Cmd may also be of interest.  It compares the files in the current
  75. directory to those in any ZIP file and offers to remove files from the ZIP
  76. that do not exist in the current directory or one of its subdirectories.
  77. This can take a little while.  I will probably rewrite this in C++ when
  78. I get a chance.
  79.  
  80.  
  81. Things You Might Want to Change
  82. -------------------------------
  83.  
  84. If you don't want a command-line, you can set NoCommandLine to 1 at the
  85. top of Wuz.Cmd.  If you want Wuz to finish unpacking the archive before
  86. opening the folder and starting the command-line, set WaitForUnzip to 1.
  87.  
  88. If you would rather the command-line always load another program, i.e. a text
  89. file viewer, etc. set FinalCommand to whatever you like in Post-Wuz.Cmd.
  90. It may be better to set WaitForUnzip to 1 in Wuz.Cmd if you do this.
  91.  
  92. If you don't want to watch the archive being unpacked, you can open the
  93. settings page of WPS Unzip, select Session and set either OS/2 window or
  94. OS/2 full screen and then Start minimized.  If you do this and set
  95. NoCommandLine to 1 in Wuz.Cmd, WUZ will only create the folder.  For WPS
  96. purists, this is the way to go!
  97.  
  98.  
  99. Legalities
  100. ----------
  101.  
  102. Okay, now for the legal stuff.  I use these routines constantly and have had
  103. no problems.  If you do, let me know.  However, I can not be held liable if
  104. anything nasty happens.  This software is strictly of the "USE AT YOUR OWN
  105. RISK" variety.
  106.  
  107. As to cost, what is this worth to you?  I would appreciate a $10 or $20 bill
  108. if you think you can swing it.  If you make a lot of money and WUZ saves you
  109. tons of time, maybe even $30-$40.  However, WUZ will not waste your time and
  110. screen space with "Guilt Trip" messages every time you use it even if you
  111. never give me a dime.  Anyhow, if you like WUZ, then at the very least send
  112. me email and tell me so.  Any checks should be made out to my mother:
  113.  
  114.   Patricia Maxwell
  115.   1587 E. Modesto Ave.
  116.   Camarillo, CA 93010
  117.   U.S.A.
  118.  
  119. I'm out of the country right now so sending checks to my Mom is easier.
  120.  
  121. Comments are welcome.  I hope these REXX routines are as useful for you
  122. as they have been for me.  I haven't found any easier way to explore
  123. archives.  Send comments to me at scott.maxwell@channel1.com.
  124.  
  125.  
  126. Coming Soon
  127. -----------
  128.  
  129. I will probably rewrite ZipStrip in C++ for speed.
  130.  
  131. Also, I will probably try to figure out a way to add Update and Refresh
  132. choices to the folder menu so that I can hide ZUPDATE.CMD and ZFRESH.CMD.
  133.  
  134. I should also be releasing my Extended Folder real-soon-now.  It will
  135. eventually provide an enhanced icon folder but currently it just adds
  136. Open Parent and Open Command-Line to the object menu of every folder.
  137. I may also use this add Update and Refresh to the object menus of
  138. extract directories.
  139.  
  140.  
  141. For Rexx Programmers
  142. --------------------
  143.  
  144. There are two routines here that you might want to put in your REXX
  145. library.  One is Check4OS2 which returns 1 if the current shell is 4OS2
  146. instead of CMD.  The other is DIRECTORY which simply makes the standard
  147. DIRECTORY command always append a '\' and accept directory names with a
  148. trailing backslash.  The standard DIRECTORY command chokes on trailing
  149. backslashes unless you are specifying the root and it never returns
  150. a name with a trailing backslash unless the current directory is the root.
  151. My routine makes everything a bit more consistent.
  152.  
  153. One other routine that you might want to check out is GetDriveSpec in Wuz.CMD.
  154. This will take a filename and return FullPath, FullName, Ext and NameOnly.
  155. This can even handle relative paths on different drives without changing
  156. your current directory on any drive.
  157.  
  158.  
  159.  
  160. Adding a New Archive Type
  161. -------------------------
  162.  
  163. If you want to add a different archiver, here is what you need to do.
  164. Edit Wuz.Cmd and go down to the Extractor.Ext = whatever section.
  165. The following explanation will make a lot more sense if you are looking
  166. at Wuz.Cmd as you read this.
  167.  
  168. A generic archiver definition consists of the following specifications:
  169.  
  170. Extractor.<ext> = '<dearchiver>'- where Ext is the actual extension you want
  171.                   to use and <dearchiver> includes any
  172.                   necessary switches.  You should always
  173.                   setup your dearchiver to extract subdirec-
  174.                   tories and automatically overwrite if
  175.                   possible.
  176. CopyTo.<ext>    = Yes/No    - Some dearchivers must extract to the same
  177.                   directory that the archive is in.  These
  178.                   will require that the archive be copied to
  179.                   the extract directory first.  Usually,
  180.                   however, this will be no.
  181. Update.<ext>    = '<archiver>'    - This should be your archive command with
  182.                   switches to update files and work
  183.                   recursively.
  184. UpdateP.<ext>    = '<exclude>'    - This is a switch to stick on to the tail
  185.                   end of the archive command to exclude
  186.                   ZCLR.CMD, ZUPDATE.CMD and ZFRESH.CMD.
  187. Fresh.<ext>    = '<archiver>'    - This should be your archive command with
  188.                   switches to update only those files that
  189.                   have changed and already exist in the
  190.                   archive.  Don't forget any necessary
  191.                   switches to work recursively through any
  192.                   subdirectories.
  193.  
  194. --------------------- Usenet: scott.maxwell@channel1.com ---------------------
  195.