From unknown Sat Jun 21 02:56:12 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#16308 <16308@debbugs.gnu.org> To: bug#16308 <16308@debbugs.gnu.org> Subject: Status: 24.3.50; doc of `font-lock-keywords' Reply-To: bug#16308 <16308@debbugs.gnu.org> Date: Sat, 21 Jun 2025 09:56:12 +0000 retitle 16308 24.3.50; doc of `font-lock-keywords' reassign 16308 emacs submitter 16308 Drew Adams severity 16308 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Dec 31 12:21:16 2013 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 To: bug-gnu-emacs@gnu.org Subject: 24.3.50; doc of `font-lock-keywords' 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-Debbugs-Envelope-To: submit 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 debbugs-submit-bounces@debbugs.gnu.org Fri Feb 07 21:51:32 2014 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 To: Drew Adams Subject: Re: bug#16308: 24.3.50; doc of `font-lock-keywords' 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-Debbugs-Envelope-To: 16308 Cc: 16308@debbugs.gnu.org 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 debbugs-submit-bounces@debbugs.gnu.org Fri Feb 07 22:21:51 2014 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 To: Lars Ingebrigtsen Subject: RE: bug#16308: 24.3.50; doc of `font-lock-keywords' 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-Debbugs-Envelope-To: 16308 Cc: 16308@debbugs.gnu.org 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 02:56:12 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: Did not alter fixed versions and reopened. Date: Sat, 08 Feb 2014 03:24:01 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # Did not alter fixed versions and reopened. thanks # This fakemail brought to you by your local debbugs # administrator From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 08 00:02:47 2014 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 To: Drew Adams Subject: Re: bug#16308: 24.3.50; doc of `font-lock-keywords' 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-Debbugs-Envelope-To: 16308 Cc: Lars Ingebrigtsen , 16308@debbugs.gnu.org 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 From unknown Sat Jun 21 02:56:12 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Mon, 10 Mar 2014 11:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator