Document the new 'w32-get/set-ime-open-status' functions

* doc/emacs/msdos.texi (Windows Keyboard): Document
'w32-set-ime-open-status'.

* etc/NEWS: Announce the new IME-related functions.
This commit is contained in:
Eli Zaretskii 2020-04-13 16:33:57 +03:00
parent 61da72dc2d
commit fc336a4655
2 changed files with 22 additions and 0 deletions

View file

@ -712,6 +712,21 @@ is @code{t}, which means these keys produce @code{AltGr}; setting it
to @code{nil} causes @key{AltGr} or the equivalent key combination to
be interpreted as the combination of @key{Ctrl} and @key{Meta}
modifiers.
@cindex IME, MS-Windows
@findex w32-set-ime-open-status
Some versions of MS-Windows, typically East Asian localized Windows,
enable the Input Method Manager (@acronym{IMM}) that allows
applications to communicate with the Input Method Editor
(@acronym{IME}), the native Windows input method service. Emacs uses
the @acronym{IME} when available to allow users to input East Asian
non-@acronym{ASCII} characters, similarly to Emacs's built-in input
methods (@pxref{Input methods}). However, in some situations the
@acronym{IME} can get in the way if it interprets simple
@acronym{ASCII} keys you input as part of a key sequence that
designates a non-@acronym{ASCII} character. The @acronym{IME} can be
temporarily turned off and then on again by using the
@code{w32-set-ime-open-status} function.
@end ifnottex
@node Windows Mouse

View file

@ -379,6 +379,13 @@ coding-system-for-{read,write} or call 'set-process-coding-system'.
'module-file-suffix' now has the value ".dylib" on macOS, but the
".so" suffix is supported as well.
+++
** On MS-Windows, Emacs can now toggle the IME.
A new function 'w32-set-ime-open-status' can now be used to disable
and enable the MS-Windows native Input Method Editor (IME) at run
time. A companion function 'w32-get-ime-open-status' returns the
current IME activation status.
----------------------------------------------------------------------
This file is part of GNU Emacs.