unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#6935: 24.0.50; doc for `font-lock-maximum-decoration'
@ 2010-08-28  4:06 Drew Adams
  2010-08-28 14:41 ` Stefan Monnier
  2011-07-14 13:49 ` Lars Magne Ingebrigtsen
  0 siblings, 2 replies; 13+ messages in thread
From: Drew Adams @ 2010-08-28  4:06 UTC (permalink / raw)
  To: 6935

The doc for `font-lock-maximum-fontification' is not very
clear/complete.
 
1. For one thing, the Emacs manual deals with it only using a `setq'
example:
 
  (setq font-lock-maximum-decoration
        '((c-mode . 1) (c++-mode . 1)))
 
We should tell users how they can use Customize for customizing it.
(No, it is not obvious how to do that.)  We should not be privileging
Lisp code in .emacs this way - especially fairly complex Lisp code.
 

2. The doc string and the Customize help for it (same thing) do not help
much either.  In particular, they are missing the info that if you add
an entry for one or more modes, then you will likely want to also add
a catch-all entry for all other modes.
 
The latter notion is not presented explicitly, but the example given
does help in this regard.  One problem is that the choice of `all' as
the UI label gives the impression that it might override other,
mode-specific entries.  For example, you might well think that order is
important and that an entry of `all' overrides any other entries that
follow.  `all' should really be renamed something that conveys the fact
that it means `all other modes', not `all modes'.
 

3. Also, to understand what the choice of `level' means here, users need
to know about fontification levels.  At least a minimum of info about
that needs to be presented in the Customize (= doc string) help.
 
 
In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2010-08-16 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4) --no-opt --cflags
-Ic:/imagesupport/include'
 






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

end of thread, other threads:[~2011-07-31 16:31 UTC | newest]

Thread overview: 13+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-08-28  4:06 bug#6935: 24.0.50; doc for `font-lock-maximum-decoration' Drew Adams
2010-08-28 14:41 ` Stefan Monnier
2010-08-28 19:54   ` Drew Adams
2010-08-30 14:41     ` Stefan Monnier
2010-08-30 15:46       ` Drew Adams
2010-08-30 22:04         ` Stefan Monnier
2010-08-30 22:56           ` Drew Adams
2010-08-31 10:33             ` Stefan Monnier
2011-07-14 13:49 ` Lars Magne Ingebrigtsen
2011-07-14 16:41   ` Drew Adams
2011-07-22  3:54   ` Chong Yidong
2011-07-31 15:00     ` Lars Magne Ingebrigtsen
2011-07-31 16:31       ` 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).