From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Gemini Lasswell Newsgroups: gmane.emacs.bugs Subject: bug#31052: 26.0.91; Improve documentation of inline-letevals Date: Wed, 04 Apr 2018 10:10:39 -0700 Message-ID: <87vad6zyls.fsf@runbox.com> References: <87a7uj24kk.fsf@runbox.com> <83efjv4ggx.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1522861811 16145 195.159.176.226 (4 Apr 2018 17:10:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 4 Apr 2018 17:10:11 +0000 (UTC) User-Agent: mu4e 0.9.18; emacs 26.0.91 Cc: 31052@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Apr 04 19:10:07 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 1f3lvC-00045s-Ee for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Apr 2018 19:10:06 +0200 Original-Received: from localhost ([::1]:44356 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f3lxH-0006aA-V1 for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Apr 2018 13:12:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43234) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f3lx9-0006Zz-JZ for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 13:12:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f3lx4-0003hx-LT for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 13:12:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:58873) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1f3lx4-0003hT-GH for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 13:12:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1f3lx4-0006LG-4y for bug-gnu-emacs@gnu.org; Wed, 04 Apr 2018 13:12:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Gemini Lasswell Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Apr 2018 17:12:02 +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.152286186224305 (code B ref 31052); Wed, 04 Apr 2018 17:12:02 +0000 Original-Received: (at 31052) by debbugs.gnu.org; 4 Apr 2018 17:11:02 +0000 Original-Received: from localhost ([127.0.0.1]:38537 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f3lw6-0006Jw-BD for submit@debbugs.gnu.org; Wed, 04 Apr 2018 13:11:02 -0400 Original-Received: from aibo.runbox.com ([91.220.196.211]:41184) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f3lw3-0006JX-Ut for 31052@debbugs.gnu.org; Wed, 04 Apr 2018 13:11:00 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=runbox.com; s=rbselector1; h=Content-Type:MIME-Version:Message-ID:Date:In-reply-to: Subject:Cc:To:From:References; bh=Aoktw11cXoPttzBvGUamq9dslJVfckqLySc43kI/Ba4=; b=Dzgbutn4APCaMfLqWjv3IjBL2N va2RlXLSK1gWgeo3zaqQYDEXG6Dz+WmICAh/5aIXv116JrkOIHj3l5frzpfDEzvCLuySEeVAtGmh/ gab1s1zpkMkjCeZkWHgp6552XPvx9rv2uOL9Dxkmx6j9Iv/1GfrUDAjut1DEixmWOJo+6NDiQq92h Y61aPOiWLyRVfQPYDJYMdV5Nt4XuQZpZafTox7YXt8CSyk4PoJ1UKyOMCi9oIGaxmjxPAQdhXBh04 ACrq0NaWfiAmWu0rLCJ6it1M1eCPmHxzFpCMRpGC0TjX8umx3LZtDEeKq+TSNWizaVyILpYon56Iv dXcjCOOA==; Original-Received: from [10.9.9.212] (helo=mailfront12.runbox.com) by mailtransmit03.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1f3lw2-0002ge-FF; Wed, 04 Apr 2018 19:10:58 +0200 Original-Received: from c-24-22-244-161.hsd1.wa.comcast.net ([24.22.244.161] helo=sockeye) by mailfront12.runbox.com with esmtpsa (uid:179284 ) (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) id 1f3lvt-0000MD-Q0; Wed, 04 Apr 2018 19:10:50 +0200 In-reply-to: <83efjv4ggx.fsf@gnu.org> 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:144892 Archived-At: Eli Zaretskii writes: > 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? The main question the existing documentation doesn't answer is what the purpose of inline-letevals is and why it should be used instead of 'let'. The misleading part of the existing documentation is that it describes inline-letevals as similar to 'let' without mentioning that it does a completely different thing to symbols in the binding list.