home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 25 / nopv25.iso / 040A / DELZIP10.ZIP / DOC.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1997-04-07  |  9.3 KB  |  224 lines
  1.  
  2.                Delphi Zip/Unzip Package, v1.0
  3.                        For Delphi v2+
  4.  
  5.  
  6. NOTE: The DLL source code is distributed separately due
  7. to it's size, and the fact that most Delphi users of this
  8. package probably don't want the C source for the DLL's.  
  9. The DLL source is also freeware, and will remain that way. 
  10. The filename of the DLL source code is DZDLLSRC.ZIP, and 
  11. it comes complete with a VC++, v4.0 makefile.
  12.  
  13.  
  14. Quick start:  Stop reading this file, and follow the 
  15. instructions in file INSTALL.TXT.
  16.  
  17.  
  18. This release contains:
  19.  
  20. DELZIP10.ZIP    - overall Freeware Delphi Zip v1.0 package
  21.  
  22.   DOC.ZIP       - various information about this release
  23.   DLL.ZIP       - the ZIPDLL and UNZDLL DLL's (require Win32)
  24.                   Put these into C:\WINDOWS\SYSTEM
  25.   VCL.ZIP       - Essential support files.  Includes the very
  26.                   useful TZipMaster VCL, as well as the DLL import
  27.                   specifications and callback files.  Put these
  28.                   into your VCL search path.
  29.   DEMO1.ZIP     - Delphi v2 source code for demo program #1.
  30.   DEMO2.ZIP     - Delphi v2 source code for demo program #2.
  31.   DEMO3.ZIP     - Delphi v2 source code for demo program #3.
  32.  
  33.  
  34.                    Notes About My Demo Programs
  35.  
  36.   All three demo programs are using an icon I designed.  It has
  37. two images in it: 16x16 and 32x32.  Developers who have come 
  38. from the Win 3.1 world should get used to providing a 16x16 
  39. image for their icon, because Win95 and NT4 put these small 
  40. icon images on the form's titlebar, and on the taskbar.  If you 
  41. don't make a 16x16 image in your icon, Windows itself will make
  42. one from the 32x32 image, but it usually doesn't look very good.
  43.  
  44.   I am NOT using any Windows Registry keys in any of the demos,
  45. or in the DLLs themselves.  Also, because of my desire to limit 
  46. unrelated code, the demo programs don't make use of any .INI 
  47. files.  Your own application programs should save the user's 
  48. ZIP/UNZIP options, and drive/directory choices in a .INI file.
  49.  
  50.   All of the 3 demos require the 2 DLLs:  
  51.   ZIPDLL.DLL and UNZDLL.DLL
  52.  
  53.  
  54.                     Notes on Demo Program 1
  55.  
  56.   This is perhaps the most useful demo program for you.  It 
  57. shows how to make a somewhat comprehensive ZIP utility program 
  58. using the ZipMaster VCL.
  59.   Using a fairly small set of .PAS files, you get a surprising
  60. amount of functionality.  This is the beauty of Delphi!
  61.   Additional VCL's needed by Demo 1: TZipMaster, TSortGrid
  62.  
  63.  
  64.                     Notes on Demo Program 2
  65.  
  66.   This is a "short and sweet" demo that shows you how to use
  67. the ZipMaster VCL to do some quickie ZIP operations inside a 
  68. program, whose main purpose may be unrelated to ZIP.  
  69.   For example, you may want to let the user ZIP up his data
  70. files with a minimum of fuss.  You, the developer, may already
  71. know the names of the data files, so you may want to embed the
  72. ZIP operation to make your program easier-to-use.  
  73.   The value here is that this demo separates out the ZIP 
  74. functionality from the user interface.  
  75.   Additional VCL's needed by Demo 2: TZipMaster
  76.  
  77.  
  78.                     Notes on Demo Program 3
  79.  
  80.   This is an advanced demo program showing you how to use the
  81. DLL's at the lowest possible level.  It uses the ZIPDLL.PAS and
  82. UNZDLL.PAS import units, and the ZCALLBCK.PAS callback unit, to
  83. directly talk to the DLLs.  
  84.   Demo Programs 1 and 2, which use the ZipMaster VCL, can only
  85. provide you with a subset of the DLL functionality (albeit, a 
  86. very useful subset).
  87.   This level of programming is not recommended for most 
  88. applications.  In most cases, you'll prefer to use ZipMaster-
  89. based programs (like demos 1 and 2), instead. This level of
  90. programming is definitely NOT RAD!
  91.   Additional VCL's needed by Demo 3: ZipDir, TSortGrid
  92.  
  93.  
  94.  
  95.                       Distribution Policy
  96.               Guidelines for Legal Re-distribution
  97.  
  98.   1) This applies to both end-users and developers.  The meat of
  99.      this package is the .DLL files, and they are needed by all
  100.      of your end-users if you use this ZIP package in your 
  101.      program.
  102.     
  103.   2) You must not charge money for any part of the ZIP package.
  104.      Warning:  The primary concern here is if you will market a
  105.      new package that is only slightly more than a verbatim copy 
  106.      of this package, or one of it's demos.  ANY release you sell
  107.      is OK as long as you charge ONLY for the changes you make.
  108.  
  109.   3) You MUST either distribute the source code for this ZIP
  110.      package, or give a WWW site where it can be obtained
  111.      freely. This can be on a Help...About screen, in printed
  112.      documentation, or in text files distributed with your 
  113.      package.  Yes, it does seem odd to have this requirement
  114.      for end-users who aren't programmers, but there is no
  115.      mistake.  After all, it isn't hard to give them a URL
  116.      and a few words explaining what it is for.
  117.  
  118.   4) You must handle product support with your own end-users.
  119.      This is imperative, because I don't have anywhere near
  120.      enough time to do support for end-users.
  121.  
  122.   5) You must document the Info-Zip's WWW home page URL, but 
  123.      don't expect any help from the Info-Zip group, since my 
  124.      release is only a derrivitive of their work.  They are 
  125.      very busy doing support for their "official" releases.
  126.         Info-Zip:   http://www.cdrom.com/pub/infozip/
  127.  
  128.   6) I will handle support issues with programmers using this 
  129.      package on a time-available basis. Since this is being
  130.      distributed as freeware, you can't expect the kind of 
  131.      support you'd get from a commercial vendor.  Please limit
  132.      your questions to those that directly pertain to this
  133.      ZIP package.  If you just have a Delphi question in 
  134.      general, you should consider other forums first (like 
  135.      the excellant BDELPHI32 forum on CompuServe, or the
  136.      Delphi Talk mailing list on the Internet).
  137.         If you qualify for membership in a private Delphi
  138.      forum, such as the Object Lessons mailing list for
  139.      graduates of the Object Lessons seminars, then that
  140.      would probably be your best bet for Delphi questions.
  141.  
  142.   7) You may NOT distribute executable versions of my demo
  143.      programs to end-users without my approval.  These are 
  144.      only example applications, and I don't think they're 
  145.      good enough yet to be distributed to end-users yet.
  146.  
  147.  
  148.                        Other Languages
  149.  
  150.    Developers of languages other than Delphi may want to use
  151. these DLLs.  You can use these DLLs with VC++ and Borland C++
  152. by simply building import/export libs for them.  I recommend
  153. a freeware utility called IMPLIB32.EXE for this purpose.  Do
  154. a Web search to find a copy of it.  
  155.  
  156.    The offical Info-Zip group is also working on a standard 
  157. set of DLLs for C++ on Win32, but their efforts have been 
  158. delayed several times, and weren't ready for me to use as a 
  159. baseline in my efforts.  Perhaps our efforts will converge 
  160. someday.  For now, however, my DLL interface is much
  161. different than theirs. 
  162.    I'll try to keep any future DLL interface changes 
  163. transparent to users of the ZipMaster VCL.
  164.  
  165.    Visual Basic users won't find it easy to use my DLLs, so 
  166. I may do a VB port of this package someday.  I'd like the 
  167. support of an advanced VB programmer to help me in this port,
  168. so send me e-mail if you are experienced and want to help.  
  169. Of course, whomever helps me in the VB port will be given 
  170. appropriate credits in the release documentation, and in the
  171. VB-specific source code.  My only caveat: the final release 
  172. must be freeware, and include all source code.
  173.  
  174.  
  175.                     Updates to this Software
  176.  
  177.     Future updates to this software will be announced on
  178. the BDELPHI32 forum on CompuServe, and will be posted in 
  179. the BDELPHI32 file area on CompuServe, and will be posted
  180. at these Web sites (if possible):
  181.  
  182.     www.objectlessons.com    
  183.       Object Lessons Delphi training company.  
  184.       Serious Training for serious programmers.
  185.  
  186.     www.delphi32.com         
  187.       One of the first, and one of the best Delphi sites.
  188.  
  189.  
  190.     Torry's is an excellent site in Russia - visit them.
  191.  
  192.     www.cdrom.com/pub/DSP    
  193.       Delphi Super Page - DSP.  This is also one of the first
  194.       and best.  It's home country is Poland, but has mirror
  195.       sites in many other countries.
  196.  
  197.  
  198.     Please DO NOT ask me to e-mail you when this software 
  199. is updated.  There are hundreds of users of this package, and
  200. I can't maintain such a long list in my free time! 
  201.     If anyone would have the time and ability to host an Internet
  202. Delphi Zip mailing list, then please let me know!  I'd like to 
  203. participate in this type of endeavor, but I don't have the time 
  204. to host it.
  205.  
  206.     You may e-mail be with your bug notices and proposed
  207. changes to this package.  If your message comes with suggested
  208. changes to source code, they WILL be evaluated, and, if used,
  209. you will get the appropriate credit in the next release.
  210.  
  211.     Special thanks go to Dennis Passmore, who offered many 
  212. useful suggestions and code snippets during the development of
  213. this software.
  214.  
  215.  
  216. Eric W. Engler
  217. Compuserve: 71673,2147
  218. From the Internet: 71673.2147@compuserve.com
  219.  
  220. Please do NOT try to send me file attachments unless you 
  221. are doing it from CompuServe.  I can supply you with my
  222. private e-mail address if you want to send me an attachment
  223. from the Internet.
  224.