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#16308: 24.3.50; doc of `font-lock-keywords' Date: Fri, 07 Feb 2014 18:50:06 -0800 Message-ID: <87iosqb9nl.fsf@building.gnus.org> References: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1391827928 3670 80.91.229.3 (8 Feb 2014 02:52:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 8 Feb 2014 02:52:08 +0000 (UTC) Cc: 16308@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 08 03:52: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 1WBy1f-0002BI-DW for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Feb 2014 03:52:15 +0100 Original-Received: from localhost ([::1]:44606 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WBy1f-00043o-3C for geb-bug-gnu-emacs@m.gmane.org; Fri, 07 Feb 2014 21:52:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45461) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WBy1X-00042V-N5 for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 21:52:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WBy1S-0007Vy-MW for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 21:52:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:41682) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WBy1S-0007Vt-JF for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 21:52:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WBy1S-0002pV-Az for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 21:52: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: Sat, 08 Feb 2014 02:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16308 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 16308-submit@debbugs.gnu.org id=B16308.139182789210810 (code B ref 16308); Sat, 08 Feb 2014 02:52:02 +0000 Original-Received: (at 16308) by debbugs.gnu.org; 8 Feb 2014 02:51:32 +0000 Original-Received: from localhost ([127.0.0.1]:55698 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBy0x-0002oH-PF for submit@debbugs.gnu.org; Fri, 07 Feb 2014 21:51:32 -0500 Original-Received: from hermes.netfonds.no ([80.91.224.195]:50418) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBy0v-0002o9-BS for 16308@debbugs.gnu.org; Fri, 07 Feb 2014 21:51:29 -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 1WBy0g-0003iB-Fv; Sat, 08 Feb 2014 03:51:14 +0100 In-Reply-To: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> (Drew Adams's message of "Tue, 31 Dec 2013 09:20:42 -0800 (PST)") User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) X-MailScanner-ID: 1WBy0g-0003iB-Fv MailScanner-NULL-Check: 1392432675.52568@q4iSVwVJozDYnKhPYIzqHg 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:84852 Archived-At: Drew Adams writes: > The description in the Elisp manual, which is our reference, should be > at least as complete as the doc string. It is not. In particular, it > does not describe the structure of the value correctly. It does not > mention the compiled form, with car `t' etc. > > The doc string is far more complete. If anything, it should be the > other way around. But preferably, both doc string and manual (node > `Search-based Fontification', currently) should each be complete and > correct. No, I think the information about the compiled form isn't particularly relevant for people who are composing the keywords, while it is relevant for people who examine the variable, so it's fine the way it is. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/