--- ibx/trunk/changelog	2015/04/14 13:10:23	27
+++ ibx/trunk/changelog	2016/12/06 10:33:46	45
@@ -1,4 +1,339 @@
-IBX Change Log  version                                                          (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
+
+IBX Change Log  version                                                     (2.0-0) Tue, 06 Dec 2016 10:33:44 +0000
+
+See also doc/readme.upgrade-4-x.to.2-0-0.xhtml for important information on
+upgrading to IBX2.
+
+1. Size property of TIBStringField is now the width in characters of the field
+   and not the byte length. This applies only to multi-byte character sets such
+   as UTF8. The original approach aligned with TStringField. However, the TStringField
+   code is not recognised as a bug and hence this change to align the behaviour.
+   The TStringField change is expected in fpc 3.2.0.
+
+2. A new property AutoFieldSize: boolean has been added to TIBStringField. When
+   true (default) then Size property value saved in the lfm is ignored. Size is
+   always set from the dynamic information read from the database. It is unclear
+   why anyone would want to override this and set Size to false.
+
+3. ibxscript: should now handle correctly a Case..End statement within a procedure
+   block.
+
+4. IBDatabase: new property - CreateIfNotExists. If true and database does not
+   exist when an attempt is made to connect to it (run time only) then an attempt
+   is made to create the database.
+
+5. IBDatabase: new event - OnCreateDatabase. This event is called after a database
+   has been successfully created as a result of a call to CreateDatabase or when
+   creating a database after it was found not to exist.
+
+6.  DBControlGrid: a race condition could result in the wrong row image being
+    written to the cache. This has been avoided by a trip round the message
+    loop before rendering the row image.
+
+7.  DBControlGrid: It is strongly recommended not to open the source DataSet for
+    a DBControlGrid during a Form's "OnShow" event handler. Under GTK2 this is
+    known to risk corrupt rendering of row images when the control is first
+    displayed. If necessary use "Application.QueueAsyncCall" to delay opening
+    of the dataset (see DBControlGrid examples) until the Form's Window has been created.
+
+8.  DBControlGrid & IBDynamicGrid: Navigation keys should now work correctly with
+    a TDateEdit control located on an editor panel.
+
+9.  TIBExtract: brought up-to-date plus many bug fixes.
+
+10. DBControlGrid: Removed memory leak when updating rows.
+
+11. TIBCMLocalDBSupport: fixed invalid free on upgrade.
+
+IBX Change Log  version                                           (1.4-3) Thu, 22 Sep 2016 18:10:15 +0100
+
+1. IBCustomDataset: When calling SetCodePage, no longer request transliteration
+   when target codepage is CP_NONE. This is a workaround for
+   http://bugs.freepascal.org/view.php?id=30622.
+
+2. DBLog option removed from TIBStatisticalService - not supported by server
+   since Firebird 1.5.
+
+3. ibxscript: An error is no longer generated for "on commit preserve rows" or
+   similar.
+
+4. IBCodePage: updated mapping between codepages and character id.
+
+5. ftWideString and ftWideMemo withdrawn. There is no UTF16 character set in
+   Firebird. Character sets with a char width of two are not UTF16.
+
+6. Strings received from the database are now always transliterated into UTF8
+   regardless of the database character set or connection character set. This
+   is for compatibility with the LCL.
+
+IBX Change Log  version  (1.4-2) Thu, 22 Sep 2016 15:25:27 +0100
+
+1. IBBlob: Defer reading of blob until read method called. This avoids having to
+   read in an entire blob just to get the size of the blob. General performance
+   improvement when opening datasets containing blobs.
+
+2. Clearing a  Blob now sets the corresponding field's modified flag.
+
+3. IBLookupCombo: When not performing auto-complete, original query sort order
+   is now used.
+
+4. IBDynamicGrid: Add OnSelectEditor event. Allows editor panel to be dynamically
+   determined.
+
+5. IBDynamicGrid: Recompute column widths after dataset closed and re-opened.
+
+6. IBLookupCombo: LazUTF8 added to uses clause to avoid compilation problems post
+   lazarus 1.6.0
+
+7. IBControls. Removed "runtime" from list of paths to avoid "multiple packages"
+   compilation error.
+
+IBX Change Log  version                                 (1.4-1) Tue, 17 May 2016 09:14:51 +0100
+
+1. No character set specified for connection: when a text blob is retrieved, the
+  character set is determined by looking up the native character set using then
+  Firebird API. Otherwise a text mode blob is assumed to have the same character
+  set as the connection.
+
+2. TIBGUIInterface: this is an internal interface. Minor type changes to allow
+   for Login Dialog returing a change to the database path.
+
+3. Design Time Database and Server login Dialogs now allow the Database Name/Server Name
+   to be changed from that given in the TIBDatabase/TIBServer component and for the
+   entered value to be saved on a project specific basis (design time only).
+
+4. IBDynamicGrid: TDBLookupCellEditor now compares its DataFieldName with the
+   column fieldname. If they are the same then it is acts as a look up for the KeyValue
+   Otherwise, it sets the column text to the selected ListField Value.
+
+5. IBDynamicGrid: Only visible columns are now taken into account When recalculating
+   column width.
+
+6. IBLookupComboEditBox: Fix error with autocomplete query when a RelationName is given
+   and a case insensitive search is requested.
+
+7. IBDynamicGrid: No longer ignores notifications removing Column Totals controls
+   or column ListSource.
+
+8. IBQuery: no longer performs unnecessary refresh of SQL Text (and hence avoids an
+   unprepare) when closing and the text has not changed.
+
+9. IBSQL: Base the cursor name on a GUID instead of a hexstr version of the class pointer.
+   Less likely to cause a cursor re-use error on Windows.
+
+10.SV5IPC: include workaround for OSX. FPC 3.0.0 has broken ipc module for darwin.
+   Expected to be fixed in 3.0.2. Hence workaround only applies to 3.0.0.
+
+11. TIBTreeView: Guard against nil destination on record changed
+
+12. AnsiString Code page support: TIBStringField.AsString and TIBMemoField.AsString now return a
+    string type with the code page set to reflect the returned field encoding after
+    Firebird driver transliteration, if any.  FPC 3.0.0 onwards only. Behaviour unchanged for 
+    earlier versions.
+
+13. AnsiString Code page support: Assigning to TIBStringField.AsString and TIBMemoField.AsString
+    will now result in transliteration to the code page specified for the Firebird driver
+    if the assigned string has a different code page. FPC 3.0.0 onwards only.
+
+14. TIBDatabase: new property UseDefaultSystemCodePage. When set any lc_ctype parameter
+    is ignored and the lc_ctype value, when the database is opened, is set to align with
+    the DefaultSystemCodePage (FPC 3.0.0 onwards). Normally, this is what you want and should ensure
+    platform independence. Note: this applies to FPC 3.0.0 and earlier versions. Pre FPC
+    3.0.0, when this property is true, the lc_ctype is UTF8 except under windows when
+    the GETACP is used to determine the Windows code page.
+
+15. TIBDatabase: new property DefaultCharSetName. This is the Firebird character set
+    name used as the lc_ctype when the database was opened. Only valid while the
+    Database is connected.
+
+16. TIBDatabase: new property DefaultCodePage (FPC >=3.0.0 only). This is the codepage
+    id that corresponds to the DefaultCharSetName.
+
+IBX Change Log  version                          (1.4-0) Mon, 15 Feb 2016 14:44:24 +0000
+
+1. Unix: If Firebird Embedded Server shared object is loaded and a local database
+   path is given and database attach fails due to access permission issues on the
+   temp directory or security database, then the attach is retried with "localhost:"
+   prefixing the databasename. This should avoid problems when the database has to
+   be accessed by a local (e.g. classic) server and libfbembed is used.
+
+2. Windows: revised search order for Firebird DLL:
+     i.   The Firebird Embedded Server in the application Directory.
+     ii.  If the FIREBIRD environment variable is set then the directory this
+          points to is searched for the FB Client DLL and then then underlying
+          "bin" directory.
+     iii. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Firebird Project\Firebird Server\Instances
+          is used to locate the Firebird installation directory and the underlying
+          "bin" directory is searched for the FB Client DLL.
+     iv.  The Default installation directories C:\Program Files\Firebird\Firebird_2_x
+          are searched for the FB Client DLL.
+     v.   The PATH Environment variable is used to search for the FB Client DLL.
+     vi.  Finally the  PATH Environment variable is used to search for IBASE.DLL.
+
+3. New Component: TIBXScript. This is an ISQL compatible SQL script execution engine.
+   See doc/readme.scriptengine and example applications.
+
+4. New Component: TIBlocalDBSupport. This is a TIBDatabase support component intended to
+   simplify the use of the embedded firebird server on both Linux and Windows platforms.
+   See dpc/readme.localdatabase and example applications.
+
+5. IBDynamicGrid: Reordering on column header click should now also work for
+   dynamic columns.
+
+6. ISQLMonitor: (Windows only). Mutex added to TMultilockGate to avoid race condition
+   between incrementing/decrementing the lock count and signalling the event.
+
+IBX Change Log  version           (1.3-2) Tue, 26 Jan 2016 14:39:54 +0000
+
+1.3.2 was never formally released and only made available as beta copies.
+
+1. DBControlGrid,IBDynamicGrid: Ignore down arrow and up arrow in TCustomMemo
+
+2. IBDynamicGrid: Now deals correctly with a single column grid which has no indicator and autosize column
+
+3. IBLookupComboEditBox: reset timer on each key press - avoids timer going off too early
+
+4. IBDynamicGrid: Call event OnUpdateSortOrder even when aliasname not found in dataset
+   i.e. when it is a calculated field
+
+5. IBDynamicGrid: Fix problem selecting a different row when expanded row at end of grid.
+   This problem was due to a race condition between recalculating row heights and
+   determining which row was selected by the mouse click. The row height calculation
+   is now deferred by an extra trip round the message loop allowing the row to
+   be always calculated on the current grid layout rather than risking it being
+   calculated on the grid layout after the expanded row has been shrunk.
+
+6. IBLookupComboEditBox: avoid race condition between cm_killfocus and cm_exit on
+   Windows.
+
+7. TIBStringField: Now has two new public properties: CharacterSetName: string and CharacterSetSize: integer;
+   These properties allow the (Firebird) character set name for the field and the max number of bytes per character
+   to be determined at runtime. See doc/readme.charactersets.html.
+
+8. TIBWideStringField: This is a new field type with the same additional public properties as above and subclassed from
+   TWideStringField. This field type is used with the character size reported by Firebird is two. See doc/readme.charactersets.html.
+
+9. TIBMemoField and TIBWideMemoField: new field types with the same additional public properties as above and subclassed from
+   TMemoField and TWideMemoField respectively. These field types are used with Blob subtype 1 and a characterset size of 
+   1, 3 or 4 (TIBMemoField) or 2 (TIBWideMemoField). See doc/readme.charactersets.html.
+
+   Both also have a new published property "DisplayTextAsClassName". If false (default) the displaytext is generated
+   from the blob text by truncating the string to the displaywidth (in characters not bytes). A displaywidth of zero
+   implies no truncation.
+
+10. IBLookupComboEditBox: Force autocomplete when EditingDone called and timer active.
+
+11. IBDynamicGrid: Call DataSet.Append when entering edit mode and dataset empty and not in insert state
+   (avoids "Not in Edit Mode" error).
+
+12. IBDynamicGrid: Correctly resize grid when one column width plus indicator.
+
+13. IBDynamicGrid: Ensure Editor Panel has focus when shown - avoids Windows API calling
+    DBGrid.DoExit on subsequent mouse click (e.g. on child control such as a tabbed page control.
+
+14. IBDynamicGrid: ignore up, down tab and return when editorpanel open and focus in a TCustomGrid descendent.
+
+15. DBControlGrid: Stop flashing grid when dataset closed and then re-opened while DisabledControls
+
+16. IBQuery: Bug fixed that prevented SQL being set programmatically once the Parser had been invoked.
+
+17. IBCustomDataSet: On close, parser is now freed and Select SQL reverts to value before DataSet Opened.
+
+IBX Change Log  version        (1.3-1) Sat, 18 Jul 2015 13:30:50 +0100
+
+1.   OnCloseUp Event Handler added to TDBLookupProperties
+
+2.   IBDynamicGrid: Call to OnEditorPanelHide is now last editor hide action - avoids
+     problem with row size when exception is called.
+
+3.   IBLookupComboEditBox: Force pending autocomplete on combobox exit.
+
+4.   IBDynamicGrid and DBControlGrid: Keyhandler now ignores up, down, escape and return keys if
+     in a TCustomComboBox and ignores return key if in a TCustomMemo
+
+5.   IBLookupComboEditBox: Ensure that KeyValue is set correctly when full text
+     keyed in i.e. when autocomplete not performed
+
+6.   Cleanup of "Uses" clauses and add console mode support. IBX should now support
+     console mode applications with all LCL required functions (builtin dialogs and
+     cursor management) centralised in the  IBDialogs unit. As long as "IBDialogs" is 
+     not included in your project, IBX should compile and link with a console mode program. 
+     See consolemode example and its "readme"for further guidence. DO NOT add the ibexpress package to a 
+     console mode application or the IDE will automatically assume that your 
+     application is GUI based. Instead, you should include the ibexpressconsolemode package.
+
+     IMPORTANT NOTE: IBDialogs must be included in GUI applications in order 
+     to use the built in dialogs and cursor management. IBDialogs is
+     included by default if "ibexpress" is in your project source's "uses" clause.
+     This should be the case for all projects created through the IDE. This is why
+     you do not want to add the ibexpress package to console mode applications. The
+     ibexpressconsolemode package has been created to allow console mode programs
+     to avoid adding LCL dependencies when using IBX, while still having the
+     unit search paths set up correctly.
+
+     Existing users should check to ensure that the "ibexpress" unit is included in
+     each project's source file (*.lpr).
+
+     You may find that in order for the IDE to recognise that ibexpressconsolemode
+     exists, you have to first open the package in the IDE and then close it. This
+     adds it to the most recently accessed packages list. To make it permanently
+     available, add the package name to lazarus' staticpackages.inc file.
+
+	 Thanks to Julio Jiménez for suggesting support of console mode.
+
+7.   SQL Parser can now accept quoted strings that include new lines
+
+8.   IBDynamicGrid: Lookup Cell Editor - the cursor is now positioned at end 
+     of text on start of edit. This is particularly useful when tabbing to a
+     column and then inserting text.
+
+9.   New Examples provided for IB Services and ISQLMonitor.
+
+10. Fix error when writing to blob streams that recorded only the last buffer
+    write in the blob stream. In most cases, this did not cause a problem as the
+    IB Blob Stream is written in a single write. However, with the TDBImage, write
+    of a graphic type prefix was lost which caused a problem when the image could
+	not be automatically recognised.
+
+11. Improve generation of random cursor names in TIBSQL - avoid risk of "cursor
+    already open" errors due to random numbers used for the cursor name being identical.
+
+12. IBTable: corrected error that could result in an "Index out of bounds" error
+    when opening the table and the Primary Key is the last or only column in the
+    table. Thanks to Rick Hoover for the fix.
+
+13. Fix TIBDatabase initialisation of lc_ctype under unix. Set to "UTF8" instead
+    of "UTF-8", and update list of available database character sets. Existing
+    users should check the current lc_ctype setting in their applications.
+
+IBX Change Log  version  (1.2-4) Sat, 09 May 2015 12:38:29 +0100
+
+1.  Firebird Services: avoid List Index error when opening a service with an
+    empty Params property.
+
+2.  IBControls: Fix problem with new link mechanism introduced in 1.2.3.
+    Link now set up in Loaded method - avoids occasional failure to apply
+    SQL markup on initial open.
+
+3.  "Employees" example performance improvements when scrolling.
+
+4.  DBControlGrid: Correctly handle edit panel removal when panel is child control of a
+    TFrame. Force recaching of selected frame to avoid GTK race (results in a
+    random image cached).
+
+5.  DBControlGrid: Should now react to changes in panel height at run time.
+
+6.  IBDynamicGrid: Redraws rows below on panel editor hide - avoids blank space at end of grid   
+    even when further rows exist.
+
+7.  DBControlGrid: DefaultRowHeight is no longer a published property as it should
+    always be derived from panel height and setting this property can cause confusion.
+    Note for existing projects: to avoid a missing property error at run time,
+    each form using the DBControlGrid must be opened, updated and saved in the IDE
+    in order to remove the property value from the lfm.
+
+
+IBX Change Log  version (1.2-3) Tue, 14 Apr 2015 14:11:17 +0100
 
 1.  TIBStoredProc. Prepare now called by ParamByName to avoid need to always
     call Prepare before setting parameter values.
@@ -83,7 +418,7 @@ IBX Change Log  version
     and password should be omitted and the unix file permissions are used to grant
     access.
 
-IBX Change Log  version                                                    (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
+IBX Change Log  version  (1.2-2) Sat, 14 Mar 2015 11:35:04 +0000
 
 1.  A new IBControl - TDBControlGrid has been added. TDBControlGrid a lookalike 
     rather than a clone for the Delphi TDBCrtlGrid. TDBControlGrid is a single column grid 
@@ -105,11 +440,11 @@ IBX Change Log  version
 4. Experimental support for the Firebird 3 SQL_BOOLEAN type has been added while still
    using the legacy Firebird API. Thanks to Gabor Boros for helping to test this feature.
 
-IBX Change Log  version                                                   (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
+IBX Change Log  version      (1.2-1) Fri, 13 Mar 2015 11:14:15 +0000
 
 Development version only.
 
-IBX Change Log  version                                      (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
+IBX Change Log  version   (1.2-0) Thu, 26 Feb 2015 10:34:04 +0000
 
 1. An internal select SQL Parser is now available for TIBCustomDataset descendents.
    This is typically used during an "OnBeforeOpen" event handler to manipulate the
@@ -169,7 +504,7 @@ IBX Change Log  version
 8. Three new examples illustrate the use of the new IB Controls
 
 
-IBX Change Log  version                      (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
+IBX Change Log  version  (1.1-0) Mon, 07 Jul 2014 14:01:07 +0100
 
 1. TIBXSQLVAR code clean up and optimisation to improve client side "prepare" and parameter
    setting performance. See "readme.field+param.names in the doc folder.(Thanks to