From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#38778: 26.3; next-error-highlight set to t doesn't seem semi-permanent Date: Tue, 03 Mar 2020 19:18:58 +0200 Message-ID: <838skhxsot.fsf@gnu.org> References: <59A3A231-5EC7-4869-81D5-46CE5DA2D75A@gmail.com> <87v9nm76z9.fsf@mail.linkov.net> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="92254"; mail-complaints-to="usenet@ciao.gmane.io" Cc: hmelman@gmail.com, 38778@debbugs.gnu.org To: Juri Linkov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Mar 03 18:20:19 2020 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 1j9BDP-000Nua-Kc for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 03 Mar 2020 18:20:19 +0100 Original-Received: from localhost ([::1]:50780 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j9BDO-0001BQ-Fc for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 03 Mar 2020 12:20:18 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36311) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j9BDB-0001BJ-0c for bug-gnu-emacs@gnu.org; Tue, 03 Mar 2020 12:20:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j9BD9-0000Ud-Ud for bug-gnu-emacs@gnu.org; Tue, 03 Mar 2020 12:20:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:33947) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j9BD8-0000Tn-7g for bug-gnu-emacs@gnu.org; Tue, 03 Mar 2020 12:20:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1j9BD8-0002Bm-1u for bug-gnu-emacs@gnu.org; Tue, 03 Mar 2020 12:20:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 03 Mar 2020 17:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 38778 X-GNU-PR-Package: emacs Original-Received: via spool by 38778-submit@debbugs.gnu.org id=B38778.15832559538353 (code B ref 38778); Tue, 03 Mar 2020 17:20:01 +0000 Original-Received: (at 38778) by debbugs.gnu.org; 3 Mar 2020 17:19:13 +0000 Original-Received: from localhost ([127.0.0.1]:39920 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j9BCK-0002Ae-Hq for submit@debbugs.gnu.org; Tue, 03 Mar 2020 12:19:13 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:49257) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j9BCJ-0002AS-GY for 38778@debbugs.gnu.org; Tue, 03 Mar 2020 12:19:12 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:34577) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1j9BCE-0008TT-0T; Tue, 03 Mar 2020 12:19:06 -0500 Original-Received: from [176.228.60.248] (port=3439 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1j9BCD-0006RL-9o; Tue, 03 Mar 2020 12:19:05 -0500 In-Reply-To: <87v9nm76z9.fsf@mail.linkov.net> (message from Juri Linkov on Tue, 03 Mar 2020 00:03:10 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:176803 Archived-At: > From: Juri Linkov > Date: Tue, 03 Mar 2020 00:03:10 +0200 > Cc: 38778@debbugs.gnu.org > > Before closing this bug report, I propose to improve the documentation: Thanks, please push to the release branch, after taking care of a nit below. > When Emacs visits the locus of an error message, it momentarily > highlights the relevant source line. The duration of this highlight > -is determined by the variable @code{next-error-highlight}. > +is determined by the variable @code{next-error-highlight} for > +loci in selected buffers, and @code{next-error-highlight-no-select} for ^^^^^^^^^^^^^^^^^^^ There's only one selected buffer, so I'd suggest to say "in the selected buffer", singular. > (defcustom next-error-highlight 0.5 > "Highlighting of locations in selected source buffers. > +See `next-error-highlight-no-select' to customize highlighting > +of locations in non-selected buffers. > If a number, highlight the locus in `next-error' face for the given time > in seconds, or until the next command is executed. > If t, highlight the locus until the next command is executed, or until > @@ -91,7 +93,9 @@ next-error-highlight > :version "22.1") > > (defcustom next-error-highlight-no-select 0.5 > - "Highlighting of locations in `next-error-no-select'. > + "Highlighting of locations in non-selected source buffers. > +Usually non-selected buffers are displayed by `next-error-no-select'. > +See `next-error-highlight' to customize highlighting of selected buffers. > If number, highlight the locus in `next-error' face for given time in seconds. > If t, highlight the locus indefinitely until some other locus replaces it. > If nil, don't highlight the locus in the source buffer. In these two doc strings, please move the reference to the other variable to the end of the doc string. That is the usual place for "see also" kinds of text, because that way it doesn't disrupt the reading of the documentation of this variable.