From unknown Sat Jun 21 03:25:50 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16308: 24.3.50; doc of `font-lock-keywords' 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: To: 16308@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.138851047629666 (code B ref -1); Tue, 31 Dec 2013 17:22:02 +0000 Received: (at submit) by debbugs.gnu.org; 31 Dec 2013 17:21:16 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 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 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 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 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 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 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 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 MIME-Version: 1.0 Message-ID: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> Date: Tue, 31 Dec 2013 09:20:42 -0800 (PST) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) 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' From unknown Sat Jun 21 03:25:50 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16308: 24.3.50; doc of `font-lock-keywords' 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: To: Drew Adams Cc: 16308@debbugs.gnu.org Received: via spool by 16308-submit@debbugs.gnu.org id=B16308.139182789210810 (code B ref 16308); Sat, 08 Feb 2014 02:52:02 +0000 Received: (at 16308) by debbugs.gnu.org; 8 Feb 2014 02:51:32 +0000 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 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 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 From: Lars Ingebrigtsen References: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> Date: Fri, 07 Feb 2014 18:50:06 -0800 In-Reply-To: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> (Drew Adams's message of "Tue, 31 Dec 2013 09:20:42 -0800 (PST)") Message-ID: <87iosqb9nl.fsf@building.gnus.org> User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1WBy0g-0003iB-Fv X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392432675.52568@q4iSVwVJozDYnKhPYIzqHg X-Spam-Status: No X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) 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/ From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 07 21:51:36 2014 Received: (at control) by debbugs.gnu.org; 8 Feb 2014 02:51:36 +0000 Received: from localhost ([127.0.0.1]:55701 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBy12-0002oe-4T for submit@debbugs.gnu.org; Fri, 07 Feb 2014 21:51:36 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:50423) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBy0z-0002oS-E2 for control@debbugs.gnu.org; Fri, 07 Feb 2014 21:51:33 -0500 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 1WBy0l-0003iL-E8 for control@debbugs.gnu.org; Sat, 08 Feb 2014 03:51:19 +0100 Date: Fri, 07 Feb 2014 18:50:11 -0800 Message-Id: <87ha8ab9ng.fsf@building.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #16308 X-MailScanner-ID: 1WBy0l-0003iL-E8 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392432679.97788@N17iQi98h7eTi9cxoMfFIA X-Spam-Status: No X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) close 16308 From unknown Sat Jun 21 03:25:50 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16308: 24.3.50; doc of `font-lock-keywords' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 08 Feb 2014 03:22: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: To: Lars Ingebrigtsen Cc: 16308@debbugs.gnu.org Received: via spool by 16308-submit@debbugs.gnu.org id=B16308.139182971123016 (code B ref 16308); Sat, 08 Feb 2014 03:22:02 +0000 Received: (at 16308) by debbugs.gnu.org; 8 Feb 2014 03:21:51 +0000 Received: from localhost ([127.0.0.1]:55777 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WByUI-0005z9-Hh for submit@debbugs.gnu.org; Fri, 07 Feb 2014 22:21:51 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:16524) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WByUG-0005z2-3D for 16308@debbugs.gnu.org; Fri, 07 Feb 2014 22:21:48 -0500 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s183LjUK012229 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 8 Feb 2014 03:21:46 GMT Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s183LiH4027497 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat, 8 Feb 2014 03:21:44 GMT Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id s183LhKY025867; Sat, 8 Feb 2014 03:21:43 GMT MIME-Version: 1.0 Message-ID: <8198f752-3624-4d73-aede-4fb583074a90@default> Date: Fri, 7 Feb 2014 19:21:42 -0800 (PST) From: Drew Adams References: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> <87iosqb9nl.fsf@building.gnus.org> In-Reply-To: <87iosqb9nl.fsf@building.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Spam-Score: -2.9 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.9 (--) > 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. Well you think wrong, then. The Elisp manual is our _reference_. The info there about `font-lock-keywords' needs to be complete. It is not at all there only for "people who are composing the keywords". From unknown Sat Jun 21 03:25:50 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16308: 24.3.50; doc of `font-lock-keywords' Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 08 Feb 2014 05:03: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: To: Drew Adams Cc: Lars Ingebrigtsen , 16308@debbugs.gnu.org Received: via spool by 16308-submit@debbugs.gnu.org id=B16308.1391835767306 (code B ref 16308); Sat, 08 Feb 2014 05:03:02 +0000 Received: (at 16308) by debbugs.gnu.org; 8 Feb 2014 05:02:47 +0000 Received: from localhost ([127.0.0.1]:56018 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WC03y-0008WV-SY for submit@debbugs.gnu.org; Sat, 08 Feb 2014 00:02:47 -0500 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:22269) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WC03w-0008WN-UW for 16308@debbugs.gnu.org; Sat, 08 Feb 2014 00:02:45 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av8EABK/CFFFpZBG/2dsb2JhbABEuzWDWRdzgh4BAQQBViMFCws0EhQYDSSIHgbBLZEKA4hhnBmBXoMV X-IPAS-Result: Av8EABK/CFFFpZBG/2dsb2JhbABEuzWDWRdzgh4BAQQBViMFCws0EhQYDSSIHgbBLZEKA4hhnBmBXoMV X-IronPort-AV: E=Sophos;i="4.84,565,1355115600"; d="scan'208";a="47067527" Received: from 69-165-144-70.dsl.teksavvy.com (HELO pastel.home) ([69.165.144.70]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 08 Feb 2014 00:02:44 -0500 Received: by pastel.home (Postfix, from userid 20848) id F0FDD60617; Sat, 8 Feb 2014 00:02:43 -0500 (EST) From: Stefan Monnier Message-ID: References: <249f7d3a-dc4e-4963-b8ce-1d3f0120609d@default> <87iosqb9nl.fsf@building.gnus.org> <8198f752-3624-4d73-aede-4fb583074a90@default> Date: Sat, 08 Feb 2014 00:02:43 -0500 In-Reply-To: <8198f752-3624-4d73-aede-4fb583074a90@default> (Drew Adams's message of "Fri, 7 Feb 2014 19:21:42 -0800 (PST)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) > Well you think wrong, then. No, you guys just disagree. And I side with Lars on this one. Stefan From debbugs-submit-bounces@debbugs.gnu.org Mon Feb 10 02:55:19 2014 Received: (at control) by debbugs.gnu.org; 10 Feb 2014 07:55:19 +0000 Received: from localhost ([127.0.0.1]:33937 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCli2-0005FE-En for submit@debbugs.gnu.org; Mon, 10 Feb 2014 02:55:18 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:56012) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WClhz-0005Ex-MP for control@debbugs.gnu.org; Mon, 10 Feb 2014 02:55:16 -0500 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 1WClhl-00016W-Fa for control@debbugs.gnu.org; Mon, 10 Feb 2014 08:55:01 +0100 Date: Sun, 09 Feb 2014 23:53:48 -0800 Message-Id: <87zjlzz9mb.fsf@building.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #16308 X-MailScanner-ID: 1WClhl-00016W-Fa X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392623701.97313@qkPjzxi+cw/bxI638M3aKw X-Spam-Status: No X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) close 16308