John H Palmieri <John.H.Palmieri.2(a)nd.edu> writes:
I'm not sure what you mean by this. Since `C-h k' is one of
the basic
help commands available, its output should be as clear and unambiguous
as possible.
The problem is that clear and unambiguous (i.e. readable in the lisp
sence, output by prin1) is not always readable in the "for humans
sense". I personally think it is a bug but I am not sure how to fix
it. Changing that particular princ to prin1 is trivial, but the kind
of output you would really want is unavailable in Emacs.
make `A undefined. This seems like better behavior to me: the
default
is still to have "A" act like "a" (so SHFT-SPC acts like SPC), but
it's not hard to unbind "A" if one wants to. (Plus, one might
actually be led to try this by reading the documentation.)
On the face of it this looks like a good idea. I don't think it would
be that difficult to do, it would just ugly the code by taking the
Qunbound special casing to a somewhat higher level.
Is this variable documented anywhere (in an info file, that is: I
know
how to type C-h v)?
You need to know to type C-h a :-). Seriously, I only found it after I
had found the part of the source code that does this transformation.
The C-h v documentation seems to be all there is.
How should I have found out about it, besides
asking people familiar with the source code?
C-h a shift RET :-)
> Does "bind" in the last sentence mean that I should
use `let'?
Yes. It probably also means that whoever wrote that help string
thought you would only use it in a situation where you were sitting in
a tight loop reading in user input. You would then surround that loop
with a (let. Note that this is at input time, not at the time the
keymap is defined.)
Jan