From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#66756: 30.0.50; [PATCH] Improve discussion of 'let' in Elisp Introduction manual Date: Sat, 18 Nov 2023 22:39:03 -0500 Message-ID: References: <3ade119d-0f0d-e60e-1bdc-9c7e02c1559c@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="6978"; mail-complaints-to="usenet@ciao.gmane.io" Cc: eliz@gnu.org, 66756@debbugs.gnu.org To: Jim Porter Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Nov 19 04:40:13 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 1r4YfN-0001Yf-E7 for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 19 Nov 2023 04:40:13 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r4YfC-0001Y5-UQ; Sat, 18 Nov 2023 22:40:02 -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 1r4YfB-0001XG-8w for bug-gnu-emacs@gnu.org; Sat, 18 Nov 2023 22:40:01 -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 1r4YfB-0000He-0i for bug-gnu-emacs@gnu.org; Sat, 18 Nov 2023 22:40:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1r4YfB-0006PX-Pw for bug-gnu-emacs@gnu.org; Sat, 18 Nov 2023 22:40:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 19 Nov 2023 03:40:01 +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.170036515624551 (code B ref 66756); Sun, 19 Nov 2023 03:40:01 +0000 Original-Received: (at 66756) by debbugs.gnu.org; 19 Nov 2023 03:39:16 +0000 Original-Received: from localhost ([127.0.0.1]:49709 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r4YeS-0006Nv-96 for submit@debbugs.gnu.org; Sat, 18 Nov 2023 22:39:16 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45906) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r4YeP-0006Ng-Np for 66756@debbugs.gnu.org; Sat, 18 Nov 2023 22:39:14 -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 ) id 1r4YeJ-00009g-4M; Sat, 18 Nov 2023 22:39:07 -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=PuH/zNKQuONtt6o4IiolQrlIG2AsQSznZmnIALvR3Co=; b=oWiVr6lnUWkx raZLwbePaeJ4aSA4c+JxGj0sYuW5Lzd9SDIGwGikpNp3RDyLhNj2ihPBncMkOROCuM50MypS3CfsJ ExmmZG1whWkUKSD693UQFnf+5ZrK9YoKfJqYi+bab/DbyNWVcYLEwVLL3u2rJO8dtZSo7fjVO5EDx HlH165bslJlyqx3qEh8vh9DFi4hD7pg78l6yCJlRn6htCDpLk5o6/2BDNmY+RAjRMx3cCTaLXkWL8 Vt4hx6hO4DNEWNDT8NSbMl71oC0WUP1n020UVkSNrXyQQokOa1gPcllHaS2N0JfGcY+pTZ++vDbzy +hi2LLcQD3XInGp8fcc97A==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1r4YeF-0001fe-Ex; Sat, 18 Nov 2023 22:39:04 -0500 In-Reply-To: <3ade119d-0f0d-e60e-1bdc-9c7e02c1559c@gmail.com> (message from Jim Porter on Fri, 17 Nov 2023 18:09:20 -0800) 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:274578 Archived-At: [[[ 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. ]]] I think your changes are good. > +parts a ``scope''). For historical reasons, Emacs Lisp uses a form of > +variable binding called ``dynamic binding'' by default. However, in > +this manual, we discuss the preferred form of binding, called > +``lexical binding'' (if you have programmed in other languages before, > +you're likely already familiar with how lexical binding behaves). In > +order to use lexical binding in a program, you should add this to the > +first line of your Emacs Lisp file: > + > +@example > +;;; -*- lexical-binding: t -*- > +@end example > + > +For more information about this, @pxref{Selecting Lisp Dialect, , , > +elisp, The Emacs Lisp Reference Manual}. Do we want to change the default some day to lexical binding:? If so, we should say so somewhere in this manual -- perhaps here, perhaps elsewhere, > +If we instead change @code{lexical-binding} to have a value of > +@code{nil}, we will get a different result here. "Get a different result" is vague -- it would be clearer if it said concretely what will happen. I suggest you show the dynamci situation in the same way you show the lexical situation. That will help people compare the two. -- 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)