unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
@ 2009-06-19  7:43 Drew Adams
  2011-07-12 14:15 ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 10+ messages in thread
From: Drew Adams @ 2009-06-19  7:43 UTC (permalink / raw)
  To: emacs-pretest-bug

It would help to add a cross reference in this Info node to the nodes
that explain buffer-local vars and frame-local vars, saying that this
is a different notion of "local" variable.
 
And vice versa. Put xrefs at the nodes about buffer-local and
frame-local, pointing to the other nodes (e.g. Local Variables).
 
The aims are to (1) point to the other nodes, and (2) say that these
are not closely related, in spite of their similar names.
 
This would help because users are not necessarily clear that these are
different critters, and looking for info about one, they might end up
mistakenly reading about another, perhaps without even realizing it.

In GNU Emacs 23.0.94.1 (i386-mingw-nt5.1.2600)
 of 2009-05-24 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'






^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2009-06-19  7:43 bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars Drew Adams
@ 2011-07-12 14:15 ` Lars Magne Ingebrigtsen
  2011-07-12 14:50   ` Drew Adams
  0 siblings, 1 reply; 10+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-12 14:15 UTC (permalink / raw)
  To: Drew Adams; +Cc: 3615

"Drew Adams" <drew.adams@oracle.com> writes:

> It would help to add a cross reference in this Info node to the nodes
> that explain buffer-local vars and frame-local vars, saying that this
> is a different notion of "local" variable.

This seems to have been fixed.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-12 14:15 ` Lars Magne Ingebrigtsen
@ 2011-07-12 14:50   ` Drew Adams
  2011-07-12 15:12     ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 10+ messages in thread
From: Drew Adams @ 2011-07-12 14:50 UTC (permalink / raw)
  To: 'Lars Magne Ingebrigtsen'; +Cc: 3615

> This seems to have been fixed.

No, I don't see that.  Please read the report again.

Where do you see, as one example, anything about frame-local variables here?






^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-12 14:50   ` Drew Adams
@ 2011-07-12 15:12     ` Lars Magne Ingebrigtsen
  2011-07-12 16:08       ` Drew Adams
                         ` (2 more replies)
  0 siblings, 3 replies; 10+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-12 15:12 UTC (permalink / raw)
  To: Drew Adams; +Cc: 3615

"Drew Adams" <drew.adams@oracle.com> writes:

> Where do you see, as one example, anything about frame-local variables here?

frame-local variables are pretty much deprecated, so there didn't seem
to be any point.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-12 15:12     ` Lars Magne Ingebrigtsen
@ 2011-07-12 16:08       ` Drew Adams
  2011-07-12 17:23         ` Chong Yidong
  2011-07-12 16:12       ` Drew Adams
  2011-07-13  6:51       ` Richard Stallman
  2 siblings, 1 reply; 10+ messages in thread
From: Drew Adams @ 2011-07-12 16:08 UTC (permalink / raw)
  To: 'Lars Magne Ingebrigtsen'; +Cc: 3615

> > Where do you see, as one example, anything about 
> > frame-local variables here?
> 
> frame-local variables are pretty much deprecated, so there didn't seem
> to be any point.

1. There is an Elisp manual node, `Frame-Local Variables'.  It is even in the
main Elisp menu (`Top'), which emphasizes its importance.

If frame-local variables have been deprecated and are not to be referred to in
the doc, then a much bigger correction to the manual is needed than just what
this bug report calls for: remove that node and all references to it.

However, I see _nothing_ in NEWS about frame-local variables being deprecated.


2. In any case, this bug report is about more than frame-local variables.

There is now a cross ref from `Local Variables' to `Buffer-Local Variables'
(good), but there is still no cross ref from the latter to the former.  And
still no explanation at `Local Variables' that it describes a different notion
of "local variable" from the other two.

It especially needs to be pointed out that "these [three notions] are not
closely related, in spite of their similar names", as the bug report says.  This
is not at all obvious, and is a recurrent cause of confusion.

Note, BTW, that there _is_ a cross ref from `Buffer-Local Variables' to
`Frame-Local Variables', and vice-versa.  What's missing are the connections to
`Local Variables'.






^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-12 15:12     ` Lars Magne Ingebrigtsen
  2011-07-12 16:08       ` Drew Adams
@ 2011-07-12 16:12       ` Drew Adams
  2011-07-13  6:51       ` Richard Stallman
  2 siblings, 0 replies; 10+ messages in thread
From: Drew Adams @ 2011-07-12 16:12 UTC (permalink / raw)
  To: 'Lars Magne Ingebrigtsen'; +Cc: 3615

It was inappropriate to close this bug as `unreproducible'.

The bug description still applies.
It is reproducible, at least in this recent build:

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-06-27 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/build/include'






^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-12 16:08       ` Drew Adams
@ 2011-07-12 17:23         ` Chong Yidong
  0 siblings, 0 replies; 10+ messages in thread
From: Chong Yidong @ 2011-07-12 17:23 UTC (permalink / raw)
  To: Drew Adams; +Cc: 'Lars Magne Ingebrigtsen', 3615

"Drew Adams" <drew.adams@oracle.com> writes:

> 1. There is an Elisp manual node, `Frame-Local Variables'.  It is even
> in the main Elisp menu (`Top'), which emphasizes its importance.
>
> If frame-local variables have been deprecated and are not to be
> referred to in the doc, then a much bigger correction to the manual is
> needed than just what this bug report calls for: remove that node and
> all references to it.
>
> However, I see _nothing_ in NEWS about frame-local variables being
> deprecated.

You're looking in the wrong NEWS.  Check out the NEWS for Emacs 22...

I'll work on removing the Frame-Local Variables node from the Elisp
manual.





^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-12 15:12     ` Lars Magne Ingebrigtsen
  2011-07-12 16:08       ` Drew Adams
  2011-07-12 16:12       ` Drew Adams
@ 2011-07-13  6:51       ` Richard Stallman
  2011-07-13 10:57         ` Juanma Barranquero
  2 siblings, 1 reply; 10+ messages in thread
From: Richard Stallman @ 2011-07-13  6:51 UTC (permalink / raw)
  To: Lars Magne Ingebrigtsen; +Cc: 3615

Why deprecate frame-local variables?

-- 
Dr Richard Stallman
President, Free Software Foundation
51 Franklin St
Boston MA 02110
USA
www.fsf.org  www.gnu.org
Skype: No way! That's nonfree (freedom-denying) software.
  Use free telephony http://directory.fsf.org/category/tel/





^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-13  6:51       ` Richard Stallman
@ 2011-07-13 10:57         ` Juanma Barranquero
  2011-07-13 18:32           ` Richard Stallman
  0 siblings, 1 reply; 10+ messages in thread
From: Juanma Barranquero @ 2011-07-13 10:57 UTC (permalink / raw)
  To: rms; +Cc: Lars Magne Ingebrigtsen, 3615

> Why deprecate frame-local variables?

There's a long thread in emacs-devel, titled "frame-local variables
weirdness", started on 2006-12-05. After many exchanges, you said:

"When frame-local variables were first implemented, there was no other
way to put frame-specific data in the mode line.  But now there is,
with :eval.

Since they are hardly used, and the original motive for them
no longer applies, we may as well delete the feature.

Would you like to do that?"

and Stefan answered:

"Sure.  I currently just marked it obsolete in the 22 branch (with a note in
NEWS), see patch below.  I'll change the pieces of code which make use of
that feature on the trunk.  If anybody wants to help out: feel free."

and then you said:

"I will delete them from the Lisp manual."

Basically, they are a source of subtle, obscure bugs; they do not
provide (almost) anything that cannot be done with
(set-)?frame-parameter, and after ten years or so of its
implementation they had all of four uses in the sources, all of them
trivial and trivially changed.

    Juanma





^ permalink raw reply	[flat|nested] 10+ messages in thread

* bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars
  2011-07-13 10:57         ` Juanma Barranquero
@ 2011-07-13 18:32           ` Richard Stallman
  0 siblings, 0 replies; 10+ messages in thread
From: Richard Stallman @ 2011-07-13 18:32 UTC (permalink / raw)
  To: Juanma Barranquero; +Cc: larsi, 3615

Thanks.

-- 
Dr Richard Stallman
President, Free Software Foundation
51 Franklin St
Boston MA 02110
USA
www.fsf.org  www.gnu.org
Skype: No way! That's nonfree (freedom-denying) software.
  Use free telephony http://directory.fsf.org/category/tel/





^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2011-07-13 18:32 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-06-19  7:43 bug#3615: 23.0.94; (elisp)Local Variables: xrefs to nodes for buffer-local and frame-local vars Drew Adams
2011-07-12 14:15 ` Lars Magne Ingebrigtsen
2011-07-12 14:50   ` Drew Adams
2011-07-12 15:12     ` Lars Magne Ingebrigtsen
2011-07-12 16:08       ` Drew Adams
2011-07-12 17:23         ` Chong Yidong
2011-07-12 16:12       ` Drew Adams
2011-07-13  6:51       ` Richard Stallman
2011-07-13 10:57         ` Juanma Barranquero
2011-07-13 18:32           ` Richard Stallman

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).