[Emacs-diffs] Changes to emacs/doc/emacs/msdog.texi,v

[Juanma Barranquero]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Juanma Barranquero <lektu>      08/05/29 08:15:05

Index: msdog.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/msdog.texi,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- msdog.texi  10 May 2008 08:53:24 -0000      1.6
+++ msdog.texi  29 May 2008 08:15:04 -0000      1.7
@@ -403,6 +403,33 @@
 key.  If you wish it to produce the @code{Alt} modifier instead, set
 the variable @code{w32-alt-is-meta} to a @code{nil} value.
 
address@hidden w32-register-hot-key
address@hidden w32-unregister-hot-key
+  Although the @key{ALT} key is mapped by default to the Emacs
address@hidden key, MS Windows preempts its use by Emacs for certain key
+combinations, such as @address@hidden  You can use function
address@hidden to allow a key sequence to be seen by Emacs
+instead of being grabbed by Windows.  This registers the key sequence as
+a Windows hot key.
+
+  The argument to @code{w32-register-hot-key} must be a one element key
+definition in vector form that would be acceptable to `define-key'.  The
address@hidden modifier is interpreted as @key{ALT} if `w32-alt-is-meta' is
address@hidden, and @code{hyper} is always interpreted as the Windows modifier
+keys.  The return value is the hotkey-id if registered, otherwise
address@hidden
+
address@hidden M-TAB @r{(MS-Windows)}
address@hidden @address@hidden vs @address@hidden (MS-Windows)
address@hidden @address@hidden vs @address@hidden (MS-Windows)
+  For example, @code{(w32-register-hot-key [M-tab])} lets you use
address@hidden normally in Emacs.  This is effective at all levels, so, for
+instance, you can use @kbd{M-TAB} at top level to complete the word or
+symbol at point, and you can use it during incremental search to
+complete the current search string against previously sought strings.
+The function @code{w32-unregister-hot-key} reverses the effect of
address@hidden
+
 @vindex w32-capslock-is-shiftlock
   By default, the @key{CapsLock} key only affects normal character
 keys (it converts lower-case characters to their upper-case