> I have a problem with this description: it doesn't really explain what
> can and what can't be an argument to these functions, and whether
> there's any significance to the term "hot-key" that is part of the
> functions' names.  An example helps, but a single example is not
> enough to overcome the difficulty of a total lack of description of
> the argument, and also of what the function actually does.  Come to
> think about it, the suggested text explains even less than the doc
> string does, which to me doesn't make sense (it should be the other
> way around).
> 
> > +@vindex w32-register-hot-key
> > +@vindex w32-unregister-hot-key
> 
> These should be @findex; @vindex is for variables/options.
> 
> > +  Although the @key{ALT} key is mapped by default to the Emacs
> > +@key{META} key, MS Windows preempts its use by Emacs for certain key
> > +combinations, such as @key{ALT-TAB}.  You can use function
> > +@code{w32-register-hot-key} to allow a key sequence to be seen by
> > +Emacs instead of being grabbed by Windows.
> > +
> > +@kindex M-TAB @r{(MS-Windows)}
> > +@cindex @code{M-TAB} vs @code{Alt-TAB} (MS-Windows)
> 
> You should use @kbd{M-@key{TAB}} and @kbd{Alt-@key{TAB}}, not
> @key{ALT-TAB} or @code{M-TAB}.
> 
> > +@cindex @code{Alt-TAB} vs @code{M-TAB} (MS-Windows)
> > +  For example, @code{(w32-register-hot-key [M-tab])} lets you use
> > +@kbd{M-TAB} normally in Emacs. This is effective at all levels, so,
>                                 ^^
> Two spaces after a period that ends a sentence, please.
> 
> Finally, please include a ChangeLog entry with your patch.

Thanks for the corrections.

Attached is a new patch. My knowledge of this is limited to what the doc string
says, so I've reproduced that. Feel free to make any more additions or
corrections. In particular, feel free to explain what a Windows hot key and
hotkey-id are.

It is important to at least let users know that they can recuperate M-TAB. But I
certainly agree that it would be good to have a complete and accurate
description of what these functions do. If you can provide that information,
please do submit a better patch.

BTW, it looks to me like there might be similar syntax errors to those I made
(e.g. @code{Alt} in @cindex), throughout this file - you might want to check the
syntax generally.

HTH.

2008-05-27 Drew Adams  <drew.adams@oracle.com>
	* msdog.text:
	Added descriptions of w32-register-hot-key and w32-unregister-hot-key.