home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 March / Chip_1998-03_cd.bin / zkuste / delphi / komprese / zip / DELZIP12.ZIP / INST-VCL.TXT < prev    next >
Text File  |  1997-09-28  |  11KB  |  268 lines
  1. Delphi Zip
  2. Version 1.20, Sept 28, 1997
  3. by Eric W. Engler
  4.  
  5.  
  6. See CHANGES.TXT for note on changes since version 1.10.  If you 
  7. already have v1.10 installed, then install this update right over
  8. the top of it.  Make sure you rebuild the Component library with
  9. the updated VCLs included with this release.
  10.  
  11.  
  12. This is a complete release, so you DO NOT need to have any prior   
  13. version before installing this release.
  14.  
  15.  
  16.   IMPORTANT NOTE FOR C++ BUILDER DEVELOPERS
  17.   -----------------------------------------
  18.   I wrote up some very important notes that you should read
  19.   before doing the following install.  See the file 
  20.   "\ZIP\DOC\CBUILDER.TXT", which came with this release.
  21.  
  22.  
  23. Installation
  24. ------------
  25.  
  26. This is one of the biggest freeware software releases for Delphi and
  27. C++ Builder.  To get going quickly and correctly, please follow these
  28. instructions.  Read them over once before starting.  If you don't
  29. understand a step, get help before you start the install!
  30.  
  31.  
  32. 1.  You MUST install this package on a computer that has Delphi 2 or 
  33. 3, or C++ Builder.  Minor version upgrades to any of these compilers
  34. should not affect this package, but you should always rebuild your
  35. VCL component library after doing a minor or major upgrade.
  36.  
  37.  
  38. 2.  You MUST have PKUNZIP.EXE v2.04g on your hard disk before trying 
  39. to install this package.  It should be located anywhere in the MS-DOS
  40. search PATH.  After this package is installed, you'll no longer need
  41. PKUNZIP.EXE on your hard disk.  The DLLs and VCLs distributed with
  42. this release do NOT require the PKZIP/PKUNZIP programs.
  43.  
  44.  
  45. 3.  Decide which "base directory" you will use for the ZIP package.
  46. I am using C:\ZIP on my computer, but you can use whatever you
  47. want.  Install this package from the MS-DOS prompt. This set of
  48. MS-DOS commands will set up your directory tree (assuming your
  49. base directory will be \ZIP):
  50.  
  51.  
  52. CD \
  53. MD ZIP
  54. CD ZIP
  55. COPY <source>DELZIP11.ZIP
  56. PKUNZIP DELZIP11    (unzip the main distribution archive)
  57. INST                (run the INST.BAT batch file)
  58.  
  59.  
  60. 4.  The VCLs included with this release are:
  61.       TZipMaster - the main ZIP support VCL
  62.                    (used by demo1 and demo2)
  63.       TSortGrid  - a very handy descendant from TStringGrid
  64.                    (used by demo1 and demo3)
  65.       TZipDir    - a simple utility VCL to get the contents 
  66.                    of a ZIP archive (used by demo3)
  67.  
  68.     The files required to support these VCLs are located in the
  69.     VCL subdirectory.  You have two choices for how to proceed
  70.     (option A is recommended):
  71.  
  72.       A) add the directory C:\ZIP\VCL to your VCL search path
  73.                              or
  74.       B) copy the files in C:\ZIP\VCL to another directory already
  75.          in your VCL search path
  76.  
  77.     If you want to use option A, the instructions for this are
  78.     included below.  If you want option B, then please copy those
  79.     files now.
  80.   
  81.  
  82. 5.  Install the three VCLs       
  83.  
  84.     This procedure will install the VCLs into the IDE.  After
  85.     this, you will be able to see them on the "Samples" tab.
  86.  
  87.     Delphi 2:
  88.       a) Close any Files or Projects that are open.
  89.       b) Select the "Component...Install" choice.
  90.       c) If you want to add C:\ZIP\VCL to the library search
  91.          path, you may do it now using the second edit box.
  92.  
  93.       d) Click on the Add button.  
  94.       e) Enter the path and filename of where the ZIPMSTR.PAS 
  95.          file is located, or find it now with Browse. 
  96.  
  97.       f) Click on the Add button.  
  98.       g) Enter the path and filename of where the SORTGRID.PAS 
  99.          file is located, or find it now with Browse. 
  100.  
  101.       h) Click on the Add button.  
  102.       i) Enter the path and filename of where the ZIPDIR.PAS 
  103.          file is located, or find it now with Browse. 
  104.  
  105.       j) Click on OK.  The component library will rebuild.
  106.  
  107.     Delphi 3:
  108.       These instructions assume you will place the VCLs into
  109.       the standard user package "DCLUSR30.DPK".  Advanced 
  110.       developers may want to use a different package, or to
  111.       make a new package.  Packages can be confusing, so I will
  112.       only document the simplest case, of putting them into 
  113.       "DCLUSR30.DPK", which will work fine for most developers.
  114.  
  115.       a) Close any Files or Projects that are open.
  116.       b) Select the "Component, Install Component" choice. Make
  117.          sure the "Into existing package" tab is selected.
  118.       c) Check to see if package: "DCLUSR30.DPK" is already 
  119.          selected.  If not, you should now locate "dclusr30.dpk".
  120.       d) Add the C:\ZIP\VCL directory to the search path
  121.          box (unless you copied the files to a path already
  122.          in the search path).
  123.  
  124.       e) In the Unit name block, enter ZIPMSTR.PAS. Click OK.
  125.       f) It will ask if you want to rebuild the Component Library.
  126.          ANSWER NO (saves time to do it only 1 time later).
  127.  
  128.       g) Click on Add.
  129.       h) In the Unit name block, enter SORTGRID.PAS. Click OK.
  130.       i) It will ask if you want to rebuild the Component Library.
  131.          ANSWER NO (saves time to do it only 1 time later).
  132.  
  133.       j) Click on Add.
  134.       k) In the Unit name block, enter ZIPDIR.PAS. Click OK.
  135.  
  136.       l) It will ask if you want to rebuild the Component Library.
  137.          ANSWER YES this time.  The component library will rebuild.
  138.          If it does not automatically install the new VCLs to the
  139.          component palette, then click on the "install" button of
  140.          the package option dialog box.
  141.  
  142.       m) When done, close the package option dialog box by
  143.          clicking on it's upper right corner.  Say "Yes" to
  144.          keep the changes.
  145.  
  146.     C++ Builder:
  147.       a) Read the file \ZIP\DOC\CBUILDER.TXT for very important
  148.          notes.  Make a backup copy of your VCL library.
  149.       a) Close any Files or Projects that are open.
  150.       b) Select the "Component...Install" choice.
  151.       c) Add C:\ZIP\VCL to the library search path, unless you
  152.          copied the files to a directory already in the path.
  153.  
  154.       d) Click on the Add button.  
  155.       e) Enter the path and filename of where the ZIPMSTR.PAS 
  156.          file is located, or find it now with Browse. 
  157.  
  158.       f) Click on the Add button.  
  159.       g) Enter the path and filename of where the SORTGRID.PAS 
  160.          file is located, or find it now with Browse. 
  161.  
  162.       h) Click on the Add button.  
  163.       i) Enter the path and filename of where the ZIPDIR.PAS 
  164.          file is located, or find it now with Browse. 
  165.  
  166.       j) Click on OK.  The component library will rebuild.
  167.          If you have "warnings" enabled, you will get lots
  168.          of warning messages.  Ignore these.
  169.             
  170. 5.  You're ready to try a demo program!
  171.  
  172.  
  173.                             DELPHI DEMOS
  174.  
  175. 1.  From the IDE, open the project C:\ZIP\DEMO1\DEMO1.DPR.
  176.     Select Run.  
  177.  
  178.     Examine the forms and decide if you need to resize any of
  179.     the controls, or change the position of anything. This is
  180.     sometimes necessary if I developed the forms at a different
  181.     screen resolution than you are using.
  182.  
  183.     The demo1 program is a fairly straight-forward example
  184.     of what you can do with this package!  Everything revolves
  185.     around the TSortGrid, which always shows you the contents 
  186.     of your ZIP archive.  Use right-click on a column header to
  187.     do an descending sort, or a left-click for an ascending sort.
  188.  
  189.     NOTE: You should have the compiler option "break on exception"
  190.     turned off if you want to use the click-to-resort option of
  191.     the grid.  This is only a concern when running the program
  192.     from the IDE.
  193.     
  194. 2.  Now, you can look at the simplest demo program.  This is
  195.     especially useful because it doesn't have so much "clutter".
  196.     It just shows you the easiest way to use TZipMaster from 
  197.     within any of your programs.
  198.  
  199.     From the Delphi IDE, open the project C:\ZIP\DEMO2\DEMO2.DPR.
  200.     Select Run.  
  201.  
  202. 3.  Demo program #3 is not intended for use by most programmers.
  203.     If you're not extremely curious about the inner workings of
  204.     the DLL interface to Delphi, I advise you to skip this demo!
  205.     It shows very advanced programmers how they can access the
  206.     DLL's without using the TZipMaster VCL.  This gives them a
  207.     few more options, but can be difficult to code and debug.
  208.     This level of programming is how I had to start out in
  209.     developing the DLL interface.  The last step I did was to
  210.     create TZipMaster and demo programs 1 and 2.  The moral of
  211.     the story: sometimes things have to get complex in order to
  212.     make them easy!
  213.  
  214.     NOTE: You should have the compiler option "break on exception"
  215.     turned off if you want to use the click-to-resort option of
  216.     the grid.  This is only a concern when running the program
  217.     from the IDE.
  218.  
  219.  
  220.                        C++ BUILDER DEMO
  221.  
  222. 1.  This is a simple program to show you how to use TZipMaster
  223.     from C++.  From the C++ Builder IDE, open the project
  224.               C:\ZIP\CDEMO1\PROJECT1.MAK
  225.  
  226. 2.  Examine the forms and decide if you need to resize any of
  227.     the controls, or change the position of anything. This is
  228.     sometimes necessary if I developed the forms at a different
  229.     screen resolution than you are using.
  230.  
  231. 3.  Select Run.
  232.  
  233. NOTE: This demo does not show an example of deleting a file
  234. from a ZIP archive.  This is, however, a supported method of
  235. TZipMaster.  It is done almost the same way an "Add" is done.
  236. See the file ZIPMSTR.PAS for an explanation of all properties,
  237. methods, and events of TZipMaster.
  238.  
  239.  
  240.                    Deployment of Your Programs
  241.  
  242. Any program you write using this package will require the two 
  243. DLLs: ZIPDLL.DLL and UNZDLL.DLL to be present of each user's
  244. hard disk.  You should have your install procedures put these
  245. files into directory C:\WINDOWS\SYSTEM.  If that isn't possible,
  246. then you should put them into the same directory as your .EXE
  247. program that uses them.
  248.  
  249. NOTE: Microsoft is said to be recommending that DLLs should
  250. be installed in application directory, rather than the Windows
  251. system directory.  This may become a requirement of a future
  252. version of Windows.
  253.  
  254. Of course, there are no distribution fees for the DLLs, or
  255. any other part of the package.  This whole package is 
  256. freeware, but does have some minor distribution restrictions
  257. (mainly that you can't profit from the ZIP DLLs, and you need
  258. to document where users can get source code).  Please see 
  259. README.TXT for these restrictions.
  260.     
  261.  
  262. See README.TXT for more general information about this release,
  263. and also check out the DOC subdirectory.
  264.  
  265.  
  266. Eric Engler
  267. englere@swcp.com
  268.