readme.txt

MYSQL 连接控件 MYSQL 连接控件

SciBit MyComponents VCL Suite Readme & Installation
---------------------------------------------------

Last minutes information
------------------------

Just in case the installer did not successfully install your packages
and/or helpfiles we give you this readme file with complete
manual instructions to install either the shareware or registered versions.

IMPORTANT
---------

If you intend to use the client or embedded driver of this suite, you will need
the libmysql.dll/libmysqld.dll (windows) or libmysqlclient.so/libmysqld.so (linux)
libraries from MySQL AB.  You can either get these from their site http://www.mysql.com
or for convenience you may download pre compiled version 4.0.20 from http://www.scibit.com
for free.  These libraries do not form part of our products or distributions and are available
for free.  Source code for all these libraries can be obtained from http://www.mysql.com
and compiled by yourself or downloaded in binary form.

NOTE(Windows): Although the embedded library distributed with MySQL 4.0.20 works fine, you may 
wish to customize it to your needs or to get a smaller footprint. As the libmysqld.dll was 
written for C++ you need to change a few compiler directives to compile it for usage 
as a standard dll for delphi:
* Get VC++ 6.0 compiler with SP5 and the Pre-processor package and open the workspace mysql.dsw
* Set libmysqld as an active project
* Set your active configuration to "Win32 Release" or "Win32 Classic" or "Win32 Pro"
A: For the 4.0.18 Build do:
* Remove ..\lib_release\bdb.lib from Project Settings\Link\Object/library modules
* If you would like to compile without InnoDB support, then delete HAVE_INNOBASE_DB Project Settings\C/C++\
Preprocessor \Preprocessor definitions
* Add USE_TLS to Project Settings\C/C++\Preprocessor\Preprocessor definitions for dbug, heap, innobase, myisam, strings, mysys, myisammrg
B: For the 4.0.20a Build do:
* Delete the "_tls" bits in the libraries referenced in Project Settings\Link\Object/library modules

* Build libmysqld

NOTE(Linux): The binary version of libmysqld.so is not always available in the linux distributions,
so compiling it yourself might be an only alternative to downloading a binary version.

Description:
------------
This is the SciBit's Delphi 5/6/7/2005/2006/2007 or Kylix 1/2/3 single source components for
MySQL servers 3.21.x to 5.x

These suite was tested with all stable MySQL servers from 3.21.x to 5.x

For support please contact SciBit at:
web: http://www.scibit.com
email: [e-mail]

Components Installation:
------------------------
Only Delphi 5/6/7/2005/2006/2007 and Kylix 1/2/3 (No Open Editions, as they have no datawareness) are supported.

	Shareware Installation:
	-----------------------
0. If installed, uninstall any previous versions of this componentset in
   Delphi/Kylix.

1. If you intend to use the clientlib driver to access your mysql server, make 
   sure the .\libmysql.dll or libmysqld.dll (Windows) or ./libmysqlclient.so or 
   libmysqld.so(Linux) file that came with the mysql installation is always 
   available somewhere to the project you are compiling. On your PATH/LD_LIBRARY_PATH, 
   win\system32 (Windows) or /usr/lib (Linux) directory or 
   the project's directory would be good choices.
2. In Kylix or Delphi click the Component-Install Packages menu, then click
   Add
3. Depending on your Delphi or Kylix version goto the corresponding directory:
	..\D5		Delphi 5
	..\D6		Delphi 6
	..\D7		Delphi 7
	..\D2005	Delphi 2005
	..\D2006	Delphi 2006
	..\D2007	Delphi 2007
	..\K1		Kylix 1
	..\K2		Kylix 2
	..\K3		Kylix 3
3. Pick the SBMySQL?0.bpl for Delphi or the bplsbmysqlk?0.so file for Kylix
   then click Open
4. Click Tools-Environment Options menu, then click Library,
   and add the same directory (/K1,/K2,K3,/D5,/D6,/D7,/D2005,/D2006,/D2007) to the Library Path.

	Full Installation:
	------------------
0. If installed, uninstall any previous versions of this component set in
   Delphi/Kylix.
1. If you intend to use the clientlib driver to access your mysql server, make 
   sure the .\libmysql.dll or libmysqld.dll (Windows) or ./libmysqlclient.so or 
   libmysqld.so(Linux) file that came with the mysql installation is always 
   available somewhere to the project you are compiling. On your PATH/LD_LIBRARY_PATH, 
   win\system32 (Windows) or /usr/lib (Linux) directory or 
   the project's directory would be good choices.
2. Click Open, then open the file:
	./Source/SBMySQL50.dpk		Delphi 5
	./Source/SBMySQL60.dpk		Delphi 6
	./Source/SBMySQL70.dpk		Delphi 7
	./Source/SBMySQL2005.dpk	Delphi 2005
	./Source/SBMySQL2006.dpk	Delphi 2006
	./Source/SBMySQL2007.dpk	Delphi 2007
	./Source/SBMySQLK10.dpk Kylix 1
	./Source/SBMySQLK20.dpk Kylix 2
	./Source/SBMySQLK30.dpk	Kylix 3
4. Click Compile and then Install.
5. Click Tools-Environment Options menu, then click Library,
   and add the same directory (/K1,/K2,K3,/D5,/D6,/D7,/D2005,/D2006,/D2007) to the Library Path.
6. You may also choose to add the source directory if you wish to rebuild
   the package.

Help File:
----------
To install the help file in Delphi's OpenHelp:
1. Click Help then Customize
2. Click Edit then Add Files
3. Add the MyComponents.hlp file on the first three tabs.
4. Click File-Save
5. Close OpenHelp

Alternative Help:
HTML Help is also available and can be found in the installation directory
with index file named: ./Help/HTML/

Help 2.0 is also available (applicable to Delphi 2005/2006/2007).  To install execute the following
[MyComponents INSTALLDIR]Help\H2Reg -r "CmdFile=BDSHelp.ini" -q

Examples:
---------
For examples see your corresponding directory:
.\Demo\Console		- A console application
.\Demo\Start		- Database&Table create, Master-Detail sample
.\Demo\Embedded		- Database&Table create, Master-Detail Embedded MySQL sample

Copyright 1999,2000,2001,2002,2003,2004,2005,2006,2007 SciBit