From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Markus Triska Newsgroups: gmane.emacs.bugs Subject: bug#36647: 26.1; Please align examples of search-based fontification with recommendations 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 Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="13240"; mail-complaints-to="usenet@blaine.gmane.org" To: 36647@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 14 11:11:08 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hmaXE-0003IC-5B for geb-bug-gnu-emacs@m.gmane.org; Sun, 14 Jul 2019 11:11:08 +0200 Original-Received: from localhost ([::1]:59438 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hmaXC-0002hI-HR for geb-bug-gnu-emacs@m.gmane.org; Sun, 14 Jul 2019 05:11:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35756) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hmaX9-0002fb-6w for bug-gnu-emacs@gnu.org; Sun, 14 Jul 2019 05:11:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hmaX8-0004vV-66 for bug-gnu-emacs@gnu.org; Sun, 14 Jul 2019 05:11:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:34986) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hmaX8-0004vP-2R for bug-gnu-emacs@gnu.org; Sun, 14 Jul 2019 05:11:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hmaX7-0000YU-T7 for bug-gnu-emacs@gnu.org; Sun, 14 Jul 2019 05:11:01 -0400 X-Loop: help-debbugs@gnu.org 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-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.15630954442108 (code B ref -1); Sun, 14 Jul 2019 09:11:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 14 Jul 2019 09:10:44 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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) Original-Received: by mt-mbpro.localdomain (Postfix, from userid 501) id 71086F62446; Sun, 14 Jul 2019 11:10:31 +0200 (CEST) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:162969 Archived-At: 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