[Top][All Lists]

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

Re: Emacs 26.1 release branch created

From: John Wiegley
Subject: Re: Emacs 26.1 release branch created
Date: Sun, 24 Sep 2017 21:23:48 -0700
User-agent: Gnus/5.130016 (Ma Gnus v0.16) Emacs/26.0 (darwin)

>>>>> "PE" == Paul Eggert <address@hidden> writes:

PE> The main issue is whether text-quoting-style should be customizable, as
PE> opposed to being a simple Lisp variable as it is now. Eli said "no", you
PE> said "yes", and as I recall this issue was unresolved the last time it was
PE> mentioned on this list. (I don't care, myself.)

It will be customizable, this is decided, as Eli has told me he's OK with it.

PE> 1. Whether the manual should recommend routinely let-binding
PE> text-quoting-style, a style that Alan favors. I think it should recommend 
PE> (message "%s" ...)
PE> style that the Emacs source code itself uses, as this style is more flexible
PE> and reliable. (I can give examples of why, if you care.)

I think (message "%s") is both simpler and more future proof, since we may end
up with other features that this could apply to.

PE> 2. Alan wants the description of every affected function to have a big
PE> paragraph about text quoting, whereas I prefer to replace those big
PE> paragraphs with short blurbs that reference a single (new) section that
PE> covers the issue in more detail than the big paragraphs would.

References to a single elaborated paragraph will make for much easier
maintenance of the documentation, so let's do that.

John Wiegley                  GPG fingerprint = 4710 CF98 AF9B 327B B80F
http://newartisans.com                          60E1 46C4 BD1A 7AC1 4BA2

reply via email to

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