From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#12282: 24.1.50; `font-lock-value-in-major-mode': doc string and parameter name Date: Sat, 08 Feb 2014 19:25:36 -0800 Message-ID: <87fvnthsr3.fsf@building.gnus.org> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1391916489 30880 80.91.229.3 (9 Feb 2014 03:28:09 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 9 Feb 2014 03:28:09 +0000 (UTC) Cc: 12282@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Feb 09 04:28:16 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WCL44-0003cr-46 for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Feb 2014 04:28:16 +0100 Original-Received: from localhost ([::1]:49002 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCL43-0000kx-ML for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Feb 2014 22:28:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59274) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCL3v-0000f9-A0 for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:28:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WCL3q-00082P-BX for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:28:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:44642) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCL3q-00082L-7d for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:28:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WCL3p-0003U3-Rx for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:28:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Feb 2014 03:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12282 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 12282-submit@debbugs.gnu.org id=B12282.139191642613296 (code B ref 12282); Sun, 09 Feb 2014 03:28:01 +0000 Original-Received: (at 12282) by debbugs.gnu.org; 9 Feb 2014 03:27:06 +0000 Original-Received: from localhost ([127.0.0.1]:58658 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCL2v-0003SN-Fc for submit@debbugs.gnu.org; Sat, 08 Feb 2014 22:27:05 -0500 Original-Received: from hermes.netfonds.no ([80.91.224.195]:50434) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCL2t-0003SF-8P for 12282@debbugs.gnu.org; Sat, 08 Feb 2014 22:27:03 -0500 Original-Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCL2e-0004Y1-60; Sun, 09 Feb 2014 04:26:49 +0100 In-Reply-To: (Drew Adams's message of "Sun, 26 Aug 2012 07:59:36 -0700") User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) X-MailScanner-ID: 1WCL2e-0004Y1-60 MailScanner-NULL-Check: 1392521209.2063@PDdic8akEO2BhQ6nEWkILA X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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:85025 Archived-At: "Drew Adams" writes: > The parameter should be renamed. It is an alist associating major modes > with font-lock decoration levels OR it is such a level. > > The current doc and parameter name give the impression that the argument > passed is typically an alist. But in practice (existing code in Emacs > distribution, as well as existing 3rd-party code), it is more often a > decoration level (including `t' for max decoration) that is passed as > argument. > > Just saying that the return value is ALIST if ALIST is not an alist, > while certainly correct, is being less clear than we could be. Fixed on trunk. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/