From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#6935: 24.0.50; doc for `font-lock-maximum-decoration' Date: Thu, 14 Jul 2011 15:49:41 +0200 Message-ID: References: <0AEEE18115BA49E58E42C1604867D444@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1310652371 3068 80.91.229.12 (14 Jul 2011 14:06:11 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 14 Jul 2011 14:06:11 +0000 (UTC) Cc: 6935@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 14 16:06:06 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QhMYF-0002pK-63 for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Jul 2011 16:06:03 +0200 Original-Received: from localhost ([::1]:56214 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhMYE-0007tT-3P for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Jul 2011 10:06:02 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:35917) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhMVW-00073w-3E for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 10:03:17 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QhMVQ-0001Pd-MZ for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 10:03:13 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48511) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhMVQ-0001PQ-BS for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 10:03:08 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QhMVP-000442-IN; Thu, 14 Jul 2011 10:03:07 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 14:03:07 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6935 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 6935-submit@debbugs.gnu.org id=B6935.131065217115544 (code B ref 6935); Thu, 14 Jul 2011 14:03:07 +0000 Original-Received: (at 6935) by debbugs.gnu.org; 14 Jul 2011 14:02:51 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhMV5-00042W-AF for submit@debbugs.gnu.org; Thu, 14 Jul 2011 10:02:51 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhMUn-000410-P1 for 6935@debbugs.gnu.org; Thu, 14 Jul 2011 10:02:33 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QhMUY-00072U-Ef; Thu, 14 Jul 2011 16:02:14 +0200 In-Reply-To: <0AEEE18115BA49E58E42C1604867D444@us.oracle.com> (Drew Adams's message of "Fri, 27 Aug 2010 21:06:09 -0700") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Depeche Mode's _Some Great Reward_: "Lie To Me" X-Hashcash: 1:23:110714:6935@debbugs.gnu.org::6Sd1NkfLuqL4zXD6:000000000000000000000000000000000000000001SMn X-Hashcash: 1:23:110714:drew.adams@oracle.com::lxfwu/p/wbSbRPPM:00000000000000000000000000000000000000012PzA X-MailScanner-ID: 1QhMUY-00072U-Ef MailScanner-NULL-Check: 1311256934.58431@B/ZZPEQ14Zu9pvwfEd1dUw X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Thu, 14 Jul 2011 10:03:07 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:48995 Archived-At: "Drew Adams" writes: > 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. For examples of complex variables like this, I find Lisp code a lot clearer than convoluted Customize settings. So this is not a bug, in my opinion. > 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 doc string seems to have been fixed in this regard, with a pretty clear example. > 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. I've now mentioned that higher levels mean more fontification. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/