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

  InstantObjects for Delphi

  Mozilla Public License 2.0
  Based on Seleqt InstantObjects.
  Portions created by Seleqt are Copyright (c) 2001-2003 Seleqt.
  Other portions and changes are Copyright (c) Ethea S.r.l.
  All rights reserved.

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


WARNING !!!

This file contains detailed info about the first option to install
InstantObjects, as per the Readme1st.txt file located in the root
folder of the project.

If you inadvertently skipped reading it, it should be a good thing
to do it now, before going on, in order to evaluate also the
second alternative.

There you will find other valuable information about the project.


INSTALLATION
------------

1. Assume cloning Git Repo into <installdir>

2. Add the following folders to your development environment's library path:

   <installdir>/Source/Core
   <installdir>/Source/Brokers/<brokername>

   Add a line for each broker you plan to use.
   If you are going to use a broker that needs a separate catalog
   (currently the IBX, UIB, DBX and ADO brokers), then
   you'll also need to add a line for each required catalog:

   <installdir>/Source/Catalogs/<catalogname>

   Here is a table of current broker-catalog dependencies:
   
   Broker              Depends on Catalog
   --------------------------------------
   IBX                 IBFb
   UIB                 IBFb
   DBX                 IBFb, MSSql, MySQL
   ADO                 MSSql
   FireDAC             IBFb, MSSql, MySQL
   
   Other brokers have their catalogs integrated into themselves,
   so there are not dependency issues for them.


3. Build and install the InstantObjects core packages:

   <installdir>/Source/Core/<version>/IOCore.dpk (build)
   <installdir>/Source/Design/<version>/DclIOCore.dpk (install)
   
   Where <version> identifies your version of Delphi
   Examples: DXE7, D10_3, etc.


4. Build and install the desired catalog and broker package(s):

   For example, if you need the ADO broker:
   
   <installdir>/Source/Catalogs/MSSql/<version>/IOMSSqlCatalog.dpk (build)
   <installdir>/Source/Brokers/ADO/<version>/IOADO.dpk (build)
   <installdir>/Source/Brokers/ADO/<version>/DclIOADO.dpk (install)

   If you need a broker that doesn't depend on a catalog, just build and
   install the broker's packages. Here's an example for the XML broker:
   
   <installdir>/Source/Brokers/XML/<version>/IOXML.dpk (build)
   <installdir>/Source/Brokers/XML/<version>/DclIOXML.dpk (install)
   
   Please note that not all brokers are available in all versions
   of Delphi. If you think you can make a supplied broker
   work in an unsupported version, or create a new broker from scratch
   then please contact us.