From unknown Sat Sep 20 13:00:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#36647: 26.1; Please align examples of search-based fontification with recommendations Resent-From: Markus Triska Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 14 Jul 2019 09:11:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 36647 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 36647@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.15630954442108 (code B ref -1); Sun, 14 Jul 2019 09:11:01 +0000 Received: (at submit) by debbugs.gnu.org; 14 Jul 2019 09:10:44 +0000 Received: from localhost ([127.0.0.1]:43807 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmaWo-0000Xu-Ej for submit@debbugs.gnu.org; Sun, 14 Jul 2019 05:10:44 -0400 Received: from lists.gnu.org ([209.51.188.17]:35215) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmaWm-0000Xm-IJ for submit@debbugs.gnu.org; Sun, 14 Jul 2019 05:10:41 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35722) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hmaWl-0002co-MW for bug-gnu-emacs@gnu.org; Sun, 14 Jul 2019 05:10:40 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hmaWk-0004mS-PO for bug-gnu-emacs@gnu.org; Sun, 14 Jul 2019 05:10:39 -0400 Received: from metalevel.at ([78.46.218.83]:44908) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hmaWk-0004lu-J7 for bug-gnu-emacs@gnu.org; Sun, 14 Jul 2019 05:10:38 -0400 Received: from mt-mbpro.localdomain (localhost.localdomain [127.0.0.1]) by metalevel.at (Postfix) with ESMTP id A6827A0462 for ; Sun, 14 Jul 2019 11:10:31 +0200 (CEST) Received: by mt-mbpro.localdomain (Postfix, from userid 501) id 71086F62446; Sun, 14 Jul 2019 11:10:31 +0200 (CEST) From: Markus Triska Date: Sun, 14 Jul 2019 11:10:31 +0200 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 78.46.218.83 X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -3.3 (---) In 39.12.2 Defining Faces, the documentation of defface includes the text: "You should not quote the symbol FACE, and it should not end in =E2=80=98-face=E2=80=99 (that would be redundant)." Yet, 23.6.2 Search-based Fontification repeatedly mentions fubar-face as example face, and its name does end in -face: ;; Highlight occurrences of =E2=80=98fubar=E2=80=99, ;; using the face which is the value of =E2=80=98fubar-face=E2=80=99. ("fubar" . fubar-face) The docstring of font-lock-keywords also repeatedly mentions fubar-face as example: (\"fubar\" . fubar-face) Occurrences of \"fubar\" in the value of `fubar-face'. To ensure exemplary face names and internal consistency of the manual, it seems appropriate to change the example face names to names that are in alignment with the manual's recommendations. For instance, the cited examples could maybe be changed, respectively, to ;; Highlight occurrences of =E2=80=98fubar=E2=80=99, ;; using the face which is the value of =E2=80=98fubar=E2=80=99. ("fubar" . fubar) and: (\"fubar\" . fubar) Occurrences of \"fubar\" in the value of the face `fubar'. to follow the recommendations? Thank you and all the best, Markus In GNU Emacs 26.1 (build 1, x86_64-apple-darwin15.3.0, X toolkit, Xaw scrol= l bars) of 2018-09-22 built on laptop Windowing system distributor 'The X.Org Foundation', version 11.0.11502000 From unknown Sat Sep 20 13:00:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#36647: 26.1; Please align examples of search-based fontification with recommendations Resent-From: Glenn Morris Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 14 Jul 2019 20:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36647 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Markus Triska Cc: 36647@debbugs.gnu.org Received: via spool by 36647-submit@debbugs.gnu.org id=B36647.156313681028754 (code B ref 36647); Sun, 14 Jul 2019 20:41:01 +0000 Received: (at 36647) by debbugs.gnu.org; 14 Jul 2019 20:40:10 +0000 Received: from localhost ([127.0.0.1]:46077 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmlI1-0007Ti-JT for submit@debbugs.gnu.org; Sun, 14 Jul 2019 16:40:09 -0400 Received: from eggs.gnu.org ([209.51.188.92]:42918) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmlHz-0007TR-78 for 36647@debbugs.gnu.org; Sun, 14 Jul 2019 16:40:07 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:58361) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hmlHt-0006dV-Mk; Sun, 14 Jul 2019 16:40:01 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1hmlHr-00086g-Uv; Sun, 14 Jul 2019 16:40:00 -0400 From: Glenn Morris References: X-Spook: militia Bin Laden Electric Albania Juarez Calderon MARTA X-Ran: hCN(p^NJ>#V%H@[8hzR$ld0O-(6v^x+F%$kAS9'05NngC{z$~#S"fy({ITF4!.{gJ;C~}O X-Hue: brightblue X-Attribution: GM Date: Sun, 14 Jul 2019 16:39:59 -0400 In-Reply-To: (Markus Triska's message of "Sun, 14 Jul 2019 11:10:31 +0200") Message-ID: <5na7dgbba8.fsf@fencepost.gnu.org> User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -3.3 (---) Markus Triska wrote: > In 39.12.2 Defining Faces, the documentation of defface includes the text: > > "You should not quote the symbol FACE, and > it should not end in '-face' (that would be redundant)." > > Yet, 23.6.2 Search-based Fontification repeatedly mentions fubar-face as > example face, and its name does end in -face: > > ;; Highlight occurrences of 'fubar', > ;; using the face which is the value of 'fubar-face'. > ("fubar" . fubar-face) fubar-face is not a face, but a variable whose value is a face. Thus, there is no inconsistency here. From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 17 07:02:31 2019 Received: (at control) by debbugs.gnu.org; 17 Jul 2019 11:02:31 +0000 Received: from localhost ([127.0.0.1]:51613 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hnhhd-0001dG-Li for submit@debbugs.gnu.org; Wed, 17 Jul 2019 07:02:31 -0400 Received: from mail-wm1-f66.google.com ([209.85.128.66]:50994) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hnhhb-0001cf-To for control@debbugs.gnu.org; Wed, 17 Jul 2019 07:02:28 -0400 Received: by mail-wm1-f66.google.com with SMTP id v15so21721972wml.0 for ; Wed, 17 Jul 2019 04:02:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=VSpkuE8xBjtVp3s3pOJQe7Aa5q5faoQ0UTPXmW6Cwhc=; b=gH/UkgATKZ2m2Wb1WWaPCnJpIPWmao97kWfrhJxGadORw6frbbkPhdCKaEkghgxsdX N85ZxDedzCLlSWEtQWBTnGXUe8usmVOpzZPZY6az2vEAD/+CbKgIE4VFWjJ5OPsRobtq IEZQI6CWBmMyhEnIyGbk+tegY/WiM1pswX9v6laeFZ78THC1wWIBY3ccu8WYIXLGRNja 6PfklvLjfFN1m1KHcgetWvUsHx2af0J9jNIIAkG/VMpsl29rLOMmnrPHrHVnr0svX9q1 2ncaLHGR5dcXKHsb10NbS6J3Ya82pADsNbgMq6gXDsyQl+SVLsF6C9WQDZ6DR7WV7gUW +LKw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=VSpkuE8xBjtVp3s3pOJQe7Aa5q5faoQ0UTPXmW6Cwhc=; b=gbafE7pkJbx0efLu2x0OKrCrAw+OMBExxXu32rNvcSmp+rcSnMlFC7qCvhL8ag5bB2 A/gX0IKldtpjHWT0a1pcOad5gokkqowphKF/c71mgM0o7O0CxNMdy+NpELz0+lhNYx+8 fAr5zsbzOUtYRz2Bp2M0ve3o4nOx3lghA6vbqm7OXZSg7HcTmxOOTkA0kjz0vI1JC4r8 z6qiJtf+JWIsZZU4cNDziAScO/6W81GT3FRSkRngkuW5Bd8UPo+XCOwSbZd7lzxzRWZr HBCcGMgn3lbqFLXEW5asJqQu713z0eIKvSPEoB7j9l9Jukbhs1rYnlr33k9Ua9qssrCY JHwQ== X-Gm-Message-State: APjAAAUqEO4PnNSN9IwBrBkFk9FlgqZgKdD5TZBqTc0FN+YJ6atmfIwa T03ggfo6+pT+0Yf9YHYlKtdmAQ== X-Google-Smtp-Source: APXvYqyOTuCTeUAPRmXkfIOq/0IlFCbOZlpXv54t3LmO/5XeEq/sz4/Mkb1DxjXAP4dtcQQ6zydYhA== X-Received: by 2002:a1c:480a:: with SMTP id v10mr35945530wma.120.1563361341855; Wed, 17 Jul 2019 04:02:21 -0700 (PDT) Received: from localhost ([2a02:8084:20e2:c380:1f68:7ff5:120d:64e]) by smtp.gmail.com with ESMTPSA id w24sm19632371wmc.30.2019.07.17.04.02.20 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Wed, 17 Jul 2019 04:02:20 -0700 (PDT) From: "Basil L. Contovounesios" To: Glenn Morris Subject: Re: bug#36647: 26.1; Please align examples of search-based fontification with recommendations References: <5na7dgbba8.fsf@fencepost.gnu.org> Date: Wed, 17 Jul 2019 12:02:12 +0100 In-Reply-To: <5na7dgbba8.fsf@fencepost.gnu.org> (Glenn Morris's message of "Sun, 14 Jul 2019 16:39:59 -0400") Message-ID: <87woggj557.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control Cc: 36647-done@debbugs.gnu.org, Markus Triska X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -1.0 (-) tags 36647 notabug close 36647 quit Glenn Morris writes: > Markus Triska wrote: > >> In 39.12.2 Defining Faces, the documentation of defface includes the tex= t: >> >> "You should not quote the symbol FACE, and >> it should not end in '-face' (that would be redundant)." >> >> Yet, 23.6.2 Search-based Fontification repeatedly mentions fubar-face as >> example face, and its name does end in -face: >> >> ;; Highlight occurrences of 'fubar', >> ;; using the face which is the value of 'fubar-face'. >> ("fubar" . fubar-face) > > fubar-face is not a face, but a variable whose value is a face. > Thus, there is no inconsistency here. Indeed, as the line immediately preceding the citation explains: =E2=80=98(MATCHER . FACESPEC)=E2=80=99 In this kind of element, FACESPEC is an expression whose value specifies the face to use for highlighting. In the simplest case, FACESPEC is a Lisp variable (a symbol) whose value is a face name. So I'm closing this report. Thanks, --=20 Basil