From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Heime Newsgroups: gmane.emacs.help Subject: Re: Introducing face in comments for various modes Date: Mon, 12 Dec 2022 03:00:29 +0000 Message-ID: <0RJB0bPRTMAqXlUbL2kGUvJtnCNPYwPhqTNi_l9nIpQAciTZYcYCikFVqi2Nr_UZLbT1_DRtX8G0dSkgI4jln5DTYBDxLz4i7L2d9wx-kA8=@protonmail.com> References: <9ZK1Solghrmps4AarUsz2E6-mAdkrTZoXPs4RTRTd9sZ0Cd8DGhK955im1kuug-EZXU3tc5rgDDd16vQexxpFnMvMFjFqnNnh0noashyLdE=@protonmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="35807"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Stefan Monnier , help-gnu-emacs@gnu.org To: Heime Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Mon Dec 12 04:01:26 2022 Return-path: Envelope-to: geh-help-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 1p4Z4I-00097v-0N for geh-help-gnu-emacs@m.gmane-mx.org; Mon, 12 Dec 2022 04:01:26 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p4Z3f-0002cm-Q9; Sun, 11 Dec 2022 22:00:47 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p4Z3Z-0002be-2S for help-gnu-emacs@gnu.org; Sun, 11 Dec 2022 22:00:44 -0500 Original-Received: from mail-4318.protonmail.ch ([185.70.43.18]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p4Z3W-0007yl-Ci for help-gnu-emacs@gnu.org; Sun, 11 Dec 2022 22:00:40 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail3; t=1670814035; x=1671073235; bh=U/W/CnTM6WhxNgA5zdPk/oQbK76VMTLeoSHTIskUdLs=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=CJasvFioT32e4/Zb6Td581B41OwmttWU62bGpHYhRpCyoW6nLPNJ6nGTO2o3SQ/V2 77hrwh0ezyLmDl/fGVASEDEtg+zBS8RG0URou3mF4Ys2vk1T4KjrLtqebK+9Vx6iRJ cPROe7n2mchpF6VY9rJm7/6qHnnnTARMCxKbkR7QkVgzC62K0ht5HUlwV6e3SMLtta q5+M2zcLtKAe+qKXkQ99+DEnDaVcS3pQswR600G9qhbX5mwGO3nLzWgwr/+CwWI3IU 5teyGfkaHoJgNeBlKeedAB7YRCPvLN1L6XEF+cXoDJQGVtjKRoEG8pzIQ+NEa2ejep LbY4Z/b/pAoMA== In-Reply-To: Feedback-ID: 57735886:user:proton Received-SPF: pass client-ip=185.70.43.18; envelope-from=heimeborgia@protonmail.com; helo=mail-4318.protonmail.ch X-Spam_score_int: -10 X-Spam_score: -1.1 X-Spam_bar: - X-Spam_report: (-1.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, TO_EQ_FM_DIRECT_MX=1 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.help:141661 Archived-At: Sent with Proton Mail secure email. ------- Original Message ------- On Monday, December 12th, 2022 at 2:24 AM, Heime wrote: > ------- Original Message ------- > On Sunday, December 11th, 2022 at 5:40 PM, Stefan Monnier via Users list = for the GNU Emacs text editor help-gnu-emacs@gnu.org wrote: >=20 > > BTW, there is a related convention in ELisp code where comments that > > start in column 0 and which are introduced with 3 or more semi-colons > > are considered sectioning headers (where ";;;" means a top-level > > header, ";;;;" a subheader, ";;;;;" a subsubheader, ...). > >=20 > > I'd be happy if Emacs were changed to highlighting those. > >=20 > > Stefan If you are colourising "Sectioning Headers", ensure that vibrant and good c= ontrast: 1) betweenthe text and the background;=20 2) and between a header, subheader, subsubheader, ... Use some colour metric (e.g. using the Web Content Accessibility Guidelines= [WCAG]). =20 Because I consistently see that developers almost never care (or have the s= kills) to properly set up colours. Have suggested changing the colour scheme as d= escribed, for "Org Headings" because they are indistinguishable against a dark backgr= ound and between a heading and its subheading. Applying such metrics have been turn= ed down, with the excuse that if I want them right, I have to work on emacs customis= ations myself, as the crappy colours are there to stay. =20 > Yes. I use headings as you describe to identify sections of code that foc= us on a particular task. But I also wanted to have some lower level categor= isation (within a function, say) to group some descriptions together. >=20 > > Heime [2022-12-11 15:35:41] wrote: > >=20 > > > The following uses `hi-lock` to change the foreground of comments mat= ching > > > a regexp. This is implemented for emacs-lisp files where comments sta= rt > > > with ";;". > > >=20 > > > I would like to extend this for other programming languages besides e= macs-lisp > > > files, using the relevant comment character automatically for that la= nguage. > > >=20 > > > (defface elfa-face > > > '((t :foreground "magenta")) > > > "Face for comment headings.") > > >=20 > > > (defun elfa-regexp (&optional actm) > > > "Identify comment category ';; [Category]'." > > > (highlight-regexp > > > "^;;\s+\\[.+\\].*$" 'elfa-face)) > > >=20 > > > (defun elfa-category () > > > "TODO." > > > (interactive) > > > (add-to-list 'auto-mode-alist '("\\.el\\'" . hi-lock-mode)) > > > (add-hook 'emacs-lisp-mode-hook 'hi-lock-mode t) > > > (add-hook 'hi-lock-mode-hook 'elfa-regexp))