From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.bugs
Subject: bug#66756: 30.0.50;
 [PATCH] Improve discussion of 'let' in Elisp Introduction manual
Date: Sun, 05 Nov 2023 21:29:29 -0500
Message-ID: <E1qzpMn-00023S-L9@fencepost.gnu.org>
References: <a9812c1d-71e4-5f3f-83a4-a2923e649f3a@gmail.com>
Reply-To: rms@gnu.org
Content-Type: text/plain; charset=Utf-8
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="36794"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: 66756@debbugs.gnu.org
To: Jim Porter <jporterbugs@gmail.com>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Nov 06 03:30:48 2023
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>
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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1qzpO3-0009Li-1l
	for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Nov 2023 03:30:47 +0100
Original-Received: from localhost ([::1] helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <bug-gnu-emacs-bounces@gnu.org>)
	id 1qzpNi-0005hQ-GF; Sun, 05 Nov 2023 21:30:26 -0500
Original-Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1qzpNh-0005hB-Jy
 for bug-gnu-emacs@gnu.org; Sun, 05 Nov 2023 21:30:25 -0500
Original-Received: from debbugs.gnu.org ([2001:470:142:5::43])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1qzpNh-000851-B8
 for bug-gnu-emacs@gnu.org; Sun, 05 Nov 2023 21:30:25 -0500
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1qzpOH-0006Gj-SC
 for bug-gnu-emacs@gnu.org; Sun, 05 Nov 2023 21:31:01 -0500
X-Loop: help-debbugs@gnu.org
Resent-From: Richard Stallman <rms@gnu.org>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Mon, 06 Nov 2023 02:31:01 +0000
Resent-Message-ID: <handler.66756.B66756.169923781524026@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 66756
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: patch
Original-Received: via spool by 66756-submit@debbugs.gnu.org id=B66756.169923781524026
 (code B ref 66756); Mon, 06 Nov 2023 02:31:01 +0000
Original-Received: (at 66756) by debbugs.gnu.org; 6 Nov 2023 02:30:15 +0000
Original-Received: from localhost ([127.0.0.1]:38468 helo=debbugs.gnu.org)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
 id 1qzpNW-0006FR-G1
 for submit@debbugs.gnu.org; Sun, 05 Nov 2023 21:30:14 -0500
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43840)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <rms@gnu.org>) id 1qzpNU-0006F7-Lh
 for 66756@debbugs.gnu.org; Sun, 05 Nov 2023 21:30:13 -0500
Original-Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <rms@gnu.org>)
 id 1qzpMo-0007lL-3x; Sun, 05 Nov 2023 21:29:30 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From:
 mime-version; bh=58Zi5U+KcoqOtzT3/iLnWCJ9kilXVHppT5YkMs3oAsk=; b=Wy/Yw5JE4D0J
 Bu9qAIfsAGtcsSMDtWbeSV6jVHM9N7FNqGuNL3sH3Uc5l8ZZVRpPXNWZ01oYt+kHrSXad2qeMEIfw
 taJJk1nN1/BNFiw+ZIZgO40eYZp9gNTsfu/pEQQgS+JvYEVsuNRLeH9VZuduZvuo69L+r96lLfkKz
 kcRFJ7HcRe7o075vuqN42jFuehqgRR2vwDzAB9MtfxHKi0zHj6I5JKDz90GqXPGdEkvYGjGloA2gl
 0zG0rkIV7zn6Y0+JObro+zZh2zDzgI81YVicLa5cdwYGkZaFNrurvBONfzVptLEpz1FSivBET2yhz
 0gI8Z3AbXZNP2hvGqi1k2Q==;
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1)
 (envelope-from <rms@gnu.org>)
 id 1qzpMn-00023S-L9; Sun, 05 Nov 2023 21:29:29 -0500
In-Reply-To: <a9812c1d-71e4-5f3f-83a4-a2923e649f3a@gmail.com> (message from
 Jim Porter on Wed, 25 Oct 2023 22:54:25 -0700)
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" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
 <mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
 <mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org
Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org
Xref: news.gmane.io gmane.emacs.bugs:273853
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/273853>

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

This change is overall a step forward.  Thanks for working on it.

A few specific parts of the new text could use a little cleaning up;
some of those parts are in the current version also.

    +``scope'').  @code{let} creates a name for a @dfn{local variable} that
    +overshadows any use of the same name outside the @code{let} expression
    +(we call this ``binding'' the variable).

The word "overshadows" seems stramge here.  The usual term is "shadows",
and I don't see that "overshadows" adds any clarity.

  >   For historical reasons, Emacs Lisp uses a form of
  > +variable binding called ``dynamic binding''.

This should say "by default", because it isn't always so.  For
instance, if you specify lexical binding, then Emacs Lisp does not use
dynamic binding, except for variables marked special.

  > +lexical binding, you should add something like this to the first line

Delete "something like".



-- 
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)