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 229 by tony, Tue Apr 10 13:32:36 2018 UTC vs.
Revision 303 by tony, Fri Jul 17 22:29:57 2020 UTC

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

Diff Legend

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