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#8460: 24.0.50; Doc string of `lexical-binding' Date: Fri, 15 Jul 2011 07:01:10 -0700 Message-ID: References: <17D4B6B946FD4F9EB9FF1E76E746E68D@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1310739739 9880 80.91.229.12 (15 Jul 2011 14:22:19 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 15 Jul 2011 14:22:19 +0000 (UTC) Cc: 8460@debbugs.gnu.org To: "'Lars Magne Ingebrigtsen'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 15 16:22:15 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QhjHS-0008Kc-V6 for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Jul 2011 16:22:15 +0200 Original-Received: from localhost ([::1]:54019 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhjHS-00011K-1V for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Jul 2011 10:22:14 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:52857) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qhixy-0004Wz-8M for bug-gnu-emacs@gnu.org; Fri, 15 Jul 2011 10:02:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qhixv-0000NS-WB for bug-gnu-emacs@gnu.org; Fri, 15 Jul 2011 10:02:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36325) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qhixv-0000NB-A8 for bug-gnu-emacs@gnu.org; Fri, 15 Jul 2011 10:02:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qhixu-0000Rk-Eq; Fri, 15 Jul 2011 10:02:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 15 Jul 2011 14:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8460 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 8460-submit@debbugs.gnu.org id=B8460.13107384911677 (code B ref 8460); Fri, 15 Jul 2011 14:02:02 +0000 Original-Received: (at 8460) by debbugs.gnu.org; 15 Jul 2011 14:01:31 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhixO-0000Qy-HA for submit@debbugs.gnu.org; Fri, 15 Jul 2011 10:01:30 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhixJ-0000QO-RH for 8460@debbugs.gnu.org; Fri, 15 Jul 2011 10:01:26 -0400 Original-Received: from rtcsinet22.oracle.com (rtcsinet22.oracle.com [66.248.204.30]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6FE1HM5015886 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 15 Jul 2011 14:01:19 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6FE1GvF004387 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 15 Jul 2011 14:01:17 GMT Original-Received: from abhmt108.oracle.com (abhmt108.oracle.com [141.146.116.60]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6FE1BAe028530; Fri, 15 Jul 2011 09:01:11 -0500 Original-Received: from dradamslap1 (/10.159.34.212) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 15 Jul 2011 07:01:10 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: AcxC8bW13zkzhxeEQjC1G46Jgfs+KwABTnYg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet22.oracle.com [66.248.204.30] X-CT-RefId: str=0001.0A090201.4E20482F.018E:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 15 Jul 2011 10:02:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:49138 Archived-At: > > It says that it "only applies to code evaluated by `eval-buffer' and > > `eval-region'." That is at best misleading. `C-M-x' > > eventually calls `eval-region', but a user would not guess that the > > doc string applies also to `C-M-x'. It would perhaps be better to > > characterize the situations where it does _not_ apply to code > > evaluation. > > True. But I've, at least, changed the doc text to clarify that it > doesn't "only" apply to these functions. Good. But it needs to somehow characterize what contexts it applies to and what it does not apply to (when it has an effect or does not). I haven't seen your fix, but it could be misleading to just mention `eval-*' even if you remove "only". > > It is also misleading in that it is sufficient to visit a > > file, such as `minibuffer.el', that has "-*- lexical-binding: t -*-" > > in its first line, for the value to be non-nil and thus affect pretty > > much anything you do in that buffer. > > The doc string says: > > This variable is automatically set from the file variables of an > interpreted Lisp file read using `load'. > > Do you have a suggestion as to how to clarify this? I think the problem was that sentence coming after the "only" statement. The impression was that it might well be set from file variables but it still "only applies..." etc. The end result needs to somehow characterize when it does and does not apply.