From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas 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: References: <3ade119d-0f0d-e60e-1bdc-9c7e02c1559c@gmail.com> <381836df-c16f-b3e7-d0c4-473290e165de@gmail.com> <9239b6bd-b476-b6c1-aef9-245e439aee42@gmail.com> <83jzq7fx5o.fsf@gnu.org> <64d90b0b-e003-7bc3-5312-6c7ab4c4591f@gmail.com> <838r6nfkfj.fsf@gnu.org> <83jzq6e0dn.fsf@gnu.org> <0fe9fc29-11d5-2983-8970-3f4b7969df2d@gmail.com> <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 , 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: 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 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 ) 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 ) 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 ) 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 ) 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 Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Dec 2023 23:11:02 +0000 Resent-Message-ID: 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 ) 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 ) 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" 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:276391 Archived-At: Jim Porter 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.