GNU bug report logs - #12282
24.1.50; `font-lock-value-in-major-mode': doc string and parameter name

Previous Next

Full log

View this message in rfc822 format

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 12282 <at> debbugs.gnu.org
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

"Drew Adams" <drew.adams <at> oracle.com> 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/

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.