ViewVC Help

View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing

root/public/ibx/branches/journaling/changelog

Comparing ibx/trunk/changelog (file contents):
Revision 241 by tony, Thu Oct 25 13:57:12 2018 UTC vs.
Revision 303 by tony, Fri Jul 17 22:29:57 2020 UTC

#	Line 1 | Line 1
1	<	IBX Change Log  version                 (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100
1	>	FBINTF Change Log  version          (1.1-6 Build 12214) Fri, 17 Jul 2020 23:10:11 +0100
2
3	<	1. IBCustomDataset: replace deprecated function ValidUTF8String with call to
4	<	Utf8EscapeControlChars
3	>	1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
4	>	with a Firebrid 3 client library.
5
6	+	2. Linux Only: FIREBIRD environment variable is now checked when loading the client library.
7	+	If a client library path is not explicitly provided and the FIREBIRD environment
8	+	variable is set then the directory given by this variable and any 'lib' subdirectory
9	+	are searched for the Firebird client library. Only if none is found, is the default
10	+	client library used.
11
12	<	IBX Change Log  version                (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100
12	>	3.  IUtil.FormatStatus now used to format error messages when using new API
13
14	<	IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove
10	<	all previous copies of the IBX source code tree before installing this release.
14	>	4.  Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
15
16	<	The IBX packages used by most users have not changed, with one exception. The
17	<	IBServices unit has been moved to the package iblegacyServices.lpk. To continue
18	<	to use the IBServices unit in your applications, please add the iblegacyServices
19	<	to the list of dependencies. To do this, open the Project Inspector and select
20	<	Add->New Requirement and select "ibLegacyServices" from the list of available
21	<	packages.
16	>	5.  SQL_TEXT handling changed. When the value of an SQL_TEXT (i.e. fixed width string) column is
17	>	returned using GetAsString and the string codepage is UTF8, the string is truncated so
18	>	that the byte length corresponds to the number of characters specified for the column.
19	>	SQL_TEXT strings are no longer automatically trimmed to remove all trailing white space. This is
20	>	correct behaviour but may affect some implementations that relied upon automatic
21	>	trimming of trailing white space.
22
23	<	1. New unit IBXServices. The IBXServices unit is a re-architectured update of
24	<	the IBServices unit providing what is intended to be a clearer and easier to
25	<	use set of IB Services components. See Chapter 10 of the IBX User Guide for
22	<	more information and the guide to "Firebird Service Management Using IBX".
23	<	As indicated above, the legacy services components are still available and
24	<	provided in a separate package. There is no need to update working applications
25	<	using the older versions except for an additional package dependency.
23	>	6.  New IFirebirdAPI Calls:
24	>	function GetClientMajor: integer;
25	>	function GetClientMinor: integer;
26
27	–	2. The IBX packages and source code tree have been re-organised in an attempt to
28	–	finally get rid of the "duplicate ppu" warnings. This re-organisation should
29	–	not affect existing users. Section 2.3 of the IBX User Guide describes the
30	–	new set of IBX packages.
27
28	<	3. The ibx/examples/DBAdmin and the ibx/examples/services example have been
33	<	updated to use the new Services API components.
28	>	FBINTF Change Log  version          (1.1-5 Build 12044) Fri, 17 Apr 2020 12:30:01 +0100
29
30	<	4. The iblocal package has been updated to use the new Services API components.
30	>	1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
31	>	case sensitive
32
33	<	5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of
38	<	TIBXSecurityService. It had been wrongly classified in the previous version
39	<	as a per database configuration item. It is global to a server and hence
40	<	correctly positioned as part of the Security Package. In the DBAdmin example,
41	<	the setting has moved to the mappings page.
33	>	2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
34
35	<	6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements
36	<	are ignored.
35	>	3. New API Calls:
36	>	IColumnMetaData.GetStatement
37	>	IColumnMetaData.GetTransaction
38	>	ISQLData.GetStrLength
39	>	IResults.GetStatement
40	>	IAttachment.OpenBlob (using Blob metadata)
41	>	IAttachment.OpenArray (using array metadata)
42
43	<	7. TIBDatabase: DropDatabase now ensures that all transactions have been properly
47	<	closed before the database is dropped. Before and After Disconnect event handlers
48	<	are also fired.
43	>	4. FBMessages: removal of unused messages
44
45	<	8. TIBTransaction: OnStartTransaction event now fires every time the transaction
51	<	is started and not just the first time.
45	>	5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
46
47	<	9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform
54	<	depenendency with comp type.
47	>	6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
48
49	<	10. IBDataOutput: select query data output is now sent to stdout instead of stderr.
49	>	FBINTF Change Log  version          (1.1-4 Build 11515)  Fri, 28 Dec 2018 10:04:19 +0000
50
51	<	11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName
52	<	then this is recognised and not ignored.
51	>	1. Fix a problem with the SQL parameter parser that failed to recognise parameters
52	>	where the second character of the parameter name is a numeric.
53
54	<	12. TIBDataSet, TIBQuery, TIBTable: additions:
55	<	function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
56	<	function GetPerfStatistics(var stats: TPerfCounters): boolean;
64	<	property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics;
54	>	2. New method for IAttachment: procedure getFBVersion(version: TStrings);
55	>	This returns the isc_version connection information as one or more lines.
56	>	This is the same information as returned by isql with the -z option.
57
58	<	GetRowsAffected returns the affected row counts from the last insert/update/delete
59	<	if EnableStatistics = true then GetPerfStatistics returns the current stats
60	<	counters for the select query. Note: stats accumulate after each fetch from
69	<	the database. To get total query cost after open, call the "Last" method
70	<	and then GetPerfStatistics.
58	>	3. If -dFIREBIRD3APIONLY is used as a compiler option then the legacy Firebird API
59	>	is no longer compiled in. Likewise, if -dLEGACYFIREBIRDAPIONLY is used as a
60	>	compiler option then the Firebird 3 API is no longer compiled in.
61
62	<	See ibx/examples/consolemode for an example of the use of GetPerfStatistics
62	>	4. IColumnMetaData: new method.
63
64	<	13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated
65	<	in parenthesises.
64	>	TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
65	>	dfDateTime,   {SQL DATETIME}
66	>	dfTime);
67
68	<	14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3
78	<	SQL identifiers are always delimited by double quotes. If false, then they are
79	<	only delimited if the identifier is a reserved word, contains lower case or special
80	<	characters. Set this property to true to retain previous behaviour.
68	>	function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
69
70	<	15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names
71	<	are now inserted in double quotes if not Reserved Words or valid SQL Identifiers.
70	>	This returns the max. number of characters returned by the "AsString" method
71	>	when the SQL type of the column is respectively TIMESTAMP, DATETIME or TIME.
72
73	<	16. TIBDataSet, TIBQuery, TIBTable: addition:
74	<	property MasterDetailDelay: integer {defaults to zero}
73	>	5. Additional argument for IAttachment.PrepareWithNamedParameters -
74	>	CaseSensitiveParams: boolean = false
75
76	<	When non-zero and the dataset is a detail table referencing a master table
77	<	through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery)
78	<	then a synchronisation delay is added (in milliseconds) between the master
91	<	row changing and the detail dataset being re-opened. If the master dataset
92	<	is scrolled before the delay expires then the delay is reset. This can be used
93	<	to avoid performance overheads when scrolling through a large master dataset.
76	>	If this argument is set to true then SQL parameter names are assumed to be case
77	>	sensitive and must be referenced (using ISQLParams.ByName) using the case
78	>	sensitive name.
79
80	<	Note: uses fptimer and hence requires a thread manager. Under Linux the
81	<	chreads unit must be included in your project. TTimer is not used in order
82	<	to avoid an LCL dependency. Requires FPC 3.0.2 or later.
80	>	6. Bug fix: when setting a query parameter, it is now possible, when the parameter
81	>	is of type VarChar or Char to set the parameter to a numeric value (e.g. using
82	>	.AsCurrency) and then subsequently to update the value to a non-numeric string
83	>	using .AsString.
84
99	–	17. TIBExtract: User role grants now excluded when etGrantsToUser not specified
100	–	with Extract Option eoDatabase.
85
102	–	18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428
103	–	When a deLayoutChanged event is reported on the ListSource dataset, the
104	–	combobox text is updated. This allows a listsource (detail) to be in a Master/Detail
105	–	relationship with the control's datasource (master).
86
87	<	19. TIBExtract: Full BigInt value range now supported for Generators/Sequences.
87	>	FBINTF Change Log  version                  (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
88
89	<	20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their
110	<	stubs. Pedantic fix really, as procedures output in dependency order anyway.
89	>	1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
90
91	<	21. TIBExtract: Package Headers and Package Bodies are now included in the extracted
92	<	DDL (Firebird 3 and later only).
91	>	2. Restrict IsMultiThread check to Unix only for compatibility with
92	>	https://bugs.freepascal.org/view.php?id=30535
93
94	<	22. TIBLookupComboBox Autocomplete Fixes:
95	<	i. Only appended text is now selected after autocomplete.
96	<	ii. Uppercase keys no longer ignored for autocomplete.
118	<	iii. Retain Prefix case is now honoured correctly.
119	<	iv. When a DataSource is assigned, typing after autocomplete now extends prefix
120	<	before autocomplete performed. i.e. behaviour now the same as when
121	<	no DataSource assigned.
94	>	3. New SQL Tokeniser added to IBUtils. This is used to pre-process SQL with
95	>	named parameters and is intended to avoid problems with (e.g.) Execute Block
96	>	and processing internal parameters as statement parameters.
97
98	<	23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring
99	<	between SQL statements.
98	>	4. New interface IFirebirdLibrary provides access to the underlying firebird DLL
99	>	or shared object. Available via a new member (GetFBLibrary) of IFirebirdAPI.
100
101	<	24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then
127	<	ObjectNames are converted to upper case before matching against metadata object
128	<	names, unless the objectname is delimited by double quotes, in which case, the
129	<	double quotes are removed and the remaining string is used (unmodified) to match
130	<	against the metadata object name.
101	>	5. New function added to IB.pas
102
103	<	If true then the ObjectName is used as is without modification and matched
133	<	against the metadata object name. No attempt is made to remove double quotes.
103	>	function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
104
105	<	25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used
106	<	with eoTrigger, these extract types can be used to select only Database Triggers,
107	<	or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types.
105	>	This allows a Firebird Library to be loaded from an explicit path. use the
106	>	IFirebirdLibrary.GetFirebirdAPI member function to get the Firebird API using
107	>	the library. It is possible to load Firebird libraries from different locations
108	>	simultaneously, each with a distinct IFirebirdAPI.
109
110	<	26. TIBXScript: If an exception occurs during the processing of a statement, the
140	<	statement separate character is now reset to the default (';').
110	>	FBINTF Change Log  version               (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
111
112	<	27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect.
112	>	1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
113	>	program compiled with -CR command line switch.
114
115	<	28. TIBXScript: Transaction is no longer automatically reactivated immediately processing
116	<	a commit or reconnect statement and instead activated only when next SQL statement
117	<	is executed.
115	>	2. IServiceManager additions (informational):
116	>	function getProtocol: TProtocol;
117	>	function getPortNo: AnsiString;
118
119	<	29. TIBSQL.HasField should no longer generate and exception when the field does not exist.
119	>	3. IServiceManager improved error handling. Interfaces changed:
120	>	function Start(Request: ISRB; RaiseExceptionOnError: boolean=true): boolean;
121	>	function Query(SQPB: ISQPB; Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
122	>	function Query(Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
123
124	<	30. TIBXScript: case insensitive regex now used when matching statements instead of
125	<	converting statement to upper case.
124	>	4. IAttachment addition (informational)
125	>	function GetSecurityDatabase: AnsiString;
126
127	<	31. TIBExtract: metadata comments now supported. New published property
128	<	IncludeMetaDataComments (default true). If true then metadata comments included
129	<	in extracted DDL. New Extract Object member eoComments. This may be used with
156	<	ExtractObject method to list all metadata comments.
127	>	5. IStatement: performance counters now updated after each Fetch. GetPerfStatistics
128	>	thus now returns accumulated stats for a select statement from opening a cursor
129	>	up to the last fetch.
130
131	<	32. TIBExtract: ListObjectNames method added.
131	>	6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
132	>	the problem.
133
134	<	33. Updated Database component editor to support additional connection string
135	<	types.
134	>	7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
135	>	replaces deprecated "comp" type.
136
137	<	IBX Change Log  version  (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000
137	>	10. Testsuite Test10 updated to include thread synchronisation for event reporting.
138
139	<	NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO
166	<	AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS
167	<	RELEASE.
139	>	11. URL Connection Strings: inet4 and inet6 now recognised.
140
141	<	NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE.
141	>	12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
142
143	<	1. IBExtract: Identity columns - add additional check for null column for generator name.
143	>	13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
144
173	–	2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses.
174	–	The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further
175	–	information). However, this is also a very useful mechanism for returning updated computed by
176	–	column values. Values returned as a result of executing an Insert or Update statement
177	–	replace existing values in the current row for each corresponding column.
145
146	<	Previously, if a dataset's select query included read only (computed by) fields then
180	<	an automatic row refresh was performed after an insert or update query had been processed,
181	<	irrespective of the setting of the "ForcedUpdates" property. This has changed such
182	<	that an automatic refresh is no longer performed if an insert or update query contains
183	<	a returning clause that updates one or more fields on the current row. A full row
184	<	refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any
185	<	field values and the select query contains read only fields. Use of Insert/update
186	<	returning should be significantly more efficient than executing a refresh query.
146	>	FBINTF Change Log  version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
147
148	<	This behaviour change is intended to be backwards compatible and there should be no need to change
189	<	existing programs, other than to improve performance by using the new capability.
148	>	1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
149
150	<	3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as
151	<	they are called when the dataset row is being deleted, there is no value in
152	<	updating the current record from the query result. Instead, a new event handler
194	<	"OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and
195	<	an OnDeleteReturning event handler is provided then it is called with the IResults returned
196	<	by the query. The event handler can then interrogate the query results and
197	<	perform whatever action is necessary. For example to confirm, to the user,
198	<	the deletion of a row with the returned values.
150	>	2. IAttachment: add two new methods
151	>	function HasDefaultCharSet: boolean;
152	>	function GetDefaultCharSetID: integer;
153
154	<	4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for
155	<	any Computed By or Identity Columns. The IBTables example has been updated to
156	<	illustrate the computation of the employee Full Name on update.
154	>	These return, respectively, true if a connection default character set was
155	>	specified and the character set id of the connection default character set.
156	>	The DefaultCharSetID is cached when the connection is opened and hence does not
157	>	require a database lookup.
158
159	<	5. TIBTable: The GeneratorField property is now published.
159	>	3. Avoid exception when a text blob is a stored procedure parameter.
160
161	<	6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
207	<	When InsertSQL is generated, the Identity columns are not included in the list of values to
208	<	be inserted. A RETURNING clause is added to the insert statement to return the value of
209	<	each Identity column after the insert is executed.
161	>	4. Update test suite to include a test for a stored proc returning a text blob.
162
163	<	7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause.
164	<	Similarly Insert Property Editor now generates Insert SQL with Computed By fields in
165	<	Insert..Returning clause.
163	>	5. IAttachment: add
164	>	function GetRemoteProtocol: AnsiString;
165	>	function GetODSMajorVersion: integer;
166	>	function GetODSMinorVersion: integer;
167	>	function GetAuthenticationMethod: AnsiString;
168
169	<	8. TIBGenerator: small performance improvement by not preparing query each time
170	<	a new value is generated.
169	>	These results are cached when the connection is opened and hence do not
170	>	require a database lookup.
171
172	<	9. TIBSQL: Free resources when transaction changed - ensures new transaction is used.
172	>	6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
173	>	connect string used to create/connect to the database.
174
175	<	10. Property editors will now sync table name to a System Table when "Include System
176	<	Tables" is selected and the query is for a System Table.
175	>	7. IAttachment: Create Database using SQL statement. The username and password
176	>	are now extracted and used to populate a DPB made available via IAttachment.getDPB.
177	>	It is now possible to use IAttachment disconnect/connect to reconnect to
178	>	a database for which the initial connection was established by a create
179	>	database sql statement. Available in FPC only.
180
181	<	11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field
224	<	values are no longer converted to milliseconds from TDateTime and then back again
225	<	to TDateTime (the conversion to milliseconds is the default TDataset approach).
181	>	8. Update Test 1 to test 5, 6 and 7 above.
182
183	<	12. Property Editors handling of Stored Procedures.
228	<	* Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and
229	<	which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select
230	<	query).
231	<	* Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2).
183	>	9. IBUtils code tidy up.
184
185	<	13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName
186	<	can be used to select a package. If non-empty, the stored procedure name is
187	<	expected to be a stored procedure defined in the specified package and the
188	<	generated SQL will be as required for a stored procedure located in a package.
185	>	10. Parameter Block interfaces "find" method. As documented, this should have
186	>	returned a nil interface when the item could not be found. Instead, an empty
187	>	interface item was returned. "Find" now works as documented and will return
188	>	a nil interface if the item cannot be found.
189
190	<	14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include
239	<	a "Package Name" drop down box to allow selection of a Firebird 3 Package from
240	<	which a stored procedure can be selected. With no package name selected, non-package
241	<	stored procedures are listed.
190	>	11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
191
192	<	15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting
193	<	for password on reconnect.
192	>	12. DBInformation: New interfaces: IDIRB and IDIRBItem added to support DB Information
193	>	requests with additional parameters. This is to enable support for fb_info_page_contents
194	>	(return of page contents). Response to fb_info_page_contents returned as
195	>	a string with code page CP_NONE.
196
197	<	16. TIBDatabase: use IAttachment for connection default character set id, code page
198	<	and character set name.
197	>	13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
198	>	test suite updated.
199
200	<	17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise
201	<	DB info lookups"
200	>	14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
201	>	a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.
202
203	<	18. IBExtract: now supports DDL Triggers and Grants to DDL objects.
203	>	15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
204	>	An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
205	>	default connection port to be specified.
206
207	<	19. Add a property Editor for TIBUpdate.RefreshSQL.
207	>	FBINTF Change Log  version                             (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
208
209	<	20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input
210	<	parameters. This stops an exception being raised when the field cannot be
258	<	located in the record buffer.
209	>	1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
210	>	Scale is no longer ignored.
211
212	<	21. Property Editors now automatically include System Tables when opened and when the query table
213	<	is a System Table.
212	>	2. Fix issues with setting SQL Param values using SetAsString with Date values
213	>	not in locale format but which are recognised by Firebird. Date values that
214	>	cannot be converted to a string using Pascal library are now passed through
215	>	to Firebird as Text Strings.
216
217	<	22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception.
218	<	This avoids errors due to a stale SQRB or SRB being used for the next query.
217	>	3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
218	>	UTF8 and not UNICODE_FSS.
219
220	<	23. IBServices: Service attach parameters now include "expected_db". This is used to
221	<	add the SPB item isc_spb_expected_db. This names a database using
222	<	an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a
223	<	database. examples/services re-written to illustrate use of "expected_db".
220	>	4. Charset ID problem. When using Firebird 3, with no default database character set
221	>	and a column has a non-default collation specified, an incorrect character set
222	>	id was being reported that could result in a 'division by zero' error when
223	>	used by IBX. This has now been fixed.
224
225	<	24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout.
226	<	This avoids truncated backups when the server returns a timeout (busy) response.
225	>	5. Move GetCharsetName, CharSetID2CodePage, CodePage2CharSetID, CharSetName2CharSetID,
226	>	CharSetWidth from IFirebirdAPI to IAttachment. This is a better data model as
227	>	the character sets supported can be updated on a per database basis. That is
228	>	it is possible to add a (Firebird) user defined character set to a database.
229
230	<	25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase.
230	>	6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
231	>	set supported by Firebird with the API.
232
233	<	26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local
234	<	databasenames. These are respectively expanded to the local system's temp directory
278	<	(including trailing delimiter) or to a prescribed data directory (including
279	<	trailing delimiter). Under Unix systems the data directory is a hidden directory
280	<	in the user's home directory. The hidden directory name is either the string returned
281	<	from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'.
282	<	Under Windows, the directory is the same as the Data Directory as decribed
283	<	above but instead prefixed by the User's application data path. These may be
284	<	used to improve application portability for Personal Databases.
233	>	7. Add missing isc_info_db_read_only to list of decoded Database Information items
234	>	in FBOutputBlock.pas and update test suite to include this item.
235
236	<	27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef
287	<	this has not worked for a long time and is not useful either. FieldDefs should be
288	<	managed using the Fields Editor as with any other dataset. To access the fields
289	<	editor for a TIBTable component, double click on the component. The fields editor
290	<	is then displayed.
236	>	8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
237
238	<	28. TIBDatabaseInfo: new properties/function
239	<	* DateDBCreated (returns date/time database created)
240	<	* TransactionCount (returns no. of active transactions)
241	<	* GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only).
296	<	* PagesFree (Firebird 3 or later)
297	<	* PagesUsed (Firebird 3 or later)
298	<	* Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only)
299	<	* EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only)
238	>	9. Loading Windows fbclient.dll: when using the FIREBIRD variable to locate the client
239	>	library or finding it by disk location, the PATH environment variable is now also set to
240	>	include the FIREBIRD directory. This is to ensure that the correct dlls in the
241	>	firebird client library dependencies are loaded.
242
243	<	29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo.
243	>	10. Testsuite: Ensure consistent UTF-8 output on Windows console.
244
245	<	30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later).
245	>	11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
246
247	<	31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable
306	<	the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later).
247	>	12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
248
249	<	32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced
250	<	in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from
251	<	firing during backup and restore.
249	>	13. FB30Statement: A check has been added to ensure that all SQL Parameters
250	>	have been given a value (including NULL). Previously, failing to set the
251	>	value of an SQL Parameter could give rise to unpredictable results or
252	>	an SQLDA error.
253
254	<	33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options
313	<	for verbose output using the new property "StatisticsRequested".
314	<	see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats
254	>	14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
255
256	<	34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later).
256	>	15. FBAttachment: Avoid string reference count error when processing an Ansistring
257	>	parameter in an array of const passed to IAttachment.OpenCursor, etc.
258
259	<	35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin"
260	<	palette. This uses the online validation feature added in Firebird 2.5. The
320	<	services's properties enable inclusion/exclusion of tables and indexes using
321	<	regular expressions. See.
322	<	https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation
259	>	16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
260	>	of const passed to IAttachment.OpenCursor, etc.
261
324	–	36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger
325	–	option on a database.
262
263	<	37. TIBCustomService: Assign method implemented to allow copying of service login
328	<	context between service API components. "Detach" method now only detaches
329	<	service when last reference to the service interface detaches. Tidy up of
330	<	code for SetActive and Attach methods including password hiding.
263	>	FBINTF Change Log  version             (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
264
265	<	38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only
333	<	and used to determine the auth method and protocol used for the connection.
265	>	1. Change syntax to Mode Delphi
266
267	<	39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using
268	<	a Create Database Statement generated by IBX.
267	>	2. Change all uses of string type to explicit AnsiString in order to ensure
268	>	compatibility between Delphi and FPC.
269
270	<	40. All IBServices now have an additional published property "PortNo". This may
271	<	be set to a non-standard port number when necessary. If zero then the default
340	<	port number is used.
270	>	3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
271	>	defined for each interface.
272
273	<	41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard
343	<	and not just the mouse.
273	>	4. Generics syntax variations for Delphi added
274
275	<	42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added.
275	>	5. PChar replaced with PByte expect where an actual string is being referenced,
276	>	where PAnsiChar is used instead.
277
278	<	43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the
348	<	image index and selected image index for each node to be set from a database field.
278	>	6. Review of type definitions in IBExternals to ensure Delphi compatibility
279
280	<	44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included
351	<	then database schema includes grants to all users. If not present then the
352	<	only user grants included are those to User PUBLIC.
280	>	7. Testsuite updated for Delphi
281
282	<	45. TIBTreeView: performance improvement. When expanding include both expanded node
355	<	and child nodes in dataset.
282	>	FBINTF Change Log  version            (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
283
284	+	1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
285	+	large blobs and the FB3 API.
286
287	<	IBX Change Log  version                            (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000
287	>	2. Update Event Handling algorithm to avoid looping due to recreation of the
288	>	event block.
289
290	<	1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf
361	<	changes.
290	>	3. Avoid invalid XSQLDA error when the only parameter is updated to null
291
292	<	2. IBCustomDataset: Fixed use of incorrect datasize in TIBStringField.SetAsString.
293	<	Bug could result in truncated multi-byte character set values.
292	>	4. Array Handling: fix problem with text arrays with character set none. When the
293	>	DB connection has a default character set (e.g. UTF8), an error is raised by
294	>	Firebird if the space allocated is not enough to allow for transliteration, even
295	>	though it is not required for character set none.
296
297	<	3. Changes consequential on moving fbintf character set utility functions from
367	<	IFirebirdAPI to IAttachment.
297	>	5. IBUtils: List of reserved words brought up-to-date
298
299	<	4. Avoid "Object is nil" error when opening a database with DefaultSystemCodePage = true
299	>	6. Add ISQL style performance statistics collection to IStatement
300
301	<	5. IBLookupComboEditBox: avoid race condition when autocompleting text that occasionally
302	<	results in autocomplete ignoring prefix text.
301	>	7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
302	>	CREATE DATABASE statement.
303
304	<	6. IBLookupComboEditBox: Ensure that cursor is not reset to start of text when
305	<	entering a new name into the text box.
304	>	8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
305	>	an array dimension is not mistaken for a named parameter prefix.
306
307	<	7. IBCustomDataset: ensure that TIBStringField uses the field size reported by
308	<	Firebird rather than recomputing it.
307	>	9. Trim function no longer applied to result of GetAsString for SQL_TEXT
308	>	when Character set is octets. Avoids loss of non printable characters at start of string.
309
310	<	8. Property Editor positioning tidy up: All IBX Property editors should now be
311	<	screen centre. Previously some were "poDesigned" which may be inappropriate
312	<	for multi monitor desktops.
310	>	10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
311	>	statistics for the last action. Requires use of procedure IStatement.EnableStatistics
312	>	to enable stats gathering.
313
314	<	10. TIBTreeView.FindNode: protect against error if zero length path or empty tree node.
314	>	11. API Version information added as constants to IB.pas
315
316	<	11. TIBTransaction: On Force Disconnect do not raise an exception when problem ending
387	<	a transaction and always reset the object.
316	>	12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
317
318	<	12. TIBQuery tidyup: remove unnecessary call to GetAffectedRows.
318	>	13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
319
320	<	13. TIBXScript: Allow for override of database filename in Create Database statements.
320	>	FBINTF Change Log  version                                      (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
321
322	<	14. IBLocaldb: Support initialisation of the database from an SQL script in addition
394	<	to a gbak format archive.
322	>	1. Initial Release
323
396	–	15. IBLocaldb: fix problem that stopped the OnSharedDataDir event from being recognised.
397	–
398	–	16. IBLocaldb: Drop database if error creating an empty database.
399	–
400	–	17. TIBTreeView: improve performance when selecting node - avoid refreshing dataset
401	–	unless selected node not in current dataset.
402	–
403	–	18. IBServices: SetDBParams method moved from TCustomIBLocalDBSupport (in IBLocalDB package)
404	–	to TIBCustomService, and IBlocalDB code tidy up.
405	–
406	–	19. IBTreeView: Initialise TIBTreeNode KeyValue to null to avoid unpredictable
407	–	behaviour due to uninitialised variable.
408	–
409	–	20. IBServices: Correct encoding of isc_spb_prp_write_mode in TIBConfigService from
410	–	integer to byte. Ditto isc_spb_prp_reserve_space and isc_spb_prp_access_mode.
411	–
412	–	21. IBSQL: When Database changed ensure that all resources are freed.
413	–
414	–	22. IBCustomDataset: When database changed ensure that queries an unprepared.
415	–
416	–	23. SQL Property Editors now use SynEdit with SQL Highlighter. New features include:
417	–	* Line Wrap on SQL Token boundaries (on user command)
418	–	* auto-complete table names in drop down list of table names
419	–	* Double click on tablename or field name adds to SQL text
420	–
421	–	24. IBDataOutput: print statistics using float (%f) format instead of decimal (%d).
422	–
423	–	25. IBTreeView: Call to FindNode: param type change from "array of Variant" to
424	–	TVariantArray. Seems to avoid memory corruption in Windows (probably a
425	–	workaround for a problem in fpc 3.0.4 win64).
426	–
427	–	26. IBDatabaseInfo: Code tidy up. Add check for database not assigned or not open.
428	–
429	–	27. IBDatabaseInfo: Remove memory leak when accessing database operation counts.
430	–
431	–	IBX Change Log  version                   (2.0-2) Fri, 24 Feb 2017 12:17:53 +0000
432	–
433	–	1. TIBDatabase.CreateDatabase: extract full DB Name from SQL using reg ex in order to
434	–	include remote system name.
435	–
436	–	2. TIBExtract: No longer include comment header and COMMIT statement for empty
437	–	tables when data included in output.
438	–
439	–	3. Profiling: IBSQL now has conditional compilation flags to enable query performance
440	–	and timing information to be written to stdout. This may be used to locate
441	–	performance bottlenecks.
442	–
443	–	4. SQLParser: only call "OnChanging" event handler when value is different.
444	–
445	–	5. IBDynamicGrid: Update handling of navigation keys for a TDateEdit
446	–
447	–	6. IBCustomDataset: Set internalunprepared flag when transaction ends. This ensures
448	–	that BindFields is called when the query is next activated. Avoids FieldName
449	–	not found error.
450	–
451	–	7. IBUpdate: This is a new IBX component similar to TIBUpdateSQL. It is more general
452	–	purpose and allows the programmer to define any action they want for Update, Insert
453	–	or Delete. This may be complex SQL (similar to a Trigger), application specific
454	–	filtering of updates, or use of statements such as Grant or Revoke instead of
455	–	normal DML. See User Manual for more information.
456	–
457	–	IBX Change Log  version                  (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000
458	–
459	–	1. TIBEvents: Fix uninitialised variable that could result in lost events.
460	–
461	–	2. TIBExtract: Added support for FB3 "USAGE" privilege.
462	–
463	–	3. TIBExtract: data formatted as Charset set "octets" is now output using
464	–	hexadecimal notation.
465	–
466	–	4. TIBExtract: Binary Blobs and array data can now be embedded in INSERT statements
467	–	using a simple XML format.
468	–
469	–	5. TIBExtract: extract of individual Triggers and Stored Procedures can now include
470	–	grants to these objects.
471	–
472	–	6. TIBExtract: Stored Procedures and Views output in dependency order to avoid
473	–	dependency problems restoring complex databases.
474	–
475	–	7. TIBXScript: This component has been restructured to allow for the processing of
476	–	embedded XML in INSERT statements and to support interactive sources in addition
477	–	to non-interactive data sources such as files.
478	–
479	–	8. TIBXScript: CREATE DATABASE, DROP DATABASE, CONNECT statements are now supported.
480	–
481	–	9. TIBXScript: ISQL compatiable Set statements are now supported:
482	–	SET SQL DIALECT
483	–	SET TERM
484	–	SET AUTODDL
485	–	SET BAIL
486	–	SET ECHO
487	–	SET COUNT
488	–	SET STATS
489	–	SET NAMES <character set>
490	–
491	–	10. IBVersion unit added to hold current IBX Version Number information.
492	–
493	–	11. TIBExtract: Use character rather than byte length for VarChar procedure arguments.,
494	–	and domain definitions.
495	–
496	–	12. TIBExtract: Triggers now use SQL2003 syntax and database and transaction triggers
497	–	fully supported.
498	–
499	–	13. TIBExtract: when a database dump includes data, the generator values are now also set.
500	–
501	–	14: IBSQLEdit: Unit LCLPlatformDef added to uses clauses for lazarus 1.7 and later.
502	–
503	–	IBX Change Log  version     (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000
504	–
505	–	See also doc/IBX4LazarusGuide.pdf for important information on
506	–	upgrading to IBX2.
507	–
508	–	1. Size property of TIBStringField is now the width in characters of the field
509	–	and not the byte length. This applies only to multi-byte character sets such
510	–	as UTF8. The original approach aligned with TStringField. However, the TStringField
511	–	code is not recognised as a bug and hence this change to align the behaviour.
512	–	The TStringField change is expected in fpc 3.2.0.
513	–
514	–	2. A new property AutoFieldSize: boolean has been added to TIBStringField. When
515	–	true (default) then Size property value saved in the lfm is ignored. Size is
516	–	always set from the dynamic information read from the database. It is unclear
517	–	why anyone would want to override this and set Size to false.
518	–
519	–	3. ibxscript: should now handle correctly a Case..End statement within a procedure
520	–	block.
521	–
522	–	4. IBDatabase: new property - CreateIfNotExists. If true and database does not
523	–	exist when an attempt is made to connect to it (run time only) then an attempt
524	–	is made to create the database.
525	–
526	–	5. IBDatabase: new event - OnCreateDatabase. This event is called after a database
527	–	has been successfully created as a result of a call to CreateDatabase or when
528	–	creating a database after it was found not to exist.
529	–
530	–	6.  DBControlGrid: a race condition could result in the wrong row image being
531	–	written to the cache. This has been avoided by a trip round the message
532	–	loop before rendering the row image.
533	–
534	–	7.  DBControlGrid: It is strongly recommended not to open the source DataSet for
535	–	a DBControlGrid during a Form's "OnShow" event handler. Under GTK2 this is
536	–	known to risk corrupt rendering of row images when the control is first
537	–	displayed. If necessary use "Application.QueueAsyncCall" to delay opening
538	–	of the dataset (see DBControlGrid examples) until the Form's Window has been created.
539	–
540	–	8.  DBControlGrid & IBDynamicGrid: Navigation keys should now work correctly with
541	–	a TDateEdit control located on an editor panel.
542	–
543	–	9.  TIBExtract: brought up-to-date plus many bug fixes.
544	–
545	–	10. DBControlGrid: Removed memory leak when updating rows.
546	–
547	–	11. TIBCMLocalDBSupport: fixed invalid free on upgrade.
548	–
549	–	IBX Change Log  version                                           (1.4-3) Thu, 22 Sep 2016 18:10:15 +0100
550	–
551	–	1. IBCustomDataset: When calling SetCodePage, no longer request transliteration
552	–	when target codepage is CP_NONE. This is a workaround for
553	–	http://bugs.freepascal.org/view.php?id=30622.
554	–
555	–	2. DBLog option removed from TIBStatisticalService - not supported by server
556	–	since Firebird 1.5.
557	–
558	–	3. ibxscript: An error is no longer generated for "on commit preserve rows" or
559	–	similar.
560	–
561	–	4. IBCodePage: updated mapping between codepages and character id.
562	–
563	–	5. ftWideString and ftWideMemo withdrawn. There is no UTF16 character set in
564	–	Firebird. Character sets with a char width of two are not UTF16.
565	–
566	–	6. Strings received from the database are now always transliterated into UTF8
567	–	regardless of the database character set or connection character set. This
568	–	is for compatibility with the LCL.
569	–
570	–	IBX Change Log  version  (1.4-2) Thu, 22 Sep 2016 15:25:27 +0100
571	–
572	–	1. IBBlob: Defer reading of blob until read method called. This avoids having to
573	–	read in an entire blob just to get the size of the blob. General performance
574	–	improvement when opening datasets containing blobs.
575	–
576	–	2. Clearing a  Blob now sets the corresponding field's modified flag.
577	–
578	–	3. IBLookupCombo: When not performing auto-complete, original query sort order
579	–	is now used.
580	–
581	–	4. IBDynamicGrid: Add OnSelectEditor event. Allows editor panel to be dynamically
582	–	determined.
583	–
584	–	5. IBDynamicGrid: Recompute column widths after dataset closed and re-opened.
585	–
586	–	6. IBLookupCombo: LazUTF8 added to uses clause to avoid compilation problems post
587	–	lazarus 1.6.0
588	–
589	–	7. IBControls. Removed "runtime" from list of paths to avoid "multiple packages"
590	–	compilation error.
591	–
592	–	IBX Change Log  version                                 (1.4-1) Tue, 17 May 2016 09:14:51 +0100
593	–
594	–	1. No character set specified for connection: when a text blob is retrieved, the
595	–	character set is determined by looking up the native character set using then
596	–	Firebird API. Otherwise a text mode blob is assumed to have the same character
597	–	set as the connection.
598	–
599	–	2. TIBGUIInterface: this is an internal interface. Minor type changes to allow
600	–	for Login Dialog returing a change to the database path.
601	–
602	–	3. Design Time Database and Server login Dialogs now allow the Database Name/Server Name
603	–	to be changed from that given in the TIBDatabase/TIBServer component and for the
604	–	entered value to be saved on a project specific basis (design time only).
605	–
606	–	4. IBDynamicGrid: TDBLookupCellEditor now compares its DataFieldName with the
607	–	column fieldname. If they are the same then it is acts as a look up for the KeyValue
608	–	Otherwise, it sets the column text to the selected ListField Value.
609	–
610	–	5. IBDynamicGrid: Only visible columns are now taken into account When recalculating
611	–	column width.
612	–
613	–	6. IBLookupComboEditBox: Fix error with autocomplete query when a RelationName is given
614	–	and a case insensitive search is requested.
615	–
616	–	7. IBDynamicGrid: No longer ignores notifications removing Column Totals controls
617	–	or column ListSource.
618	–
619	–	8. IBQuery: no longer performs unnecessary refresh of SQL Text (and hence avoids an
620	–	unprepare) when closing and the text has not changed.
621	–
622	–	9. IBSQL: Base the cursor name on a GUID instead of a hexstr version of the class pointer.
623	–	Less likely to cause a cursor re-use error on Windows.
624	–
625	–	10.SV5IPC: include workaround for OSX. FPC 3.0.0 has broken ipc module for darwin.
626	–	Expected to be fixed in 3.0.2. Hence workaround only applies to 3.0.0.
627	–
628	–	11. TIBTreeView: Guard against nil destination on record changed
629	–
630	–	12. AnsiString Code page support: TIBStringField.AsString and TIBMemoField.AsString now return a
631	–	string type with the code page set to reflect the returned field encoding after
632	–	Firebird driver transliteration, if any.  FPC 3.0.0 onwards only. Behaviour unchanged for
633	–	earlier versions.
634	–
635	–	13. AnsiString Code page support: Assigning to TIBStringField.AsString and TIBMemoField.AsString
636	–	will now result in transliteration to the code page specified for the Firebird driver
637	–	if the assigned string has a different code page. FPC 3.0.0 onwards only.
638	–
639	–	14. TIBDatabase: new property UseDefaultSystemCodePage. When set any lc_ctype parameter
640	–	is ignored and the lc_ctype value, when the database is opened, is set to align with
641	–	the DefaultSystemCodePage (FPC 3.0.0 onwards). Normally, this is what you want and should ensure
642	–	platform independence. Note: this applies to FPC 3.0.0 and earlier versions. Pre FPC
643	–	3.0.0, when this property is true, the lc_ctype is UTF8 except under windows when
644	–	the GETACP is used to determine the Windows code page.
645	–
646	–	15. TIBDatabase: new property DefaultCharSetName. This is the Firebird character set
647	–	name used as the lc_ctype when the database was opened. Only valid while the
648	–	Database is connected.
649	–
650	–	16. TIBDatabase: new property DefaultCodePage (FPC >=3.0.0 only). This is the codepage
651	–	id that corresponds to the DefaultCharSetName.
652	–
653	–	IBX Change Log  version                          (1.4-0) Mon, 15 Feb 2016 14:44:24 +0000
654	–
655	–	1. Unix: If Firebird Embedded Server shared object is loaded and a local database
656	–	path is given and database attach fails due to access permission issues on the
657	–	temp directory or security database, then the attach is retried with "localhost:"
658	–	prefixing the databasename. This should avoid problems when the database has to
659	–	be accessed by a local (e.g. classic) server and libfbembed is used.
660	–
661	–	2. Windows: revised search order for Firebird DLL:
662	–	i.   The Firebird Embedded Server in the application Directory.
663	–	ii.  If the FIREBIRD environment variable is set then the directory this
664	–	points to is searched for the FB Client DLL and then then underlying
665	–	"bin" directory.
666	–	iii. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project\Firebird Server\Instances
667	–	is used to locate the Firebird installation directory and the underlying
668	–	"bin" directory is searched for the FB Client DLL.
669	–	iv.  The Default installation directories C:\Program Files\Firebird\Firebird_2_x
670	–	are searched for the FB Client DLL.
671	–	v.   The PATH Environment variable is used to search for the FB Client DLL.
672	–	vi.  Finally the  PATH Environment variable is used to search for IBASE.DLL.
673	–
674	–	3. New Component: TIBXScript. This is an ISQL compatible SQL script execution engine.
675	–	See doc/readme.scriptengine and example applications.
676	–
677	–	4. New Component: TIBlocalDBSupport. This is a TIBDatabase support component intended to
678	–	simplify the use of the embedded firebird server on both Linux and Windows platforms.
679	–	See dpc/readme.localdatabase and example applications.
680	–
681	–	5. IBDynamicGrid: Reordering on column header click should now also work for
682	–	dynamic columns.
683	–
684	–	6. ISQLMonitor: (Windows only). Mutex added to TMultilockGate to avoid race condition
685	–	between incrementing/decrementing the lock count and signalling the event.
686	–
687	–	IBX Change Log  version           (1.3-2) Tue, 26 Jan 2016 14:39:54 +0000
688	–
689	–	1.3.2 was never formally released and only made available as beta copies.
690	–
691	–	1. DBControlGrid,IBDynamicGrid: Ignore down arrow and up arrow in TCustomMemo
692	–
693	–	2. IBDynamicGrid: Now deals correctly with a single column grid which has no indicator and autosize column
694	–
695	–	3. IBLookupComboEditBox: reset timer on each key press - avoids timer going off too early
696	–
697	–	4. IBDynamicGrid: Call event OnUpdateSortOrder even when aliasname not found in dataset
698	–	i.e. when it is a calculated field
699	–
700	–	5. IBDynamicGrid: Fix problem selecting a different row when expanded row at end of grid.
701	–	This problem was due to a race condition between recalculating row heights and
702	–	determining which row was selected by the mouse click. The row height calculation
703	–	is now deferred by an extra trip round the message loop allowing the row to
704	–	be always calculated on the current grid layout rather than risking it being
705	–	calculated on the grid layout after the expanded row has been shrunk.
706	–
707	–	6. IBLookupComboEditBox: avoid race condition between cm_killfocus and cm_exit on
708	–	Windows.
709	–
710	–	7. TIBStringField: Now has two new public properties: CharacterSetName: string and CharacterSetSize: integer;
711	–	These properties allow the (Firebird) character set name for the field and the max number of bytes per character
712	–	to be determined at runtime. See doc/readme.charactersets.html.
713	–
714	–	8. TIBWideStringField: This is a new field type with the same additional public properties as above and subclassed from
715	–	TWideStringField. This field type is used with the character size reported by Firebird is two. See doc/readme.charactersets.html.
716	–
717	–	9. TIBMemoField and TIBWideMemoField: new field types with the same additional public properties as above and subclassed from
718	–	TMemoField and TWideMemoField respectively. These field types are used with Blob subtype 1 and a characterset size of
719	–	1, 3 or 4 (TIBMemoField) or 2 (TIBWideMemoField). See doc/readme.charactersets.html.
720	–
721	–	Both also have a new published property "DisplayTextAsClassName". If false (default) the displaytext is generated
722	–	from the blob text by truncating the string to the displaywidth (in characters not bytes). A displaywidth of zero
723	–	implies no truncation.
724	–
725	–	10. IBLookupComboEditBox: Force autocomplete when EditingDone called and timer active.
726	–
727	–	11. IBDynamicGrid: Call DataSet.Append when entering edit mode and dataset empty and not in insert state
728	–	(avoids "Not in Edit Mode" error).
729	–
730	–	12. IBDynamicGrid: Correctly resize grid when one column width plus indicator.
731	–
732	–	13. IBDynamicGrid: Ensure Editor Panel has focus when shown - avoids Windows API calling
733	–	DBGrid.DoExit on subsequent mouse click (e.g. on child control such as a tabbed page control.
734	–
735	–	14. IBDynamicGrid: ignore up, down tab and return when editorpanel open and focus in a TCustomGrid descendent.
736	–
737	–	15. DBControlGrid: Stop flashing grid when dataset closed and then re-opened while DisabledControls
738	–
739	–	16. IBQuery: Bug fixed that prevented SQL being set programmatically once the Parser had been invoked.
740	–
741	–	17. IBCustomDataSet: On close, parser is now freed and Select SQL reverts to value before DataSet Opened.
742	–
743	–	IBX Change Log  version        (1.3-1) Sat, 18 Jul 2015 13:30:50 +0100
744	–
745	–	1.   OnCloseUp Event Handler added to TDBLookupProperties
746	–
747	–	2.   IBDynamicGrid: Call to OnEditorPanelHide is now last editor hide action - avoids
748	–	problem with row size when exception is called.
749	–
750	–	3.   IBLookupComboEditBox: Force pending autocomplete on combobox exit.
751	–
752	–	4.   IBDynamicGrid and DBControlGrid: Keyhandler now ignores up, down, escape and return keys if
753	–	in a TCustomComboBox and ignores return key if in a TCustomMemo
754	–
755	–	5.   IBLookupComboEditBox: Ensure that KeyValue is set correctly when full text
756	–	keyed in i.e. when autocomplete not performed
757	–
758	–	6.   Cleanup of "Uses" clauses and add console mode support. IBX should now support
759	–	console mode applications with all LCL required functions (builtin dialogs and
760	–	cursor management) centralised in the  IBDialogs unit. As long as "IBDialogs" is
761	–	not included in your project, IBX should compile and link with a console mode program.
762	–	See consolemode example and its "readme"for further guidence. DO NOT add the ibexpress package to a
763	–	console mode application or the IDE will automatically assume that your
764	–	application is GUI based. Instead, you should include the ibexpressconsolemode package.
765	–
766	–	IMPORTANT NOTE: IBDialogs must be included in GUI applications in order
767	–	to use the built in dialogs and cursor management. IBDialogs is
768	–	included by default if "ibexpress" is in your project source's "uses" clause.
769	–	This should be the case for all projects created through the IDE. This is why
770	–	you do not want to add the ibexpress package to console mode applications. The
771	–	ibexpressconsolemode package has been created to allow console mode programs
772	–	to avoid adding LCL dependencies when using IBX, while still having the
773	–	unit search paths set up correctly.
774	–
775	–	Existing users should check to ensure that the "ibexpress" unit is included in
776	–	each project's source file (*.lpr).
777	–
778	–	You may find that in order for the IDE to recognise that ibexpressconsolemode
779	–	exists, you have to first open the package in the IDE and then close it. This
780	–	adds it to the most recently accessed packages list. To make it permanently
781	–	available, add the package name to lazarus' staticpackages.inc file.
782	–
783	–	Thanks to Julio Jiménez for suggesting support of console mode.
784	–
785	–	7.   SQL Parser can now accept quoted strings that include new lines
786	–
787	–	8.   IBDynamicGrid: Lookup Cell Editor - the cursor is now positioned at end
788	–	of text on start of edit. This is particularly useful when tabbing to a
789	–	column and then inserting text.
790	–
791	–	9.   New Examples provided for IB Services and ISQLMonitor.
792	–
793	–	10. Fix error when writing to blob streams that recorded only the last buffer
794	–	write in the blob stream. In most cases, this did not cause a problem as the
795	–	IB Blob Stream is written in a single write. However, with the TDBImage, write
796	–	of a graphic type prefix was lost which caused a problem when the image could
797	–	not be automatically recognised.
798	–
799	–	11. Improve generation of random cursor names in TIBSQL - avoid risk of "cursor
800	–	already open" errors due to random numbers used for the cursor name being identical.
801	–
802	–	12. IBTable: corrected error that could result in an "Index out of bounds" error
803	–	when opening the table and the Primary Key is the last or only column in the
804	–	table. Thanks to Rick Hoover for the fix.
805	–
806	–	13. Fix TIBDatabase initialisation of lc_ctype under unix. Set to "UTF8" instead
807	–	of "UTF-8", and update list of available database character sets. Existing
808	–	users should check the current lc_ctype setting in their applications.
809	–
810	–	IBX Change Log  version  (1.2-4) Sat, 09 May 2015 12:38:29 +0100
811	–
812	–	1.  Firebird Services: avoid List Index error when opening a service with an
813	–	empty Params property.
814	–
815	–	2.  IBControls: Fix problem with new link mechanism introduced in 1.2.3.
816	–	Link now set up in Loaded method - avoids occasional failure to apply
817	–	SQL markup on initial open.
818	–
819	–	3.  "Employees" example performance improvements when scrolling.
820	–
821	–	4.  DBControlGrid: Correctly handle edit panel removal when panel is child control of a
822	–	TFrame. Force recaching of selected frame to avoid GTK race (results in a
823	–	random image cached).
824	–
825	–	5.  DBControlGrid: Should now react to changes in panel height at run time.
826	–
827	–	6.  IBDynamicGrid: Redraws rows below on panel editor hide - avoids blank space at end of grid
828	–	even when further rows exist.
829	–
830	–	7.  DBControlGrid: DefaultRowHeight is no longer a published property as it should
831	–	always be derived from panel height and setting this property can cause confusion.
832	–	Note for existing projects: to avoid a missing property error at run time,
833	–	each form using the DBControlGrid must be opened, updated and saved in the IDE
834	–	in order to remove the property value from the lfm.
835	–
836	–
837	–	IBX Change Log  version (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
838	–
839	–	1.  TIBStoredProc. Prepare now called by ParamByName to avoid need to always
840	–	call Prepare before setting parameter values.
841	–
842	–	2.  Error message on ParamByName (all cases) not found now includes name of missing parameter.
843	–
844	–	3.  Code tidyup and more robust handling of dsql information result vector.
845	–
846	–	4.  Support for centralised handling of transaction status changes. TIBTransaction
847	–	has been given additional events "AfterEdit", "AfterInsert", "AfterDelete", "AfterPost"
848	–	and "AfterExecQuery". The first three are called after the same event is called
849	–	for an IBCustomDataSet descendent using the Transaction. The fourth is called
850	–	after a call to TIBSQL.ExecQuery, again using this transaction. These new events
851	–	enable monitoring of transaction status changes for a given transaction to be
852	–	handled in a single place. For example, when a change to the dataset occurs
853	–	an indicator can be set that shows the user that in order to save changes,
854	–	the transaction should be committed.  Rather than doing this per dataset, this
855	–	can now be done per transaction.
856	–
857	–	5.  TDataSet.CheckBrowseMode automatically posts changes to the current row when
858	–	the dataset is scrolled. However, any changes to the current row are, by default,
859	–	discarded when the dataset is closed. TIBDataSet, TIBQuery and TIBTable now
860	–	have a new property "DataSetCloseAction" that adds automatic posting of changes
861	–	on dataset close. If this property is set to dcDiscardChanges (default) then the
862	–	behaviour is unchanged from previous versions. if the value is set to dcSaveChanges
863	–	then IBX will attempt to post any unsaved changes before the dataset is closed
864	–	(and after the BeforeClose event handler is called). The exception is when the
865	–	dataset is being closed as a result of a transaction rollback. In this case,
866	–	no action is taken and any unsaved  changes are discarded. This avoids both
867	–	unnecessary overhead and the risk that a validation error may occur in the Post
868	–	raising an exception and thereby preventing a rollback.
869	–
870	–	6.  String Field sizes and Display Widths should now be correct for multi-byte character sets.
871	–	In earlier versions, the Display Width was set to the maximum byte width rather than the character
872	–	width. Display Widths are now corrected by dividing by the max byte width per character.
873	–	For UTF8 character sets, the byte width is four and hence the Display Width will be
874	–	the byte width divided by 4. The byte width of each character set is determined
875	–	dynamically when the database connection is estabished from the RDB$CHARACTER_SETS
876	–	system table. (see also http://bugs.freepascal.org/view.php?id=27766).
877	–
878	–	7.  SQLParser will now correctly parse SQL Text which contains ':' within quoted string.
879	–
880	–	8.  IBLookupComboEditBox: List should now always be restored to full list when the
881	–	control loses focus. Default Key press default interval reduced to 200ms.
882	–
883	–	9.  DBControlGrid: Ensure that selection is changed to newly appended row, even
884	–	when dataset rows are less than visible rows.
885	–
886	–	10. IBDynamicGrid: Editor Panel is not shown on indicator click if Datasource
887	–	does not exist or DataSet is empty. More responsive on dataset open. New event
888	–	OnRestorePosition. Column sort disabled if no header row.
889	–
890	–	11. IBTreeView: improved handling of response to "Add Node". Avoid scrolling dataset
891	–	while dataset state is dsInsert. Avoids posting errors.
892	–
893	–	12. IBControls: New mechanism for distributing UpdateSQL and UpdateParams events. This is to
894	–	avoid conflict with DisableControls/EnableControls with Master/Detail linked tables.
895	–
896	–	13. IBLookupComboEditBox: Now avoids SQL Errors when combo box text contains single quotes.
897	–
898	–	14. TIBDataSet and TIBQuery: new Event - OnValidatePost. This event has been introduced
899	–	to solve a specific problem. That is when the dataset cursor is moved (e.g. by
900	–	a grid mouse click and the current row is being edited or inserted. In this case, TDataset
901	–	always "posts" the current record regardless or whether or not it may be more appropriate
902	–	to cancel any changes; the post occurs before the "BeforeScroll" event fires due to the way the
903	–	"MoveBy" function is implemented by TDataSet. The OnValidatePost event is called
904	–	as the first action of the "Post" method and allows the handler to convert the Post
905	–	into a Cancel if that is the appropriate action on moving to a different row. This is
906	–	achieved by returning with "CancelPost" argument set to true. Note that an exception could be
907	–	raised here, but it may still be more appropriate to validate a post and signal
908	–	a problem in the "BeforePost" event handler. See readme.automaticposts.xhtml)
909	–
910	–	15. On Unix derived systems, the Firebird library name can now be given as a colon
911	–	separated list. Each library name on the list is tried in turn, in left to right
912	–	order with the first found being used as the firebird library. By default, on Linux,
913	–	the library name list is 'libfbembed.so.2.5:libfbembed.so.2.1:libfbclient.so.2'. This can be
914	–	overidden by the FBLIB environment variable or the OnGetLibraryName function.
915	–
916	–	Note: when using the libfbembed.so, if you prefix the database name with "localhost:"
917	–	then it will still attempt to access the database via the Firebird Server and will
918	–	require a username and password. If only the pathname is given, then the username
919	–	and password should be omitted and the unix file permissions are used to grant
920	–	access.
921	–
922	–	IBX Change Log  version  (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
923	–
924	–	1.  A new IBControl - TDBControlGrid has been added. TDBControlGrid a lookalike
925	–	rather than a clone for the Delphi TDBCrtlGrid. TDBControlGrid is a single column grid
926	–	that replicates a TWinControl - typically a TPanel or a TFrame in each row. Each row
927	–	corresponds to a row of the linked DataSource. Any data aware control on the
928	–	replicated (e.g.) TPanel will then appear to have the appropriate value for the row.
929	–
930	–	2. As suggested by Julio Jiménez, a new property "SQLHourGlass" has been added to TIBDatabase.
931	–	When set to false (default true), the Hour Glass cursor is supcpressed and no cursor change
932	–	takes place during database access. This may be useful when there are performance issues with
933	–	the change of cursor. Setting the property to false suppresses the change of cursor.
934	–
935	–	3. As suggested by Julio Jiménez, a new property "AutoCommit" has been added to TIBDataSet, TIBQuery
936	–	and TIBTable. When set to acCommitRetaining (Default: acDisabled), a call is made to
937	–	Transaction.CommitRetaining immediately after every Post or Delete. This has the effect of
938	–	making all changes permanent immediately rather than when the transaction is explicitly
939	–	committed.
940	–
941	–	4. Experimental support for the Firebird 3 SQL_BOOLEAN type has been added while still
942	–	using the legacy Firebird API. Thanks to Gabor Boros for helping to test this feature.
943	–
944	–	IBX Change Log  version      (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
945	–
946	–	Development version only.
947	–
948	–	IBX Change Log  version   (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
949	–
950	–	1. An internal select SQL Parser is now available for TIBCustomDataset descendents.
951	–	This is typically used during an "OnBeforeOpen" event handler to manipulate the
952	–	"Where" and "Having" clauses to implement user specified filters of arbitrary
953	–	complexity.
954	–
955	–	2. A new Component Palette entry "Firebird Data Controls" is now available. This has
956	–	three new data aware controls dependent on IBX and which make use of the SQL Parser.
957	–	These are:
958	–
959	–	- TIBLookupComboEditBox
960	–	- TIBDynamicGrid
961	–	- TIBTreeview
962	–
963	–	TIBLookupComboEditBox is a TDBLookupComboBox descendent that implements "autocomplete"
964	–	of typed in text and "autoinsert" of new entries. Autocomplete uses SQL manipulation
965	–	to revise the available list and restrict it to items that are prefixed by the
966	–	typed text (either case sensitive or case insensitive). Autoinsert allows a
967	–	newly typed entry to be added to the list dataset and included in the available
968	–	list items.
969	–
970	–	TIBDynamicGrid is a TDBGrid descendent that provides for:
971	–	- automatic resizing of selected columns to fill the available row length
972	–	- automatic positioning and sizing of a "totals" control, typically at the
973	–	column footer, on a per column basis.
974	–	- DataSet resorting on header row click, sorting the dataset by the selected column.
975	–	A second click on the same header cell reversed the sort order.
976	–	- Support for a "Panel Editor". That is on clicking the indicator column, the row
977	–	is automatically expanded and a panel superimposed on it. The panel can have any
978	–	number of child controls, typically data aware controls with the same datasource
979	–	as the grid allowing for editing of additional fields and more complex editors.
980	–	- Reselection of the same row following resorting.
981	–	- A new cell editor that provides the same functionality as TIBLookupComboEditBox.
982	–	Its properties are specified on a per column basis and allows for one or more
983	–	columns to have their values selected from a list provided by a dataset.
984	–	Autocomplete and autoinsert are also available. The existing picklist editor
985	–	is unaffected by the extension.
986	–
987	–	TIBTreeView is a data aware TCustomTreeView.
988	–
989	–	3. When getting a field value using FieldByName.AsVariant, an SQL_INT64 with a
990	–	zero scale will no longer return an error. An Int64 will be returned instead.
991	–
992	–	4. TIBTransaction now has events for Before and After Transaction End and a new function
993	–	"GetEndAction" allowing the EndAction to be accessed by these event handlers.
994	–
995	–	5. TIBQuery can now handle correctly queries which contain the same keyword parameter
996	–	repeated multiple times.
997	–
998	–	6. TIBUpdateSQL will no longer return an error when "RowsAffected" is <> 1. This error
999	–	check used to get in the way of using Stored Procedures, and "Update or Insert"
1000	–	statements.
1001	–
1002	–	7. Insert, Modify and Delete property Editors now support Query Generation from
1003	–	Stored Procedures.
1004	–
1005	–	8. Three new examples illustrate the use of the new IB Controls
1006	–
1007	–
1008	–	IBX Change Log  version  (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
1009	–
1010	–	1. TIBXSQLVAR code clean up and optimisation to improve client side "prepare" and parameter
1011	–	setting performance. See "readme.field+param.names in the doc folder.(Thanks to
1012	–	Gabor Boros for reporting this problem and for testing the improvements).
1013	–
1014	–	2. IBX can now support dialect 3 quoted column names that contain spaces and which differ only in their case.
1015	–	See readme.field+param.names in the doc folder.
1016	–
1017	–	3. IBX SQL Editors will now automatically add double quotes around column names when the database
1018	–	dialect is "3" and the column name contains spaces or is a Firebird 2.5 SQL Reserved Word.
1019	–
1020	–	4. Param Type LargeInt now supported in TIBQuery and TIBStoredProc
1021	–
1022	–	5. TIBSQL.ExecQuery retry on failure removed to avoid problems with "at most once"
1023	–	actions.
1024	–
1025	–	6. TIBTransaction.SetDefaultDatabase uses SetObjectProp instead of mis-using SetOrdProp (with
1026	–	thanks to Yuriy Kopnin for pointing this out).
1027	–
1028	–	7. GenerateParamName is now a published property of TIBSQL, TIBQuery and TIBDataSet.
1029	–
1030	–	8. varWord, varShortInt and varInt64 added to TIBXSQLVAR.SetAsVariant and hence now available as variant types
1031	–	for both fields and parameter setting.
1032	–
1033	–	9. Changes to the Select SQL in an IBCustomDataset descendent should now be
1034	–	visible in the Fields Editor immediately afterwards - rather than only after cycling the "active" property.
1035	–
1036	–	10. TIBSQL SQL editor will operate correctly and not report an SQL syntax error on SQL test,
1037	–	when DSQL ('?') parameter placeholders are used and the TIBSQL.GenerateParamNames property is set to true.
1038	–
1039	–	11. TIBTable now has a property editor for "MasterFields"
1040	–
1041	–	12. SQL Property Editors now include a checkbox "Allow DSQL Placeholder". This corresponds to the
1042	–	GenerateParamNames property and should be set when using DSQL (i.e. '?') style parameters.
1043	–
1044	–	13. The IBTransaction editor now has a radio button ("Unspecified") which is set when the combination
1045	–	of settings is unrecognised. Selecting this radio button has no effect on the settings.
1046	–
1047	–
1048	–	IBX Change Log  version                 (1.0-5) Sat, 28 Dec 2013 19:22:23 +0000
1049	–
1050	–	1. TBookmark change conditional compile changed to >= 2.7.0 to match revised availability of change.
1051	–
1052	–	IBX Change Log  version          (1.0-4) Thu, 28 Feb 2013 16:56:13 +0000
1053	–
1054	–	1. In a TIBCustomDataset descendent, a generator now only sets the value when
1055	–	it is null. This allows for alternative user defined setting of the generator
1056	–
1057	–	Many thanks to Julio Jiménez for this fix
1058	–
1059	–	2. An Error Dialog is now displayed in the Lazarus IDE if IBX cannot find the Firebird Library
1060	–	and suggests that the user may have forgotten to install it.
1061	–
1062	–	IBX Change Log  version         (1.0-3) Thu, 22 Nov 2012 22:53:39 +0000
1063	–
1064	–	1. Conditional compilation used to limit registration of TIntegerField to
1065	–	Lazarus versions less than 1.1
1066	–
1067	–	2. When a database connection is created, character set is now by default set
1068	–	to UTF8 (Unix) or to the current Windows code page (Windows) if in the range
1069	–	1250 to 1254.
1070	–
1071	–
1072	–	IBX Change Log  version     (1.0-2) Tue, 09 Oct 2012 09:10:30 +0100
1073	–
1074	–	1. TBookmark change conditional compile changed to > 2.6.2 to match expected availability of change.
1075	–
1076	–
1077	–	IBX Change Log  version    (1.0-1) Sun, 05 Aug 2012 20:00:04 +0100
1078	–
1079	–	1. In IBCustomDataset. Changed CurBookmark from string to TBookmark for compiler versions > 2.6.0
1080	–	Necessary because of TBookmark type and TDataSet.Bookmark property change in fpc 2.7.1
1081	–
1082	–	2. IBX now registers TIntegerField as a "No Icon" component. This may be removed if the fpc DB
1083	–	package is changed to do this (which it should do).
1084	–
1085	–	IBX Change Log  version (1.0-0)  Sat, 28 Apr 2012 16:43:00 +0100
1086	–
1087	–	1. Add "if active then active := false" to TIBCustomDataset destructor. (Avoid error on database close).
1088	–
1089	–	2. Make use of $STATIC conditional in IBSQLMonitor (Needed for FPC 2.6.0 compliance)
1090	–
1091	–	3. Database Property Editor: Character Set drop down box now uses "OnChange" rather than "OnCloseUp" to react to changes
1092	–
1093	–	4. Property editors should now correctly resize.
1094	–
1095	–	5. In IBDatabaseEdit.TestClick, the LoginPrompt is now set to the state of the LoginPrompt Checkbox
1096	–	(restored original functionality)
1097	–
1098	–	6. Under OSX, if IBX fails to load libfbclient.dylib, it will now try and load the firebird
1099	–	library using the absolute path /Library/Frameworks/Firebird.framework/Firebird.

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines