The present "xim-input-style" help paragraph seems to me difficult to
understand. I've tried to rewrite it to make it more understandable
while keeping the exact same meaning, see the proposed diff attached
to this mail.
As I am no XIM specialist, I don't know if this help section is
up-to-date (I hope it is, but…); so I'm asking for two kinds of
reviews about this proposed change:
- some regular XIM user: please check the facts;
- some native speaker of English: please check the style and syntax.
Best regards,
Tony.
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
For more options, visit https://groups.google.com/d/optout.
# HG changeset patch
# Parent 0f7d84ec0e3b471fdf22407b960c01c5ccf1b6ae
Rewrite "xim-input-style" help section to make it clearer
diff --git a/runtime/doc/mbyte.txt b/runtime/doc/mbyte.txt
--- a/runtime/doc/mbyte.txt
+++ b/runtime/doc/mbyte.txt
@@ -826,43 +826,41 @@ Use the RPM or port for your system.
The first and second areas are defined in international input of X with the
names of "Preedit Area", "Status Area" respectively. The third and fourth
areas are not defined and are left to be managed by the |IM-server|. In the
international input, four input styles have been defined using combinations
of Preedit Area and Status Area: |OnTheSpot|, |OffTheSpot|, |OverTheSpot|
and |Root|.
- Currently, GUI Vim supports three styles, |OverTheSpot|, |OffTheSpot| and
- |Root|.
- When compiled with |+GUI_GTK| feature, GUI Vim supports two styles,
- |OnTheSpot| and |OverTheSpot|. You can select the style with the 'imstyle'
+ Currently, GUI Vim supports two or three of these styles, depending on GUI
+ flavor, as outlined below. You can select the style with the 'imstyle'
option.
-*. on-the-spot *OnTheSpot*
- Preedit Area and Status Area are performed by the client application in
- the area of application. The client application is directed by the
+*. on-the-spot (GTK only) *OnTheSpot*
+ The Preedit and Status Areas are performed by the client application in
+ the area of the application. The client application is directed by the
|IM-server| to display all pre-edit data at the location of text
insertion. The client registers callbacks invoked by the input method
during pre-editing.
-*. over-the-spot *OverTheSpot*
- Status Area is created in a fixed position within the area of application,
- in case of Vim, the position is the additional status line. Preedit Area
- is made at present input position of application. The input method
- displays pre-edit data in a window which it brings up directly over the
- text insertion position.
-*. off-the-spot *OffTheSpot*
- Preedit Area and Status Area are performed in the area of application, in
- case of Vim, the area is additional status line. The client application
- provides display windows for the pre-edit data to the input method which
- displays into them directly.
-*. root-window *Root*
- Preedit Area and Status Area are outside of the application. The input
- method displays all pre-edit data in a separate area of the screen in a
- window specific to the input method.
+*. over-the-spot (all GUIs) *OverTheSpot*
+ The Status Area is created in a fixed position within the area of
+ application; in the case of Vim, the position is the additional status
+ line. The Preedit Area is made at the present input position of
+ application. The input method displays pre-edit data in a window which it
+ brings up directly over the text insertion position.
+*. off-the-spot (non-GTK only) *OffTheSpot*
+ Both the Preedit and Status Areas are performed in the area of the
+ application; in the case of Vim, the area is the additional status line.
+ The client application provides display windows for the pre-edit data to
+ the input method which displays into them directly.
+*. root-window (non-GTK only) *Root*
+ Both the Preedit and Status Areas are outside of the application. The
+ input method displays all pre-edit data in a separate area of the screen
+ in a window specific to the input method.
USING XIM *multibyte-input* *E284* *E286* *E287* *E288*
*E285* *E289*
Note that Display and Input are independent. It is possible to see your
language even though you have no input method for it. But when your Display
method doesn't match your Input method, the text will be displayed wrong.
