From unknown Tue Aug 19 05:13:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10713: 24.0.93; doc of `local-variable-if-set-p' 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:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10713 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 10713@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.132829291030792 (code B ref -1); Fri, 03 Feb 2012 18:16:02 +0000 Received: (at submit) by debbugs.gnu.org; 3 Feb 2012 18:15:10 +0000 Received: from localhost ([127.0.0.1]:52556 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtNfC-00080a-BN for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:15:10 -0500 Received: from eggs.gnu.org ([140.186.70.92]:37874) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtNfA-00080P-E1 for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:15:09 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtNeR-0004Vg-EW for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:14:29 -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]:59267) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtNeR-0004Vc-D8 for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:14:23 -0500 Received: from eggs.gnu.org ([140.186.70.92]:60751) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtNeN-0002ln-Dx for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:14:23 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtNeC-0004RK-1A for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:14:19 -0500 Received: from rcsinet15.oracle.com ([148.87.113.117]:45823) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtNeB-0004RB-MH for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:14:07 -0500 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id q13IE5iB007702 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 3 Feb 2012 18:14:06 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q13IE4xk011327 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 3 Feb 2012 18:14:05 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 q13IE4NV021794 for ; Fri, 3 Feb 2012 12:14:04 -0600 Received: from dradamslap1 (/10.159.45.74) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 03 Feb 2012 10:14:04 -0800 From: "Drew Adams" Date: Fri, 3 Feb 2012 10:14:00 -0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Aczin5qfmKO3TJbBTf+5uwMyuiVFBw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-CT-RefId: str=0001.0A090203.4F2C23EE.0067,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 (----) 1. The doc string says much more about this function than does the Elisp manual (node Creating Buffer-Local). The manual should say at least as much as the doc string says - it is quite incomplete about this function. 2. The doc string refers the reader to the manual (same node) for more information! AFAICT, there is not more info about this in that node - there is less. If there is more info to be given about this function than what is in the doc string, please add it to the manual. 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 Tue Aug 19 05:13:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10713: 24.0.93; doc of `local-variable-if-set-p' 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:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10713 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: <10713@debbugs.gnu.org> Received: via spool by 10713-submit@debbugs.gnu.org id=B10713.132829372732387 (code B ref 10713); Fri, 03 Feb 2012 18:29:02 +0000 Received: (at 10713) by debbugs.gnu.org; 3 Feb 2012 18:28:47 +0000 Received: from localhost ([127.0.0.1]:52578 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtNsM-0008QJ-5M for submit@debbugs.gnu.org; Fri, 03 Feb 2012 13:28:46 -0500 Received: from rcsinet15.oracle.com ([148.87.113.117]:38911) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtNsJ-0008Q6-W7 for 10713@debbugs.gnu.org; Fri, 03 Feb 2012 13:28:44 -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 q13IS3Ku023565 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <10713@debbugs.gnu.org>; Fri, 3 Feb 2012 18:28:04 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 q13IS26h022653 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <10713@debbugs.gnu.org>; Fri, 3 Feb 2012 18:28:03 GMT Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q13IS2Wh031199 for <10713@debbugs.gnu.org>; Fri, 3 Feb 2012 12:28:02 -0600 Received: from dradamslap1 (/10.159.45.74) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 03 Feb 2012 10:28:02 -0800 From: "Drew Adams" References: Date: Fri, 3 Feb 2012 10:27:59 -0800 Message-ID: <5D0DBEF571C145FF9ED579A519AB713B@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Aczin5qfmKO3TJbBTf+5uwMyuiVFBwAAEn2Q 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.4F2C2734.0038,ss=1,re=0.000,fgs=0 X-Spam-Score: -6.9 (------) 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: -6.9 (------) What's more, this sentence in the doc string (perhaps the most important sentence) seems incorrect. At a minimum it is not clear (to me at least). "More precisely, this means that setting the variable (with `set' or`setq'), while it does not have a `let'-style binding that was made in BUFFER, will produce a buffer local binding." First of all, why the qualification "with `set' or `setq'"? Does it really matter how the variable is _set_? If you are trying to distinguish setting from `let' binding (?) then say so. More importantly, the phrase "while it does not have a `let'-style binding that was made in BUFFER" makes no sense (to me at least). `let' bindings are not made in buffers. If this explanation is trying to say something "more precisely" it is doing a poor job of it. Are you perhaps really trying to say something like the following? "The local value in BUFFER is set, provided the variable is not currently `let' bound." Please clarify this doc. Try using more than one sentence to get your point across, for a start. That will likely help you say what you are really trying to say (which is not clear to me). From unknown Tue Aug 19 05:13:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10713: 24.0.93; doc of `local-variable-if-set-p' Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 07 Sep 2012 14:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10713 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 10713@debbugs.gnu.org Received: via spool by 10713-submit@debbugs.gnu.org id=B10713.134702737326319 (code B ref 10713); Fri, 07 Sep 2012 14:17:01 +0000 Received: (at 10713) by debbugs.gnu.org; 7 Sep 2012 14:16:13 +0000 Received: from localhost ([127.0.0.1]:46687 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zLw-0006qR-O4 for submit@debbugs.gnu.org; Fri, 07 Sep 2012 10:16:13 -0400 Received: from mail-ie0-f172.google.com ([209.85.223.172]:36879) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zLv-0006qL-DC for 10713@debbugs.gnu.org; Fri, 07 Sep 2012 10:16:12 -0400 Received: by ieak13 with SMTP id k13so5057461iea.3 for <10713@debbugs.gnu.org>; Fri, 07 Sep 2012 07:15:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=Mt/BXJRZX4PSS81xkzASCdKSUsD4G77KQXtai3GpjCM=; b=VNNU92UcRvyvAXI50U8Pl4EyTRmSfxEJ2SagIyuBf+EbREl63rIybRy85+QVpNgiyd CbdcicBMB15jQGl4FogR7rgpDaE0SVZY2P4fq+tFn0k6DWKSQdh/uOEDN1DnCZmmkREW AyUkl3mNqbjF1LPlOWb/bSKf5bT6V41lNSc6KY/hmQaehjrZKX0UVS+6cjIbuegcfCMQ 3IbUmfPw3S9BNOYbUebBDvCKDfVshEQ4HZ19yo8kydcCWqf6TbVO66XwPwQlWmjKewRS ZwKP3dqLc/7CgPBKxCb6cdRb5rX0ruROIsbz+6ZeJH0fii6/JA3YdGhh5QJwlP17jMIJ VATA== Received: by 10.50.159.194 with SMTP id xe2mr8887763igb.62.1347027352903; Fri, 07 Sep 2012 07:15:52 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id i17sm8256016igd.5.2012.09.07.07.15.49 (version=SSLv3 cipher=OTHER); Fri, 07 Sep 2012 07:15:51 -0700 (PDT) From: Chong Yidong References: Date: Fri, 07 Sep 2012 22:15:44 +0800 In-Reply-To: (Drew Adams's message of "Fri, 3 Feb 2012 10:14:00 -0800") Message-ID: <87vcfpudf3.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) 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: -2.6 (--) "Drew Adams" writes: > 1. The doc string says much more about this function than does the Elisp > manual (node Creating Buffer-Local). The manual should say at least as > much as the doc string says - it is quite incomplete about this > function. > > 2. The doc string refers the reader to the manual (same node) for more > information! AFAICT, there is not more info about this in that node - > there is less. If there is more info to be given about this function > than what is in the doc string, please add it to the manual. Fixed in trunk. From debbugs-submit-bounces@debbugs.gnu.org Fri Sep 07 10:16:36 2012 Received: (at control) by debbugs.gnu.org; 7 Sep 2012 14:16:36 +0000 Received: from localhost ([127.0.0.1]:46690 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zMJ-0006r5-8j for submit@debbugs.gnu.org; Fri, 07 Sep 2012 10:16:36 -0400 Received: from mail-ie0-f172.google.com ([209.85.223.172]:36879) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zMH-0006qL-0g for control@debbugs.gnu.org; Fri, 07 Sep 2012 10:16:33 -0400 Received: by mail-ie0-f172.google.com with SMTP id k13so5057461iea.3 for ; Fri, 07 Sep 2012 07:16:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type; bh=Jbu4iQzuZpEMhm1w+VTAsFxqmWBeVbXRs4Q4Z06WX/8=; b=vyPsPPx5ev9zmD6hyeUZWXEQecXgMtNr61Wz5s8jLQHb0clD7gh9v7R9+Xy9cF26e2 naFbnzHTQ0H3hhwnG7P9za5PA+bwDC4qXyKdbwRlr6MpQlL40iCAqpkL9hSj7gurMP3c BpeSADNoB9ZylCFM9pwzN5zN5xrjRutsGVJawtpxl38whErLRj8JU30+ngVqrIjLPzLB /aFGDIxsQ/0iGOf5wdT6uxksIaO5vuBzmyEOlxR6ALl/8alfzF/VExIkHDHVyxnax/6C UTuP9nfWq4CYKB769PGfw2SEs/Otd9OZC1R9Q/tnrEvqfLV7+fhuaQs4yCkwEz9HeF1t IIBA== Received: by 10.50.186.169 with SMTP id fl9mr9152956igc.9.1347027374835; Fri, 07 Sep 2012 07:16:14 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id 10sm13129266igf.11.2012.09.07.07.16.10 (version=SSLv3 cipher=OTHER); Fri, 07 Sep 2012 07:16:14 -0700 (PDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 10713 Date: Fri, 07 Sep 2012 22:16:04 +0800 Message-ID: <87pq5xsyu3.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) 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: -2.6 (--) close 10713 thanks