Re: Emacs 26.1 release branch created

[Paul Eggert]

On 09/22/2017 11:04 AM, Alan Mackenzie wrote:
> the main point here is to remind the reader that quotes can be
> output as is by binding text-quoting-style

But that's not how Elisp code typically outputs quotes as is. I see no 
instances of such a thing in the emacs-26 branch. Instead, code 
typically uses backslash escapes (in doc strings) or %s applied to the 
output of 'format' (in message formats). It's better for the Elisp 
manual to suggest the techniques that are typically used.

> Perhaps you could suggest an improved wording
Sure, a suggested patch is attached. This patch attempts to address only 
this issue; it doesn't affect whether text-quoting-style is 
customizable, as that is orthogonal. Since there were three or four 
copies of boilerplate language that was getting longer, this patch 
creates a new node Text Quoting Style that contains the detailed 
discussion of text-quoting-style and how to get around it, and adjusts 
the other parts of the manual to mention the issue briefly and 
cross-reference to the new section.

0001-Improve-text-quoting-style-doc-in-lispref.txt
Description: Text document