From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10713: 24.0.93; doc of `local-variable-if-set-p' Date: Fri, 3 Feb 2012 10:27:59 -0800 Message-ID: <5D0DBEF571C145FF9ED579A519AB713B@us.oracle.com> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1328293719 18674 80.91.229.3 (3 Feb 2012 18:28:39 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 3 Feb 2012 18:28:39 +0000 (UTC) To: <10713@debbugs.gnu.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Feb 03 19:28:39 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RtNsC-000535-8f for geb-bug-gnu-emacs@m.gmane.org; Fri, 03 Feb 2012 19:28:36 +0100 Original-Received: from localhost ([::1]:40310 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtNsB-0007Mp-Jw for geb-bug-gnu-emacs@m.gmane.org; Fri, 03 Feb 2012 13:28:35 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:52010) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtNs8-0007MU-MF for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:28:33 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtNs4-0006Fk-RG for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:28:32 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48956) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtNs4-0006Fg-OV for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:28:28 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RtNsc-0008Qx-Ee for bug-gnu-emacs@gnu.org; Fri, 03 Feb 2012 13:29:02 -0500 X-Loop: help-debbugs@gnu.org 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: Original-Received: via spool by 10713-submit@debbugs.gnu.org id=B10713.132829372732387 (code B ref 10713); Fri, 03 Feb 2012 18:29:02 +0000 Original-Received: (at 10713) by debbugs.gnu.org; 3 Feb 2012 18:28:47 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: from dradamslap1 (/10.159.45.74) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 03 Feb 2012 10:28:02 -0800 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 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.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:56438 Archived-At: 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).