ZipBuilderSFX, for Borland C++ Builder version 1, 3, 4 , 5 and 6
Version 3.2.0
By Roger Aelbrecht, Roger.Aelbrecht@Tiscali.be
----------------------------------------------------------------------

TZipBuilderSFX is a translation of TZipMasterSFX from Delphi to C++.
It is functionally identical, but it has been coded in C++ to make 
it possible for TZipBuilder users to have these functionality because
the Delphi version is an add in for the ZipMaster component

I am going to use the term "BCB" to mean "Borland C++ Builder".
----------------------------------------------------------------------

Unsupported Properties
----------------------
Since I normally use the BCB5 release, sometimes new properties
of VCLs will get saved with DFM files.  Please tell it to
"Ignore" any "Property not found" type of error you may see.


1.  You MUST install this package on a computer that has BCB.
    
2.  The VCL included with this release is TZipBuilderSFX 

    The files required to support this VCL are located in the
    VCL subdirectory.  You have two choices for how to proceed
    (option A is recommended):

      A) add the directory C:\...    \VCL to your VCL search path
         which can be set after step 3a.
         (C:\.. being the directory where you copied all files.)
                             or
      B) copy the files in \VCL to another directory
         already in your VCL search path

    If you want to use option A, the instructions for this are
    included below.  If you want option B, then please copy those
    files now.
                         
3.  Install the VCLs in C++ Builder:

    This procedure will install the VCLs into the IDE.  After
    this, you will be able to see them on the "Components" tab.

      a) Select the "Component...Install" choice from the menu.

      b) Click on the Add button.
      c) Click on the Browse button.
      d) Select the path and filename of where the ZipBuilderSFX.cpp 
         file is located. 
      e) Add the path where ZipBuilderSFX.cpp is located to the
         Searchpath       (eg:  ;$(BCB)\YourPath  )
      f) Click on OK.  The component library will rebuild.
         If you have "warnings" enabled, you can get lots
         of warning messages not related to this new package.
         Ignore these.

   If something went wrong:

     There is some instability in the code that builds
     the VCL library for version 1 of CBuilder. This is a
     manageable problem as long as you are aware of it.

     You must always keep a good copy of your component
     library on a floppy disk (or another hard disk directory)
     for safe keeping.  Sometimes, problems during the build
     of the VCL library can cause it to be corrupted, which
     then prevents CBuilder from even starting.

     The Component Library file is named 'CMPLIB32.CCL' and
     the Options file 'CMPLIB32.OPT'. These are in the 'bin'
     subdirectory under the main CBuilder directory.
  
     If the component library becomes corrupted, restore
     the automatic copy made by BCB of "CMPLIB32.CCL", named
     CMPLIB32.~CC and delete the temporary files in that
     directory: CMPLIB32.I* and CMPLIB32.TDS.  Now, go back
     into CBuilder and fix the problem that caused the library
     to become corrupted. (Just recompiling will probably enough).
     Sometimes it is also neccessary to restore the old version
     of 'CMPLIB32.OPT' Named: 'CMPLIB32.~OP'.
 
     If you have corrupted the automatic backup files BCB make
     you should restore them with your own saved versions.     
     
----------------------------------------------------------------------
     
                       C++ BUILDER HELP

 Installation
------------
1) Copy ZipBuilderSFX.hlp and ZipBuilderSFX.cnt from \Help
   to BCB's help directory.

2) In BCB's HELP subdirectory, edit BCB.cnt and add the
   following two lines to the appropriate sections in this 
   small file:
   :Index ZipBuilderSFX Component Help=ZipBuilderSFX.hlp
   :include ZipBuilderSFX.cnt

3) If you want to see the component in the bookshelf, then:
   Edit BCBMain.cnt and add the following line:
   :include ZipBuilderSFX.cnt

4) Delete the *.FTS and *.GID files from the BCB Help
   subdirectory. This can be done easily from Explorer.   
   Make sure BCB is NOT running when you do this.
   If you want to do it from an MS-DOS prompt:
   C> del *.GID
   C> del *.FTS

5) The next time you use BCB's Help feature, it'll say
   "preparing help file for first use".  This is when it
   is rebuilding the .GID files to include the new Help topics.
   The next time you do a full text search in Help, it'll rebuild
   *.FTS files.

You now have context-sensitive help on the TZipBuilder
component inside the BCB IDE!

----------------------------------------------------------------------
                      DEMO                                            
                      
Installation
------------
1.  The Demo directory has a number of sub directories one for BCB1,
    one for BCB3 specific files, etc. The files that are
    common to all environments are in the Demo directory.
    To install a demo you HAVE to COPY the files from the sub
    directory BCBx to the Demo directory. Sometimes you will
    be asked to overwrite an existing file this is NOT an error
    and you should confirm the question.
    

2.  Important: 
		a) You have to set the include and library path in your project,
       not only for the demo's but also for new projects.
       1) Open a project.
       2) Select the "Options...Project" choice from the menu.
       3) Select the Directories/Conditionals tab.
       4) Add to 'include path': The path where ZipBuilderSFX.h is located.
       5) Add to 'Library path': the path where ZipBuilderSFX.obj is located.
       6) Click on the Ok button.
       7) Save your project.

    b) The ZipBuilderSFX component uses a language depended *.bin file
    	 if you installed these files in another directory than the
    	 Windows/System directory you have to enter the correct path in 
    	 the SFXPath property before building the demo
    	 
----------------------------------------------------------------------
    
                  DEPLOYMENT OF YOUR PROGRAMS

To use TZipBuilderSFX you need to supply one of both methods in your 
application to create the sfx program

You can use the *.bin files then you have to supply and install any of 
the needed DZSFXxx.Bin, BCBSFXxx.bin with your program
on a path were they can be found by the component.
How the component locates the *.bin files is explained in the on-line
help file in the item 'SFXPath'
                                
Alternatively you can use the *.res version. You can include in your 
application any or all of the DZSFXxx.res, BCBSFxx.res files, when needed 
the component will create the sfx program out of these data resources, 
you need to include all the languages that you want to support or include 
the DZSFX_ALL.res or BCBSFX_ALL.res for all available languages.
If you included the resource files in your application and a new version 
of any the .bin files becomes available you can use this new version 
without recompiling your program by adding the new version in a path
were it can be found by the component as indicated above. The version 
control in the program will always use the latest available *.bin or
resource 

Of course, there are no distribution fees for any part of the package.  
This whole package is freeware, but does have some minor distribution 
restrictions (mainly that you can't profit from the ZIP DLLs, and you 
need to document where users can get source code).  Please see 
.....\README.TXT for these restrictions.
    
