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 303 by tony, Fri Jul 17 22:29:57 2020 UTC vs.
Revision 309 by tony, Tue Jul 21 08:00:42 2020 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines