From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#6935: 24.0.50; doc for `font-lock-maximum-decoration' Date: Fri, 27 Aug 2010 21:06:09 -0700 Message-ID: <0AEEE18115BA49E58E42C1604867D444@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1282968589 26736 80.91.229.12 (28 Aug 2010 04:09:49 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 28 Aug 2010 04:09:49 +0000 (UTC) To: 6935@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 28 06:09:48 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OpCji-0002hO-0l for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Aug 2010 06:09:46 +0200 Original-Received: from localhost ([127.0.0.1]:34429 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OpCjh-00050U-9N for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Aug 2010 00:09:45 -0400 Original-Received: from [140.186.70.92] (port=46986 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OpCjW-0004zB-Qf for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2010 00:09:39 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OpCjR-0002RX-Je for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2010 00:09:34 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57313) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OpCjR-0002RS-IG for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2010 00:09:29 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OpCh3-0004rM-PI; Sat, 28 Aug 2010 00:07:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 28 Aug 2010 04:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 6935 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.128296836718662 (code B ref -1); Sat, 28 Aug 2010 04:07:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Aug 2010 04:06:07 +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 1OpCgA-0004qw-JN for submit@debbugs.gnu.org; Sat, 28 Aug 2010 00:06:06 -0400 Original-Received: from mail.gnu.org ([199.232.76.166] helo=mx10.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OpCg9-0004qa-2b for submit@debbugs.gnu.org; Sat, 28 Aug 2010 00:06:05 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:59655) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1OpCha-0005mA-E1 for submit@debbugs.gnu.org; Sat, 28 Aug 2010 00:07:34 -0400 Original-Received: from [140.186.70.92] (port=46529 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OpChV-0004gw-7w for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2010 00:07:33 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OpChQ-0002Dj-2y for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2010 00:07:29 -0400 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:35469) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OpChP-0002Da-UQ for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2010 00:07:24 -0400 Original-Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id o7S47L62023078 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 28 Aug 2010 04:07:22 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o7RLM2lT009173 for ; Sat, 28 Aug 2010 04:07:21 GMT Original-Received: from abhmt003.oracle.com by acsmt353.oracle.com with ESMTP id 556491581282968365; Fri, 27 Aug 2010 21:06:05 -0700 Original-Received: from dradamslap1 (/10.159.220.83) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 27 Aug 2010 21:06:05 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: ActGZlgvwEkID6SrRyuKii401rU50w== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5931 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 28 Aug 2010 00:07:01 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:39793 Archived-At: 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'