bug#4472: marked as done (23.1; Emacs manual not too helpful about binding keys)

[Emacs bug Tracking System]

Your message dated Sat, 19 Sep 2009 17:28:54 -0400
with message-id <87ws3ur5d5.fsf@cyd.mit.edu>
and subject line Re: 23.1; Emacs manual not too helpful about binding keys
has caused the Emacs bug report #4472,
regarding 23.1; Emacs manual not too helpful about binding keys
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
4472: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=4472
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems
> --- Begin Message ---
>
>
>
> Subject: 
>
> 23.1; Emacs manual not too helpful about binding keys
>
>
>
>
> Date: 
>
> Thu, 17 Sep 2009 15:51:39 -0700
>
>
>
>
> I find the Emacs manual not to be very helpful about how to bind key
> sequences.  I couldn't even find the form (kbd...) in the manual, and
> I thought that was what we are now recommending in general (no?).
>  
> I tried using `i' in the manual to find information about how to bind
> keys, but it wasn't very helpful. I looked for `binding', and the only
> index entry was for node Commands. I tried `i key TAB' and saw lots
> that looks similar (rebinding, binding,...). Not too clear to me.
>  
> I finally found node Init Rebinding (weird name, BTW). It had examples
> of using strings such as "\C-z" and vectors such as [?\C-=] and
> [C-mouse-1], but it had nothing about `kbd' or the form [(control
> mouse-1)].
>  
> I didn't find a node that explained the various formats and their
> different uses and limitations. I didn't find any general format
> recommendations. I didn't find any link in Init Rebinding to another
> node that might explain such things - the only link there sends you to
> a node explaining details about keyboard encodings and binding
> non-ASCII keys.
>  
> Where is the introductory, top-level explanation about recommended
> ways to bind keys? Surely that's something that even lots of
> non-expert users do. The Key Bindings node (from node Customization)
> sends you immediately into the depths of understanding keymaps - no
> introduction there about binding keys AFAICT.
>  
> I did find information about `kbd' in the Elisp manual, and even some
> text that stresses its convenience and portability. But that
> information is missing from the Emacs manual AFAICT. IIUC, this is
> info that is quite important for most users. There are often questions
> at help-gnu-emacs about how to bind keys, and the answer there is
> typically: "Use kbd". If this is a FAQ, then the answer belongs in the
> Emacs manual, no?
>  
> I this kind of info belongs in the Emacs manual and I hope that
> someone can find the time to add it (or move it) there.
>
> In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600)
>  of 2009-07-29 on SOFT-MJASON
> Windowing system distributor `Microsoft Corp.', version 5.1.2600
> configured using `configure --with-gcc (4.4)'
>
>
>
>
>
> --- End Message ---
> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: 23.1; Emacs manual not too helpful about binding keys
>
>
>
>
> Date: 
>
> Sat, 19 Sep 2009 17:28:54 -0400
>
>
>
>
> User-agent: 
>
> Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux)
>
>
>
>
> "Drew Adams" <drew.adams@oracle.com> writes:
>
> > Please read the whole bug report, and filter out whatever has been fixed since
> > then.
>
> I've checked in some changes which should clarify things.
>
> --- End Message ---