ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/changelog
(Generate patch)

Comparing ibx/trunk/changelog (file contents):
Revision 305 by tony, Fri Jul 17 22:51:19 2020 UTC vs.
Revision 359 by tony, Tue Dec 7 09:37:32 2021 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines