* bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords'
@ 2015-01-01 22:25 Drew Adams
2015-01-03 3:19 ` Stefan Monnier
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2015-01-01 22:25 UTC (permalink / raw)
To: 19483
`C-h v font-lock-syntactic-keywords' says that the variable is obsolete
since 24.1. But in font-lock.el, the code, multiple doc strings, and
the Commentary all rely on it.
Something is not up to date, it seems. Whatever that is, it should have
been taken care of at the same time that this variable was declared
obsolete. That's 4 releases ago, now. As of Emacs 25.1, it will be 5
releases overdue.
In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
of 2014-10-20 on LEG570
Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords'
2015-01-01 22:25 bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords' Drew Adams
@ 2015-01-03 3:19 ` Stefan Monnier
2015-01-03 7:59 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Stefan Monnier @ 2015-01-03 3:19 UTC (permalink / raw)
To: Drew Adams; +Cc: 19483-done
tags 19483 notabug
thanks
> `C-h v font-lock-syntactic-keywords' says that the variable is obsolete
> since 24.1.
That's right.
> But in font-lock.el, the code, multiple doc strings, and
> the Commentary all rely on it.
No, they just keep supporting it, because it's only "obsolete" and not
"removed".
Do you really want to advocate we remove features right away when we
decide they're obsolete?
Stefan
^ permalink raw reply [flat|nested] 5+ messages in thread* bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords'
2015-01-03 3:19 ` Stefan Monnier
@ 2015-01-03 7:59 ` Drew Adams
2015-01-04 2:36 ` Stefan Monnier
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2015-01-03 7:59 UTC (permalink / raw)
To: Stefan Monnier; +Cc: 19483-done
> tags 19483 notabug
> thanks
>
> > `C-h v font-lock-syntactic-keywords' says that the variable is
> > obsolete since 24.1.
>
> That's right.
>
> > But in font-lock.el, the code, multiple doc strings, and
> > the Commentary all rely on it.
>
> No, they just keep supporting it, because it's only "obsolete" and
> not "removed".
The doc and Commentary should reflect the fact that it has been
declared "obsolete". That's the point.
> Do you really want to advocate we remove features right away when we
> decide they're obsolete?
Strawman, again. No one suggested that you remove any feature.
Read the bug report. It's about the doc (including Commentary).
When you deprecate something, the doc for it should state that it
is deprecated. Everywhere.
That the doc was not brought up to date about this as soon as
the status changed to deprecated was a doc bug 4 releases ago.
The bug is still there.
Emacs is the self-documenting editor. It should tell users
about itself accurately.
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords'
2015-01-03 7:59 ` Drew Adams
@ 2015-01-04 2:36 ` Stefan Monnier
2015-01-04 3:00 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Stefan Monnier @ 2015-01-04 2:36 UTC (permalink / raw)
To: Drew Adams; +Cc: 19483-done
> The doc and Commentary should reflect the fact that it has been
> declared "obsolete". That's the point.
Oh, I missed that. Then, yes, feel free to install a patch for that.
Most of the doc should simply be removed.
Stefan
^ permalink raw reply [flat|nested] 5+ messages in thread* bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords'
2015-01-04 2:36 ` Stefan Monnier
@ 2015-01-04 3:00 ` Drew Adams
0 siblings, 0 replies; 5+ messages in thread
From: Drew Adams @ 2015-01-04 3:00 UTC (permalink / raw)
To: Stefan Monnier; +Cc: 19483-done
> > The doc and Commentary should reflect the fact that it has been
> > declared "obsolete". That's the point.
>
> Oh, I missed that. Then, yes, feel free to install a patch for
> that. Most of the doc should simply be removed.
The bug status should not be "done"/"notabug", as long as the
problem exists.
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2015-01-04 3:00 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-01-01 22:25 bug#19483: 25.0.50; out-of-date doc and Commentary in `font-lock' wrt `font-lock-syntactic-keywords' Drew Adams
2015-01-03 3:19 ` Stefan Monnier
2015-01-03 7:59 ` Drew Adams
2015-01-04 2:36 ` Stefan Monnier
2015-01-04 3:00 ` Drew Adams
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).