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 56 by tony, Mon Mar 6 10:20:02 2017 UTC vs.
Revision 305 by tony, Fri Jul 17 22:51:19 2020 UTC

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

Diff Legend

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