From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Stefan Kangas <stefankangas@gmail.com>
Newsgroups: gmane.emacs.bugs
Subject: bug#66756: 30.0.50;
 [PATCH] Improve discussion of 'let' in Elisp Introduction manual
Date: Sat, 16 Dec 2023 15:10:08 -0800
Message-ID: <CADwFkmk0uvEFwNad0V_KLGt7aRkpKFuq=hhKmHcX=xqifNECBQ@mail.gmail.com>
References: <a9812c1d-71e4-5f3f-83a4-a2923e649f3a@gmail.com>
 <a5120e2f-b008-1b74-1ad9-3fe7d861b13c@gmail.com>
 <E1qx8nq-0007DY-HV@fencepost.gnu.org>
 <3ade119d-0f0d-e60e-1bdc-9c7e02c1559c@gmail.com>
 <E1r4YeF-0001fe-Ex@fencepost.gnu.org>
 <381836df-c16f-b3e7-d0c4-473290e165de@gmail.com>
 <f44cca7f-13bb-a41a-c9ce-55f1b736c52b@gmail.com>
 <E1r5zuY-00041H-Bl@fencepost.gnu.org>
 <9239b6bd-b476-b6c1-aef9-245e439aee42@gmail.com>
 <83jzq7fx5o.fsf@gnu.org> <64d90b0b-e003-7bc3-5312-6c7ab4c4591f@gmail.com>
 <838r6nfkfj.fsf@gnu.org> <fb691578-f89f-d0d1-aab0-7e9e4236bab1@gmail.com>
 <83jzq6e0dn.fsf@gnu.org> <0fe9fc29-11d5-2983-8970-3f4b7969df2d@gmail.com>
 <E1r9zK1-0003MB-PT@fencepost.gnu.org>
 <8cea0f24-e868-2236-2697-bd4af1c863d3@gmail.com>
 <96a00148-c5a8-7bd5-f9f0-eca3ddd9783b@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="1680"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: eliz@gnu.org, 66756@debbugs.gnu.org
To: Jim Porter <jporterbugs@gmail.com>, rms@gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Dec 17 00:11:14 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 1rEdoQ-0000JT-CA
	for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 17 Dec 2023 00:11:14 +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 1rEdoL-0006gT-BK; Sat, 16 Dec 2023 18:11:09 -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 1rEdoF-0006fX-CR
 for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2023 18:11:04 -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 1rEdoD-0004nm-EB
 for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2023 18:11:03 -0500
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1rEdoE-0005GX-7y
 for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2023 18:11:02 -0500
X-Loop: help-debbugs@gnu.org
Resent-From: Stefan Kangas <stefankangas@gmail.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Sat, 16 Dec 2023 23:11:02 +0000
Resent-Message-ID: <handler.66756.B66756.170276821820185@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.170276821820185
 (code B ref 66756); Sat, 16 Dec 2023 23:11:02 +0000
Original-Received: (at 66756) by debbugs.gnu.org; 16 Dec 2023 23:10:18 +0000
Original-Received: from localhost ([127.0.0.1]:56329 helo=debbugs.gnu.org)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
 id 1rEdnV-0005FV-PX
 for submit@debbugs.gnu.org; Sat, 16 Dec 2023 18:10:18 -0500
Original-Received: from mail-wr1-x435.google.com ([2a00:1450:4864:20::435]:44133)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stefankangas@gmail.com>) id 1rEdnT-0005FF-RA
 for 66756@debbugs.gnu.org; Sat, 16 Dec 2023 18:10:16 -0500
Original-Received: by mail-wr1-x435.google.com with SMTP id
 ffacd0b85a97d-33664cc674bso8732f8f.0
 for <66756@debbugs.gnu.org>; Sat, 16 Dec 2023 15:10:14 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=gmail.com; s=20230601; t=1702768209; x=1703373009; darn=debbugs.gnu.org;
 h=cc:to:subject:message-id:date:mime-version:references:in-reply-to
 :from:from:to:cc:subject:date:message-id:reply-to;
 bh=hD1ElKuc23iptgCmDKu5oQCRxuax8efNs5c97lnJ3b4=;
 b=X3cY7uj68VRZA9yJXIS2E+JK+c5NSH2cEW6tNmNduOhikBm/ucqdDmndHVJzyV2Xu8
 kYafoMbaSRblOO3+Smx+y7lMf9me/uwyN8QHS5WjgDvyoTvMKBTBQZwJAWT3T1ZgUPhv
 eRDIF2qrdSzeHHcNDkHXG5kmKtWEtJmtboCzwJK75aLvxAHncWoGLKX33PTDtU2t3KSB
 uMuq8a1HO+wQt34F0VcXwV/qx0KP60BxH1udZm1zPN4O8XJe8vboKlHODnGkyH1j908Y
 Op5Jn7I7srND4iYwNnsjQPOqoXRgmLAlVxO9H920nRqIYE+XVxbN2MZcF8Bj/SVSHG6W
 NjrQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20230601; t=1702768209; x=1703373009;
 h=cc:to:subject:message-id:date:mime-version:references:in-reply-to
 :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;
 bh=hD1ElKuc23iptgCmDKu5oQCRxuax8efNs5c97lnJ3b4=;
 b=jo/Q7zBcJ5TnsKXYXEL62WPH1Q87Z2DrZvekBfugSV69fxBvWEFKhriYjU26c/+dDN
 bCWMn8y6H45AcS+gmuedgCyE7Lttb+v0ALih0kAc20UFC+nP6pmGZyL18ddAju3ENe4W
 UKJ/EvrUjUCwg0Quo3bdcw34L/Uw4BrGCisgKUjM62p1y2KygsyPBWDcKeXA+zk2JeXT
 onqFc8EqE8W5jHPPrR7tV/SVVHHr10Sthnt1OxMtXf17+B8iQ3aYoSPhnhREs7Tp8ImF
 EgmzmBBFrk17UrjQo23AhuWN1KCD6HVUZ6tw8HzRUqbsdzj0EP/QCiEDxbb9qyK38mVb
 JOWw==
X-Gm-Message-State: AOJu0YyzUUBCcOV93Stzc8IsgJrein4aEMp8M5ObYRFIZqSlHcf7Xt5b
 g7790ULrG810FDhq4TT0Nm7nvMuvF2sBQPMjbJk=
X-Google-Smtp-Source: AGHT+IGTOPi7OgyfiOLyto/EivbGt31y1qY6z2C1YfZlsJV76OTU6qZHzgDUfg8k3dz4lGWXoDoKXqRpIRDYaBUi+QM=
X-Received: by 2002:a05:6000:551:b0:334:32d:63df with SMTP id
 b17-20020a056000055100b00334032d63dfmr6515813wrf.25.1702768208894; Sat, 16
 Dec 2023 15:10:08 -0800 (PST)
Original-Received: from 753933720722 named unknown by gmailapi.google.com with
 HTTPREST; Sat, 16 Dec 2023 15:10:08 -0800
In-Reply-To: <96a00148-c5a8-7bd5-f9f0-eca3ddd9783b@gmail.com>
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:276391
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/276391>

Jim Porter <jporterbugs@gmail.com> writes:

> On 12/3/2023 8:34 PM, Jim Porter wrote:
>> I've split this into a main section and two subnodes: one describing how
>> lexical and dynamic binding work, and one showing an example of how they
>> behave differently in practice. Maybe the titles could be improved, but
>> they're the best I could come up with at the time...
>
> Does anyone have any further comments on this patch? If not, I'll merge
> it into the master branch in the next few days. (Of course, we can
> always improve it more after merging if someone has a suggestion.)

I suggest merging it to emacs-29.  If we indeed think it's better, let's
get the improved documentation into users' hands.