experimental/tqtinterface/qt4/changes.immodule

This file describes significant change from
qt-x11-immodule-bc-qt3.3.2-20040623.

Differences from previous release
(qt-x11-immodule-unified-qt3.3.3-20040819) are itemized with '+'
sign. Search it to track incremental change.

****************************************************************************
*                           For users                                      *
****************************************************************************

General
-------

+ A strange character inversion problem on some input methods has been
  fixed


Input methods
-------------

- Added "simple" input method which provides dead/multi key composing
  for latin languages


User Interface
--------------

- Added input method selection menu in the context menu of text
  widgets


Configuration
-------------

+ default IM configuration feature of qtconfig has been disabled in BC
  mode. This is a political change to avoid the confusion about input
  method configuration in accordance with GTK+ environment.

  See following discussion for further information.

  http://freedesktop.org/pipermail/immodule-qt/2004-August/000416.html

- Added new environment variables TQT_IM_SWITCHER and TQT_IM_MODULE to
  set user's favorite input method as default. See README.immodule for
  examples.


Build & Install
---------------

+ configure options have been changed for internal reasons. See 'How
  to install' section of README.immodule

- This version of immodule requires corresponding version of each
  input method plugins (i.e. update your additional input method
  plugins)

- Plugin directory has been changed from $TQTDIR/plugins/input/ to
  $TQTDIR/plugins/inputmethods/. Delete old directory.

- Some codes have been changed to allow compiling against TQt 3.2.x or
  earlier.


****************************************************************************
*                          For develpers                                   *
****************************************************************************

Documents
---------

- Almost description of TQInputContext and TQInputContextPlugin has been
  filled. Feel free to ask obscure things at our mailinglist.


New features
------------

- Pluggable input method switcher

  Now we can write input method switcher as an ordinary input method
  plugin. The two plugins 'imsw-multi' and 'imsw-none' are provided as
  default. But the architecture needs more discussion about whether
  the design is right or not. Join the discussion.

- Pluggable popup menu

  Any input method can provide its own popup menu. See
  http://freedesktop.org/pipermail/immodule-qt/2004-August/000266.html
  for further information.

- TQInputContext proxying

  Some methods of TQInputContext have been changed to enable
  TQInputContext proxying. This feature is required to implement
  pluggable input method switcher.


General
-------

+ TQInputContext has been source compatible with TQt4 version. Basic
  input method plugin can be source compatible without #ifdef. Only
  pluggable popup menu requires #ifdef'ed different code. In addition,
  be careful about use of classes that is deprecated in TQt4.

- Our two development tree for TQt3 'Binary Compatible' and 'ALL' have
  been merged into this unified source tree. The source tree is called
  'Unified' patch.

- 'dead keys' for latin languages have been added into TQt::Key

- Added plugins/src/inputmethods directory to build input method
  plugins within the TQt source tree. The directory name 'inputmethods'
  is intended to be compatible with TQt/Embedded. Install directory
  name is still kept as 'input' for backward compatibility

- Changed XIM input method to a plugin instead of directly link into
  libtqt

- Plugin directory has been changed from $TQTDIR/plugins/input/ to
  $TQTDIR/plugins/inputmethods/. Replace install directory with new
  one.

- Fixed some bugs in previous qt-x11-immodule-bc-qt3.3.2-20040623. See
  following log for more detail.

  * src/kernel/tqwidget_x11.cpp
    - (destroyInputContext): Replace the code with original Simplified
      API patch. See the comment to recognize the original intention
    - (focusInputContext): Fix a condition to call qic->setFocus() as
      originally written. See added comment to recognize the original
      intention

- TQLocale dependency has been removed to be compiled on TQt 3.2.x or
  earlier

- Many internal improvements and cleanups


API Changes in qt-x11-immodule-unified-qt3.3.3-20040910
-------------------------------------------------------
+ TQInputContext

  * TQInputContext()

    Added 'parent' arg to be compatible with TQt4. Since the arg
    defaults to 0, no modification of plugins are required.

  * language()
  * identifierName()

    Return type of these two methods have been changed from TQCString
    which is deprecated in TQt4 to TQString to make plugins source
    compatible with TQt4.

  * addActionsTo()

    New method for TQt4 text widget developer


API Changes in qt-x11-immodule-unified-qt3.3.3-20040812
-------------------------------------------------------

- TQInputContext proxying

  TQInputContext have been changed as follows to enable TQInputContext
  proxying.

  1. Use signal to deliver TQIMEvent instead of explicit
     postEvent(). This enables TQIMEvent proxying and better platform
     abstraction. Corresponding slot is created as
     TQApplication::imEventReceived().

  2. Move some methods of TQInputContext to public from protected or
     private. This enables that proxy-IM can access slave methods.

  3. Make some methods of TQInputContext virtual. This enables
     overriding the methods as proxy

  4. Rename TQInputContext::name() to identifierName() to avoid
     conflicting with TQObject::name()


- TQInputContext

  * language()

    New method to indicate current language

  * menus()

    New method for the pluggable popup menu feature

  * addMenusTo()

    New method for text widget developer

  * deletionRequested()

    New signal to request deletion of this instance. This is added for
    fatal error handling

  * identifierName()

    This replaces name() of previous API to avoid conflicting with
    TQObject::name(), and to distinguish the role from displayName()

  * filterEvent()

    Turn the argument into const. See
    http://freedesktop.org/pipermail/immodule-qt/2004-August/000335.html
    for further information

  * isComposing
  * isPreeditRelocationEnabled

    Move to public from protected to allow proxying

  * setFocusWidget
  * setHolderWidget
  * releaseComposingWidget

    Move to public from private to allow proxying

  * tqfocusWidget
  * holderWidget

    - Make public from protected to allow proxying
    - Make virtual to allow overriding the method as proxy

- TQInputContextPlugin

  * languages()

    New method which returns what languages are supported by the
    TQInputContext instance

  * displayName()

    New method which returns a user friendly i18n-ized name of the
    TQInputContext instance

  * description()

    New method which returns a i18n-ized brief description of the
    TQInputContext instance