Re: Trunk still not open

[Glenn Morris]

Dmitry Gutov wrote:

> I see that no one has commented on "documenting the changes in triplicate".

The Emacs manual and the lispref should not duplicate each other (in
non-trivial ways). The manual describes the user-level interface, and
the lispref the programmer-level interface (the distinction between the
two can be a bit grey of course), and they should cross-reference each
other where relevant.

In this specific case, I think you found an example where the lispref
repeats too much information from the manual. The manual should document
what blink-matching-paren does, and how to turn it off, and what (main)
customization options exists. The lispref should contain the stuff about
blink-paren-function and blink-matching-open. The descriptions of
blink-matching-paren, blink-matching-paren-distance,
blink-matching-delay should probably be removed from the lispref in
favour of a cross-reference to the Emacs manual.