From: "Drew Adams" <drew.adams@oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi@gnus.org>
Cc: 8460@debbugs.gnu.org
Subject: bug#8460: 24.0.50; Doc string of `lexical-binding'
Date: Fri, 15 Jul 2011 08:19:39 -0700 [thread overview]
Message-ID: <C43F4B1DC57F44DBA2859E870D45C434@us.oracle.com> (raw)
In-Reply-To: <m3pqlb7i03.fsf@quimbies.gnus.org>
> > I haven't seen your fix, but it could be misleading to just
> > mention `eval-*' even if you remove "only".
>
> The current text is:
>
> ---
> If non-nil, use lexical binding when evaluating code.
> This applies to code evaluated by `eval-buffer' and `eval-region' and
> other commands that call these functions, like `eval-defun' and
> the like.
> This variable is automatically set from the file variables of an
> interpreted Lisp file read using `load'.
> ---
>
> I'm not sure that that's much clearer than the original, actually.
The problem is this: We say that it "applies to" a certain number of cases.
That begs the question, "What does it _not_ apply to?"
IOW, why don't we just say this?
"Non-nil means use lexical binding when evaluating code."
Presumably there is some good reason why we don't. And that good reason remains
a mystery: in what cases does non-nil _not_ mean to use lexical binding when
evaluating code?
Or if there are really no such cases, and the only reason for mentioning
`eval-*' in the first place was to give some examples, then make that clear.
Say, in that case, "For example, ... `eval-buffer'...".
Currently it is not clear (I have no idea, in fact) whether non-nil always means
use lexical binding or not. And if not, I have no idea what those "not" cases
are. In sum, I haven't a clue what the value does, except that at least in some
cases it means use lexical binding when evaluating code.
It's not about the _wording_. I can help with the wording if you provide the
content. What is it that we are trying to communicate to users, exactly?
next prev parent reply other threads:[~2011-07-15 15:19 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-04-09 18:06 bug#8460: 24.0.50; Doc string of `lexical-binding' Drew Adams
2011-07-15 12:59 ` Lars Magne Ingebrigtsen
2011-07-15 14:01 ` Drew Adams
2011-07-15 14:09 ` Lars Magne Ingebrigtsen
2011-07-15 15:19 ` Drew Adams [this message]
2011-07-18 13:38 ` Stefan Monnier
2011-07-18 13:45 ` Drew Adams
2011-07-19 15:18 ` Lars Magne Ingebrigtsen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=C43F4B1DC57F44DBA2859E870D45C434@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=8460@debbugs.gnu.org \
--cc=larsi@gnus.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.