From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#41571: 27.0.91; "(elisp) Interpolated Strings" is under "(elisp) Text" Date: Thu, 28 May 2020 09:58:47 +0300 Message-ID: <83d06osfyw.fsf@gnu.org> References: <877dwxexsh.fsf@tcd.ie> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="100250"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 41571@debbugs.gnu.org To: "Basil L. Contovounesios" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu May 28 09:00:12 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jeCWR-000Py1-On for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 28 May 2020 09:00:11 +0200 Original-Received: from localhost ([::1]:58390 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jeCWQ-0001O0-QD for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 28 May 2020 03:00:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46722) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jeCWJ-0001Nl-VR for bug-gnu-emacs@gnu.org; Thu, 28 May 2020 03:00:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39272) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jeCWI-0006Fq-LO for bug-gnu-emacs@gnu.org; Thu, 28 May 2020 03:00:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jeCWI-0003K7-IE for bug-gnu-emacs@gnu.org; Thu, 28 May 2020 03:00:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 28 May 2020 07:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41571 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 41571-submit@debbugs.gnu.org id=B41571.159064914512687 (code B ref 41571); Thu, 28 May 2020 07:00:02 +0000 Original-Received: (at 41571) by debbugs.gnu.org; 28 May 2020 06:59:05 +0000 Original-Received: from localhost ([127.0.0.1]:50818 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jeCVN-0003IZ-4D for submit@debbugs.gnu.org; Thu, 28 May 2020 02:59:05 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:39152) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jeCVL-0003I3-Fo for 41571@debbugs.gnu.org; Thu, 28 May 2020 02:59:03 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:56106) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jeCVF-0005fj-KA; Thu, 28 May 2020 02:58:57 -0400 Original-Received: from [176.228.60.248] (port=1153 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jeCVE-0005SP-K2; Thu, 28 May 2020 02:58:57 -0400 In-Reply-To: <877dwxexsh.fsf@tcd.ie> (contovob@tcd.ie) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:181127 Archived-At: > From: "Basil L. Contovounesios" > Date: Thu, 28 May 2020 00:57:34 +0100 > > The Elisp manual node "(elisp) Interpolated Strings", which documents > the function format-spec and is new in Emacs 27, is currently included > under "(elisp) Text", which opens with: > > This chapter describes the functions that deal with the text in a > buffer. Most examine, insert, or delete text in the current buffer, > often operating at point or on text adjacent to point. Many are > interactive. All the functions that change the text provide for undoing > the changes (*note Undo). > > I think a more appropriate location would be following "(elisp) > Formatting Strings", or at least under "(elisp) Strings and Characters". I agree, but can we please take this opportunity to improve that section? First, it uses passive tense too much for no real reason AFAICT. More importantly, the description of the feature is not clear enough. I had trouble understanding even the "trivial example" it shows, let alone all the rest. The very purpose of the feature is not really obvious after reading the text. Thanks.