home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / WPZ001.ZIP / README < prev    next >
Text File  |  1992-11-29  |  4KB  |  114 lines
  1.             README FOR WPZIP(tm) - Workplace ZIP class DLL
  2.             ----------------------------------------------
  3.  
  4.                              Version 0.01
  5.                             November, 1992
  6.  
  7.                     by and Copr (c) 1992 John W. Cocula
  8.  
  9. NOTE: This is a very preliminary effort at providing a Workplace
  10.       Shell class to aid in the manipulation of .ZIP files.  Its
  11.       current functionality is quite limited, but still
  12.       simplifies two of my most common activities--looking at
  13.       ZIP contents, and reading README files.
  14.  
  15.  
  16. INTRODUCTION
  17. ------------
  18.  
  19. The ultimate goal of WPZIP(tm) is to fully encapsulate all forms of
  20. ZIP file manipulation in a Workplace Shell (WPS) class so the
  21. command-line interface to ZIP utilities (such as PKWARE's PKZIP) will
  22. not be necessary.  When this class is completed, manipulation of ZIP
  23. files and their contents will be nearly identical to manipulating
  24. real files using the standard WPFolder and WPDataFile classes.
  25.  
  26. In its current incarnation, WPZIP(tm) is installed as a subclass of
  27. WPDataFile, and adds a new menu item to the Open context menu, to
  28. open a Details view.  This details view shows pertinent information
  29. about each ZIP entry (name, size before and after compression,
  30. compression method, last modified date and time, CRC, etc.).  
  31.  
  32. Double-clicking on an entry, or pressing Enter, will invoke a
  33. new session with the command line "PKUNZIP -cm <zip> <file>".
  34. I use this to view README files and the like.
  35.  
  36.  
  37. INSTALLATION
  38. ------------
  39.  
  40. Copy WPZIP.DLL to your \OS2\DLL directory and run ADDCLASS.CMD.
  41.  
  42. Now open a WPS folder which contains a .ZIP file.  You will notice
  43. that the icon is not the normal file icon.  Double-click on the
  44. file's icon and you will see a new window appear with the ZIP's
  45. contents.  Double-click on an entry that appears to be a text
  46. file, and, if you have PKUNZIP somewhere on your PATH, you should
  47. see the file output into a window.
  48.  
  49.  
  50. FUTURE
  51. ------
  52.  
  53. Basically, the whole thing still needs to be written.  The skeleton
  54. provided here barely scratches the surface of the possibilities.
  55. Here is a brief list of the obvious enhancements yet to be made:
  56.  
  57.  - Add full drag-and-drop interface to add and remove entries
  58.  
  59.  - Provide user interface to enter class-wide setting of zipper
  60.    and unzipper programs and parameters for:
  61.  
  62.    - Dragging a file out of the ZIP
  63.  
  64.      - When the file is encrypted
  65.  
  66.    - Ctrl-dragging (copying) a file into the ZIP
  67.  
  68.    - Alt-dragging (moving) a file into the ZIP
  69.  
  70.    - Double-clicking on (apparent) text files
  71.  
  72.    - Double-clicking on (apparent) binary files
  73.  
  74.    - Adding/changing file comments
  75.  
  76.  - popup context menus for non-direct manipulation and
  77.    information
  78.  
  79.  - allow direct editing of zip file comments
  80.  
  81.  - reflect recursed directories in container control
  82.  
  83.  - allow other container views (icon, tree, etc.)
  84.  
  85.  - write generic archive manipulation parent class and subclasses
  86.    for different archive types (.ZIP, .LZH, .ZOO, etc.).
  87.  
  88.  
  89.  
  90. I am not in a great hurry to complete this project; it is not near
  91. the top of my current priority queue.  However, I would gladly invite
  92. anyone to provide encouragement (preferably of the monetary kind). I
  93. consider WPZIP(tm) to be shareware.  When more functionality is
  94. present, I will ask a small price for continued usage.  For now, use
  95. as you see fit with the following proviso:
  96.  
  97.  
  98. LEGAL STUFF
  99. -----------
  100.  
  101. WPZIP(tm) is copyright 1992 by John W. Cocula.  I grant any and
  102. all the use of this software provided that in no event shall John
  103. W. Cocula be liable for any damages whatsoever (including, without
  104. limitation, damages for loss of business profits, business
  105. interruption, loss of business information, or other pecuniary
  106. loss) arising out of the use of or inability to use this software,
  107. even if John W. Cocula has been advised of the possibility of such
  108. damages.
  109.  
  110. You are free to use and distribute WPZIP(tm) Version 0.01 as long
  111. as you do not charge anyone for its use or modify the package
  112. contents.  This notice must accompany distribution of Version 0.01.
  113.  
  114.