unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#16308: 24.3.50; doc of `font-lock-keywords'
@ 2013-12-31 17:20 Drew Adams
  2014-02-08  2:50 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2013-12-31 17:20 UTC (permalink / raw)
  To: 16308

The description in the Elisp manual, which is our reference, should be
at least as complete as the doc string.  It is not.  In particular, it
does not describe the structure of the value correctly.  It does not
mention the compiled form, with car `t' etc.

The doc string is far more complete.  If anything, it should be the
other way around.  But preferably, both doc string and manual (node
`Search-based Fontification', currently) should each be complete and
correct.

[BTW, the name of that node should use "Search-Based", not "Search-based".]


In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2013-12-27 on ODIEONE
Bzr revision: 115778 rgm@gnu.org-20131228000456-1797o8z6veuyozs0
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
 'CFLAGS=-O0 -g3' LDFLAGS=-Lc:/Devel/emacs/lib
 CPPFLAGS=-Ic:/Devel/emacs/include'





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

* bug#16308: 24.3.50; doc of `font-lock-keywords'
  2013-12-31 17:20 bug#16308: 24.3.50; doc of `font-lock-keywords' Drew Adams
@ 2014-02-08  2:50 ` Lars Ingebrigtsen
  2014-02-08  3:21   ` Drew Adams
  0 siblings, 1 reply; 4+ messages in thread
From: Lars Ingebrigtsen @ 2014-02-08  2:50 UTC (permalink / raw)
  To: Drew Adams; +Cc: 16308

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

> The description in the Elisp manual, which is our reference, should be
> at least as complete as the doc string.  It is not.  In particular, it
> does not describe the structure of the value correctly.  It does not
> mention the compiled form, with car `t' etc.
>
> The doc string is far more complete.  If anything, it should be the
> other way around.  But preferably, both doc string and manual (node
> `Search-based Fontification', currently) should each be complete and
> correct.

No, I think the information about the compiled form isn't particularly
relevant for people who are composing the keywords, while it is relevant
for people who examine the variable, so it's fine the way it is.

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





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

* bug#16308: 24.3.50; doc of `font-lock-keywords'
  2014-02-08  2:50 ` Lars Ingebrigtsen
@ 2014-02-08  3:21   ` Drew Adams
  2014-02-08  5:02     ` Stefan Monnier
  0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2014-02-08  3:21 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 16308

> No, I think the information about the compiled form isn't
> particularly relevant for people who are composing the keywords,
> while it is relevant for people who examine the variable, so
> it's fine the way it is.

Well you think wrong, then.

The Elisp manual is our _reference_.  The info there about
`font-lock-keywords' needs to be complete.  It is not at all
there only for "people who are composing the keywords".





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

* bug#16308: 24.3.50; doc of `font-lock-keywords'
  2014-02-08  3:21   ` Drew Adams
@ 2014-02-08  5:02     ` Stefan Monnier
  0 siblings, 0 replies; 4+ messages in thread
From: Stefan Monnier @ 2014-02-08  5:02 UTC (permalink / raw)
  To: Drew Adams; +Cc: Lars Ingebrigtsen, 16308

> Well you think wrong, then.

No, you guys just disagree.  And I side with Lars on this one.


        Stefan





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

end of thread, other threads:[~2014-02-08  5:02 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-12-31 17:20 bug#16308: 24.3.50; doc of `font-lock-keywords' Drew Adams
2014-02-08  2:50 ` Lars Ingebrigtsen
2014-02-08  3:21   ` Drew Adams
2014-02-08  5:02     ` Stefan Monnier

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).