GREG LIEF'S ASSORTED DELPHI COMPONENTS (a/k/a "G.L.A.D.")
Version 2.0

Thank you for purchasing G.L.A.D.!

This file contains important instructions for installing the G.L.A.D.
components.  There are five sections, one for each version of Delphi.
Within each section are two subsections: one for installing the
components and one for integrating the GLAD help file into the Delphi
on-line help system.

Everything should be smooth sailing, both in terms of installation and
usage.  However, I have learned from years of third-party tool
development that software flourishes best when used by as many people
as possible -- therefore, I certainly welcome your input with respect
to enhancement requests.  I make no guarantees that your suggestion(s)
will be included in future versions, but I will do my best.

Also remember that you will automatically receive all minor source
code updates to G.L.A.D. components as a matter of course.  I trust
that you find this to be helpful in your continued Delphi endeavours.

*** BEFORE YOU GO ANY FURTHER, PLEASE READ THE FOLLOWING TWO
INSTALLATION NOTES!!!! ***

-----------------------------------------------------------------------------

IMPORTANT INSTALLATION NOTE #1: Some people have reported that, aftering 
installing G.L.A.D., when they try to run an application containing one 
or more of the G.L.A.D. components, they get a compiler error ("###.DCU 
file not found").  The solution is to first make sure that the directory 
containing the G.L.A.D. source code or .DCU files is in your search path.  
Go to the TOOLS ("OPTIONS" in Delphi 1) menu and select ENVIRONMENT OPTIONS. 
Click on the LIBRARY tab, then add that directory to the end of your Library 
Path. If you are still having problems, then it means that your Library Path 
is too long. Although Delphi isn't kind enough to inform you, it will truncate 
your library path (I believe the limit is 256 characters).  If this is the 
case, and it can be if you have installed a lot of third party components, 
then you should consolidate your .DCU files into fewer directories and 
trim the library path accordingly.

-----------------------------------------------------------------------------

IMPORTANT INSTALLATION NOTE #2 (Delphi 4): If you are using D4 and have not 
yet installed Update Patch #3, you will probably encounter the following
error when attempting to install the G.L.A.D. package collection (GLAD.DPC):

   "The procedure entry point blah-blah-blah was not found"

Although you would never know it from looking at this highly cryptic error, 
the problem stems from the fact that the G.L.A.D. packages were compiled under 
Delphi 4 Update Patch #3. Apparently the differences in Update Patch #3 are 
significant enough to render its DCUs incompatible with earlier versions of 
Delphi 4. The fix is simple: Install Update Patch #3!  If you have not already
downloaded this patch, you can find it at the following URL:

   http://www.borland.com/devsupport/delphi/downloads/index.html

If you do not already have update patch #2 (which is entirely possible because
it is a very large file and can be difficult to download from the above URL),
an alternate solution for installing the Delphi 4 version of G.L.A.D. is to 
use the "old-style" installation -- i.e., use _INSTALL.PAS rather than my 
pre-built packages.  The GLAD package collection was compiled under D4 update 
patch #2, so it consists of compiled code, hence the incompatibility error.  
If you use the _INSTALL.PAS method, that will force all units to be recompiled 
under whatever version of Delphi 4 you are currently running, and all should be well.

-----------------------------------------------------------------------------

In closing, I want to mention that I am using the "TGL" prefix for all
of the G.L.A.D. components.  This is to preclude against naming conflicts
with other third party products.  If you are interested, you can find a 
list of other registered prefixes at the Delphi Prefix Registry 
(http://developers.href.com/-dpr:homepage).

Your humble author,

Greg Lief
Web:  www.greglief.com
Mail: greglief@greglief.com


=====================
DELPHI 1 INSTALLATION
=====================

Upgrade Instructions
--------------------

If you already have installed an earlier version of G.L.A.D.,
I strongly recommend that you de-install that before proceeding.  You 
may de-install the components with these two steps:

1) Open Delphi and choose the Options | Install Component menu option.

2) Look in the list of installed units for _INSTALL.PAS file. Highlight
   that file and click on the Remove button.

3) Click on the OK button.


Component Installation
----------------------

1) Open Delphi and choose the Options | Install Component menu option.

2) Click upon the Add Button, and select the \GLAD\D1\_INSTALL.PAS
   file. This should appear at the top of the file list.

3) Press OK twice.

4) After your component library has been recompiled, you will find
   four new tabs:

   * GLAD: Database  (all database-related components except grids)
   * GLAD: DBGrids   (all data-aware grid derivatives)
   * GLAD: Interface (all other visual components)
   * GLAD: Misc.     (all other non-visual components)

   Feel free to rearrange the components thereupon as you see fit.


Help Integration
----------------

1) Copy the G.L.A.D. help file (GLAD.HLP) to the same directory that
   contains the rest of the Delphi help files (should be \DELPHI\BIN).

2) Copy the G.L.A.D. keyword file (GLAD.KWF) to the same directory
   that contains the other Delphi keyword files (should be
   \DELPHI\HELP).

3) Run the Help Installer utility (\DELPHI\HELP\HELPINST.EXE -- this
   should be available from the Delphi program group). From within
   this program, open the file DELPHI.HDX, which should be located
   in the \DELPHI\BIN directory. Click on the plus sign (+) to add
   GLAD.KWF to the existing keyword files comprising DELPHI.HDX.
   Then select the File | Save menu option, which will recompile
   DELPHI.HDX.


=====================
DELPHI 2 INSTALLATION
=====================

Upgrade Instructions
--------------------

If you already have installed an earlier version of G.L.A.D.,
I strongly recommend that you de-install that before proceeding.  You 
may de-install the components with these two steps:

1) Open Delphi and choose the Component | Install menu option.

2) Look in the list of installed units for _INSTALL.PAS file. Highlight
   that file and click on the Remove button.

3) Click on the OK button.


Component Installation
----------------------

1) Open Delphi and choose the Component | Install menu option.

2) Click upon the Add Button, and select the \GLAD\D2\_INSTALL.PAS
   file. This should appear at the top of the file list.

3) Press OK twice.

4) After your component library has been recompiled, you will find
   four new tabs:

   * GLAD: Database  (all database-related components except grids)
   * GLAD: DBGrids   (all data-aware grid derivatives)
   * GLAD: Interface (all other visual components)
   * GLAD: Misc.     (all other non-visual components)

   Feel free to rearrange the components thereupon as you see fit.


Help Integration
----------------

1) Copy the G.L.A.D. help, keyword, and content files (GLAD.HLP,
   GLAD.KWF, GLAD.CNT) to the same directory that contains the rest
   of the Delphi help files (this will probably be
   \PROGRAM FILES\BORLAND\DELPHI 2\HELP).

2) Run the Help Installer utility (\DELPHI 2\HELP\TOOLS\HELPINST.EXE).
   From within this program, open the file DELPHI.HDX, which should be
   located in the \DELPHI\BIN directory. Click on the plus sign (+) to
   add GLAD.KWF to the existing keyword files comprising DELPHI.HDX.
   Then select the File | Save menu option, which will recompile
   DELPHI.HDX.


=====================
DELPHI 3 INSTALLATION
=====================

Upgrade Instructions
--------------------

If you already have installed an earlier version of G.L.A.D.,
I strongly recommend that you de-install that before proceeding.  You 
may de-install the components with these two steps:

1) Open Delphi and choose the Component | Install Packages menu option.

2) Look in the list for either the entire G.L.A.D. package (if you 
   previously used _INSTALL.PAS) or the four individual G.L.A.D. 
   packages (GLAD_Database, GLAD_DBGrids, GLAD_Interface, and GLAD_Misc).

3) Select each GLAD-related package and click upon the Remove button to 
   uninstall it.

4) Click on the OK button to save your changes.


Component Installation
----------------------

I have provided four pre-built packages for your convenience:

* GLAD_Database   (all database-related components except grids)
* GLAD_DBGrids    (all data-aware grid derivatives)
* GLAD_Interface  (all other visual components)
* GLAD_Misc       (all other non-visual components)

These are all contained within the G.L.A.D. package collection 
(GLAD.DPC).  To install one or all of these packages, follow
these steps:

1) Open Delphi, then choose the Component | Install Packages menu
   option.

2) Click on the Add button and switch the file mask to "Package 
   collection (*.dpc)".  Select the file \GLAD\D3\GLAD.DPC and 
   click on the OK button.

3) The Install Package Collection dialog will appear, giving you 
   the opportunity to perform a full or custom installation.  If 
   you select full installation, all four of the abovementioned 
   packages will be installed.  

4) By default the packages will be installed to the \GLAD\D3 
   directory.  You may change this by clicking the Directories
   button and editing this value as desired.

If you prefer to customize the installation of the G.L.A.D. components
by setting up your own package(s), follow these instructions:

1) Open Delphi, then choose the Component | Install Component menu
   option.

2) Switch to the "Into new package" tab, then click upon the Browse 
   button and select \GLAD\D3\_INSTALL.PAS.

3) Move down to the "Package file name" edit control and type in 
   something other than "GLAD_REG" (e.g., "GLAD").  

4) Click on the OK button, then answer Yes to the next dialog.

5) After the GLAD package has been installed, you will find four new
   tabs:

   * GLAD: Database  (all database-related components except grids)
   * GLAD: DBGrids   (all data-aware grid derivatives)
   * GLAD: Interface (all other visual components)
   * GLAD: Misc.     (all other non-visual components)

6) Make sure that the directory containing your G.L.A.D. D3 files 
   is present within the Delphi Library path. You can do this by 
   by selecting the Tools | Environment Options menu option within
   the IDE, then clicking on the Library tab and editing the "Library
   Path" entry as necessary. Otherwise, you will get "missing 
   XXXXXXXX.DCU" errors when attempting to compile a project containing
   one or more G.L.A.D. components.


Help Integration
----------------

1) Copy the G.L.A.D. help and content files (GLAD.HLP and GLAD.CNT) to
   the same directory that contains the rest of the Delphi help files
   (this should be \PROGRAM FILES\BORLAND\DELPHI 3\HELP).

2) Locate the file DELPHI3.CNT, which should be in the same directory
   with the help files.  Open this in a text editor.

3) Near the top of this file, you should see an Index section that
   resembles the following:

     ; Index section
     ;==============
     :Index VCL Object and Component Reference=vcl3.hlp
     :Index Object Pascal Reference =obpascl3.hlp

   Add the following statement to this section:

     :Index Greg Lief's Assorted Delphi components =glad.hlp

4) Beneath the Index section should be an Include section.  Add
   the following two statements at the bottom of this section:

     :Include glad.cnt
     :Link glad.hlp


=====================
DELPHI 4 INSTALLATION
=====================

Upgrade Instructions
--------------------

If you already have installed an earlier version of G.L.A.D.,
I strongly recommend that you de-install that before proceeding.  You 
may de-install the components with these two steps:

1) Open Delphi and choose the Component | Install Packages menu option.

2) Look in the list for either the entire G.L.A.D. package (if you 
   previously used _INSTALL.PAS) or the four individual G.L.A.D. 
   packages (GLAD_Database, GLAD_DBGrids, GLAD_Interface, and GLAD_Misc).

3) Select each GLAD-related package and click upon the Remove button to 
   uninstall it.

4) Click on the OK button to save your changes.


Component Installation
----------------------

I have provided four pre-built packages for your convenience:

* GLAD_Database   (all database-related components except grids)
* GLAD_DBGrids    (all data-aware grid derivatives)
* GLAD_Interface  (all other visual components)
* GLAD_Misc       (all other non-visual components)

These are all contained within the G.L.A.D. package collection 
(GLAD.DPC).  To install one or all of these packages, follow
these steps:

1) Open Delphi, then choose the Component | Install Packages menu
   option.

2) Click on the Add button and switch the file mask to "Package 
   collection (*.dpc)".  Select the file \GLAD\D4\GLAD.DPC and 
   click on the OK button.

3) The Install Package Collection dialog will appear, giving you 
   the opportunity to perform a full or custom installation.  If 
   you select full installation, all four of the abovementioned 
   packages will be installed.  

4) By default the packages will be installed to the \GLAD\D4 
   directory.  You may change this by clicking the Directories
   button and editing this value as desired.

If you prefer to customize the installation of the G.L.A.D. components
by setting up your own package(s), follow these instructions:

1) Open Delphi, then choose the Component | Install Component menu
   option.

2) Switch to the "Into new package" tab, then click upon the Browse 
   button and select \GLAD\D4\_INSTALL.PAS.

3) Move down to the "Package file name" edit control and type in 
   something other than "GLAD_REG" (e.g., "GLAD").  

4) Click on the OK button, then answer Yes to the next dialog.

5) After the GLAD package has been installed, you will find four new
   tabs:

   * GLAD: Database  (all database-related components except grids)
   * GLAD: DBGrids   (all data-aware grid derivatives)
   * GLAD: Interface (all other visual components)
   * GLAD: Misc.     (all other non-visual components)

6) Make sure that the directory containing your G.L.A.D. D4 files 
   is present within the Delphi Library path. You can do this by 
   by selecting the Tools | Environment Options menu option within
   the IDE, then clicking on the Library tab and editing the "Library
   Path" entry as necessary. Otherwise, you will get "missing 
   XXXXXXXX.DCU" errors when attempting to compile a project containing
   one or more G.L.A.D. components.


Help Integration
----------------

First, attempt the Delphi 3 help integration instructions.  If those
do not appear to work, then proceed with the following:

1) Copy the G.L.A.D. help and content files (GLAD.HLP and GLAD.CNT) to
   the same directory that contains the rest of the Delphi help files
   (this should be \PROGRAM FILES\BORLAND\DELPHI 4\HELP).

2) Exit Delphi 4 if you are running it.  

3) If the file DELPHI4.GID exists, delete it.  This will be in the 
   same directory as the rest of the Delphi 4 help files.

4) Locate the file DELPHI4.OHI, which should be in the same directory
   with the help files.  Open this file in a text editor and add the 
   following line:

      :INDEX Greg Lief's Assorted Delphi components=glad.hlp

5) Locate the file DELPHI4.CNT, which should be in the same directory
   with the help files.  Open this file in a text editor and add the 
   following line to the first section:

      :INDEX Greg Lief's Assorted Delphi components=glad.hlp

6) Look for the INCLUDE section in the file DELPHI4.CNT. Add the 
   following two lines to that section:
  
      :Link glad.hlp
      :Include glad.cnt

7) Locate the file DELPHI4.OHL, which should be in the same directory.
   Open this file in a text editor and add the following line:

      :LINK glad.hlp

8) Repeat step #7 for the file DELPHI4.CFG.

9) Locate the file DELPHI4.OHC, which should be in the same directory.
   Open this file in a text editor and add the following line:

      :INCLUDE glad.cnt

10) Fire up Delphi 4.  Select the Help|Contents menu option. You should
    see "Greg Lief's Assorted Delphi components" at the bottom of the 
    first screen. If not, please verify that you have followed all of 
    the steps listed above.


=====================
DELPHI 5 INSTALLATION
=====================

Upgrade Instructions
--------------------

If you already have installed an earlier version of G.L.A.D.,
I strongly recommend that you de-install that before proceeding.  You 
may de-install the components with these two steps:

1) Open Delphi and choose the Component | Install Packages menu option.

2) Look in the list for either the entire G.L.A.D. package (if you 
   previously used _INSTALL.PAS) or the eight individual G.L.A.D. 
   packages.

3) Select each GLAD-related package and click upon the Remove button to 
   uninstall it.

4) Click on the OK button to save your changes.


Component Installation
----------------------

I have provided eight pre-built packages for your convenience:

* GLAD_Database     (all database-related components except grids)
* GLAD_Database_D   (same as above, but those components requiring design-time editors)
* GLAD_DBGrids      (all data-aware grid derivatives)
* GLAD_DBGrids_D    (same as above, but those components requiring design-time editors)
* GLAD_Interface    (all other visual components)
* GLAD_Interface_D  (same as above, but those components requiring design-time editors)
* GLAD_Misc         (all other non-visual components)
* GLAD_Misc_D       (same as above, but those components requiring design-time editors)

To install one or all of these packages, follow these steps:

1) Open Delphi, then choose the Component | Install Packages menu
   option.

2) Click on the Add button and switch the directory where you 
   installed the G.L.A.D. D5 files (probably \GLAD\D5).

3) Select the desired packages. Remember that this File Open dialog
   supports multiple selections, so you can grab them all at once.

4) Click on the OK button to install your selected packages

5) Make sure that the directory containing your G.L.A.D. D5 files 
   is present within the Delphi Library path. You can do this by 
   by selecting the Tools | Environment Options menu option within
   the IDE, then clicking on the Library tab and editing the "Library
   Path" entry as necessary. Otherwise, you will get "missing 
   XXXXXXXX.DCU" errors when attempting to compile a project containing
   one or more G.L.A.D. components.


Help Integration
----------------

1) Copy the G.L.A.D. help and content files (GLAD.HLP and GLAD.CNT) to
   the same directory that contains the rest of the Delphi help files
   (this should be \PROGRAM FILES\BORLAND\DELPHI 5\HELP).

2) Exit Delphi 5 if you are running it.  

3) If the file DELPHI5.GID exists, delete it.  This will be in the 
   same directory as the rest of the Delphi 5 help files.

4) Locate the file DELPHI5.OHI, which should be in the same directory
   with the help files.  Open this file in a text editor and add the 
   following line:

      :INDEX Greg Lief's Assorted Delphi components=glad.hlp

5) Locate the file DELPHI5.OHL, which should be in the same directory.
   Open this file in a text editor and add the following line:

      :LINK glad.hlp

6) Locate the file DELPHI4.OHC, which should be in the same directory.
   Open this file in a text editor and add the following line:

      :INCLUDE glad.cnt

7) Fire up Delphi 5.  Select the Help|Contents menu option. You should
    see "Greg Lief's Assorted Delphi components" at the bottom of the 
    first screen. If not, please verify that you have followed all of 
    the steps listed above.


=========================
C++BUILDER 1 INSTALLATION
=========================

Upgrade Instructions
--------------------

If you already have installed an earlier version of G.L.A.D.,
I strongly recommend that you de-install that before proceeding.  You 
may de-install the components with these two steps:

1) Open C++Builder and choose the Component | Install menu option.

2) Look in the list of installed units for _INSTALL.PAS file. Highlight
   that file and click on the Remove button.

3) Click on the OK button.


Component Installation
----------------------

1) Open C++Builder and choose the Component | Install menu option.

2) Click upon the Add Button, and select the \GLAD\CBUILDER\_INSTALL.PAS file.
   This should appear at the top of the file list.

3) Press OK twice.

4) After your component library has been recompiled, you will find
   four new tabs:

   * GLAD: Database  (all database-related components except grids)
   * GLAD: DBGrids   (all data-aware grid derivatives)
   * GLAD: Interface (all other visual components)
   * GLAD: Misc.     (all other non-visual components)

   Feel free to rearrange the components thereupon as you see fit.

NOTE: The TGregCalendar and TDateDialog components do not
currently support C++Builder because Borland did not see fit to
include the TCalendar base class with that product.

Sorry... C++Builder Help Integration instructions are not available.


=========================
C++BUILDER 3 INSTALLATION
=========================

If you are using C++Builder version 3, please contact me and I will send 
you the necessary library files to simplify your installation process. 
These files are free of charge -- however, I do not include them in the 
standard distribution package because most of my customers do not use 
C++Builder.

Help Integration
----------------

1) Select the Help | Customize menu option.

2) When the OpenHelp dialog box appears, select the Contents tab,
then select the Edit | Add File menu option.  Using the directory
browser, select GLAD.CNT.

3) Switch to the second tab (Index). Select the Edit | Add File menu
option, then select GLAD.HLP.

4) Switch to the third tab (Link). Select the Edit | Add File menu
option and select GLAD.HLP.

5) Switch to the fourth tab (Project). Select the Edit | Add File
menu option and select GLAD.CNT.

6) Exit the OpenHelp dialog, and when it prompts you to do so, click Yes
to save your changes.

(Special thanks to Andy Bell for his assistance with the C++Builder 3
installation instructions!)

*** end of file README.TXT