ViewVC Help

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

root/public/ibx/trunk/changelog

Comparing ibx/trunk/changelog (file contents):
Revision 303 by tony, Fri Jul 17 22:29:57 2020 UTC vs.
Revision 380 by tony, Mon Jan 10 10:13:17 2022 UTC

#	Line 1 | Line 1
1	<	FBINTF Change Log  version          (1.1-6 Build 12214) Fri, 17 Jul 2020 23:10:11 +0100
1	>	IBX Change Log  version (2.5-0 Build 12933) Mon, 29 Nov 2021 14:59:54 +0000
2
3	<	1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
4	<	with a Firebrid 3 client library.
3	>	1. IBCustomDataset: Modify TISQL component now defaults to GoToFirstRecordOnExecute := true.
4	>	This is for compatibility with Firebird 5 where Update...Returning can return
5	>	a cursor.
6
7	<	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.
7	>	IBX Change Log  version (2.4-3 Build 12886) Sat, 23 Oct 2021 14:58:30 +0100
8
9	<	3.  IUtil.FormatStatus now used to format error messages when using new API
9	>	1. Add try-..except check when initially loading library in IDE. This should
10	>	ensure that IDE continues to load even when a failure occurs in IBX load
11	>	library.
12
13	<	4.  Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
13	>	2. IBXScript: now recognises a CASE...END block within a stored procedure and
14	>	hence will correctly detect end of the outer containing block when the block
15	>	contains a SELECT ... CASE ... END construct.
16
17	<	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.
17	>	3. IBExtract: some further tidying up to remove extraneous white space.
18
19	<	6.  New IFirebirdAPI Calls:
20	<	function GetClientMajor: integer;
25	<	function GetClientMinor: integer;
19	>	4. IBCustomDataSet: DefaultFieldClasses array declaration updated to avoid compile time
20	>	errors when extra elements are added to DB.TFieldType.
21
22	+	5. IBUpdate: updated to reflect changes to ISQLParam.
23
24	<	FBINTF Change Log  version          (1.1-5 Build 12044) Fri, 17 Apr 2020 12:30:01 +0100
24	>	6. IBXScript: now correctly parses a DECLARE statement which includes a quoted string.
25
26	<	1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
31	<	case sensitive
26	>	7. IBExtract: for ODS >=13, increment generator value by one for ALTER SEQUENCE statement.
27
28	<	2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
28	>	8. IBSQL: Support for scrollable cursors added (note: local databases only)
29
30	<	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)
30	>	IBX Change Log  version (2.4-2 Build 12773) Mon, 23 Aug 2021 11:59:42 +0100
31
32	<	4. FBMessages: removal of unused messages
32	>	1. TIBDatabaseInfo: review and tidy-up of property types. Most widen to int64 with the
33	>	exception of those defined to be one byte wide e.g. DBImplementationNo.
34
35	<	5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
35	>	2. TIBSQL: Batch Update/Insert support added.
36
37	<	6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
37	>	3. TIBStoredProc: when generating the SQL, the value of the StoredProcName property
38	>	is no longer automatically converted to upper case when it is syntactically a
39	>	SQL Identifier. This is to support the use of stored procedures defined e.g.
40	>	as CREATE PROCEDURE "iCASE".
41
42	<	FBINTF Change Log  version          (1.1-4 Build 11515)  Fri, 28 Dec 2018 10:04:19 +0000
42	>	There could be a backwards compatibility issue when the StoredProcName was entered
43	>	manually at design time. That is not selected from the drop down list. If the
44	>	StoredProcName is entered in mixed case and the procedure was declared e.g. as
45	>	CREATE PROCEDURE iCASE, then the SQL generation will be incorrect. You should
46	>	ensure that the value of the StoredProcName is all upper case, unless it was
47	>	declared under dialect 3 and explicitly as mixed case (i.e. delimited by double
48	>	quotes).
49
50	<	1. Fix a problem with the SQL parameter parser that failed to recognise parameters
51	<	where the second character of the parameter name is a numeric.
50	>	Note that when a stored procedure name was declared delimited in double quotes,
51	>	as in the first example above, the value of the StoredProcName property must not
52	>	include the delimiters (double quotes).
53
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.
54	>	4. IBXUpgradeConfFile: an exception is now raised if a patch file specified in
55	>	upgrade.conf was not found. This replaces silently ignoring the problem.
56
57	<	3. If -dFIREBIRD3APIONLY is used as a compiler option then the legacy Firebird API
58	<	is no longer compiled in. Likewise, if -dLEGACYFIREBIRDAPIONLY is used as a
59	<	compiler option then the Firebird 3 API is no longer compiled in.
57	>	5. TIBLocalDBSupport: new property "SectionHeaderTemplate". This defaults to
58	>	'Version.%.3d' and is used to generate the section header names (for a given
59	>	version no.) in the upgrade.conf file.
60
61	<	4. IColumnMetaData: new method.
61	>	IBX Change Log  version (2.4-1 Build 12550) Wed, 23 Jun 2021 13:59:14 +0100
62
63	<	TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
64	<	dfDateTime,   {SQL DATETIME}
66	<	dfTime);
63	>	1. -c command line option added to fbsql example program. Used to set connection
64	>	character set.
65
66	<	function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
66	>	IBX Change Log  version (2.4-0 Build 12543) Mon, 22 Feb 2021 11:00:08 +0000
67
68	<	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.
68	>	1. Firebird 4 support added.
69
70	<	5. Additional argument for IAttachment.PrepareWithNamedParameters -
71	<	CaseSensitiveParams: boolean = false
70	>	2. New FB4 data types TIME WITH TIME ZONE, TIMESTAMP WITH TIME ZONE, DECFLOAT and
71	>	extended precision NUMERIC fields are supported.
72
73	<	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.
73	>	3. TFmtBCDField is used to support access to DECFLOAT and extended precision NUMERIC fields.
74
75	<	6. Bug fix: when setting a query parameter, it is now possible, when the parameter
76	<	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.
75	>	4. TIBDateTimeField and TIBTimeField are introduced in support of TIMESTAMP WITH TIME ZONE
76	>	and TIME WITH TIME ZONE fields. These inherit from TDateTimeField.
77
78	+	5. IBExtract now supports FB4 enhancements:
79	+	- new data types as above
80	+	- Identity column extensions
81	+	- Default user role
82	+	- SQL Security clause for Database, Tables, Procedures, Functions and Triggers
83	+	- Internal Functions
84
85	+	6. IBExtract: new event: OnExtractLines.
86
87	<	FBINTF Change Log  version                  (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
87	>	7. IBExtract: revert create trigger to legacy syntax see Firebird CORE-6243, CORE-5545 and DOC-145
88
89	<	1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
89	>	8. IBXServices: Server version no. parsing now allows any letter before major version number
90	>	and is no longer restricted to 'V' e.g. "LI-T4.0.0.1436 Firebird 4.0 Beta 1"
91
92	<	2. Restrict IsMultiThread check to Unix only for compatibility with
93	<	https://bugs.freepascal.org/view.php?id=30535
92	>	9. TIBDataSet and TIBQuery: new property TZTextOption. Used to determine the default
93	>	format for rendering a time zone.
94
95	<	3. New SQL Tokeniser added to IBUtils. This is used to pre-process SQL with
96	<	named parameters and is intended to avoid problems with (e.g.) Execute Block
96	<	and processing internal parameters as statement parameters.
95	>	10. TIBDataSet and TIBQuery: new property DefaultTZDate. Used to provide the default date
96	>	to convert TIME WITH TIME ZONE data type values to and from GMT.
97
98	<	4. New interface IFirebirdLibrary provides access to the underlying firebird DLL
99	<	or shared object. Available via a new member (GetFBLibrary) of IFirebirdAPI.
98	>	11. Unit name IBTypes changed to IBInternals. Internal interfaces TIBGUIInterface and TIBTimerInf renamed to
99	>	IIBGUIInterface and IIBTimerInf respectively.
100
101	<	5. New function added to IB.pas
101	>	12. Constants: DPBPrefix and TPBPrefix moved to IB unit. DPBConstantNames and TPBConstantNames
102	>	now accessible as properties of TIBDatabase and TIBTransaction respectively.
103
104	<	function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
104	>	13. String Fields: when a fixed character with (CHAR) field is returned, it is now
105	>	truncated to its fixed character width rather than being right padded with
106	>	white space to the maximum data size.
107
108	<	This allows a Firebird Library to be loaded from an explicit path. use the
109	<	IFirebirdLibrary.GetFirebirdAPI member function to get the Firebird API using
110	<	the library. It is possible to load Firebird libraries from different locations
108	<	simultaneously, each with a distinct IFirebirdAPI.
108	>	14. TIBTable.Empty table. In additional to deleting all records in the underlying
109	>	table, the internal buffers are now also flushed ensuring that the TIBTable is
110	>	also empty.
111
112	<	FBINTF Change Log  version               (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
112	>	15. TBatchSQLStatementReader: Line buffer is now cleared on call to reset.
113
114	<	1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
115	<	program compiled with -CR command line switch.
114	>	16. TIBXControlService descendents: DatabaseName may now be set using a database
115	>	connect string. The database name is extracted from the connect string.
116
117	<	2. IServiceManager additions (informational):
116	<	function getProtocol: TProtocol;
117	<	function getPortNo: AnsiString;
117	>	17. DBControlGrid: Minor bug fixes. avoid AV on form closure, avoid black panel
118
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;
119	>	18. TIBExtract: Data type of COMPUTED By columns is no longer included in SQL.
120
121	<	4. IAttachment addition (informational)
122	<	function GetSecurityDatabase: AnsiString;
121	>	19. Local database on Linux and with legacy API and FB 2.5 embedded server: fixed problem with password
122	>	not being present as required.
123
124	<	5. IStatement: performance counters now updated after each Fetch. GetPerfStatistics
125	<	thus now returns accumulated stats for a select statement from opening a cursor
129	<	up to the last fetch.
124	>	20. IBTreeView split into DBTreeView and IBTreeView. This former is an IBX indepedent
125	>	version that can be customised to work with other database drivers.
126
127	<	6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
128	<	the problem.
127	>	21. ISQLMonitor: use platform specific LineEnding to delimit messages. Avoids
128	>	unnecessary CR at end of line on Unix platforms.
129
130	<	7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
131	<	replaces deprecated "comp" type.
130	>	22. ISQLMonitor: Unix: Default semaphore timeout increased from 1 second to 10
131	>	seconds in order to reduce risk of message loss.
132
133	<	10. Testsuite Test10 updated to include thread synchronisation for event reporting.
133	>	23. ISQLMonitor: read and write count statistics now available via:
134	>	property TIBSQLMonitor.ReadCount;
135	>	IIBSQLMonitorHook.GetWriteCount: integer;
136
137	<	11. URL Connection Strings: inet4 and inet6 now recognised.
137	>	24. ISQLMonitor tidy up and unit split. IPC functions moved to new unit IBIPC.
138
139	<	12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
139	>	IBX Change Log  version (2.3-5 Build 12350) Tue, 25 Aug 2020 16:11:02 +0100
140
141	<	13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
141	>	1.  TIBStringField: when a string value is read from a dataset buffer, if the
142	>	number of UTF8 characters exceeds the string size then string is truncated
143	>	to the maximum string size. This is  usually a problem with fixed width columns
144	>	right padded with white space.
145
146	+	2.  SQLFiltered and SQLFilterParams added to TIBQuery, TIBTable and TIBDataset.
147	+	If SQLFiltered is set then when a dataset is opened, each line in the
148	+	SQLFilterParams property is assumed to be a SQL condition clause and
149	+	ANDed into the Where clause of the SQL Select statement provided as a
150	+	dataset property. Each such SQL condition thus acts as an additional filter
151	+	on the dataset.
152
153	<	FBINTF Change Log  version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
153	>	3.  The Filtered property inherited from TDataset is no longer used for SQL (server
154	>	side filters).
155
156	<	1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
156	>	4. IBLookupComboEditBox: Selection should no longer reset to start of text when
157	>	text matches complete entry.
158
159	<	2. IAttachment: add two new methods
160	<	function HasDefaultCharSet: boolean;
152	<	function GetDefaultCharSetID: integer;
159	>	5. TIBDataLink: Detail Dataset params not refreshed unless both master and detail
160	>	dataset are active (avoids risk of access violation if master is inactive)
161
162	<	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.
162	>	6. TIBEvents: Registered property can now be set at design time even if database not open
163
164	<	3. Avoid exception when a text blob is a stored procedure parameter.
164	>	7. TIBEvents: component now correctly re-initialised after call to UnregisterEvents.
165	>	This should prevent "spillover" of events between sessions.
166
167	<	4. Update test suite to include a test for a stored proc returning a text blob.
167	>	8. TIBCustomDataset: GetNextRecord now called when reseting to first record of a unidirectional dataset.
168	>	This should ensure that the internal buffer is set up correctly and avoids
169	>	a duplicate initial row.
170
171	<	5. IAttachment: add
172	<	function GetRemoteProtocol: AnsiString;
173	<	function GetODSMajorVersion: integer;
174	<	function GetODSMinorVersion: integer;
167	<	function GetAuthenticationMethod: AnsiString;
171	>	9. TIBStringField: DataSize now given as byte size of string less trailing any zero character.
172	>	That is, the DataSize should be the field size * character set width. The
173	>	value returned by DataSize is now the same as the Dataset buffer size reserved
174	>	for the field.
175
176	<	These results are cached when the connection is opened and hence do not
170	<	require a database lookup.
176	>	10. IBExtract: Tidyup of SQL generation. Avoid unnecessary double quotes.
177
178	<	6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
179	<	connect string used to create/connect to the database.
178	>	11. TIBCustomDataset: Add checks on buffer sizes when copying data from row to field buffer
179	>	and vice-versa. This may result in an exception being raised (correctly) for
180	>	older programs when using dataset fields added to a form and the database has been
181	>	upgraded. For example, computed fields can change from 32-bit to 64-bit integers.
182	>	In such cases, the field needs to be deleted in the IDE fields editor and then
183	>	added back in.
184
185	<	7. IAttachment: Create Database using SQL statement. The username and password
186	<	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.
185	>	12. IBCustomDataSet: CanInsert, CanEdit, CanDelete and CanRefresh updated to return
186	>	false if query contains only white space and not just empty.
187
188	<	8. Update Test 1 to test 5, 6 and 7 above.
188	>	12. IBCustomDataset: Blob data is now cleared when TDataSet.Cancel is called. This
189	>	should ensure that (e.g.) a TDBMemo is correctly refreshed after a dataset edit
190	>	is cancelled.
191
192	<	9. IBUtils code tidy up.
192	>	13. IBCustomDataset: SetArrayIntf should no longer cause an access violation if
193	>	called on a null field.
194
195	<	10. Parameter Block interfaces "find" method. As documented, this should have
196	<	returned a nil interface when the item could not be found. Instead, an empty
197	<	interface item was returned. "Find" now works as documented and will return
188	<	a nil interface if the item cannot be found.
195	>	14. IBCustomDataSet: An access violation should no longer occur when calling CancelUpdates
196	>	results in an empty dataTC86                Client side Filtered Dataset    1       X
197	>	set.
198
199	<	11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
199	>	15. IBCustomDataSet: OnUpdateError should now be called in all circumstances when
200	>	a cached update is applied and an exception is raised.
201
202	<	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.
202	>	16. IBCustomDataSet: Avoid access violation when SetBookmarkData called with nil pointer.
203
204	<	13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
198	<	test suite updated.
204	>	17. Console Mode Local Database support: backup/restore should now work correctly.
205
206	<	14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
207	<	a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.
206	>	18. Local Database Support: if an upgrade fails, a downgrade is now performed if
207	>	possible and an exception raised.
208
209	<	15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
210	<	An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
205	<	default connection port to be specified.
209	>	19. MinimumVersionNo added to Local Database Support. Database will not open if
210	>	below this version no. and upgrade not possible.
211
212	<	FBINTF Change Log  version                             (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
212	>	IBX Change Log  version (2.3-4 Build 12041) Fri, 17 Apr 2020 14:00:32 +0100
213
214	<	1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
215	<	Scale is no longer ignored.
214	>	1.  TIBXDataSet and Generators: Generator Names that are not all upper case or
215	>	not SQL Identifiers are now supported.
216
217	<	2. Fix issues with setting SQL Param values using SetAsString with Date values
218	<	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.
217	>	2.  TIBXScript: Set Generator is no longer rejected as unrecognised SQL and is
218	>	passed to the Firebird engine for execution.
219
220	<	3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
221	<	UTF8 and not UNICODE_FSS.
220	>	3.  TIBDataSet: Unidirectional datasets now give an error message if an attempt
221	>	is made to scroll back.
222
223	<	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.
223	>	4.  New unit: IBMessages.pas. Contains only messages used by IBX and not FBIntf
224
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.
225	>	5. TIBLookupComboEditBox: When generating auto-complete SQL, the ListField is now
226	>	only enclosed in double quotes in SQL dialect 3 and when it needs to be.
227
228	<	6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
229	<	set supported by Firebird with the API.
228	>	6. TIBLookupComboEditBox: when the list source opens, the ListField name is now
229	>	validated. If no match is found in the list of field names and the database has
230	>	been opened in SQL Dialect 3, then the ListField Name is converted to upper case
231	>	if it then matches a field name. Otherwise, a Listfield not valid exception occurs.
232
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.
233	>	7. IBGeneratoreditor.pas: Add missing parenthesis around "IS" statement for compliance
234	>	with fpc 3.2.
235
236	<	8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
236	>	IBX Change Log  version (2.3-3 Build 11512) Fri, 28 Dec 2018 10:04:17 +0000
237
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.
238
239	<	10. Testsuite: Ensure consistent UTF-8 output on Windows console.
239	>	1. New property for TIBDatabase and TIBXServicesConnection. This is "ConfigOverrides"
240	>	and is used to override the default settings in the client side "firebird.conf" This
241	>	includes "WireCompression" and "WireCrypt". The value of this property is a "TStrings".
242	>	Each line of the string list should be a setting in the same format as "firebird.conf".
243	>	For example "WireCompression = true" in order to request wire compression on the client side.
244
245	<	11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
245	>	Note: explicit settings in the client side "firebird.conf" appear to take precedence
246	>	over settings given in TIBDatabase and TIBXServicesConnection. Many client side settings
247	>	also require a compatible setting in the server side "firebird.conf". For example
248	>	"WireCompression = true" must also be set in the server's "firebird.conf" for wire
249	>	compression to be used.
250
251	<	12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
251	>	Whether or not WireCompression or WireCrypt are in use can be checked using the information
252	>	returned with the Client/Server protocol version. See ibx/examples/dbadmin and
253	>	ibx/examples/dbinfo for examples of how to display this information.
254
255	<	13. FB30Statement: A check has been added to ensure that all SQL Parameters
256	<	have been given a value (including NULL). Previously, failing to set the
257	<	value of an SQL Parameter could give rise to unpredictable results or
252	<	an SQLDA error.
255	>	2. New property for TIBDatabase and TIBXServicesConnection: "WireCompression". This
256	>	is a "convenience" property. If set the "WireCompression=true" is added to the
257	>	ConfigOverrides. If unchecked then this setting is removed.
258
259	<	14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
259	>	3. TIBExtract: 64-bit integer types are now correctly extracted as "BIGINT" and
260	>	not "INT64".
261
262	<	15. FBAttachment: Avoid string reference count error when processing an Ansistring
263	<	parameter in an array of const passed to IAttachment.OpenCursor, etc.
262	>	4. New published properties for TIBCSVDataOut, TIBInsertStmtsOut and TIBBlockFormatOut
263	>	These are:
264	>	property TimestampFormat: string;
265	>	property DateFormat: string;
266	>	property TimeFormat: string;
267
268	<	16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
269	<	of const passed to IAttachment.OpenCursor, etc.
268	>	Respectively, these provide the date time format templates for SQL types: TIMESTAMP,
269	>	DATETIME and TIME. The format strings use the standard FPC date/time format
270	>	characters (see https://www.freepascal.org/docs-html/rtl/sysutils/formatchars.html).
271
272	+	If any of the above properties are set to an empty string, then the locale default
273	+	is used. This uses the ShortDateFormat and the LongTimeFormat. In timestamp, the
274	+	locale default is extended by appending '.zzz' to include milliseconds.
275
276	<	FBINTF Change Log  version             (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
276	>	TIBCSVDataOut by default sets these properties to the empty string, while the other
277	>	two use: 'yyyy.mm.dd hh:nn:ss.zzz', 'yyyy.mm.dd' and 'hh:nn:ss.zzz' respectively.
278
279	<	1. Change syntax to Mode Delphi
279	>	5. New published property for TIBCSVDataOut:
280	>	property QuoteStrings: boolean (default true)
281
282	<	2. Change all uses of string type to explicit AnsiString in order to ensure
283	<	compatibility between Delphi and FPC.
282	>	If false then strings are unquoted, otherwise, the QuoteChar property value is
283	>	used to delimit each and every string in the output.
284
285	<	3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
286	<	defined for each interface.
285	>	6. New published properties for TIBCSVDataOut:
286	>	property FieldSeparator: string;
287	>	property HeaderSeparator: string;
288
289	<	4. Generics syntax variations for Delphi added
289	>	Respectively, these provide the separator character(s) used to separate fields
290	>	in data and header rows. Both default to ','.
291
292	<	5. PChar replaced with PByte expect where an actual string is being referenced,
293	<	where PAnsiChar is used instead.
292	>	7. New published properties for TIBCSVDataOut and TIBBlockFormatOut:
293	>	TOnFormatTextString = procedure(sender: TObject; var TextString: string) of object;
294	>	property OnFormatTextString;
295
296	<	6. Review of type definitions in IBExternals to ensure Delphi compatibility
296	>	This event handler can be used to process text strings before they are included
297	>	in the output e.g. to replace unprintable characters with alternative strings.
298	>	This only applies to columns with an SQL Type of SQL_VARYING and SQL_TEXT.
299
300	<	7. Testsuite updated for Delphi
300	>	8. TIBDataSet now raises an exception when ParamByName called with an invalid parameter name.
301	>	Uses "FindParam" if in order to find out if a parameter with a given name exists
302	>	and without raising and exception if it does not.
303
304	<	FBINTF Change Log  version            (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
304	>	9. TIBQuery now uses IBX SQL Parser instead of the TParams SQL parser in order to ensure
305	>	consistency with SQL queries.
306
307	<	1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
308	<	large blobs and the FB3 API.
307	>	10. CaseSensitiveParameterNames property added to TIBSQL, TIBDataSet and TIBQuery.
308	>	When true, SQL statement parameter names are parsed case sensitive. Note for
309	>	TIBDataSet only applies to Select query.
310
311	<	2. Update Event Handling algorithm to avoid looping due to recreation of the
312	<	event block.
311	>	11. IBEvents: removing a TIBEvent component from a form should no longer result in
312	>	an IDE exception.
313
314	<	3. Avoid invalid XSQLDA error when the only parameter is updated to null
314	>	12. LocalDBSupport: initial database creation should now work correctly
315	>	when the schema source is an sql file.
316
317	<	4. Array Handling: fix problem with text arrays with character set none. When the
318	<	DB connection has a default character set (e.g. UTF8), an error is raised by
319	<	Firebird if the space allocated is not enough to allow for transliteration, even
320	<	though it is not required for character set none.
317	>	13. TIBCMLocalDBSupport: new event handler "property OnProgressEvent: TOnProgressEvent"
318	>	when defined, this handler will be called by the internal TIBXScript during
319	>	initial database creation when the schema source is an sql file and may be used
320	>	to provide a visual indication of progress in console mode.
321
322	<	5. IBUtils: List of reserved words brought up-to-date
322	>	14. TCustomIBLocalDBSupport: new public property "InOnCreateDB: boolean". This is set
323	>	to true while a new local database is being created and its schema populated.
324	>	Useful in (e.g.) TIBDatabase.OnAfterConnect handler to suppress actions
325	>	when the database is disconnected/connected during the create DB procedure.
326
327	<	6. Add ISQL style performance statistics collection to IStatement
327	>	15. TIBXScript: any User/password parameters found in a CREATE DATABASE statement
328	>	are now always ignored and replaced by the user name and password provided as
329	>	the login parameters for the TIBDatabase referenced from the TIBXScript. The
330	>	IgnoreCreateDatabase property still applies and the CREATE DATABASE statement is
331	>	completely ignored if this property is true.
332
333	<	7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
334	<	CREATE DATABASE statement.
333	>	16. Code tidyup in IBTreeView: Node properties initialisation moved from TIBTreeView.AddNodes
334	>	to TIBTreeView.Added. An OnAddition event handler is no longer needed to initialise
335	>	ImageIndex and SelectImageIndex values on AddNode.
336
337	<	8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
338	<	an array dimension is not mistaken for a named parameter prefix.
337	>	17. TIBDatabase.Attachment and TIBXServicesConnection.ServicesIntf properties are now
338	>	read/write. This should enabled (e.g.) multiple instances of TIBDatabase to share
339	>	the same database connection.
340
341	<	9. Trim function no longer applied to result of GetAsString for SQL_TEXT
342	<	when Character set is octets. Avoids loss of non printable characters at start of string.
341	>	18. TIBDataSet and TIBQuery now support the TDataSet "Filter" property.
342	>	if provided, this should be an conditional SQL expression suitable for
343	>	including in an SQL Select statement "where" clause. If non-empty and the
344	>	"Filtered" property is true then the SQL expression provided as the value of
345	>	the "Filter" property is "ANDed" with any existing condition statement
346	>	in the SQL statement's "Where" clause.
347
348	<	10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
349	<	statistics for the last action. Requires use of procedure IStatement.EnableStatistics
312	<	to enable stats gathering.
348	>	If the "Filter" property is set at run time, the "Filtered" property is true
349	>	and the dataset is already open, then the dataset is closed and re-opened automatically.
350
351	<	11. API Version information added as constants to IB.pas
351	>	The "Filter" condition may include IBX style parameters. In which case, their
352	>	value must be set by the dataset's "OnBeforeOpen" event handler.
353
354	<	12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
354	>	This is a public property for TIBDataSet and TIBQuery query and intended for
355	>	use at run time.
356
357	<	13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
357	>	Note: The property is a published property of TIBTable. The TIBTable functionality
358	>	is unaffected by this change.
359
360	<	FBINTF Change Log  version                                      (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
360	>	IBX Change Log  version (2.3-2) Wed, 05 Dec 2018 12:19:23 +0000
361
362	<	1. Initial Release
362	>	1. Remove need to check for IsMultiThread by providing access to GUI timers via
363	>	IBGUIInterface. Note: master/detail delay timer does not apply to console
364	>	mode apps.
365
366	+	2. TIBCustomDataSet: SQLParser ignored if it does not contain a valid select
367	+	statement. This avoids problems if "Execute Block" is used as the Query.
368	+
369	+	3. IBSQLParser now uses the common SQL tokeniser from fbintf. This replaces the
370	+	internal SQL tokeniser routines.
371	+
372	+	4. IBSQLParser: new property NotaSelectStmt. Set to true if SQL fails to parse
373	+	as a select statement, with or without CTEs.
374	+
375	+	5. IBSQLParser: parser now recognises the "ROWS" clause.
376	+
377	+	6. TIBXScript now uses the common SQL tokeniser from fbintf. This replaces the
378	+	internal SQL tokeniser routines.
379	+
380	+	7.  Fix error in TIBXScript processing of "set" statements. This avoids exceptions
381	+	being raised for valid set statements processed by a data formatter.
382	+
383	+	8. New published property for TIBDatabase and TIBXServicesConnection. This is
384	+	FirebirdLibraryPathName: string. If not empty it is used to explicitly specify
385	+	the path of the Firebird Library used by the database/services connection.
386	+
387	+	9. New read only public property for TIBDatabase and TIBXServicesConnection. This
388	+	is FirebirdAPI and returns the IFirebirdAPI interface used by the database/
389	+	services connection.
390	+
391	+	10.SQL Property editors now quote parameter names if "Quote identifier" is selected
392	+	or param name is not a valid SQL identifier.
393	+
394	+	11. IBLookupComboEditBox: In Lazarus 2.0, TDBLookupComboBox takes a more restrictive
395	+	view of whether the text box should be editable when no DataSource is specified.
396	+	TIBLookupComboEditBox has been updated to workaround this problem. As long as
397	+	ReadOnly is false, the text box is editable when no DataSource is specified.
398	+
399	+	12. AllowUseOfFBLIB is now set to "true" at design time. This is to allow use of
400	+	the FBLIB environment variable. If you do not want to permit this then you
401	+	must modify the Register procedure in the design/IBDBReg.pas unit to remove
402	+	this setting.
403	+
404	+	IBX Change Log  version                 (2.3-1) Thu, 25 Oct 2018 14:39:45 +0100
405	+
406	+	1. IBCustomDataset: replace deprecated function ValidUTF8String with call to
407	+	Utf8EscapeControlChars
408	+
409	+	IBX Change Log  version                (2.3-0) Mon, 16 Apr 2018 09:48:06 +0100
410	+
411	+	IMPORTANT: the source code tree has been re-organised for IBX 2.3. Please remove
412	+	all previous copies of the IBX source code tree before installing this release.
413	+
414	+	The IBX packages used by most users have not changed, with one exception. The
415	+	IBServices unit has been moved to the package iblegacyServices.lpk. To continue
416	+	to use the IBServices unit in your applications, please add the iblegacyServices
417	+	to the list of dependencies. To do this, open the Project Inspector and select
418	+	Add->New Requirement and select "ibLegacyServices" from the list of available
419	+	packages.
420	+
421	+	1. New unit IBXServices. The IBXServices unit is a re-architectured update of
422	+	the IBServices unit providing what is intended to be a clearer and easier to
423	+	use set of IB Services components. See Chapter 10 of the IBX User Guide for
424	+	more information and the guide to "Firebird Service Management Using IBX".
425	+	As indicated above, the legacy services components are still available and
426	+	provided in a separate package. There is no need to update working applications
427	+	using the older versions except for an additional package dependency.
428	+
429	+	2. The IBX packages and source code tree have been re-organised in an attempt to
430	+	finally get rid of the "duplicate ppu" warnings. This re-organisation should
431	+	not affect existing users. Section 2.3 of the IBX User Guide describes the
432	+	new set of IBX packages.
433	+
434	+	3. The ibx/examples/DBAdmin and the ibx/examples/services example have been
435	+	updated to use the new Services API components.
436	+
437	+	4. The iblocal package has been updated to use the new Services API components.
438	+
439	+	5. procedure SetAutoAdmin; in the new IBX Services this method is now a member of
440	+	TIBXSecurityService. It had been wrongly classified in the previous version
441	+	as a per database configuration item. It is global to a server and hence
442	+	correctly positioned as part of the Security Package. In the DBAdmin example,
443	+	the setting has moved to the mappings page.
444	+
445	+	6. TIBXScript: IgnoreCreateDatabase added. If true then CREATE DATABASE statements
446	+	are ignored.
447	+
448	+	7. TIBDatabase: DropDatabase now ensures that all transactions have been properly
449	+	closed before the database is dropped. Before and After Disconnect event handlers
450	+	are also fired.
451	+
452	+	8. TIBTransaction: OnStartTransaction event now fires every time the transaction
453	+	is started and not just the first time.
454	+
455	+	9. IBDataOutput: Use FormatFloat for all performance statistics to avoid platform
456	+	depenendency with comp type.
457	+
458	+	10. IBDataOutput: select query data output is now sent to stdout instead of stderr.
459	+
460	+	11. TIBDatabase: Remove regression. If a user login dialog changes the DatabaseName
461	+	then this is recognised and not ignored.
462	+
463	+	12. TIBDataSet, TIBQuery, TIBTable: additions:
464	+	function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
465	+	function GetPerfStatistics(var stats: TPerfCounters): boolean;
466	+	property EnableStatistics: boolean read FEnableStatistics write SetEnableStatistics;
467	+
468	+	GetRowsAffected returns the affected row counts from the last insert/update/delete
469	+	if EnableStatistics = true then GetPerfStatistics returns the current stats
470	+	counters for the select query. Note: stats accumulate after each fetch from
471	+	the database. To get total query cost after open, call the "Last" method
472	+	and then GetPerfStatistics.
473	+
474	+	See ibx/examples/consolemode for an example of the use of GetPerfStatistics
475	+
476	+	13. TIBExtract: Identity columns DDL. "Start with clause" now correctly encapsulated
477	+	in parenthesises.
478	+
479	+	14. TIBExtract: new published property "AlwaysQuoteIdentifiers". If true then in dialect 3
480	+	SQL identifiers are always delimited by double quotes. If false, then they are
481	+	only delimited if the identifier is a reserved word, contains lower case or special
482	+	characters. Set this property to true to retain previous behaviour.
483	+
484	+	15. Insert SQL Property Editor. In Insert Returning Clause, Identity column names
485	+	are now inserted in double quotes if not Reserved Words or valid SQL Identifiers.
486	+
487	+	16. TIBDataSet, TIBQuery, TIBTable: addition:
488	+	property MasterDetailDelay: integer {defaults to zero}
489	+
490	+	When non-zero and the dataset is a detail table referencing a master table
491	+	through either a MasterSource (TIBTable) or a DataSource (TIBDataSet, TIBQuery)
492	+	then a synchronisation delay is added (in milliseconds) between the master
493	+	row changing and the detail dataset being re-opened. If the master dataset
494	+	is scrolled before the delay expires then the delay is reset. This can be used
495	+	to avoid performance overheads when scrolling through a large master dataset.
496	+
497	+	Note: uses fptimer and hence requires a thread manager. Under Linux the
498	+	chreads unit must be included in your project. TTimer is not used in order
499	+	to avoid an LCL dependency. Requires FPC 3.0.2 or later.
500	+
501	+	17. TIBExtract: User role grants now excluded when etGrantsToUser not specified
502	+	with Extract Option eoDatabase.
503	+
504	+	18. TIBLookupComboEditBox: Workaround added for https://bugs.freepascal.org/view.php?id=33428
505	+	When a deLayoutChanged event is reported on the ListSource dataset, the
506	+	combobox text is updated. This allows a listsource (detail) to be in a Master/Detail
507	+	relationship with the control's datasource (master).
508	+
509	+	19. TIBExtract: Full BigInt value range now supported for Generators/Sequences.
510	+
511	+	20. TIBExtract: Select Procedures (Procedure type 1) now include "SUSPEND;" clause in their
512	+	stubs. Pedantic fix really, as procedures output in dependency order anyway.
513	+
514	+	21. TIBExtract: Package Headers and Package Bodies are now included in the extracted
515	+	DDL (Firebird 3 and later only).
516	+
517	+	22. TIBLookupComboBox Autocomplete Fixes:
518	+	i. Only appended text is now selected after autocomplete.
519	+	ii. Uppercase keys no longer ignored for autocomplete.
520	+	iii. Retain Prefix case is now honoured correctly.
521	+	iv. When a DataSource is assigned, typing after autocomplete now extends prefix
522	+	before autocomplete performed. i.e. behaviour now the same as when
523	+	no DataSource assigned.
524	+
525	+	23. TIBXScript: Single Line Comments starting with '--' are now ignored when occurring
526	+	between SQL statements.
527	+
528	+	24. TIBExtract: New published property CaseSensitiveObjectNames. If false (default) then
529	+	ObjectNames are converted to upper case before matching against metadata object
530	+	names, unless the objectname is delimited by double quotes, in which case, the
531	+	double quotes are removed and the remaining string is used (unmodified) to match
532	+	against the metadata object name.
533	+
534	+	If true then the ObjectName is used as is without modification and matched
535	+	against the metadata object name. No attempt is made to remove double quotes.
536	+
537	+	25. TIBExtract: New Extract Types: etDatabaseTriggers and etDDLTriggers. When used
538	+	with eoTrigger, these extract types can be used to select only Database Triggers,
539	+	or DDL Triggers or both. Ignored when etTable or etTrigger included in Extract Types.
540	+
541	+	26. TIBXScript: If an exception occurs during the processing of a statement, the
542	+	statement separate character is now reset to the default (';').
543	+
544	+	27. TIBDatabase: Reconnect method added and used by TIBXScript for reconnect.
545	+
546	+	28. TIBXScript: Transaction is no longer automatically reactivated immediately processing
547	+	a commit or reconnect statement and instead activated only when next SQL statement
548	+	is executed.
549	+
550	+	29. TIBSQL.HasField should no longer generate and exception when the field does not exist.
551	+
552	+	30. TIBXScript: case insensitive regex now used when matching statements instead of
553	+	converting statement to upper case.
554	+
555	+	31. TIBExtract: metadata comments now supported. New published property
556	+	IncludeMetaDataComments (default true). If true then metadata comments included
557	+	in extracted DDL. New Extract Object member eoComments. This may be used with
558	+	ExtractObject method to list all metadata comments.
559	+
560	+	32. TIBExtract: ListObjectNames method added.
561	+
562	+	33. Updated Database component editor to support additional connection string
563	+	types.
564	+
565	+	IBX Change Log  version  (2.2-0) Wed, 28 Feb 2018 10:57:45 +0000
566	+
567	+	NOTE: THE LOCATIONS OF SOME OF THE UNIT DIRECTORIES HAS CHANGED FROM IBX 2.1. THIS IS TO
568	+	AVOID DUPLICATE PPU WARNINGS. PLEASE REMOVE EARLIER VERSIONS OF IBX BEFORE INSTALLING THIS
569	+	RELEASE.
570	+
571	+	NOTE: THE DBADMIN DEMO REQUIRES THAT THE MemDSLaz PACKAGE IS INSTALLED IN THE LAZARUS IDE.
572	+
573	+	1. IBExtract: Identity columns - add additional check for null column for generator name.
574	+
575	+	2. IBCustomDataSet: Insert and Modify (Update) queries now recognise and process SQL RETURNING clauses.
576	+	The main use for this is for Firebird 3 Identity columns (see IBXDocumentation 6.6.8 for further
577	+	information). However, this is also a very useful mechanism for returning updated computed by
578	+	column values. Values returned as a result of executing an Insert or Update statement
579	+	replace existing values in the current row for each corresponding column.
580	+
581	+	Previously, if a dataset's select query included read only (computed by) fields then
582	+	an automatic row refresh was performed after an insert or update query had been processed,
583	+	irrespective of the setting of the "ForcedUpdates" property. This has changed such
584	+	that an automatic refresh is no longer performed if an insert or update query contains
585	+	a returning clause that updates one or more fields on the current row. A full row
586	+	refresh is only performed if (a) ForcedRefresh is true or (b) the query does not return any
587	+	field values and the select query contains read only fields. Use of Insert/update
588	+	returning should be significantly more efficient than executing a refresh query.
589	+
590	+	This behaviour change is intended to be backwards compatible and there should be no need to change
591	+	existing programs, other than to improve performance by using the new capability.
592	+
593	+	3. IBCustomDataSet: DELETE...RETURNING queries are now also recognised. However, as
594	+	they are called when the dataset row is being deleted, there is no value in
595	+	updating the current record from the query result. Instead, a new event handler
596	+	"OnDeleteReturning" is provided. If a DELETE...RETURNING query is execute and
597	+	an OnDeleteReturning event handler is provided then it is called with the IResults returned
598	+	by the query. The event handler can then interrogate the query results and
599	+	perform whatever action is necessary. For example to confirm, to the user,
600	+	the deletion of a row with the returned values.
601	+
602	+	4. TIBTable: generated Insert and Update SQL now include a RETURNING clause for
603	+	any Computed By or Identity Columns. The IBTables example has been updated to
604	+	illustrate the computation of the employee Full Name on update.
605	+
606	+	5. TIBTable: The GeneratorField property is now published.
607	+
608	+	6. The InsertSQL property editor now shows Firebird 3 Identity columns separate from the Field List.
609	+	When InsertSQL is generated, the Identity columns are not included in the list of values to
610	+	be inserted. A RETURNING clause is added to the insert statement to return the value of
611	+	each Identity column after the insert is executed.
612	+
613	+	7. The Modify Property Editor now generates Update SQL with Computed By fields in Update..Returning clause.
614	+	Similarly Insert Property Editor now generates Insert SQL with Computed By fields in
615	+	Insert..Returning clause.
616	+
617	+	8. TIBGenerator: small performance improvement by not preparing query each time
618	+	a new value is generated.
619	+
620	+	9. TIBSQL: Free resources when transaction changed - ensures new transaction is used.
621	+
622	+	10. Property editors will now sync table name to a System Table when "Include System
623	+	Tables" is selected and the query is for a System Table.
624	+
625	+	11. Minor Performance improvement to handling of Date/Time types in IBX datasets. Field
626	+	values are no longer converted to milliseconds from TDateTime and then back again
627	+	to TDateTime (the conversion to milliseconds is the default TDataset approach).
628	+
629	+	12. Property Editors handling of Stored Procedures.
630	+	* Select and Refresh: only show a list of stored procedures that return multiple rows (proc type 1) and
631	+	which have a non-empty list of output parameters (i.e. stored procedures that may be used in a select
632	+	query).
633	+	* Modify and Insert: only show a list of stored procedures that return at most a singleton row (proc type 2).
634	+
635	+	13. IBStoredProc: Now supports Firebird 3 Package Names. A new published property PackageName
636	+	can be used to select a package. If non-empty, the stored procedure name is
637	+	expected to be a stored procedure defined in the specified package and the
638	+	generated SQL will be as required for a stored procedure located in a package.
639	+
640	+	14. Select, Refresh, Insert, Modify, Delete and TIBSQL SQL Property Editors now include
641	+	a "Package Name" drop down box to allow selection of a Firebird 3 Package from
642	+	which a stored procedure can be selected. With no package name selected, non-package
643	+	stored procedures are listed.
644	+
645	+	15. TIBXScript: turn off database login prompt when reconnecting - this avoids prompting
646	+	for password on reconnect.
647	+
648	+	16. TIBDatabase: use IAttachment for connection default character set id, code page
649	+	and character set name.
650	+
651	+	17. TIBDatabaseInfo: cache ODS Version information on first request in order to minimise
652	+	DB info lookups"
653	+
654	+	18. IBExtract: now supports DDL Triggers and Grants to DDL objects.
655	+
656	+	19. Add a property Editor for TIBUpdate.RefreshSQL.
657	+
658	+	20. IBUpdate: Ignore non-data (e.g. calculated) fields when assembling list of input
659	+	parameters. This stops an exception being raised when the field cannot be
660	+	located in the record buffer.
661	+
662	+	21. Property Editors now automatically include System Tables when opened and when the query table
663	+	is a System Table.
664	+
665	+	22. IBServices: SQRB and SRB buffers are now reset when service query throws an exception.
666	+	This avoids errors due to a stale SQRB or SRB being used for the next query.
667	+
668	+	23. IBServices: Service attach parameters now include "expected_db". This is used to
669	+	add the SPB item isc_spb_expected_db. This names a database using
670	+	an alternative Security Database (FB3 onwards) and allows (e.g. backup/restore) using such a
671	+	database. examples/services re-written to illustrate use of "expected_db".
672	+
673	+	24. IBServices: TIBControlAndQueryService.WriteNextChunk no longer ignores isc_info_svc_timeout.
674	+	This avoids truncated backups when the server returns a timeout (busy) response.
675	+
676	+	25. TIBDatabase: isc_dpb_page_size now supported as a database parameter when using TIBDatabase.CreateDatabase.
677	+
678	+	26. TIBDatabase: DatabaseName property may now be prefixed by $TEMP$ or $DATADIR$ for local
679	+	databasenames. These are respectively expanded to the local system's temp directory
680	+	(including trailing delimiter) or to a prescribed data directory (including
681	+	trailing delimiter). Under Unix systems the data directory is a hidden directory
682	+	in the user's home directory. The hidden directory name is either the string returned
683	+	from the SysUtils "Vendor Name" or "IBX" if empty. In either case prefixed by a '.'.
684	+	Under Windows, the directory is the same as the Data Directory as decribed
685	+	above but instead prefixed by the User's application data path. These may be
686	+	used to improve application portability for Personal Databases.
687	+
688	+	27. TIBTable: FieldDefs property is no longer published. Due to the use of TIBFieldDef
689	+	this has not worked for a long time and is not useful either. FieldDefs should be
690	+	managed using the Fields Editor as with any other dataset. To access the fields
691	+	editor for a TIBTable component, double click on the component. The fields editor
692	+	is then displayed.
693	+
694	+	28. TIBDatabaseInfo: new properties/function
695	+	* DateDBCreated (returns date/time database created)
696	+	* TransactionCount (returns no. of active transactions)
697	+	* GetDatabasePage(PageNo: integer) (returns contents of specified database page - SYSDBA only).
698	+	* PagesFree (Firebird 3 or later)
699	+	* PagesUsed (Firebird 3 or later)
700	+	* Encrypted (returns true if database encrypted. (Firebird 3.0.3 or later only)
701	+	* EncryptionKeyName (returns the name of the encryption key if any (Firebird 3.0.3 or later only)
702	+
703	+	29. IBServices classes now provided the decoded release number in the (array) property ServerVersionNo.
704	+
705	+	30. TIBSecurityService now supports display/modification of the User Admin Role (Firebird 2.5 and later).
706	+
707	+	31. TIBConfigService now has a procedure SetAutoAdmin(Value: boolean) to enable/disable
708	+	the automtic mapping of privileged OS users to the RDB$ADMIN role (Firebird 2.5 and later).
709	+
710	+	32. TIBBackupService: New Option - NoDBTriggers equivalent to -nodbtriggers switch introduced
711	+	in the gbak utility at V.2.1 to prevent database-level and transaction-level triggers from
712	+	firing during backup and restore.
713	+
714	+	33. Both TIBBackupService and TIBRestoreService now support backup/restore statistics options
715	+	for verbose output using the new property "StatisticsRequested".
716	+	see https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-util-gbak.html#rnfb25-util-gbakstats
717	+
718	+	34. TIBRestoreService: now supports new options RestoreMetaDataOnly (Firebird 2.5 and later).
719	+
720	+	35. TIBOnlineValidationService component added to the IBServices and the "Firebird Admin"
721	+	palette. This uses the online validation feature added in Firebird 2.5. The
722	+	services's properties enable inclusion/exclusion of tables and indexes using
723	+	regular expressions. See.
724	+	https://firebirdsql.org/file/documentation/release_notes/html/en/2_5/rnfb25-apiods-api.html#rnfb25-apiods-api-onlinevalidation
725	+
726	+	36. IBServices: procedure TIBConfigService.SetNoLinger added to set no linger
727	+	option on a database.
728	+
729	+	37. TIBCustomService: Assign method implemented to allow copying of service login
730	+	context between service API components. "Detach" method now only detaches
731	+	service when last reference to the service interface detaches. Tidy up of
732	+	code for SetActive and Attach methods including password hiding.
733	+
734	+	38. TIBDatabase: new properties: AuthenticationMethod and RemoteProtocol. Read only
735	+	and used to determine the auth method and protocol used for the connection.
736	+
737	+	39. TIBDatabase: ensure that SQLDialect setting is used when creating a database using
738	+	a Create Database Statement generated by IBX.
739	+
740	+	40. All IBServices now have an additional published property "PortNo". This may
741	+	be set to a non-standard port number when necessary. If zero then the default
742	+	port number is used.
743	+
744	+	41: TIBLookupComboeditBox: Ensure dataset updated when change selected with the keyboard
745	+	and not just the mouse.
746	+
747	+	42. TIBCustomDataset: reopen query if already active when a TIBControlLink is added.
748	+
749	+	43. TIBTreeview: new ImageIndexField and SelectedIndexField Property allows the
750	+	image index and selected image index for each node to be set from a database field.
751	+
752	+	44. TIBExtract: new extract type (etGrantsToUser) for use with eoDatabase. If included
753	+	then database schema includes grants to all users. If not present then the
754	+	only user grants included are those to User PUBLIC.
755	+
756	+	45. TIBTreeView: performance improvement. When expanding include both expanded node
757	+	and child nodes in dataset.
758	+
759	+
760	+	IBX Change Log  version                            (2.1-0) Fri, 15 Dec 2017 12:20:11 +0000
761	+
762	+	1. IBCustomDataset: Minor change of PChar to PByte for compatibility with fbintf
763	+	changes.
764	+
765	+	2. IBCustomDataset: Fixed use of incorrect datasize in TIBStringField.SetAsString.
766	+	Bug could result in truncated multi-byte character set values.
767	+
768	+	3. Changes consequential on moving fbintf character set utility functions from
769	+	IFirebirdAPI to IAttachment.
770	+
771	+	4. Avoid "Object is nil" error when opening a database with DefaultSystemCodePage = true
772	+
773	+	5. IBLookupComboEditBox: avoid race condition when autocompleting text that occasionally
774	+	results in autocomplete ignoring prefix text.
775	+
776	+	6. IBLookupComboEditBox: Ensure that cursor is not reset to start of text when
777	+	entering a new name into the text box.
778	+
779	+	7. IBCustomDataset: ensure that TIBStringField uses the field size reported by
780	+	Firebird rather than recomputing it.
781	+
782	+	8. Property Editor positioning tidy up: All IBX Property editors should now be
783	+	screen centre. Previously some were "poDesigned" which may be inappropriate
784	+	for multi monitor desktops.
785	+
786	+	10. TIBTreeView.FindNode: protect against error if zero length path or empty tree node.
787	+
788	+	11. TIBTransaction: On Force Disconnect do not raise an exception when problem ending
789	+	a transaction and always reset the object.
790	+
791	+	12. TIBQuery tidyup: remove unnecessary call to GetAffectedRows.
792	+
793	+	13. TIBXScript: Allow for override of database filename in Create Database statements.
794	+
795	+	14. IBLocaldb: Support initialisation of the database from an SQL script in addition
796	+	to a gbak format archive.
797	+
798	+	15. IBLocaldb: fix problem that stopped the OnSharedDataDir event from being recognised.
799	+
800	+	16. IBLocaldb: Drop database if error creating an empty database.
801	+
802	+	17. TIBTreeView: improve performance when selecting node - avoid refreshing dataset
803	+	unless selected node not in current dataset.
804	+
805	+	18. IBServices: SetDBParams method moved from TCustomIBLocalDBSupport (in IBLocalDB package)
806	+	to TIBCustomService, and IBlocalDB code tidy up.
807	+
808	+	19. IBTreeView: Initialise TIBTreeNode KeyValue to null to avoid unpredictable
809	+	behaviour due to uninitialised variable.
810	+
811	+	20. IBServices: Correct encoding of isc_spb_prp_write_mode in TIBConfigService from
812	+	integer to byte. Ditto isc_spb_prp_reserve_space and isc_spb_prp_access_mode.
813	+
814	+	21. IBSQL: When Database changed ensure that all resources are freed.
815	+
816	+	22. IBCustomDataset: When database changed ensure that queries an unprepared.
817	+
818	+	23. SQL Property Editors now use SynEdit with SQL Highlighter. New features include:
819	+	* Line Wrap on SQL Token boundaries (on user command)
820	+	* auto-complete table names in drop down list of table names
821	+	* Double click on tablename or field name adds to SQL text
822	+
823	+	24. IBDataOutput: print statistics using float (%f) format instead of decimal (%d).
824	+
825	+	25. IBTreeView: Call to FindNode: param type change from "array of Variant" to
826	+	TVariantArray. Seems to avoid memory corruption in Windows (probably a
827	+	workaround for a problem in fpc 3.0.4 win64).
828	+
829	+	26. IBDatabaseInfo: Code tidy up. Add check for database not assigned or not open.
830	+
831	+	27. IBDatabaseInfo: Remove memory leak when accessing database operation counts.
832	+
833	+	IBX Change Log  version                   (2.0-2) Fri, 24 Feb 2017 12:17:53 +0000
834	+
835	+	1. TIBDatabase.CreateDatabase: extract full DB Name from SQL using reg ex in order to
836	+	include remote system name.
837	+
838	+	2. TIBExtract: No longer include comment header and COMMIT statement for empty
839	+	tables when data included in output.
840	+
841	+	3. Profiling: IBSQL now has conditional compilation flags to enable query performance
842	+	and timing information to be written to stdout. This may be used to locate
843	+	performance bottlenecks.
844	+
845	+	4. SQLParser: only call "OnChanging" event handler when value is different.
846	+
847	+	5. IBDynamicGrid: Update handling of navigation keys for a TDateEdit
848	+
849	+	6. IBCustomDataset: Set internalunprepared flag when transaction ends. This ensures
850	+	that BindFields is called when the query is next activated. Avoids FieldName
851	+	not found error.
852	+
853	+	7. IBUpdate: This is a new IBX component similar to TIBUpdateSQL. It is more general
854	+	purpose and allows the programmer to define any action they want for Update, Insert
855	+	or Delete. This may be complex SQL (similar to a Trigger), application specific
856	+	filtering of updates, or use of statements such as Grant or Revoke instead of
857	+	normal DML. See User Manual for more information.
858	+
859	+	IBX Change Log  version                  (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000
860	+
861	+	1. TIBEvents: Fix uninitialised variable that could result in lost events.
862	+
863	+	2. TIBExtract: Added support for FB3 "USAGE" privilege.
864	+
865	+	3. TIBExtract: data formatted as Charset set "octets" is now output using
866	+	hexadecimal notation.
867	+
868	+	4. TIBExtract: Binary Blobs and array data can now be embedded in INSERT statements
869	+	using a simple XML format.
870	+
871	+	5. TIBExtract: extract of individual Triggers and Stored Procedures can now include
872	+	grants to these objects.
873	+
874	+	6. TIBExtract: Stored Procedures and Views output in dependency order to avoid
875	+	dependency problems restoring complex databases.
876	+
877	+	7. TIBXScript: This component has been restructured to allow for the processing of
878	+	embedded XML in INSERT statements and to support interactive sources in addition
879	+	to non-interactive data sources such as files.
880	+
881	+	8. TIBXScript: CREATE DATABASE, DROP DATABASE, CONNECT statements are now supported.
882	+
883	+	9. TIBXScript: ISQL compatiable Set statements are now supported:
884	+	SET SQL DIALECT
885	+	SET TERM
886	+	SET AUTODDL
887	+	SET BAIL
888	+	SET ECHO
889	+	SET COUNT
890	+	SET STATS
891	+	SET NAMES <character set>
892	+
893	+	10. IBVersion unit added to hold current IBX Version Number information.
894	+
895	+	11. TIBExtract: Use character rather than byte length for VarChar procedure arguments.,
896	+	and domain definitions.
897	+
898	+	12. TIBExtract: Triggers now use SQL2003 syntax and database and transaction triggers
899	+	fully supported.
900	+
901	+	13. TIBExtract: when a database dump includes data, the generator values are now also set.
902	+
903	+	14: IBSQLEdit: Unit LCLPlatformDef added to uses clauses for lazarus 1.7 and later.
904	+
905	+	IBX Change Log  version     (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000
906	+
907	+	See also doc/IBX4LazarusGuide.pdf for important information on
908	+	upgrading to IBX2.
909	+
910	+	1. Size property of TIBStringField is now the width in characters of the field
911	+	and not the byte length. This applies only to multi-byte character sets such
912	+	as UTF8. The original approach aligned with TStringField. However, the TStringField
913	+	code is not recognised as a bug and hence this change to align the behaviour.
914	+	The TStringField change is expected in fpc 3.2.0.
915	+
916	+	2. A new property AutoFieldSize: boolean has been added to TIBStringField. When
917	+	true (default) then Size property value saved in the lfm is ignored. Size is
918	+	always set from the dynamic information read from the database. It is unclear
919	+	why anyone would want to override this and set Size to false.
920	+
921	+	3. ibxscript: should now handle correctly a Case..End statement within a procedure
922	+	block.
923	+
924	+	4. IBDatabase: new property - CreateIfNotExists. If true and database does not
925	+	exist when an attempt is made to connect to it (run time only) then an attempt
926	+	is made to create the database.
927	+
928	+	5. IBDatabase: new event - OnCreateDatabase. This event is called after a database
929	+	has been successfully created as a result of a call to CreateDatabase or when
930	+	creating a database after it was found not to exist.
931	+
932	+	6.  DBControlGrid: a race condition could result in the wrong row image being
933	+	written to the cache. This has been avoided by a trip round the message
934	+	loop before rendering the row image.
935	+
936	+	7.  DBControlGrid: It is strongly recommended not to open the source DataSet for
937	+	a DBControlGrid during a Form's "OnShow" event handler. Under GTK2 this is
938	+	known to risk corrupt rendering of row images when the control is first
939	+	displayed. If necessary use "Application.QueueAsyncCall" to delay opening
940	+	of the dataset (see DBControlGrid examples) until the Form's Window has been created.
941	+
942	+	8.  DBControlGrid & IBDynamicGrid: Navigation keys should now work correctly with
943	+	a TDateEdit control located on an editor panel.
944	+
945	+	9.  TIBExtract: brought up-to-date plus many bug fixes.
946	+
947	+	10. DBControlGrid: Removed memory leak when updating rows.
948	+
949	+	11. TIBCMLocalDBSupport: fixed invalid free on upgrade.
950	+
951	+	IBX Change Log  version                                           (1.4-3) Thu, 22 Sep 2016 18:10:15 +0100
952	+
953	+	1. IBCustomDataset: When calling SetCodePage, no longer request transliteration
954	+	when target codepage is CP_NONE. This is a workaround for
955	+	http://bugs.freepascal.org/view.php?id=30622.
956	+
957	+	2. DBLog option removed from TIBStatisticalService - not supported by server
958	+	since Firebird 1.5.
959	+
960	+	3. ibxscript: An error is no longer generated for "on commit preserve rows" or
961	+	similar.
962	+
963	+	4. IBCodePage: updated mapping between codepages and character id.
964	+
965	+	5. ftWideString and ftWideMemo withdrawn. There is no UTF16 character set in
966	+	Firebird. Character sets with a char width of two are not UTF16.
967	+
968	+	6. Strings received from the database are now always transliterated into UTF8
969	+	regardless of the database character set or connection character set. This
970	+	is for compatibility with the LCL.
971	+
972	+	IBX Change Log  version  (1.4-2) Thu, 22 Sep 2016 15:25:27 +0100
973	+
974	+	1. IBBlob: Defer reading of blob until read method called. This avoids having to
975	+	read in an entire blob just to get the size of the blob. General performance
976	+	improvement when opening datasets containing blobs.
977	+
978	+	2. Clearing a  Blob now sets the corresponding field's modified flag.
979	+
980	+	3. IBLookupCombo: When not performing auto-complete, original query sort order
981	+	is now used.
982	+
983	+	4. IBDynamicGrid: Add OnSelectEditor event. Allows editor panel to be dynamically
984	+	determined.
985	+
986	+	5. IBDynamicGrid: Recompute column widths after dataset closed and re-opened.
987	+
988	+	6. IBLookupCombo: LazUTF8 added to uses clause to avoid compilation problems post
989	+	lazarus 1.6.0
990	+
991	+	7. IBControls. Removed "runtime" from list of paths to avoid "multiple packages"
992	+	compilation error.
993	+
994	+	IBX Change Log  version                                 (1.4-1) Tue, 17 May 2016 09:14:51 +0100
995	+
996	+	1. No character set specified for connection: when a text blob is retrieved, the
997	+	character set is determined by looking up the native character set using then
998	+	Firebird API. Otherwise a text mode blob is assumed to have the same character
999	+	set as the connection.
1000	+
1001	+	2. TIBGUIInterface: this is an internal interface. Minor type changes to allow
1002	+	for Login Dialog returing a change to the database path.
1003	+
1004	+	3. Design Time Database and Server login Dialogs now allow the Database Name/Server Name
1005	+	to be changed from that given in the TIBDatabase/TIBServer component and for the
1006	+	entered value to be saved on a project specific basis (design time only).
1007	+
1008	+	4. IBDynamicGrid: TDBLookupCellEditor now compares its DataFieldName with the
1009	+	column fieldname. If they are the same then it is acts as a look up for the KeyValue
1010	+	Otherwise, it sets the column text to the selected ListField Value.
1011	+
1012	+	5. IBDynamicGrid: Only visible columns are now taken into account When recalculating
1013	+	column width.
1014	+
1015	+	6. IBLookupComboEditBox: Fix error with autocomplete query when a RelationName is given
1016	+	and a case insensitive search is requested.
1017	+
1018	+	7. IBDynamicGrid: No longer ignores notifications removing Column Totals controls
1019	+	or column ListSource.
1020	+
1021	+	8. IBQuery: no longer performs unnecessary refresh of SQL Text (and hence avoids an
1022	+	unprepare) when closing and the text has not changed.
1023	+
1024	+	9. IBSQL: Base the cursor name on a GUID instead of a hexstr version of the class pointer.
1025	+	Less likely to cause a cursor re-use error on Windows.
1026	+
1027	+	10.SV5IPC: include workaround for OSX. FPC 3.0.0 has broken ipc module for darwin.
1028	+	Expected to be fixed in 3.0.2. Hence workaround only applies to 3.0.0.
1029	+
1030	+	11. TIBTreeView: Guard against nil destination on record changed
1031	+
1032	+	12. AnsiString Code page support: TIBStringField.AsString and TIBMemoField.AsString now return a
1033	+	string type with the code page set to reflect the returned field encoding after
1034	+	Firebird driver transliteration, if any.  FPC 3.0.0 onwards only. Behaviour unchanged for
1035	+	earlier versions.
1036	+
1037	+	13. AnsiString Code page support: Assigning to TIBStringField.AsString and TIBMemoField.AsString
1038	+	will now result in transliteration to the code page specified for the Firebird driver
1039	+	if the assigned string has a different code page. FPC 3.0.0 onwards only.
1040	+
1041	+	14. TIBDatabase: new property UseDefaultSystemCodePage. When set any lc_ctype parameter
1042	+	is ignored and the lc_ctype value, when the database is opened, is set to align with
1043	+	the DefaultSystemCodePage (FPC 3.0.0 onwards). Normally, this is what you want and should ensure
1044	+	platform independence. Note: this applies to FPC 3.0.0 and earlier versions. Pre FPC
1045	+	3.0.0, when this property is true, the lc_ctype is UTF8 except under windows when
1046	+	the GETACP is used to determine the Windows code page.
1047	+
1048	+	15. TIBDatabase: new property DefaultCharSetName. This is the Firebird character set
1049	+	name used as the lc_ctype when the database was opened. Only valid while the
1050	+	Database is connected.
1051	+
1052	+	16. TIBDatabase: new property DefaultCodePage (FPC >=3.0.0 only). This is the codepage
1053	+	id that corresponds to the DefaultCharSetName.
1054	+
1055	+	IBX Change Log  version                          (1.4-0) Mon, 15 Feb 2016 14:44:24 +0000
1056	+
1057	+	1. Unix: If Firebird Embedded Server shared object is loaded and a local database
1058	+	path is given and database attach fails due to access permission issues on the
1059	+	temp directory or security database, then the attach is retried with "localhost:"
1060	+	prefixing the databasename. This should avoid problems when the database has to
1061	+	be accessed by a local (e.g. classic) server and libfbembed is used.
1062	+
1063	+	2. Windows: revised search order for Firebird DLL:
1064	+	i.   The Firebird Embedded Server in the application Directory.
1065	+	ii.  If the FIREBIRD environment variable is set then the directory this
1066	+	points to is searched for the FB Client DLL and then then underlying
1067	+	"bin" directory.
1068	+	iii. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project\Firebird Server\Instances
1069	+	is used to locate the Firebird installation directory and the underlying
1070	+	"bin" directory is searched for the FB Client DLL.
1071	+	iv.  The Default installation directories C:\Program Files\Firebird\Firebird_2_x
1072	+	are searched for the FB Client DLL.
1073	+	v.   The PATH Environment variable is used to search for the FB Client DLL.
1074	+	vi.  Finally the  PATH Environment variable is used to search for IBASE.DLL.
1075	+
1076	+	3. New Component: TIBXScript. This is an ISQL compatible SQL script execution engine.
1077	+	See doc/readme.scriptengine and example applications.
1078	+
1079	+	4. New Component: TIBlocalDBSupport. This is a TIBDatabase support component intended to
1080	+	simplify the use of the embedded firebird server on both Linux and Windows platforms.
1081	+	See dpc/readme.localdatabase and example applications.
1082	+
1083	+	5. IBDynamicGrid: Reordering on column header click should now also work for
1084	+	dynamic columns.
1085	+
1086	+	6. ISQLMonitor: (Windows only). Mutex added to TMultilockGate to avoid race condition
1087	+	between incrementing/decrementing the lock count and signalling the event.
1088	+
1089	+	IBX Change Log  version           (1.3-2) Tue, 26 Jan 2016 14:39:54 +0000
1090	+
1091	+	1.3.2 was never formally released and only made available as beta copies.
1092	+
1093	+	1. DBControlGrid,IBDynamicGrid: Ignore down arrow and up arrow in TCustomMemo
1094	+
1095	+	2. IBDynamicGrid: Now deals correctly with a single column grid which has no indicator and autosize column
1096	+
1097	+	3. IBLookupComboEditBox: reset timer on each key press - avoids timer going off too early
1098	+
1099	+	4. IBDynamicGrid: Call event OnUpdateSortOrder even when aliasname not found in dataset
1100	+	i.e. when it is a calculated field
1101	+
1102	+	5. IBDynamicGrid: Fix problem selecting a different row when expanded row at end of grid.
1103	+	This problem was due to a race condition between recalculating row heights and
1104	+	determining which row was selected by the mouse click. The row height calculation
1105	+	is now deferred by an extra trip round the message loop allowing the row to
1106	+	be always calculated on the current grid layout rather than risking it being
1107	+	calculated on the grid layout after the expanded row has been shrunk.
1108	+
1109	+	6. IBLookupComboEditBox: avoid race condition between cm_killfocus and cm_exit on
1110	+	Windows.
1111	+
1112	+	7. TIBStringField: Now has two new public properties: CharacterSetName: string and CharacterSetSize: integer;
1113	+	These properties allow the (Firebird) character set name for the field and the max number of bytes per character
1114	+	to be determined at runtime. See doc/readme.charactersets.html.
1115	+
1116	+	8. TIBWideStringField: This is a new field type with the same additional public properties as above and subclassed from
1117	+	TWideStringField. This field type is used with the character size reported by Firebird is two. See doc/readme.charactersets.html.
1118	+
1119	+	9. TIBMemoField and TIBWideMemoField: new field types with the same additional public properties as above and subclassed from
1120	+	TMemoField and TWideMemoField respectively. These field types are used with Blob subtype 1 and a characterset size of
1121	+	1, 3 or 4 (TIBMemoField) or 2 (TIBWideMemoField). See doc/readme.charactersets.html.
1122	+
1123	+	Both also have a new published property "DisplayTextAsClassName". If false (default) the displaytext is generated
1124	+	from the blob text by truncating the string to the displaywidth (in characters not bytes). A displaywidth of zero
1125	+	implies no truncation.
1126	+
1127	+	10. IBLookupComboEditBox: Force autocomplete when EditingDone called and timer active.
1128	+
1129	+	11. IBDynamicGrid: Call DataSet.Append when entering edit mode and dataset empty and not in insert state
1130	+	(avoids "Not in Edit Mode" error).
1131	+
1132	+	12. IBDynamicGrid: Correctly resize grid when one column width plus indicator.
1133	+
1134	+	13. IBDynamicGrid: Ensure Editor Panel has focus when shown - avoids Windows API calling
1135	+	DBGrid.DoExit on subsequent mouse click (e.g. on child control such as a tabbed page control.
1136	+
1137	+	14. IBDynamicGrid: ignore up, down tab and return when editorpanel open and focus in a TCustomGrid descendent.
1138	+
1139	+	15. DBControlGrid: Stop flashing grid when dataset closed and then re-opened while DisabledControls
1140	+
1141	+	16. IBQuery: Bug fixed that prevented SQL being set programmatically once the Parser had been invoked.
1142	+
1143	+	17. IBCustomDataSet: On close, parser is now freed and Select SQL reverts to value before DataSet Opened.
1144	+
1145	+	IBX Change Log  version        (1.3-1) Sat, 18 Jul 2015 13:30:50 +0100
1146	+
1147	+	1.   OnCloseUp Event Handler added to TDBLookupProperties
1148	+
1149	+	2.   IBDynamicGrid: Call to OnEditorPanelHide is now last editor hide action - avoids
1150	+	problem with row size when exception is called.
1151	+
1152	+	3.   IBLookupComboEditBox: Force pending autocomplete on combobox exit.
1153	+
1154	+	4.   IBDynamicGrid and DBControlGrid: Keyhandler now ignores up, down, escape and return keys if
1155	+	in a TCustomComboBox and ignores return key if in a TCustomMemo
1156	+
1157	+	5.   IBLookupComboEditBox: Ensure that KeyValue is set correctly when full text
1158	+	keyed in i.e. when autocomplete not performed
1159	+
1160	+	6.   Cleanup of "Uses" clauses and add console mode support. IBX should now support
1161	+	console mode applications with all LCL required functions (builtin dialogs and
1162	+	cursor management) centralised in the  IBDialogs unit. As long as "IBDialogs" is
1163	+	not included in your project, IBX should compile and link with a console mode program.
1164	+	See consolemode example and its "readme"for further guidence. DO NOT add the ibexpress package to a
1165	+	console mode application or the IDE will automatically assume that your
1166	+	application is GUI based. Instead, you should include the ibexpressconsolemode package.
1167	+
1168	+	IMPORTANT NOTE: IBDialogs must be included in GUI applications in order
1169	+	to use the built in dialogs and cursor management. IBDialogs is
1170	+	included by default if "ibexpress" is in your project source's "uses" clause.
1171	+	This should be the case for all projects created through the IDE. This is why
1172	+	you do not want to add the ibexpress package to console mode applications. The
1173	+	ibexpressconsolemode package has been created to allow console mode programs
1174	+	to avoid adding LCL dependencies when using IBX, while still having the
1175	+	unit search paths set up correctly.
1176	+
1177	+	Existing users should check to ensure that the "ibexpress" unit is included in
1178	+	each project's source file (*.lpr).
1179	+
1180	+	You may find that in order for the IDE to recognise that ibexpressconsolemode
1181	+	exists, you have to first open the package in the IDE and then close it. This
1182	+	adds it to the most recently accessed packages list. To make it permanently
1183	+	available, add the package name to lazarus' staticpackages.inc file.
1184	+
1185	+	Thanks to Julio Jiménez for suggesting support of console mode.
1186	+
1187	+	7.   SQL Parser can now accept quoted strings that include new lines
1188	+
1189	+	8.   IBDynamicGrid: Lookup Cell Editor - the cursor is now positioned at end
1190	+	of text on start of edit. This is particularly useful when tabbing to a
1191	+	column and then inserting text.
1192	+
1193	+	9.   New Examples provided for IB Services and ISQLMonitor.
1194	+
1195	+	10. Fix error when writing to blob streams that recorded only the last buffer
1196	+	write in the blob stream. In most cases, this did not cause a problem as the
1197	+	IB Blob Stream is written in a single write. However, with the TDBImage, write
1198	+	of a graphic type prefix was lost which caused a problem when the image could
1199	+	not be automatically recognised.
1200	+
1201	+	11. Improve generation of random cursor names in TIBSQL - avoid risk of "cursor
1202	+	already open" errors due to random numbers used for the cursor name being identical.
1203	+
1204	+	12. IBTable: corrected error that could result in an "Index out of bounds" error
1205	+	when opening the table and the Primary Key is the last or only column in the
1206	+	table. Thanks to Rick Hoover for the fix.
1207	+
1208	+	13. Fix TIBDatabase initialisation of lc_ctype under unix. Set to "UTF8" instead
1209	+	of "UTF-8", and update list of available database character sets. Existing
1210	+	users should check the current lc_ctype setting in their applications.
1211	+
1212	+	IBX Change Log  version  (1.2-4) Sat, 09 May 2015 12:38:29 +0100
1213	+
1214	+	1.  Firebird Services: avoid List Index error when opening a service with an
1215	+	empty Params property.
1216	+
1217	+	2.  IBControls: Fix problem with new link mechanism introduced in 1.2.3.
1218	+	Link now set up in Loaded method - avoids occasional failure to apply
1219	+	SQL markup on initial open.
1220	+
1221	+	3.  "Employees" example performance improvements when scrolling.
1222	+
1223	+	4.  DBControlGrid: Correctly handle edit panel removal when panel is child control of a
1224	+	TFrame. Force recaching of selected frame to avoid GTK race (results in a
1225	+	random image cached).
1226	+
1227	+	5.  DBControlGrid: Should now react to changes in panel height at run time.
1228	+
1229	+	6.  IBDynamicGrid: Redraws rows below on panel editor hide - avoids blank space at end of grid
1230	+	even when further rows exist.
1231	+
1232	+	7.  DBControlGrid: DefaultRowHeight is no longer a published property as it should
1233	+	always be derived from panel height and setting this property can cause confusion.
1234	+	Note for existing projects: to avoid a missing property error at run time,
1235	+	each form using the DBControlGrid must be opened, updated and saved in the IDE
1236	+	in order to remove the property value from the lfm.
1237	+
1238	+
1239	+	IBX Change Log  version (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
1240	+
1241	+	1.  TIBStoredProc. Prepare now called by ParamByName to avoid need to always
1242	+	call Prepare before setting parameter values.
1243	+
1244	+	2.  Error message on ParamByName (all cases) not found now includes name of missing parameter.
1245	+
1246	+	3.  Code tidyup and more robust handling of dsql information result vector.
1247	+
1248	+	4.  Support for centralised handling of transaction status changes. TIBTransaction
1249	+	has been given additional events "AfterEdit", "AfterInsert", "AfterDelete", "AfterPost"
1250	+	and "AfterExecQuery". The first three are called after the same event is called
1251	+	for an IBCustomDataSet descendent using the Transaction. The fourth is called
1252	+	after a call to TIBSQL.ExecQuery, again using this transaction. These new events
1253	+	enable monitoring of transaction status changes for a given transaction to be
1254	+	handled in a single place. For example, when a change to the dataset occurs
1255	+	an indicator can be set that shows the user that in order to save changes,
1256	+	the transaction should be committed.  Rather than doing this per dataset, this
1257	+	can now be done per transaction.
1258	+
1259	+	5.  TDataSet.CheckBrowseMode automatically posts changes to the current row when
1260	+	the dataset is scrolled. However, any changes to the current row are, by default,
1261	+	discarded when the dataset is closed. TIBDataSet, TIBQuery and TIBTable now
1262	+	have a new property "DataSetCloseAction" that adds automatic posting of changes
1263	+	on dataset close. If this property is set to dcDiscardChanges (default) then the
1264	+	behaviour is unchanged from previous versions. if the value is set to dcSaveChanges
1265	+	then IBX will attempt to post any unsaved changes before the dataset is closed
1266	+	(and after the BeforeClose event handler is called). The exception is when the
1267	+	dataset is being closed as a result of a transaction rollback. In this case,
1268	+	no action is taken and any unsaved  changes are discarded. This avoids both
1269	+	unnecessary overhead and the risk that a validation error may occur in the Post
1270	+	raising an exception and thereby preventing a rollback.
1271	+
1272	+	6.  String Field sizes and Display Widths should now be correct for multi-byte character sets.
1273	+	In earlier versions, the Display Width was set to the maximum byte width rather than the character
1274	+	width. Display Widths are now corrected by dividing by the max byte width per character.
1275	+	For UTF8 character sets, the byte width is four and hence the Display Width will be
1276	+	the byte width divided by 4. The byte width of each character set is determined
1277	+	dynamically when the database connection is estabished from the RDB$CHARACTER_SETS
1278	+	system table. (see also http://bugs.freepascal.org/view.php?id=27766).
1279	+
1280	+	7.  SQLParser will now correctly parse SQL Text which contains ':' within quoted string.
1281	+
1282	+	8.  IBLookupComboEditBox: List should now always be restored to full list when the
1283	+	control loses focus. Default Key press default interval reduced to 200ms.
1284	+
1285	+	9.  DBControlGrid: Ensure that selection is changed to newly appended row, even
1286	+	when dataset rows are less than visible rows.
1287	+
1288	+	10. IBDynamicGrid: Editor Panel is not shown on indicator click if Datasource
1289	+	does not exist or DataSet is empty. More responsive on dataset open. New event
1290	+	OnRestorePosition. Column sort disabled if no header row.
1291	+
1292	+	11. IBTreeView: improved handling of response to "Add Node". Avoid scrolling dataset
1293	+	while dataset state is dsInsert. Avoids posting errors.
1294	+
1295	+	12. IBControls: New mechanism for distributing UpdateSQL and UpdateParams events. This is to
1296	+	avoid conflict with DisableControls/EnableControls with Master/Detail linked tables.
1297	+
1298	+	13. IBLookupComboEditBox: Now avoids SQL Errors when combo box text contains single quotes.
1299	+
1300	+	14. TIBDataSet and TIBQuery: new Event - OnValidatePost. This event has been introduced
1301	+	to solve a specific problem. That is when the dataset cursor is moved (e.g. by
1302	+	a grid mouse click and the current row is being edited or inserted. In this case, TDataset
1303	+	always "posts" the current record regardless or whether or not it may be more appropriate
1304	+	to cancel any changes; the post occurs before the "BeforeScroll" event fires due to the way the
1305	+	"MoveBy" function is implemented by TDataSet. The OnValidatePost event is called
1306	+	as the first action of the "Post" method and allows the handler to convert the Post
1307	+	into a Cancel if that is the appropriate action on moving to a different row. This is
1308	+	achieved by returning with "CancelPost" argument set to true. Note that an exception could be
1309	+	raised here, but it may still be more appropriate to validate a post and signal
1310	+	a problem in the "BeforePost" event handler. See readme.automaticposts.xhtml)
1311	+
1312	+	15. On Unix derived systems, the Firebird library name can now be given as a colon
1313	+	separated list. Each library name on the list is tried in turn, in left to right
1314	+	order with the first found being used as the firebird library. By default, on Linux,
1315	+	the library name list is 'libfbembed.so.2.5:libfbembed.so.2.1:libfbclient.so.2'. This can be
1316	+	overidden by the FBLIB environment variable or the OnGetLibraryName function.
1317	+
1318	+	Note: when using the libfbembed.so, if you prefix the database name with "localhost:"
1319	+	then it will still attempt to access the database via the Firebird Server and will
1320	+	require a username and password. If only the pathname is given, then the username
1321	+	and password should be omitted and the unix file permissions are used to grant
1322	+	access.
1323	+
1324	+	IBX Change Log  version  (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
1325	+
1326	+	1.  A new IBControl - TDBControlGrid has been added. TDBControlGrid a lookalike
1327	+	rather than a clone for the Delphi TDBCrtlGrid. TDBControlGrid is a single column grid
1328	+	that replicates a TWinControl - typically a TPanel or a TFrame in each row. Each row
1329	+	corresponds to a row of the linked DataSource. Any data aware control on the
1330	+	replicated (e.g.) TPanel will then appear to have the appropriate value for the row.
1331	+
1332	+	2. As suggested by Julio Jiménez, a new property "SQLHourGlass" has been added to TIBDatabase.
1333	+	When set to false (default true), the Hour Glass cursor is supcpressed and no cursor change
1334	+	takes place during database access. This may be useful when there are performance issues with
1335	+	the change of cursor. Setting the property to false suppresses the change of cursor.
1336	+
1337	+	3. As suggested by Julio Jiménez, a new property "AutoCommit" has been added to TIBDataSet, TIBQuery
1338	+	and TIBTable. When set to acCommitRetaining (Default: acDisabled), a call is made to
1339	+	Transaction.CommitRetaining immediately after every Post or Delete. This has the effect of
1340	+	making all changes permanent immediately rather than when the transaction is explicitly
1341	+	committed.
1342	+
1343	+	4. Experimental support for the Firebird 3 SQL_BOOLEAN type has been added while still
1344	+	using the legacy Firebird API. Thanks to Gabor Boros for helping to test this feature.
1345	+
1346	+	IBX Change Log  version      (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
1347	+
1348	+	Development version only.
1349	+
1350	+	IBX Change Log  version   (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
1351	+
1352	+	1. An internal select SQL Parser is now available for TIBCustomDataset descendents.
1353	+	This is typically used during an "OnBeforeOpen" event handler to manipulate the
1354	+	"Where" and "Having" clauses to implement user specified filters of arbitrary
1355	+	complexity.
1356	+
1357	+	2. A new Component Palette entry "Firebird Data Controls" is now available. This has
1358	+	three new data aware controls dependent on IBX and which make use of the SQL Parser.
1359	+	These are:
1360	+
1361	+	- TIBLookupComboEditBox
1362	+	- TIBDynamicGrid
1363	+	- TIBTreeview
1364	+
1365	+	TIBLookupComboEditBox is a TDBLookupComboBox descendent that implements "autocomplete"
1366	+	of typed in text and "autoinsert" of new entries. Autocomplete uses SQL manipulation
1367	+	to revise the available list and restrict it to items that are prefixed by the
1368	+	typed text (either case sensitive or case insensitive). Autoinsert allows a
1369	+	newly typed entry to be added to the list dataset and included in the available
1370	+	list items.
1371	+
1372	+	TIBDynamicGrid is a TDBGrid descendent that provides for:
1373	+	- automatic resizing of selected columns to fill the available row length
1374	+	- automatic positioning and sizing of a "totals" control, typically at the
1375	+	column footer, on a per column basis.
1376	+	- DataSet resorting on header row click, sorting the dataset by the selected column.
1377	+	A second click on the same header cell reversed the sort order.
1378	+	- Support for a "Panel Editor". That is on clicking the indicator column, the row
1379	+	is automatically expanded and a panel superimposed on it. The panel can have any
1380	+	number of child controls, typically data aware controls with the same datasource
1381	+	as the grid allowing for editing of additional fields and more complex editors.
1382	+	- Reselection of the same row following resorting.
1383	+	- A new cell editor that provides the same functionality as TIBLookupComboEditBox.
1384	+	Its properties are specified on a per column basis and allows for one or more
1385	+	columns to have their values selected from a list provided by a dataset.
1386	+	Autocomplete and autoinsert are also available. The existing picklist editor
1387	+	is unaffected by the extension.
1388	+
1389	+	TIBTreeView is a data aware TCustomTreeView.
1390	+
1391	+	3. When getting a field value using FieldByName.AsVariant, an SQL_INT64 with a
1392	+	zero scale will no longer return an error. An Int64 will be returned instead.
1393	+
1394	+	4. TIBTransaction now has events for Before and After Transaction End and a new function
1395	+	"GetEndAction" allowing the EndAction to be accessed by these event handlers.
1396	+
1397	+	5. TIBQuery can now handle correctly queries which contain the same keyword parameter
1398	+	repeated multiple times.
1399	+
1400	+	6. TIBUpdateSQL will no longer return an error when "RowsAffected" is <> 1. This error
1401	+	check used to get in the way of using Stored Procedures, and "Update or Insert"
1402	+	statements.
1403	+
1404	+	7. Insert, Modify and Delete property Editors now support Query Generation from
1405	+	Stored Procedures.
1406	+
1407	+	8. Three new examples illustrate the use of the new IB Controls
1408	+
1409	+
1410	+	IBX Change Log  version  (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
1411	+
1412	+	1. TIBXSQLVAR code clean up and optimisation to improve client side "prepare" and parameter
1413	+	setting performance. See "readme.field+param.names in the doc folder.(Thanks to
1414	+	Gabor Boros for reporting this problem and for testing the improvements).
1415	+
1416	+	2. IBX can now support dialect 3 quoted column names that contain spaces and which differ only in their case.
1417	+	See readme.field+param.names in the doc folder.
1418	+
1419	+	3. IBX SQL Editors will now automatically add double quotes around column names when the database
1420	+	dialect is "3" and the column name contains spaces or is a Firebird 2.5 SQL Reserved Word.
1421	+
1422	+	4. Param Type LargeInt now supported in TIBQuery and TIBStoredProc
1423	+
1424	+	5. TIBSQL.ExecQuery retry on failure removed to avoid problems with "at most once"
1425	+	actions.
1426	+
1427	+	6. TIBTransaction.SetDefaultDatabase uses SetObjectProp instead of mis-using SetOrdProp (with
1428	+	thanks to Yuriy Kopnin for pointing this out).
1429	+
1430	+	7. GenerateParamName is now a published property of TIBSQL, TIBQuery and TIBDataSet.
1431	+
1432	+	8. varWord, varShortInt and varInt64 added to TIBXSQLVAR.SetAsVariant and hence now available as variant types
1433	+	for both fields and parameter setting.
1434	+
1435	+	9. Changes to the Select SQL in an IBCustomDataset descendent should now be
1436	+	visible in the Fields Editor immediately afterwards - rather than only after cycling the "active" property.
1437	+
1438	+	10. TIBSQL SQL editor will operate correctly and not report an SQL syntax error on SQL test,
1439	+	when DSQL ('?') parameter placeholders are used and the TIBSQL.GenerateParamNames property is set to true.
1440	+
1441	+	11. TIBTable now has a property editor for "MasterFields"
1442	+
1443	+	12. SQL Property Editors now include a checkbox "Allow DSQL Placeholder". This corresponds to the
1444	+	GenerateParamNames property and should be set when using DSQL (i.e. '?') style parameters.
1445	+
1446	+	13. The IBTransaction editor now has a radio button ("Unspecified") which is set when the combination
1447	+	of settings is unrecognised. Selecting this radio button has no effect on the settings.
1448	+
1449	+
1450	+	IBX Change Log  version                 (1.0-5) Sat, 28 Dec 2013 19:22:23 +0000
1451	+
1452	+	1. TBookmark change conditional compile changed to >= 2.7.0 to match revised availability of change.
1453	+
1454	+	IBX Change Log  version          (1.0-4) Thu, 28 Feb 2013 16:56:13 +0000
1455	+
1456	+	1. In a TIBCustomDataset descendent, a generator now only sets the value when
1457	+	it is null. This allows for alternative user defined setting of the generator
1458	+
1459	+	Many thanks to Julio Jiménez for this fix
1460	+
1461	+	2. An Error Dialog is now displayed in the Lazarus IDE if IBX cannot find the Firebird Library
1462	+	and suggests that the user may have forgotten to install it.
1463	+
1464	+	IBX Change Log  version         (1.0-3) Thu, 22 Nov 2012 22:53:39 +0000
1465	+
1466	+	1. Conditional compilation used to limit registration of TIntegerField to
1467	+	Lazarus versions less than 1.1
1468	+
1469	+	2. When a database connection is created, character set is now by default set
1470	+	to UTF8 (Unix) or to the current Windows code page (Windows) if in the range
1471	+	1250 to 1254.
1472	+
1473	+
1474	+	IBX Change Log  version     (1.0-2) Tue, 09 Oct 2012 09:10:30 +0100
1475	+
1476	+	1. TBookmark change conditional compile changed to > 2.6.2 to match expected availability of change.
1477	+
1478	+
1479	+	IBX Change Log  version    (1.0-1) Sun, 05 Aug 2012 20:00:04 +0100
1480	+
1481	+	1. In IBCustomDataset. Changed CurBookmark from string to TBookmark for compiler versions > 2.6.0
1482	+	Necessary because of TBookmark type and TDataSet.Bookmark property change in fpc 2.7.1
1483	+
1484	+	2. IBX now registers TIntegerField as a "No Icon" component. This may be removed if the fpc DB
1485	+	package is changed to do this (which it should do).
1486	+
1487	+	IBX Change Log  version (1.0-0)  Sat, 28 Apr 2012 16:43:00 +0100
1488	+
1489	+	1. Add "if active then active := false" to TIBCustomDataset destructor. (Avoid error on database close).
1490	+
1491	+	2. Make use of $STATIC conditional in IBSQLMonitor (Needed for FPC 2.6.0 compliance)
1492	+
1493	+	3. Database Property Editor: Character Set drop down box now uses "OnChange" rather than "OnCloseUp" to react to changes
1494	+
1495	+	4. Property editors should now correctly resize.
1496	+
1497	+	5. In IBDatabaseEdit.TestClick, the LoginPrompt is now set to the state of the LoginPrompt Checkbox
1498	+	(restored original functionality)
1499	+
1500	+	6. Under OSX, if IBX fails to load libfbclient.dylib, it will now try and load the firebird
1501	+	library using the absolute path /Library/Frameworks/Firebird.framework/Firebird.

Comparing ibx/trunk/changelog (property svn:eol-style):
Revision 303 by tony, Fri Jul 17 22:29:57 2020 UTC vs.
Revision 380 by tony, Mon Jan 10 10:13:17 2022 UTC

#	Line 0 | Line 1
1	+	native

Diff Legend

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