summaryrefslogtreecommitdiffstats
path: root/changes.immodule
blob: 6fcbccd80a92e808454c8a1e0191b079eb99a0b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
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 QT_IM_SWITCHER and QT_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 retquires corresponding version of each
  input method plugins (i.e. update your additional input method
  plugins)

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

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


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

Documents
---------

- Almost description of QInputContext and QInputContextPlugin 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.

- QInputContext proxying

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


General
-------

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

- Our two development tree for Qt3 '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 Qt::Key

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

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

- Plugin directory has been changed from $QTDIR/plugins/input/ to
  $QTDIR/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/qwidget_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

- QLocale dependency has been removed to be compiled on Qt 3.2.x or
  earlier

- Many internal improvements and cleanups


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

  * QInputContext()

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

  * language()
  * identifierName()

    Return type of these two methods have been changed from QCString
    which is deprecated in Qt4 to QString to make plugins source
    compatible with Qt4.

  * addActionsTo()

    New method for Qt4 text widget developer


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

- QInputContext proxying

  QInputContext have been changed as follows to enable QInputContext
  proxying.

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

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

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

  4. Rename QInputContext::name() to identifierName() to avoid
     conflicting with QObject::name()


- QInputContext

  * 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
    QObject::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

  * focusWidget
  * holderWidget

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

- QInputContextPlugin

  * languages()

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

  * displayName()

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

  * description()

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