From unknown Wed Jun 25 09:12:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10715: 24.0.93; doc of `buffer-local-variables' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 03 Feb 2012 18:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10715 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 10715@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.13282952352293 (code B ref -1); Fri, 03 Feb 2012 18:54:02 +0000 Received: (at submit) by debbugs.gnu.org; 3 Feb 2012 18:53:55 +0000 Received: from localhost ([127.0.0.1]:52607 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtOGg-0000av-JW for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:53:55 -0500 Received: from eggs.gnu.org ([140.186.70.92]:41040) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtOGe-0000ai-Eg for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:53:53 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtOG0-0003Xn-ET for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:53:13 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([140.186.70.17]:39842) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtOG0-0003Xj-D0 for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:53:12 -0500 Received: from eggs.gnu.org ([140.186.70.92]:36494) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtOFu-00044g-Sz for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:53:12 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtOFs-0003Wb-TN for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:53:06 -0500 Received: from rcsinet15.oracle.com ([148.87.113.117]:62020) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtOFs-0003WL-Jw for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:53:04 -0500 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id q13Ir078020477 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 3 Feb 2012 18:53:01 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q13IqxV7029659 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 3 Feb 2012 18:53:00 GMT Received: from abhmt117.oracle.com (abhmt117.oracle.com [141.146.116.69]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q13IqwRG015354 for ; Fri, 3 Feb 2012 12:52:59 -0600 Received: from dradamslap1 (/10.159.45.74) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 03 Feb 2012 10:52:58 -0800 From: "Drew Adams" Date: Fri, 3 Feb 2012 10:52:55 -0800 Message-ID: <6A5A7120307D41EBA84CBDB433286922@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AczipQpFFKUxf4MmSBqsBjw3gnR4aw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.4F2C2D0E.0001,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -4.2 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) (elisp) `Creating Buffer-Local' says: "However, when a variable's buffer-local binding in BUFFER is void, then the variable appears directly in the resulting list." It is true that a Lisp variable is a symbol. But this sentence is not as clear as it could be, because some readers will not immediately understand that "the variable appears directly in the resulting list" means that the corresponding list element is the symbol. The doc string is clearer (and shorter) in this case: "For a symbol that is locally unbound, just the symbol appears in the value." The manual is right to mention BUFFER explicitly in this regard, but the wording should be made clearer. In GNU Emacs 24.0.93.1 (i386-mingw-nt5.1.2600) of 2012-01-29 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include --ldflags -LD:/devel/emacs/libs/gnutls-3.0.9/lib' From unknown Wed Jun 25 09:12:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10715: 24.0.93; doc of `buffer-local-variables' Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 07 Feb 2012 06:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10715 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 10715@debbugs.gnu.org Received: via spool by 10715-submit@debbugs.gnu.org id=B10715.13285965531789 (code B ref 10715); Tue, 07 Feb 2012 06:36:02 +0000 Received: (at 10715) by debbugs.gnu.org; 7 Feb 2012 06:35:53 +0000 Received: from localhost ([127.0.0.1]:58109 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rueed-0000Sm-Hi for submit@debbugs.gnu.org; Tue, 07 Feb 2012 01:35:52 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:33322 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rueeb-0000Se-B2 for 10715@debbugs.gnu.org; Tue, 07 Feb 2012 01:35:50 -0500 Received: from [155.69.16.237] (port=57875 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1Ruedi-0006C1-B9; Tue, 07 Feb 2012 01:34:54 -0500 From: Chong Yidong References: <6A5A7120307D41EBA84CBDB433286922@us.oracle.com> Date: Tue, 07 Feb 2012 14:34:47 +0800 In-Reply-To: <6A5A7120307D41EBA84CBDB433286922@us.oracle.com> (Drew Adams's message of "Fri, 3 Feb 2012 10:52:55 -0800") Message-ID: <87haz3xibc.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.93 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) "Drew Adams" writes: > The manual is right to mention BUFFER explicitly in this regard, but the > wording should be made clearer. Fixed, thanks. From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 07 01:36:06 2012 Received: (at control) by debbugs.gnu.org; 7 Feb 2012 06:36:06 +0000 Received: from localhost ([127.0.0.1]:58113 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rueep-0000TU-GY for submit@debbugs.gnu.org; Tue, 07 Feb 2012 01:36:04 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:33329 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rueem-0000T0-1f for control@debbugs.gnu.org; Tue, 07 Feb 2012 01:36:00 -0500 Received: from [155.69.16.237] (port=57876 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1Ruedt-0006Dy-6d for control@debbugs.gnu.org; Tue, 07 Feb 2012 01:35:05 -0500 From: Chong Yidong To: control@debbugs.gnu.org Subject: close 10715 Date: Tue, 07 Feb 2012 14:34:59 +0800 Message-ID: <8739anb17w.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) close 10715 thanks