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#16308: 24.3.50; doc of `font-lock-keywords' Date: Tue, 31 Dec 2013 09:20:42 -0800 (PST) Message-ID: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1388510536 306 80.91.229.3 (31 Dec 2013 17:22:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 31 Dec 2013 17:22:16 +0000 (UTC) To: 16308@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Dec 31 18:22:21 2013 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 1Vy31J-00007O-70 for geb-bug-gnu-emacs@m.gmane.org; Tue, 31 Dec 2013 18:22:21 +0100 Original-Received: from localhost ([::1]:35204 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vy31I-0003JR-Qp for geb-bug-gnu-emacs@m.gmane.org; Tue, 31 Dec 2013 12:22:20 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50151) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vy316-0003JI-CH for bug-gnu-emacs@gnu.org; Tue, 31 Dec 2013 12:22:18 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vy311-0003ao-5x for bug-gnu-emacs@gnu.org; Tue, 31 Dec 2013 12:22:08 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:40857) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vy311-0003ak-2U for bug-gnu-emacs@gnu.org; Tue, 31 Dec 2013 12:22:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Vy310-0007js-JL for bug-gnu-emacs@gnu.org; Tue, 31 Dec 2013 12:22:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 31 Dec 2013 17:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 16308 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.138851047629666 (code B ref -1); Tue, 31 Dec 2013 17:22:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 31 Dec 2013 17:21:16 +0000 Original-Received: from localhost ([127.0.0.1]:54875 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Vy30F-0007iP-Im for submit@debbugs.gnu.org; Tue, 31 Dec 2013 12:21:16 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:48274) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Vy30D-0007iF-Ga for submit@debbugs.gnu.org; Tue, 31 Dec 2013 12:21:14 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vy303-00039C-8S for submit@debbugs.gnu.org; Tue, 31 Dec 2013 12:21:13 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:54821) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vy303-000398-4z for submit@debbugs.gnu.org; Tue, 31 Dec 2013 12:21:03 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49967) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vy2zu-0002rv-I1 for bug-gnu-emacs@gnu.org; Tue, 31 Dec 2013 12:21:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vy2zl-00037b-VK for bug-gnu-emacs@gnu.org; Tue, 31 Dec 2013 12:20:54 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:41839) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vy2zl-00037R-Oe for bug-gnu-emacs@gnu.org; Tue, 31 Dec 2013 12:20:45 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id rBVHKhRo004282 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 31 Dec 2013 17:20:44 GMT Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rBVHKgXE019967 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 31 Dec 2013 17:20:43 GMT Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rBVHKgve025081 for ; Tue, 31 Dec 2013 17:20:42 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). 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:82786 Archived-At: 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. [BTW, the name of that node should use "Search-Based", not "Search-based".] In GNU Emacs 24.3.50.1 (i686-pc-mingw32) of 2013-12-27 on ODIEONE Bzr revision: 115778 rgm@gnu.org-20131228000456-1797o8z6veuyozs0 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/binary --enable-checking=3Dyes,glyphs 'CFLAGS=3D-O0 -g3' LDFLAGS=3D-Lc:/Devel/emacs/lib CPPFLAGS=3D-Ic:/Devel/emacs/include'