From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: Emacs 26.1 release branch created Date: Tue, 19 Sep 2017 12:11:02 -0700 Organization: UCLA Computer Science Department Message-ID: References: <83377mls4d.fsf@gnu.org> <20170919173511.GA19168@ACM> <83bmm6h8vr.fsf@gnu.org> <20170919180944.GB19168@ACM> <838thah71i.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------8BFA2EC2FAA2B27667237B2E" X-Trace: blaine.gmane.org 1505848348 10024 195.159.176.226 (19 Sep 2017 19:12:28 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 19 Sep 2017 19:12:28 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0 Cc: jwiegley@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii , Alan Mackenzie Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Sep 19 21:12:23 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1duNwT-0002G0-GW for ged-emacs-devel@m.gmane.org; Tue, 19 Sep 2017 21:12:21 +0200 Original-Received: from localhost ([::1]:44951 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1duNwa-0001S2-TE for ged-emacs-devel@m.gmane.org; Tue, 19 Sep 2017 15:12:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52175) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1duNvM-0001AH-9u for emacs-devel@gnu.org; Tue, 19 Sep 2017 15:11:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1duNvL-0004dG-5v for emacs-devel@gnu.org; Tue, 19 Sep 2017 15:11:12 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:57012) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1duNvH-0004ZF-D6; Tue, 19 Sep 2017 15:11:07 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id C1ACD160078; Tue, 19 Sep 2017 12:11:05 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id fbI7UWeL7nnp; Tue, 19 Sep 2017 12:11:03 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 98466160A5A; Tue, 19 Sep 2017 12:11:03 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id SMRXvMvYh3yN; Tue, 19 Sep 2017 12:11:03 -0700 (PDT) Original-Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 7B412160078; Tue, 19 Sep 2017 12:11:03 -0700 (PDT) In-Reply-To: <838thah71i.fsf@gnu.org> Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:218534 Archived-At: This is a multi-part message in MIME format. --------------8BFA2EC2FAA2B27667237B2E Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit On 09/19/2017 11:34 AM, Eli Zaretskii wrote: > So for now, I think we should leave things as they are and wait for > feedback. To address some of Alan's concerns, how about adding a brief note to the user manual, in its section "Display Custom" that already says "Beginning users can skip [this section]" and that already mentions things like tty-suppress-bold-inverse-default-colors that are meant for expert users. Something like the attached, perhaps? --------------8BFA2EC2FAA2B27667237B2E Content-Type: text/x-patch; name="0001-Mention-text-quoting-style-in-user-manual.patch" Content-Disposition: attachment; filename="0001-Mention-text-quoting-style-in-user-manual.patch" Content-Transfer-Encoding: quoted-printable >From dab4b8b8fe444412ac017278ee4c801f2fe6fb24 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Tue, 19 Sep 2017 12:08:37 -0700 Subject: [PATCH] Mention text-quoting-style in user manual * doc/emacs/display.texi (Display Custom): Document text-quoting-style, briefly. Lack of documentation noted by Alan Mackenzie in: http://lists.gnu.org/archive/html/emacs-devel/2017-09/msg00632.html --- doc/emacs/display.texi | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi index 2aa79e1161..878632692e 100644 --- a/doc/emacs/display.texi +++ b/doc/emacs/display.texi @@ -1839,6 +1839,15 @@ Display Custom @code{tty-suppress-bold-inverse-default-colors} with a non-@code{nil} argument to suppress the effect of bold-face in this case. =20 +@vindex text-quoting-style + Emacs infers how to quote in messages, help and info by examining +its environment. By default, Emacs quotes @t{=E2=80=98like this=E2=80=99= } with curved +single quotes if displayable, and @t{`like this'} with grave accent +and apostrophe otherwise. If the default does not work for you, you +can override it by setting the variable @code{text-quoting-style}. +@xref{Keys in Documentation,, Substituting Key Bindings in +Documentation, elisp, The GNU Emacs Lisp Reference Manual}. + @vindex display-raw-bytes-as-hex Raw bytes are displayed in octal format by default, for example a byte with a decimal value of 128 is displayed as @code{\200}. To --=20 2.13.5 --------------8BFA2EC2FAA2B27667237B2E--