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.devel Subject: Re: Semantic hl-line-mode (was: ELPA: add lin.el) Date: Wed, 10 Nov 2021 16:33:08 +0200 Message-ID: <83pmr82i8r.fsf@gnu.org> References: <871r3uv1tk.fsf@protesilaos.com> <87czn9kt7o.fsf@protesilaos.com> <87y25whzcm.fsf@protesilaos.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="2253"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org, monnier@iro.umontreal.ca, stefankangas@gmail.com To: Protesilaos Stavrou Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Nov 10 15:34:05 2021 Return-path: Envelope-to: ged-emacs-devel@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 1mkofs-0000NK-OE for ged-emacs-devel@m.gmane-mx.org; Wed, 10 Nov 2021 15:34:04 +0100 Original-Received: from localhost ([::1]:42318 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mkofq-0006q4-Sd for ged-emacs-devel@m.gmane-mx.org; Wed, 10 Nov 2021 09:34:02 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:51370) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mkof6-0005ZZ-Uh for emacs-devel@gnu.org; Wed, 10 Nov 2021 09:33:16 -0500 Original-Received: from [2001:470:142:3::e] (port=33076 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mkof5-0005Ax-E4; Wed, 10 Nov 2021 09:33:15 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=XRC0kFucEwBDldSyWXI4JOwKArz39qji4Xoj9/RtX/U=; b=Q6o7aFaNm+DU FdqJTU9hxejao0vc+IUVlsiVKYG+dVFwkQlZr6xVhA74810c7PCsOpA3jNXRrso8X68CKjQ8y5w43 4jcO1bb2dhY80Rxau9icEBsPqBXguvxJY+dDFK7WNJKLtRweXvM8NmpQJRn09v6HzaJ0OMRwXURZM uqXq1rruWh7H+AHT+ZWJZ+eavFBbd9MsIrfxM2civOuCm7DdeE+WHH85hdCKvEk26LQogZsXPDKwg 2VFTXv4s2t7HfeSaDqABTGDzmc9uYuKnoBz972MMUztpsRtfcJugZlH+pTDERZlmI03i93ZY061uI u75G/XUpEXOO27q5YhiK8w==; Original-Received: from [87.69.77.57] (port=3068 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 1mkof4-00026e-5J; Wed, 10 Nov 2021 09:33:15 -0500 In-Reply-To: <87y25whzcm.fsf@protesilaos.com> (message from Protesilaos Stavrou on Wed, 10 Nov 2021 16:14:33 +0200) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:279173 Archived-At: > From: Protesilaos Stavrou > Date: Wed, 10 Nov 2021 16:14:33 +0200 > Cc: emacs-devel > > Following your advice, I have prepared a patch for hl-line.el. Please > find it attached. Feel welcome to make changes. Thanks. > +** Semantic hl-line-mode > +It is now possible to differentiate between two types of highlighting: > +(i) line selection, or (ii) simple line highlight. The former is > +appropriate for interfaces that operate on the current line (e.g. a > +listing of email threads), while the latter helps identify the point > +on the vertical axis. > + > +Major modes can register themselves as having a selection-based > +interface by setting the local variable 'hl-line-select-line-style' to > +non-nil. In that case, they will use the new 'hl-line-selection' > +face. > + > +The user option 'hl-line-selection-ui' can be set to nil to disable > +this feature altogether, meaning that only the 'hl-line-face' will be > +applied. > + > +Users or theme developers may, in turn, choose to make the 'hl-line' > +face more subtle while allowing a more prominent style where it is > +really needed via the 'hl-line-selection' face. I've read this text and the other documentation in the patch, and I still don't understand what this does and how it differs from the default operation of hl-line. You describe quite a lot of implementation-elated details, but very little information that can help the user decide whether he or she wants this option. I think one problem (but not the only one) is that you use "selection", which is an overloaded term (you definitely do NOT mean X selections, right?). Could you please rework the documentation so that it becomes more user-facing?