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

["Drew Adams" <drew.adams@oracle.com>]

[-- Attachment #1: Type: text/plain, Size: 1073 bytes --]

> > 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 #2: throw-unquoted-keys.png --]
[-- Type: image/png, Size: 8647 bytes --]