From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#31052: 26.0.91; Improve documentation of inline-letevals Date: Wed, 04 Apr 2018 09:45:50 +0300 Message-ID: <83efjv4ggx.fsf@gnu.org> References: <87a7uj24kk.fsf@runbox.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1522824252 15762 195.159.176.226 (4 Apr 2018 06:44:12 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 4 Apr 2018 06:44:12 +0000 (UTC) Cc: 31052@debbugs.gnu.org To: Gemini Lasswell Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Apr 04 08:44:08 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1f3c9O-0003yM-Ri for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Apr 2018 08:44:06 +0200 Original-Received: from localhost ([::1]:37785 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f3cBS-0006Te-Fo for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Apr 2018 02:46:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56926) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f3cBK-0006TL-VI for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 02:46:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f3cBG-0002eG-1y for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 02:46:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:57879) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1f3cBF-0002dp-TV for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 02:46:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1f3cBF-0006Xs-MV for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 02:46:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Apr 2018 06:46:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31052 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31052-submit@debbugs.gnu.org id=B31052.152282435225142 (code B ref 31052); Wed, 04 Apr 2018 06:46:01 +0000 Original-Received: (at 31052) by debbugs.gnu.org; 4 Apr 2018 06:45:52 +0000 Original-Received: from localhost ([127.0.0.1]:37543 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f3cB6-0006XS-3J for submit@debbugs.gnu.org; Wed, 04 Apr 2018 02:45:52 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:37656) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f3cB5-0006XG-1m for 31052@debbugs.gnu.org; Wed, 04 Apr 2018 02:45:51 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f3cAu-00025C-Up for 31052@debbugs.gnu.org; Wed, 04 Apr 2018 02:45:45 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:33680) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f3cAu-00024z-RE; Wed, 04 Apr 2018 02:45:40 -0400 Original-Received: from [176.228.60.248] (port=3617 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1f3cAu-0003hp-DM; Wed, 04 Apr 2018 02:45:40 -0400 In-reply-to: <87a7uj24kk.fsf@runbox.com> (message from Gemini Lasswell on Tue, 03 Apr 2018 17:33:31 -0700) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:144873 Archived-At: > From: Gemini Lasswell > Date: Tue, 03 Apr 2018 17:33:31 -0700 > > I just got acquainted with inline-letevals and found its description > in the Elisp manual confusing because the purpose of the macro is not > stated, and it is described as similar to 'let' without mention of an > important difference in what happens to the elements of the bindings > list which are symbols. > > Here's a patch to functions.texi where I've attempted to clarify the > description. Thanks, but your text left me confused, perhaps because it mixes the details of the syntax and semantics with the explanation of why and how to use them, and what is the result of such usage. These should be generally kept separate for clarity. How about if you first tell informally what information is missing from the original text, and then we see how to augment that by adding the missing bits?