Re: C-M-TAB stand-in for M-TAB, on MS Windows?

[Stefan Monnier <monnier@iro.umontreal.ca>]

Can someone install this patch?


        Stefan


>>>>> "Drew" == Drew Adams <drew.adams@oracle.com> writes:

>> 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.