bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#13219: 24.3.50; missing `...' in Emacs manual


From: Drew Adams
Subject: bug#13219: 24.3.50; missing `...' in Emacs manual
Date: Fri, 21 Dec 2012 00:24:21 -0800

> > There are still some missing `...' in the Emacs manual.  See node
> > `Keys', for instance.  Each key sequence is correctly quoted there,
> > except for these: `<F1>', `<F2>', `<ESC>'.  `<ESC> C-h' is
> > correctly quoted, but `<ESC>' is not quoted, though it should be.
> 
> It is the convention in the manual not to insert `..' around single
> function keys which are already printed like <this>.  Not a 
> bug (and no bike-shedding please).

See attached screenshot.  Are you perhaps trying to make a virtue (and a
convention) out of mistake?  Do you honestly think it is more readable to have
these exceptions?

If you want to get rid of unnecessary wrappers, and have consistency at the same
time, then get rid of the angle brackets.  They serve no purpose whatsoever, as
I've demonstrated before (and can again).

I can even give you the code to get rid of them from the product altogether (not
the doc), with the exception of the C code for `substitute-command-keys', which
someone else will need to patch.  Better: I can give you code that makes them
optional.

Attachment: throw-unquoted-keys.png
Description: PNG image


reply via email to

[Prev in Thread] Current Thread [Next in Thread]