From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#50041: Add font-lock-doc-markup-face Date: Sat, 14 Aug 2021 08:56:47 +0300 Message-ID: <83r1ewbmcg.fsf@gnu.org> References: <837dgpcx1g.fsf@gnu.org> <1A815899-9854-4042-B4C1-BCF85BF4E794@acm.org> <8335rdcu1p.fsf@gnu.org> <5FDD6903-3ECB-4F3E-90D8-FA591A5A143D@acm.org> <83y295banl.fsf@gnu.org> <34CEA0B4-3AE8-4E70-A092-D57341741D33@acm.org> <83tujtb3i2.fsf@gnu.org> <9A060FF9-242D-47DE-AA4D-D41BFA5779EE@acm.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29849"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, 50041@debbugs.gnu.org To: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 14 07:58:09 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mEmgL-0007Xh-Iq for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 14 Aug 2021 07:58:09 +0200 Original-Received: from localhost ([::1]:54162 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mEmgK-0004dd-3d for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 14 Aug 2021 01:58:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:60850) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mEmgE-0004dT-6A for bug-gnu-emacs@gnu.org; Sat, 14 Aug 2021 01:58:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60113) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mEmgD-0006zX-VV for bug-gnu-emacs@gnu.org; Sat, 14 Aug 2021 01:58:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mEmgD-0001hb-TK for bug-gnu-emacs@gnu.org; Sat, 14 Aug 2021 01:58:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Aug 2021 05:58:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50041 X-GNU-PR-Package: emacs Original-Received: via spool by 50041-submit@debbugs.gnu.org id=B50041.16289206346489 (code B ref 50041); Sat, 14 Aug 2021 05:58:01 +0000 Original-Received: (at 50041) by debbugs.gnu.org; 14 Aug 2021 05:57:14 +0000 Original-Received: from localhost ([127.0.0.1]:43426 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mEmfO-0001gW-03 for submit@debbugs.gnu.org; Sat, 14 Aug 2021 01:57:14 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:44374) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mEmfI-0001g0-2h for 50041@debbugs.gnu.org; Sat, 14 Aug 2021 01:57:08 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:42976) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mEmfC-00068v-ER; Sat, 14 Aug 2021 01:56:58 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2011 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mEmfB-0002KA-TH; Sat, 14 Aug 2021 01:56:58 -0400 In-Reply-To: <9A060FF9-242D-47DE-AA4D-D41BFA5779EE@acm.org> (message from Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= on Fri, 13 Aug 2021 23:24:13 +0200) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:211803 Archived-At: > From: Mattias Engdegård > Date: Fri, 13 Aug 2021 23:24:13 +0200 > Cc: larsi@gnus.org, 50041@debbugs.gnu.org > > > "Font Lock mode face used to highlight documentation." > > All faces have very terse doc strings and I naturally assumed that was the preferred style; it certainly didn't prevent me from understanding it. Anyway, I have amended the doc strings of both font-lock-doc-face and font-lock-doc-markup-face. > > > Also, I think "for mark-up elements" is too terse and assumes too much > > of prior knowledge; we should make more clear what that means, or > > provide a couple of examples. > > Maybe, but let's not exaggerate; this is standard terminology. Nevertheless, the text has been extended. > > > The NEWS entry is now clear enough, but I think the manual > > and the doc string still need some work. > > Very well, they have now all been expanded further. Thanks, this LGTM.