ViewVC Help

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

root/public/ibx/branches/journaling/changelog

Comparing ibx/trunk/changelog (file contents):
Revision 47 by tony, Mon Jan 9 15:31:51 2017 UTC vs.
Revision 306 by tony, Fri Jul 17 22:53:33 2020 UTC

#	Line 1 | Line 1
1	<	IBX Change Log  version                  (2.0-1) Mon, 09 Jan 2017 15:31:49 +0000
1	>	FBINTF Change Log  version          (1.1-6 Build 12214) Fri, 17 Jul 2020 23:10:11 +0100
2
3	<	1. TIBEvents: Fix uninitialised variable that could result in lost events.
3	>	1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
4	>	with a Firebrid 3 client library.
5
6	<	2. TIBExtract: Added support for FB3 "USAGE" privilege.
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	<	3. TIBExtract: data formatted as Charset set "octets" is now output using
8	<	hexadecimal notation.
12	>	3.  IUtil.FormatStatus now used to format error messages when using new API
13
14	<	4. TIBExtract: Binary Blobs and array data can now be embedded in INSERT statements
11	<	using a simple XML format.
14	>	4.  Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
15
16	<	5. TIBExtract: extract of individual Triggers and Stored Procedures can now include
17	<	grants to these objects.
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	<	6. TIBExtract: Stored Procedures and Views output in dependency order to avoid
24	<	dependency problems restoring complex databases.
23	>	6.  New IFirebirdAPI Calls:
24	>	function GetClientMajor: integer;
25	>	function GetClientMinor: integer;
26
19	–	7. TIBXScript: This component has been restructured to allow for the processing of
20	–	embedded XML in INSERT statements and to support interactive sources in addition
21	–	to non-interactive data sources such as files.
27
28	<	8. TIBXScript: CREATE DATABASE, DROP DATABASE, CONNECT statements are now supported.
28	>	FBINTF Change Log  version          (1.1-5 Build 12044) Fri, 17 Apr 2020 12:30:01 +0100
29
30	<	9. TIBXScript: ISQL compatiable Set statements are now supported:
31	<	SET SQL DIALECT
27	<	SET TERM
28	<	SET AUTODDL
29	<	SET BAIL
30	<	SET ECHO
31	<	SET COUNT
32	<	SET STATS
33	<	SET NAMES <character set>
30	>	1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
31	>	case sensitive
32
33	<	10. IBVersion unit added to hold current IBX Version Number information.
33	>	2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
34
35	<	11. TIBExtract: Use character rather than byte length for VarChar procedure arguments.,
36	<	and domain definitions.
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	<	12. TIBExtract: Triggers now use SQL2003 syntax and database and transaction triggers
41	<	fully supported.
43	>	4. FBMessages: removal of unused messages
44
45	<	13. TIBExtract: when a database dump includes data, the generator values are now also set.
45	>	5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
46
47	<	14: IBSQLEdit: Unit LCLPlatformDef added to uses clauses for lazarus 1.7 and later.
47	>	6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
48
49	<	IBX Change Log  version     (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000
49	>	FBINTF Change Log  version          (1.1-4 Build 11515)  Fri, 28 Dec 2018 10:04:19 +0000
50
51	<	See also doc/readme.upgrade-4-x.to.2-0-0.xhtml for important information on
52	<	upgrading to IBX2.
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	<	1. Size property of TIBStringField is now the width in characters of the field
55	<	and not the byte length. This applies only to multi-byte character sets such
56	<	as UTF8. The original approach aligned with TStringField. However, the TStringField
55	<	code is not recognised as a bug and hence this change to align the behaviour.
56	<	The TStringField change is expected in fpc 3.2.0.
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	<	2. A new property AutoFieldSize: boolean has been added to TIBStringField. When
59	<	true (default) then Size property value saved in the lfm is ignored. Size is
60	<	always set from the dynamic information read from the database. It is unclear
61	<	why anyone would want to override this and set Size to false.
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	<	3. ibxscript: should now handle correctly a Case..End statement within a procedure
64	<	block.
62	>	4. IColumnMetaData: new method.
63
64	<	4. IBDatabase: new property - CreateIfNotExists. If true and database does not
65	<	exist when an attempt is made to connect to it (run time only) then an attempt
66	<	is made to create the database.
64	>	TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
65	>	dfDateTime,   {SQL DATETIME}
66	>	dfTime);
67
68	<	5. IBDatabase: new event - OnCreateDatabase. This event is called after a database
71	<	has been successfully created as a result of a call to CreateDatabase or when
72	<	creating a database after it was found not to exist.
68	>	function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
69
70	<	6.  DBControlGrid: a race condition could result in the wrong row image being
71	<	written to the cache. This has been avoided by a trip round the message
76	<	loop before rendering the row image.
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	<	7.  DBControlGrid: It is strongly recommended not to open the source DataSet for
74	<	a DBControlGrid during a Form's "OnShow" event handler. Under GTK2 this is
80	<	known to risk corrupt rendering of row images when the control is first
81	<	displayed. If necessary use "Application.QueueAsyncCall" to delay opening
82	<	of the dataset (see DBControlGrid examples) until the Form's Window has been created.
73	>	5. Additional argument for IAttachment.PrepareWithNamedParameters -
74	>	CaseSensitiveParams: boolean = false
75
76	<	8.  DBControlGrid & IBDynamicGrid: Navigation keys should now work correctly with
77	<	a TDateEdit control located on an editor panel.
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	<	9.  TIBExtract: brought up-to-date plus many bug fixes.
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
89	–	10. DBControlGrid: Removed memory leak when updating rows.
85
91	–	11. TIBCMLocalDBSupport: fixed invalid free on upgrade.
86
87	<	IBX Change Log  version                                           (1.4-3) Thu, 22 Sep 2016 18:10:15 +0100
87	>	FBINTF Change Log  version                  (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
88
89	<	1. IBCustomDataset: When calling SetCodePage, no longer request transliteration
96	<	when target codepage is CP_NONE. This is a workaround for
97	<	http://bugs.freepascal.org/view.php?id=30622.
89	>	1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
90
91	<	2. DBLog option removed from TIBStatisticalService - not supported by server
92	<	since Firebird 1.5.
91	>	2. Restrict IsMultiThread check to Unix only for compatibility with
92	>	https://bugs.freepascal.org/view.php?id=30535
93
94	<	3. ibxscript: An error is no longer generated for "on commit preserve rows" or
95	<	similar.
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	<	4. IBCodePage: updated mapping between codepages and character id.
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	<	5. ftWideString and ftWideMemo withdrawn. There is no UTF16 character set in
108	<	Firebird. Character sets with a char width of two are not UTF16.
101	>	5. New function added to IB.pas
102
103	<	6. Strings received from the database are now always transliterated into UTF8
111	<	regardless of the database character set or connection character set. This
112	<	is for compatibility with the LCL.
103	>	function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
104
105	<	IBX Change Log  version  (1.4-2) Thu, 22 Sep 2016 15:25:27 +0100
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	<	1. IBBlob: Defer reading of blob until read method called. This avoids having to
117	<	read in an entire blob just to get the size of the blob. General performance
118	<	improvement when opening datasets containing blobs.
110	>	FBINTF Change Log  version               (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
111
112	<	2. Clearing a  Blob now sets the corresponding field's modified flag.
112	>	1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
113	>	program compiled with -CR command line switch.
114
115	<	3. IBLookupCombo: When not performing auto-complete, original query sort order
116	<	is now used.
115	>	2. IServiceManager additions (informational):
116	>	function getProtocol: TProtocol;
117	>	function getPortNo: AnsiString;
118
119	<	4. IBDynamicGrid: Add OnSelectEditor event. Allows editor panel to be dynamically
120	<	determined.
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	<	5. IBDynamicGrid: Recompute column widths after dataset closed and re-opened.
124	>	4. IAttachment addition (informational)
125	>	function GetSecurityDatabase: AnsiString;
126
127	<	6. IBLookupCombo: LazUTF8 added to uses clause to avoid compilation problems post
128	<	lazarus 1.6.0
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	<	7. IBControls. Removed "runtime" from list of paths to avoid "multiple packages"
132	<	compilation error.
131	>	6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
132	>	the problem.
133
134	<	IBX Change Log  version                                 (1.4-1) Tue, 17 May 2016 09:14:51 +0100
134	>	7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
135	>	replaces deprecated "comp" type.
136
137	<	1. No character set specified for connection: when a text blob is retrieved, the
139	<	character set is determined by looking up the native character set using then
140	<	Firebird API. Otherwise a text mode blob is assumed to have the same character
141	<	set as the connection.
137	>	10. Testsuite Test10 updated to include thread synchronisation for event reporting.
138
139	<	2. TIBGUIInterface: this is an internal interface. Minor type changes to allow
144	<	for Login Dialog returing a change to the database path.
139	>	11. URL Connection Strings: inet4 and inet6 now recognised.
140
141	<	3. Design Time Database and Server login Dialogs now allow the Database Name/Server Name
147	<	to be changed from that given in the TIBDatabase/TIBServer component and for the
148	<	entered value to be saved on a project specific basis (design time only).
141	>	12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
142
143	<	4. IBDynamicGrid: TDBLookupCellEditor now compares its DataFieldName with the
151	<	column fieldname. If they are the same then it is acts as a look up for the KeyValue
152	<	Otherwise, it sets the column text to the selected ListField Value.
143	>	13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
144
154	–	5. IBDynamicGrid: Only visible columns are now taken into account When recalculating
155	–	column width.
145
146	<	6. IBLookupComboEditBox: Fix error with autocomplete query when a RelationName is given
158	<	and a case insensitive search is requested.
146	>	FBINTF Change Log  version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
147
148	<	7. IBDynamicGrid: No longer ignores notifications removing Column Totals controls
161	<	or column ListSource.
148	>	1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
149
150	<	8. IBQuery: no longer performs unnecessary refresh of SQL Text (and hence avoids an
151	<	unprepare) when closing and the text has not changed.
150	>	2. IAttachment: add two new methods
151	>	function HasDefaultCharSet: boolean;
152	>	function GetDefaultCharSetID: integer;
153
154	<	9. IBSQL: Base the cursor name on a GUID instead of a hexstr version of the class pointer.
155	<	Less likely to cause a cursor re-use error on Windows.
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	<	10.SV5IPC: include workaround for OSX. FPC 3.0.0 has broken ipc module for darwin.
170	<	Expected to be fixed in 3.0.2. Hence workaround only applies to 3.0.0.
159	>	3. Avoid exception when a text blob is a stored procedure parameter.
160
161	<	11. TIBTreeView: Guard against nil destination on record changed
161	>	4. Update test suite to include a test for a stored proc returning a text blob.
162
163	<	12. AnsiString Code page support: TIBStringField.AsString and TIBMemoField.AsString now return a
164	<	string type with the code page set to reflect the returned field encoding after
165	<	Firebird driver transliteration, if any.  FPC 3.0.0 onwards only. Behaviour unchanged for
166	<	earlier versions.
163	>	5. IAttachment: add
164	>	function GetRemoteProtocol: AnsiString;
165	>	function GetODSMajorVersion: integer;
166	>	function GetODSMinorVersion: integer;
167	>	function GetAuthenticationMethod: AnsiString;
168
169	<	13. AnsiString Code page support: Assigning to TIBStringField.AsString and TIBMemoField.AsString
170	<	will now result in transliteration to the code page specified for the Firebird driver
181	<	if the assigned string has a different code page. FPC 3.0.0 onwards only.
169	>	These results are cached when the connection is opened and hence do not
170	>	require a database lookup.
171
172	<	14. TIBDatabase: new property UseDefaultSystemCodePage. When set any lc_ctype parameter
173	<	is ignored and the lc_ctype value, when the database is opened, is set to align with
185	<	the DefaultSystemCodePage (FPC 3.0.0 onwards). Normally, this is what you want and should ensure
186	<	platform independence. Note: this applies to FPC 3.0.0 and earlier versions. Pre FPC
187	<	3.0.0, when this property is true, the lc_ctype is UTF8 except under windows when
188	<	the GETACP is used to determine the Windows code page.
172	>	6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
173	>	connect string used to create/connect to the database.
174
175	<	15. TIBDatabase: new property DefaultCharSetName. This is the Firebird character set
176	<	name used as the lc_ctype when the database was opened. Only valid while the
177	<	Database is connected.
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	<	16. TIBDatabase: new property DefaultCodePage (FPC >=3.0.0 only). This is the codepage
195	<	id that corresponds to the DefaultCharSetName.
181	>	8. Update Test 1 to test 5, 6 and 7 above.
182
183	<	IBX Change Log  version                          (1.4-0) Mon, 15 Feb 2016 14:44:24 +0000
183	>	9. IBUtils code tidy up.
184
185	<	1. Unix: If Firebird Embedded Server shared object is loaded and a local database
186	<	path is given and database attach fails due to access permission issues on the
187	<	temp directory or security database, then the attach is retried with "localhost:"
188	<	prefixing the databasename. This should avoid problems when the database has to
203	<	be accessed by a local (e.g. classic) server and libfbembed is used.
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	<	2. Windows: revised search order for Firebird DLL:
206	<	i.   The Firebird Embedded Server in the application Directory.
207	<	ii.  If the FIREBIRD environment variable is set then the directory this
208	<	points to is searched for the FB Client DLL and then then underlying
209	<	"bin" directory.
210	<	iii. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project\Firebird Server\Instances
211	<	is used to locate the Firebird installation directory and the underlying
212	<	"bin" directory is searched for the FB Client DLL.
213	<	iv.  The Default installation directories C:\Program Files\Firebird\Firebird_2_x
214	<	are searched for the FB Client DLL.
215	<	v.   The PATH Environment variable is used to search for the FB Client DLL.
216	<	vi.  Finally the  PATH Environment variable is used to search for IBASE.DLL.
190	>	11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
191
192	<	3. New Component: TIBXScript. This is an ISQL compatible SQL script execution engine.
193	<	See doc/readme.scriptengine and example applications.
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	<	4. New Component: TIBlocalDBSupport. This is a TIBDatabase support component intended to
198	<	simplify the use of the embedded firebird server on both Linux and Windows platforms.
223	<	See dpc/readme.localdatabase and example applications.
197	>	13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
198	>	test suite updated.
199
200	<	5. IBDynamicGrid: Reordering on column header click should now also work for
201	<	dynamic columns.
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	<	6. ISQLMonitor: (Windows only). Mutex added to TMultilockGate to avoid race condition
204	<	between incrementing/decrementing the lock count and signalling the event.
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	<	IBX Change Log  version           (1.3-2) Tue, 26 Jan 2016 14:39:54 +0000
207	>	FBINTF Change Log  version                             (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
208
209	<	1.3.2 was never formally released and only made available as beta copies.
209	>	1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
210	>	Scale is no longer ignored.
211
212	<	1. DBControlGrid,IBDynamicGrid: Ignore down arrow and up arrow in TCustomMemo
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	<	2. IBDynamicGrid: Now deals correctly with a single column grid which has no indicator and autosize column
217	>	3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
218	>	UTF8 and not UNICODE_FSS.
219
220	<	3. IBLookupComboEditBox: reset timer on each key press - avoids timer going off too early
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	<	4. IBDynamicGrid: Call event OnUpdateSortOrder even when aliasname not found in dataset
226	<	i.e. when it is a calculated field
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	<	5. IBDynamicGrid: Fix problem selecting a different row when expanded row at end of grid.
231	<	This problem was due to a race condition between recalculating row heights and
246	<	determining which row was selected by the mouse click. The row height calculation
247	<	is now deferred by an extra trip round the message loop allowing the row to
248	<	be always calculated on the current grid layout rather than risking it being
249	<	calculated on the grid layout after the expanded row has been shrunk.
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	<	6. IBLookupComboEditBox: avoid race condition between cm_killfocus and cm_exit on
234	<	Windows.
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	<	7. TIBStringField: Now has two new public properties: CharacterSetName: string and CharacterSetSize: integer;
255	<	These properties allow the (Firebird) character set name for the field and the max number of bytes per character
256	<	to be determined at runtime. See doc/readme.charactersets.html.
236	>	8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
237
238	<	8. TIBWideStringField: This is a new field type with the same additional public properties as above and subclassed from
239	<	TWideStringField. This field type is used with the character size reported by Firebird is two. See doc/readme.charactersets.html.
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	<	9. TIBMemoField and TIBWideMemoField: new field types with the same additional public properties as above and subclassed from
262	<	TMemoField and TWideMemoField respectively. These field types are used with Blob subtype 1 and a characterset size of
263	<	1, 3 or 4 (TIBMemoField) or 2 (TIBWideMemoField). See doc/readme.charactersets.html.
243	>	10. Testsuite: Ensure consistent UTF-8 output on Windows console.
244
245	<	Both also have a new published property "DisplayTextAsClassName". If false (default) the displaytext is generated
266	<	from the blob text by truncating the string to the displaywidth (in characters not bytes). A displaywidth of zero
267	<	implies no truncation.
245	>	11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
246
247	<	10. IBLookupComboEditBox: Force autocomplete when EditingDone called and timer active.
247	>	12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
248
249	<	11. IBDynamicGrid: Call DataSet.Append when entering edit mode and dataset empty and not in insert state
250	<	(avoids "Not in Edit Mode" error).
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	<	12. IBDynamicGrid: Correctly resize grid when one column width plus indicator.
254	>	14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
255
256	<	13. IBDynamicGrid: Ensure Editor Panel has focus when shown - avoids Windows API calling
257	<	DBGrid.DoExit on subsequent mouse click (e.g. on child control such as a tabbed page control.
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	<	14. IBDynamicGrid: ignore up, down tab and return when editorpanel open and focus in a TCustomGrid descendent.
259	>	16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
260	>	of const passed to IAttachment.OpenCursor, etc.
261
281	–	15. DBControlGrid: Stop flashing grid when dataset closed and then re-opened while DisabledControls
262
263	<	16. IBQuery: Bug fixed that prevented SQL being set programmatically once the Parser had been invoked.
263	>	FBINTF Change Log  version             (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
264
265	<	17. IBCustomDataSet: On close, parser is now freed and Select SQL reverts to value before DataSet Opened.
265	>	1. Change syntax to Mode Delphi
266
267	<	IBX Change Log  version        (1.3-1) Sat, 18 Jul 2015 13:30:50 +0100
267	>	2. Change all uses of string type to explicit AnsiString in order to ensure
268	>	compatibility between Delphi and FPC.
269
270	<	1.   OnCloseUp Event Handler added to TDBLookupProperties
270	>	3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
271	>	defined for each interface.
272
273	<	2.   IBDynamicGrid: Call to OnEditorPanelHide is now last editor hide action - avoids
292	<	problem with row size when exception is called.
273	>	4. Generics syntax variations for Delphi added
274
275	<	3.   IBLookupComboEditBox: Force pending autocomplete on combobox exit.
275	>	5. PChar replaced with PByte expect where an actual string is being referenced,
276	>	where PAnsiChar is used instead.
277
278	<	4.   IBDynamicGrid and DBControlGrid: Keyhandler now ignores up, down, escape and return keys if
297	<	in a TCustomComboBox and ignores return key if in a TCustomMemo
278	>	6. Review of type definitions in IBExternals to ensure Delphi compatibility
279
280	<	5.   IBLookupComboEditBox: Ensure that KeyValue is set correctly when full text
300	<	keyed in i.e. when autocomplete not performed
280	>	7. Testsuite updated for Delphi
281
282	<	6.   Cleanup of "Uses" clauses and add console mode support. IBX should now support
303	<	console mode applications with all LCL required functions (builtin dialogs and
304	<	cursor management) centralised in the  IBDialogs unit. As long as "IBDialogs" is
305	<	not included in your project, IBX should compile and link with a console mode program.
306	<	See consolemode example and its "readme"for further guidence. DO NOT add the ibexpress package to a
307	<	console mode application or the IDE will automatically assume that your
308	<	application is GUI based. Instead, you should include the ibexpressconsolemode package.
282	>	FBINTF Change Log  version            (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
283
284	<	IMPORTANT NOTE: IBDialogs must be included in GUI applications in order
285	<	to use the built in dialogs and cursor management. IBDialogs is
312	<	included by default if "ibexpress" is in your project source's "uses" clause.
313	<	This should be the case for all projects created through the IDE. This is why
314	<	you do not want to add the ibexpress package to console mode applications. The
315	<	ibexpressconsolemode package has been created to allow console mode programs
316	<	to avoid adding LCL dependencies when using IBX, while still having the
317	<	unit search paths set up correctly.
284	>	1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
285	>	large blobs and the FB3 API.
286
287	<	Existing users should check to ensure that the "ibexpress" unit is included in
288	<	each project's source file (*.lpr).
287	>	2. Update Event Handling algorithm to avoid looping due to recreation of the
288	>	event block.
289
290	<	You may find that in order for the IDE to recognise that ibexpressconsolemode
323	<	exists, you have to first open the package in the IDE and then close it. This
324	<	adds it to the most recently accessed packages list. To make it permanently
325	<	available, add the package name to lazarus' staticpackages.inc file.
290	>	3. Avoid invalid XSQLDA error when the only parameter is updated to null
291
292	<	Thanks to Julio Jiménez for suggesting support of console mode.
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.   SQL Parser can now accept quoted strings that include new lines
297	>	5. IBUtils: List of reserved words brought up-to-date
298
299	<	8.   IBDynamicGrid: Lookup Cell Editor - the cursor is now positioned at end
332	<	of text on start of edit. This is particularly useful when tabbing to a
333	<	column and then inserting text.
299	>	6. Add ISQL style performance statistics collection to IStatement
300
301	<	9.   New Examples provided for IB Services and ISQLMonitor.
301	>	7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
302	>	CREATE DATABASE statement.
303
304	<	10. Fix error when writing to blob streams that recorded only the last buffer
305	<	write in the blob stream. In most cases, this did not cause a problem as the
339	<	IB Blob Stream is written in a single write. However, with the TDBImage, write
340	<	of a graphic type prefix was lost which caused a problem when the image could
341	<	not be automatically recognised.
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	<	11. Improve generation of random cursor names in TIBSQL - avoid risk of "cursor
308	<	already open" errors due to random numbers used for the cursor name being identical.
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	<	12. IBTable: corrected error that could result in an "Index out of bounds" error
311	<	when opening the table and the Primary Key is the last or only column in the
312	<	table. Thanks to Rick Hoover for the fix.
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	<	13. Fix TIBDatabase initialisation of lc_ctype under unix. Set to "UTF8" instead
351	<	of "UTF-8", and update list of available database character sets. Existing
352	<	users should check the current lc_ctype setting in their applications.
314	>	11. API Version information added as constants to IB.pas
315
316	<	IBX Change Log  version  (1.2-4) Sat, 09 May 2015 12:38:29 +0100
316	>	12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
317
318	<	1.  Firebird Services: avoid List Index error when opening a service with an
357	<	empty Params property.
318	>	13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
319
320	<	2.  IBControls: Fix problem with new link mechanism introduced in 1.2.3.
360	<	Link now set up in Loaded method - avoids occasional failure to apply
361	<	SQL markup on initial open.
320	>	FBINTF Change Log  version                                      (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
321
322	<	3.  "Employees" example performance improvements when scrolling.
322	>	1. Initial Release
323
365	–	4.  DBControlGrid: Correctly handle edit panel removal when panel is child control of a
366	–	TFrame. Force recaching of selected frame to avoid GTK race (results in a
367	–	random image cached).
368	–
369	–	5.  DBControlGrid: Should now react to changes in panel height at run time.
370	–
371	–	6.  IBDynamicGrid: Redraws rows below on panel editor hide - avoids blank space at end of grid
372	–	even when further rows exist.
373	–
374	–	7.  DBControlGrid: DefaultRowHeight is no longer a published property as it should
375	–	always be derived from panel height and setting this property can cause confusion.
376	–	Note for existing projects: to avoid a missing property error at run time,
377	–	each form using the DBControlGrid must be opened, updated and saved in the IDE
378	–	in order to remove the property value from the lfm.
379	–
380	–
381	–	IBX Change Log  version (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
382	–
383	–	1.  TIBStoredProc. Prepare now called by ParamByName to avoid need to always
384	–	call Prepare before setting parameter values.
385	–
386	–	2.  Error message on ParamByName (all cases) not found now includes name of missing parameter.
387	–
388	–	3.  Code tidyup and more robust handling of dsql information result vector.
389	–
390	–	4.  Support for centralised handling of transaction status changes. TIBTransaction
391	–	has been given additional events "AfterEdit", "AfterInsert", "AfterDelete", "AfterPost"
392	–	and "AfterExecQuery". The first three are called after the same event is called
393	–	for an IBCustomDataSet descendent using the Transaction. The fourth is called
394	–	after a call to TIBSQL.ExecQuery, again using this transaction. These new events
395	–	enable monitoring of transaction status changes for a given transaction to be
396	–	handled in a single place. For example, when a change to the dataset occurs
397	–	an indicator can be set that shows the user that in order to save changes,
398	–	the transaction should be committed.  Rather than doing this per dataset, this
399	–	can now be done per transaction.
400	–
401	–	5.  TDataSet.CheckBrowseMode automatically posts changes to the current row when
402	–	the dataset is scrolled. However, any changes to the current row are, by default,
403	–	discarded when the dataset is closed. TIBDataSet, TIBQuery and TIBTable now
404	–	have a new property "DataSetCloseAction" that adds automatic posting of changes
405	–	on dataset close. If this property is set to dcDiscardChanges (default) then the
406	–	behaviour is unchanged from previous versions. if the value is set to dcSaveChanges
407	–	then IBX will attempt to post any unsaved changes before the dataset is closed
408	–	(and after the BeforeClose event handler is called). The exception is when the
409	–	dataset is being closed as a result of a transaction rollback. In this case,
410	–	no action is taken and any unsaved  changes are discarded. This avoids both
411	–	unnecessary overhead and the risk that a validation error may occur in the Post
412	–	raising an exception and thereby preventing a rollback.
413	–
414	–	6.  String Field sizes and Display Widths should now be correct for multi-byte character sets.
415	–	In earlier versions, the Display Width was set to the maximum byte width rather than the character
416	–	width. Display Widths are now corrected by dividing by the max byte width per character.
417	–	For UTF8 character sets, the byte width is four and hence the Display Width will be
418	–	the byte width divided by 4. The byte width of each character set is determined
419	–	dynamically when the database connection is estabished from the RDB$CHARACTER_SETS
420	–	system table. (see also http://bugs.freepascal.org/view.php?id=27766).
421	–
422	–	7.  SQLParser will now correctly parse SQL Text which contains ':' within quoted string.
423	–
424	–	8.  IBLookupComboEditBox: List should now always be restored to full list when the
425	–	control loses focus. Default Key press default interval reduced to 200ms.
426	–
427	–	9.  DBControlGrid: Ensure that selection is changed to newly appended row, even
428	–	when dataset rows are less than visible rows.
429	–
430	–	10. IBDynamicGrid: Editor Panel is not shown on indicator click if Datasource
431	–	does not exist or DataSet is empty. More responsive on dataset open. New event
432	–	OnRestorePosition. Column sort disabled if no header row.
433	–
434	–	11. IBTreeView: improved handling of response to "Add Node". Avoid scrolling dataset
435	–	while dataset state is dsInsert. Avoids posting errors.
436	–
437	–	12. IBControls: New mechanism for distributing UpdateSQL and UpdateParams events. This is to
438	–	avoid conflict with DisableControls/EnableControls with Master/Detail linked tables.
439	–
440	–	13. IBLookupComboEditBox: Now avoids SQL Errors when combo box text contains single quotes.
441	–
442	–	14. TIBDataSet and TIBQuery: new Event - OnValidatePost. This event has been introduced
443	–	to solve a specific problem. That is when the dataset cursor is moved (e.g. by
444	–	a grid mouse click and the current row is being edited or inserted. In this case, TDataset
445	–	always "posts" the current record regardless or whether or not it may be more appropriate
446	–	to cancel any changes; the post occurs before the "BeforeScroll" event fires due to the way the
447	–	"MoveBy" function is implemented by TDataSet. The OnValidatePost event is called
448	–	as the first action of the "Post" method and allows the handler to convert the Post
449	–	into a Cancel if that is the appropriate action on moving to a different row. This is
450	–	achieved by returning with "CancelPost" argument set to true. Note that an exception could be
451	–	raised here, but it may still be more appropriate to validate a post and signal
452	–	a problem in the "BeforePost" event handler. See readme.automaticposts.xhtml)
453	–
454	–	15. On Unix derived systems, the Firebird library name can now be given as a colon
455	–	separated list. Each library name on the list is tried in turn, in left to right
456	–	order with the first found being used as the firebird library. By default, on Linux,
457	–	the library name list is 'libfbembed.so.2.5:libfbembed.so.2.1:libfbclient.so.2'. This can be
458	–	overidden by the FBLIB environment variable or the OnGetLibraryName function.
459	–
460	–	Note: when using the libfbembed.so, if you prefix the database name with "localhost:"
461	–	then it will still attempt to access the database via the Firebird Server and will
462	–	require a username and password. If only the pathname is given, then the username
463	–	and password should be omitted and the unix file permissions are used to grant
464	–	access.
465	–
466	–	IBX Change Log  version  (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
467	–
468	–	1.  A new IBControl - TDBControlGrid has been added. TDBControlGrid a lookalike
469	–	rather than a clone for the Delphi TDBCrtlGrid. TDBControlGrid is a single column grid
470	–	that replicates a TWinControl - typically a TPanel or a TFrame in each row. Each row
471	–	corresponds to a row of the linked DataSource. Any data aware control on the
472	–	replicated (e.g.) TPanel will then appear to have the appropriate value for the row.
473	–
474	–	2. As suggested by Julio Jiménez, a new property "SQLHourGlass" has been added to TIBDatabase.
475	–	When set to false (default true), the Hour Glass cursor is supcpressed and no cursor change
476	–	takes place during database access. This may be useful when there are performance issues with
477	–	the change of cursor. Setting the property to false suppresses the change of cursor.
478	–
479	–	3. As suggested by Julio Jiménez, a new property "AutoCommit" has been added to TIBDataSet, TIBQuery
480	–	and TIBTable. When set to acCommitRetaining (Default: acDisabled), a call is made to
481	–	Transaction.CommitRetaining immediately after every Post or Delete. This has the effect of
482	–	making all changes permanent immediately rather than when the transaction is explicitly
483	–	committed.
484	–
485	–	4. Experimental support for the Firebird 3 SQL_BOOLEAN type has been added while still
486	–	using the legacy Firebird API. Thanks to Gabor Boros for helping to test this feature.
487	–
488	–	IBX Change Log  version      (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
489	–
490	–	Development version only.
491	–
492	–	IBX Change Log  version   (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
493	–
494	–	1. An internal select SQL Parser is now available for TIBCustomDataset descendents.
495	–	This is typically used during an "OnBeforeOpen" event handler to manipulate the
496	–	"Where" and "Having" clauses to implement user specified filters of arbitrary
497	–	complexity.
498	–
499	–	2. A new Component Palette entry "Firebird Data Controls" is now available. This has
500	–	three new data aware controls dependent on IBX and which make use of the SQL Parser.
501	–	These are:
502	–
503	–	- TIBLookupComboEditBox
504	–	- TIBDynamicGrid
505	–	- TIBTreeview
506	–
507	–	TIBLookupComboEditBox is a TDBLookupComboBox descendent that implements "autocomplete"
508	–	of typed in text and "autoinsert" of new entries. Autocomplete uses SQL manipulation
509	–	to revise the available list and restrict it to items that are prefixed by the
510	–	typed text (either case sensitive or case insensitive). Autoinsert allows a
511	–	newly typed entry to be added to the list dataset and included in the available
512	–	list items.
513	–
514	–	TIBDynamicGrid is a TDBGrid descendent that provides for:
515	–	- automatic resizing of selected columns to fill the available row length
516	–	- automatic positioning and sizing of a "totals" control, typically at the
517	–	column footer, on a per column basis.
518	–	- DataSet resorting on header row click, sorting the dataset by the selected column.
519	–	A second click on the same header cell reversed the sort order.
520	–	- Support for a "Panel Editor". That is on clicking the indicator column, the row
521	–	is automatically expanded and a panel superimposed on it. The panel can have any
522	–	number of child controls, typically data aware controls with the same datasource
523	–	as the grid allowing for editing of additional fields and more complex editors.
524	–	- Reselection of the same row following resorting.
525	–	- A new cell editor that provides the same functionality as TIBLookupComboEditBox.
526	–	Its properties are specified on a per column basis and allows for one or more
527	–	columns to have their values selected from a list provided by a dataset.
528	–	Autocomplete and autoinsert are also available. The existing picklist editor
529	–	is unaffected by the extension.
530	–
531	–	TIBTreeView is a data aware TCustomTreeView.
532	–
533	–	3. When getting a field value using FieldByName.AsVariant, an SQL_INT64 with a
534	–	zero scale will no longer return an error. An Int64 will be returned instead.
535	–
536	–	4. TIBTransaction now has events for Before and After Transaction End and a new function
537	–	"GetEndAction" allowing the EndAction to be accessed by these event handlers.
538	–
539	–	5. TIBQuery can now handle correctly queries which contain the same keyword parameter
540	–	repeated multiple times.
541	–
542	–	6. TIBUpdateSQL will no longer return an error when "RowsAffected" is <> 1. This error
543	–	check used to get in the way of using Stored Procedures, and "Update or Insert"
544	–	statements.
545	–
546	–	7. Insert, Modify and Delete property Editors now support Query Generation from
547	–	Stored Procedures.
548	–
549	–	8. Three new examples illustrate the use of the new IB Controls
550	–
551	–
552	–	IBX Change Log  version  (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
553	–
554	–	1. TIBXSQLVAR code clean up and optimisation to improve client side "prepare" and parameter
555	–	setting performance. See "readme.field+param.names in the doc folder.(Thanks to
556	–	Gabor Boros for reporting this problem and for testing the improvements).
557	–
558	–	2. IBX can now support dialect 3 quoted column names that contain spaces and which differ only in their case.
559	–	See readme.field+param.names in the doc folder.
560	–
561	–	3. IBX SQL Editors will now automatically add double quotes around column names when the database
562	–	dialect is "3" and the column name contains spaces or is a Firebird 2.5 SQL Reserved Word.
563	–
564	–	4. Param Type LargeInt now supported in TIBQuery and TIBStoredProc
565	–
566	–	5. TIBSQL.ExecQuery retry on failure removed to avoid problems with "at most once"
567	–	actions.
568	–
569	–	6. TIBTransaction.SetDefaultDatabase uses SetObjectProp instead of mis-using SetOrdProp (with
570	–	thanks to Yuriy Kopnin for pointing this out).
571	–
572	–	7. GenerateParamName is now a published property of TIBSQL, TIBQuery and TIBDataSet.
573	–
574	–	8. varWord, varShortInt and varInt64 added to TIBXSQLVAR.SetAsVariant and hence now available as variant types
575	–	for both fields and parameter setting.
576	–
577	–	9. Changes to the Select SQL in an IBCustomDataset descendent should now be
578	–	visible in the Fields Editor immediately afterwards - rather than only after cycling the "active" property.
579	–
580	–	10. TIBSQL SQL editor will operate correctly and not report an SQL syntax error on SQL test,
581	–	when DSQL ('?') parameter placeholders are used and the TIBSQL.GenerateParamNames property is set to true.
582	–
583	–	11. TIBTable now has a property editor for "MasterFields"
584	–
585	–	12. SQL Property Editors now include a checkbox "Allow DSQL Placeholder". This corresponds to the
586	–	GenerateParamNames property and should be set when using DSQL (i.e. '?') style parameters.
587	–
588	–	13. The IBTransaction editor now has a radio button ("Unspecified") which is set when the combination
589	–	of settings is unrecognised. Selecting this radio button has no effect on the settings.
590	–
591	–
592	–	IBX Change Log  version                 (1.0-5) Sat, 28 Dec 2013 19:22:23 +0000
593	–
594	–	1. TBookmark change conditional compile changed to >= 2.7.0 to match revised availability of change.
595	–
596	–	IBX Change Log  version          (1.0-4) Thu, 28 Feb 2013 16:56:13 +0000
597	–
598	–	1. In a TIBCustomDataset descendent, a generator now only sets the value when
599	–	it is null. This allows for alternative user defined setting of the generator
600	–
601	–	Many thanks to Julio Jiménez for this fix
602	–
603	–	2. An Error Dialog is now displayed in the Lazarus IDE if IBX cannot find the Firebird Library
604	–	and suggests that the user may have forgotten to install it.
605	–
606	–	IBX Change Log  version         (1.0-3) Thu, 22 Nov 2012 22:53:39 +0000
607	–
608	–	1. Conditional compilation used to limit registration of TIntegerField to
609	–	Lazarus versions less than 1.1
610	–
611	–	2. When a database connection is created, character set is now by default set
612	–	to UTF8 (Unix) or to the current Windows code page (Windows) if in the range
613	–	1250 to 1254.
614	–
615	–
616	–	IBX Change Log  version     (1.0-2) Tue, 09 Oct 2012 09:10:30 +0100
617	–
618	–	1. TBookmark change conditional compile changed to > 2.6.2 to match expected availability of change.
619	–
620	–
621	–	IBX Change Log  version    (1.0-1) Sun, 05 Aug 2012 20:00:04 +0100
622	–
623	–	1. In IBCustomDataset. Changed CurBookmark from string to TBookmark for compiler versions > 2.6.0
624	–	Necessary because of TBookmark type and TDataSet.Bookmark property change in fpc 2.7.1
625	–
626	–	2. IBX now registers TIntegerField as a "No Icon" component. This may be removed if the fpc DB
627	–	package is changed to do this (which it should do).
628	–
629	–	IBX Change Log  version (1.0-0)  Sat, 28 Apr 2012 16:43:00 +0100
630	–
631	–	1. Add "if active then active := false" to TIBCustomDataset destructor. (Avoid error on database close).
632	–
633	–	2. Make use of $STATIC conditional in IBSQLMonitor (Needed for FPC 2.6.0 compliance)
634	–
635	–	3. Database Property Editor: Character Set drop down box now uses "OnChange" rather than "OnCloseUp" to react to changes
636	–
637	–	4. Property editors should now correctly resize.
638	–
639	–	5. In IBDatabaseEdit.TestClick, the LoginPrompt is now set to the state of the LoginPrompt Checkbox
640	–	(restored original functionality)
641	–
642	–	6. Under OSX, if IBX fails to load libfbclient.dylib, it will now try and load the firebird
643	–	library using the absolute path /Library/Frameworks/Firebird.framework/Firebird.

Diff Legend

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