GNU bug report logs - #59954
29.0.50; flymake-reporting-backends documentation could use some work

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: wishlist; Reported by: Stefan Kangas <stefankangas@HIDDEN>; dated Sat, 10 Dec 2022 23:27:01 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.
Severity set to 'wishlist' from 'normal' Request was from Stefan Kangas <stefankangas@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

Message received at 59954 <at> debbugs.gnu.org:


Received: (at 59954) by debbugs.gnu.org; 11 Dec 2022 11:35:40 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Dec 11 06:35:40 2022
Received: from localhost ([127.0.0.1]:46348 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1p4KcO-0000wN-3B
	for submit <at> debbugs.gnu.org; Sun, 11 Dec 2022 06:35:40 -0500
Received: from mail-wm1-f54.google.com ([209.85.128.54]:52046)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <joaotavora@HIDDEN>) id 1p4KcH-0000wG-M2
 for 59954 <at> debbugs.gnu.org; Sun, 11 Dec 2022 06:35:38 -0500
Received: by mail-wm1-f54.google.com with SMTP id bg10so2987031wmb.1
 for <59954 <at> debbugs.gnu.org>; Sun, 11 Dec 2022 03:35:33 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=content-transfer-encoding:mime-version:user-agent:message-id:date
 :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date
 :message-id:reply-to;
 bh=hhtMYCfVhWE9n8wViLv616G+Q8mgX9AZHLSSdfVKsfk=;
 b=TTQqpbyPwAzMBE0lNrUYyXux2LiJcCWl+5osbwX1do3KY0D2eqHCKQ2aMyZNGNUc5N
 5QxeEbsyjMY42bFfpDcuIfBcnVezmExOXGZX+mKdhmBtQniIKp+wwuiGgWfafc243B1L
 hxXenyE/mP+CwcmXoWFli36CdZzcx2Om0LzMztW+Xn0JrqmqRM7F7yyPZfVGj6KQKzVf
 1U1ta+IHlcroqifx1MVAM1CSur7Y5G6PMsx4qfp3CDtrmImBf8Ixb7BISg3cI5DQo1uI
 kDk9OJdP5wzqp1K6LjlgxoimnR7X7WQxFoS9k0FOY/IzOXH355SjKubLbR41GZYPTWOS
 lv7A==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=content-transfer-encoding:mime-version:user-agent:message-id:date
 :references:in-reply-to:subject:cc:to:from:x-gm-message-state:from
 :to:cc:subject:date:message-id:reply-to;
 bh=hhtMYCfVhWE9n8wViLv616G+Q8mgX9AZHLSSdfVKsfk=;
 b=wn0OGEpICFrxjOiQiSG3vhcKeRPCNSJFhD0vHj5AuX/iNL7jPUNlmQaGYGGeJbJa0n
 fyXruYd4pCR3zySIfs3Gj6J4WZTGekCIhb28QDIX8FRr9KQtTIPq5MjAVuuo3bZXovVp
 N4+d44giC/m/VNhUBdcKXUJ/4YN4Q+1MS4n3DEuCrCKSWHdjaUlf6W38e70Hnc9sKQ0G
 LJYzJtzYwvrMSXstCIeRcVoq8+ByqD1JNrtPhJcuydBSIR6l/mxDJDplXJ6JegNxJ9XV
 RSu+z9JQbB9iCmly6IZoYQbRbNBncd9lhHjn0bjt0qgCC7V0E/Wiz4ir4QNkRKs3pK1L
 M6ww==
X-Gm-Message-State: ANoB5pnAwPnQoNWMi7b+u77rtcSTSZyF3Fb9HNlJJN/MHlgARTDI3VXQ
 Oxhzsbt54QmaoEtquHLf0cs8hjQOUPMvUA==
X-Google-Smtp-Source: AA0mqf58CmwcIG4Ah5GiSdlFcAIxachKVp5TEd2/HE8uLqcwKc6kNXyGrVJ0R0UztFlAtF3Ky3Aw/Q==
X-Received: by 2002:a05:600c:21d8:b0:3d0:8d48:2993 with SMTP id
 x24-20020a05600c21d800b003d08d482993mr9941139wmj.36.1670758527594; 
 Sun, 11 Dec 2022 03:35:27 -0800 (PST)
Received: from krug ([87.196.73.60]) by smtp.gmail.com with ESMTPSA id
 q11-20020a05600c46cb00b003d1cf67460esm5949893wmo.40.2022.12.11.03.35.26
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Sun, 11 Dec 2022 03:35:27 -0800 (PST)
From: =?utf-8?B?Sm/Do28gVMOhdm9yYQ==?= <joaotavora@HIDDEN>
To: Stefan Kangas <stefankangas@HIDDEN>
Subject: Re: bug#59954: 29.0.50; flymake-reporting-backends documentation
 could use some work
In-Reply-To: <CADwFkmm0oZob7NuB-aBCk2ybf=WSMAUc-UOFgsrTM+As_H7vRg@HIDDEN>
 (Stefan Kangas's message of "Sat, 10 Dec 2022 15:26:18 -0800")
References: <CADwFkmm0oZob7NuB-aBCk2ybf=WSMAUc-UOFgsrTM+As_H7vRg@HIDDEN>
Date: Sun, 11 Dec 2022 11:36:51 +0000
Message-ID: <87a63ugoj0.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 59954
Cc: 59954 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Stefan Kangas <stefankangas@HIDDEN> writes:

> On a side note, and not necessarily part of this bug report, it would
> also be useful with some documentation that says to find out more about
> a particular back-end.  Currently, I guess `C-h f' is the recommended
> way to do that?

Yes.  describe-function (C-h f) is the right way because back-ends are
represented by functions.  You can invent a M-x flymake-describe-backend
with a different completion set, but it should funnel to M-x
describe-function and give the very same output.

On a related note, you can see that in the commands M-x
flymake-show-[buffer|project]-diagnostics, the backend's itself is
represented in a column.  Currently this name is synthesized from the
initials of the symbol name bound to the function.  This works well as a
default, but it could be augmented:

For example:

* There could be a 'flymake-backend-name' property on the symbols for
  an extra indirection or better names

* Clicking the name in that report could bring up the same thing as C-h
  f, effectively describing the backend.

Jo=C3=A3o






Information forwarded to bug-gnu-emacs@HIDDEN:
bug#59954; Package emacs. Full text available.

Message received at 59954 <at> debbugs.gnu.org:


Received: (at 59954) by debbugs.gnu.org; 11 Dec 2022 11:27:24 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Dec 11 06:27:24 2022
Received: from localhost ([127.0.0.1]:46340 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1p4KUO-0000qD-8Y
	for submit <at> debbugs.gnu.org; Sun, 11 Dec 2022 06:27:24 -0500
Received: from mail-wm1-f42.google.com ([209.85.128.42]:40569)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <joaotavora@HIDDEN>) id 1p4KUL-0000q6-FU
 for 59954 <at> debbugs.gnu.org; Sun, 11 Dec 2022 06:27:22 -0500
Received: by mail-wm1-f42.google.com with SMTP id
 v124-20020a1cac82000000b003cf7a4ea2caso2876747wme.5
 for <59954 <at> debbugs.gnu.org>; Sun, 11 Dec 2022 03:27:21 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=content-transfer-encoding:mime-version:user-agent:message-id:date
 :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date
 :message-id:reply-to;
 bh=hFzRyEbHJaGgkUETHc2YFyVngsuqskqgIJ3FMIxRv9E=;
 b=N2CGQmUMu+p81dm5oTOvLcUHYPNXF2gc0QWu3H2/7alRT9/IpfJ0HdAOeX6fAQimfU
 Js/ImaI2/YggmwmD9/GT3awhyGJ95q3AXpD8E/oq+GC2LVEP/0Opksxqp1lhGSEj/mgx
 pLiDsMIjZbzsbdIGNGuXQjieKWaKUC7cRqyP/JhNvFXAmYlaGxk+u/o/nQNvgCDMze1j
 z/NyPeLOmdne0Xg2jKbU2Vg+XrpWBZZ6LM8yrSDQQecsUlgU2tdld+b2KwB0Om04MNZk
 e72sJwwdQFjL/QKSu6Xqw6vUJz3s/8sjvExDP9bl0DP9R+olHrWdRxUlukUfhDC+Q3RG
 EUtg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=content-transfer-encoding:mime-version:user-agent:message-id:date
 :references:in-reply-to:subject:cc:to:from:x-gm-message-state:from
 :to:cc:subject:date:message-id:reply-to;
 bh=hFzRyEbHJaGgkUETHc2YFyVngsuqskqgIJ3FMIxRv9E=;
 b=okpDR5Kv5cNUEJLh7NQbjUxGfULVoNeQGEnq65vGPYztv9ZgkbegH1KOzHkBAjTIiz
 zUri0PeiQlekrVI9cc2qygdMrT2MocZ1OedCm53o/G1sxjj4d1o5bjb5wCiEC2F4OYOZ
 XxbFJT7cBmWgZ4ad+yU7FGVz3PimmNJFHBRXZwT23INJ8jkXN8lKu0s8op6hrisS+7x/
 u5Ute57DZZ3xTEp+EWp/IrbD2fa9Zuk0mD07DC5L0BgvO05ZJIFohHVgx7Fvb0dpy669
 jfZA8NYYpeom+d2zYD7W+4xouMCUlkSG7mZX4FlHFqYuIrkHX7zcQyVJUfrea59a2n8k
 +wKw==
X-Gm-Message-State: ANoB5plGaMDt3mGw7zivgwl7k38HhUWFqI/uA+rxp06ldPyHQyH6Gudy
 Vg6QO7xwSAVvyz+aVZejpAcAkrjVBOfEHg==
X-Google-Smtp-Source: AA0mqf40OluLq/zaZG2ug2fxvD/jF7XS40WLuGRCRZqOt5017sIVH+UYaKZzyO44EGoDtFpAJrNo7A==
X-Received: by 2002:a1c:f216:0:b0:3c6:e60f:3f6f with SMTP id
 s22-20020a1cf216000000b003c6e60f3f6fmr9705064wmc.38.1670758035241; 
 Sun, 11 Dec 2022 03:27:15 -0800 (PST)
Received: from krug ([87.196.73.60]) by smtp.gmail.com with ESMTPSA id
 q24-20020a056000137800b002428c4fb16asm6077843wrz.10.2022.12.11.03.27.14
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Sun, 11 Dec 2022 03:27:14 -0800 (PST)
From: =?utf-8?B?Sm/Do28gVMOhdm9yYQ==?= <joaotavora@HIDDEN>
To: Stefan Kangas <stefankangas@HIDDEN>
Subject: Re: bug#59954: 29.0.50; flymake-reporting-backends documentation
 could use some work
In-Reply-To: <CADwFkmm0oZob7NuB-aBCk2ybf=WSMAUc-UOFgsrTM+As_H7vRg@HIDDEN>
 (Stefan Kangas's message of "Sat, 10 Dec 2022 15:26:18 -0800")
References: <CADwFkmm0oZob7NuB-aBCk2ybf=WSMAUc-UOFgsrTM+As_H7vRg@HIDDEN>
Date: Sun, 11 Dec 2022 11:28:38 +0000
Message-ID: <87edt6gowp.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 59954
Cc: 59954 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Stefan Kangas <stefankangas@HIDDEN> writes:

> The docstring of `flymake-reporting-backends' says:
>
>     Compute reporting Flymake backends in current buffer.

From all the Flymake backends present in `flymake-diagnostic-functions',
the "reporting" ones are the ones that have reported back, i.e. called
their REPORT-FN arguments.

The distinction is (mildly) useful because the Lisp function that
implements them always returns, but that doesn't necessarily mean that
the backend has arranged for the REPORT-FN callback to be called.  When
it is called, the backend enters the "reporting set".

> It is also not really explained in (info "(flymake) Troubleshooting").
> More precisely, I think it must be spelled out how it's different from
> `flymake-running-backends', and in which situations one would want to
> use one or the other.

A "running" backend is simply a backend which has been activated

> I understand that the "reporting" ones are basically the union of the
> running and disabled ones, right?

Not necessarily.  A backend may be running and we haven't yet decided if
it will become a reporting backend or a disabled one.

> "reporting"?  That is not immediately clear to me.  Surely if they are
> disabled, they are *not* reporting?  This could use some explanation.

Best explanation is in these notes and in the code.  There is partially
a historical rationale, as I was trying to keep the visual interface of
the old Flymake reasonably intact, and AFAIR it had representation for
all these states.

But there is also a fair bit of overengineering here.  It makes sense to
represent the states internally, but I've never ever found those
interactive functions useful.  Maybe a bit in the early days of
debugging... IMO you could just trash them or redesign them into a
tabulated list or something.

Jo=C3=A3o




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#59954; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 10 Dec 2022 23:26:27 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Dec 10 18:26:27 2022
Received: from localhost ([127.0.0.1]:45739 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1p49Eh-0001Rq-9i
	for submit <at> debbugs.gnu.org; Sat, 10 Dec 2022 18:26:27 -0500
Received: from lists.gnu.org ([209.51.188.17]:48144)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stefankangas@HIDDEN>) id 1p49Ed-0001Rk-Eu
 for submit <at> debbugs.gnu.org; Sat, 10 Dec 2022 18:26:25 -0500
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 <stefankangas@HIDDEN>)
 id 1p49Ed-0001vm-74
 for bug-gnu-emacs@HIDDEN; Sat, 10 Dec 2022 18:26:23 -0500
Received: from mail-oa1-x35.google.com ([2001:4860:4864:20::35])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <stefankangas@HIDDEN>)
 id 1p49Eb-0007xL-7n
 for bug-gnu-emacs@HIDDEN; Sat, 10 Dec 2022 18:26:22 -0500
Received: by mail-oa1-x35.google.com with SMTP id
 586e51a60fabf-1445ca00781so4277921fac.1
 for <bug-gnu-emacs@HIDDEN>; Sat, 10 Dec 2022 15:26:19 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=to:subject:message-id:date:mime-version:from:from:to:cc:subject
 :date:message-id:reply-to;
 bh=FtEML2AVicFTEbfhrjd1pPIbTPnap7dD2dYEVo/q8P4=;
 b=ZKWQGRH0jjgrdar9uZP/nvuf/smYcYDWFRpveSsIJyV7+fTG7jmlq4ijlgK4Qz0yUD
 8v8VdD4wSrxuDRYlYcj0X93rPlt6l7ulAnoOjl5LuDSAPjf4B5Vo8Cb4QOa23ctaWAcF
 Q/BZ9b131jKwH+y+Fa+xeFTl1pKTI5RBw89HnMM1WsgZrLjMeDQlGsrIlsKMo47i6t0h
 qakpKhPHmg8Qof2LAr99BK//w/ohplRIjMe8iJ6U4vOEllJiBOl88VdG97LFewIebLE4
 Gb/jYJj5UvYDjV12vD1BnDKj6Kj4/6+pd4VCFY6r6r28fFElXQUnZYYjKfMQkgyqOtMa
 dT6w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=to:subject:message-id:date:mime-version:from:x-gm-message-state
 :from:to:cc:subject:date:message-id:reply-to;
 bh=FtEML2AVicFTEbfhrjd1pPIbTPnap7dD2dYEVo/q8P4=;
 b=W5Fgl8SadNuSCQ/jkAXw4TrB5+GJPRVkHG0WGVyt86FAYCqkW1p3B4lAzRw5acosFo
 tycMkUtKZyz50mizhTFS9G/j7kTZoCX0GZh0m2gssM65fjsW8FhOeVAEmeg7xeOp8Qg3
 lLIYbP2ylhplQI7J1SUsvLY7hG/CywtBcvqXD02RXWNj/6f3AO1klP2yqZYh00SjmPvx
 lN/fZGRywAhUwrG74r/YOmMUel8jp2kA9b9v4pqPPa6w0YgfdmJ6rnXgnHB8DqL3eqLd
 5gWluV0e1gUkMMc84IWpzhIjcNnoRzFIes090gFuCbiyBiUtg38qw66JyrHOVeYQhhWL
 HfmA==
X-Gm-Message-State: ANoB5pngUfkfyBfdfUFz3hXI/ruF4SdodHBTtDXCV6LMxBRgZoSaBPJV
 SvrVY3q8VF7FW59pzpJV6/bYS+UA23yk74Q5astSnnZQ
X-Google-Smtp-Source: AA0mqf73RP8IZeUcuY4bHoEPyAY2SjadfZwgb8SiqLRtqphPCA1DMkbX35b9NhZzVGrMc8SbfdrTVhp96KmwwuNAQGk=
X-Received: by 2002:a05:6870:7813:b0:148:28c1:3d46 with SMTP id
 hb19-20020a056870781300b0014828c13d46mr98218oab.199.1670714778876; Sat, 10
 Dec 2022 15:26:18 -0800 (PST)
Received: from 753933720722 named unknown by gmailapi.google.com with
 HTTPREST; Sat, 10 Dec 2022 15:26:18 -0800
From: Stefan Kangas <stefankangas@HIDDEN>
X-Debbugs-CC: =?UTF-8?B?Sm/Do28gVMOhdm9yYSA8am9hb3Rhdm9yYUBnbWFpbC5jb20+?=
X-Hashcash: 1:20:221210:bug-gnu-emacs@HIDDEN::txISo0vQlU2lZMnA:2iTI
MIME-Version: 1.0
Date: Sat, 10 Dec 2022 15:26:18 -0800
Message-ID: <CADwFkmm0oZob7NuB-aBCk2ybf=WSMAUc-UOFgsrTM+As_H7vRg@HIDDEN>
Subject: 29.0.50; flymake-reporting-backends documentation could use some work
To: bug-gnu-emacs@HIDDEN
Content-Type: text/plain; charset="UTF-8"
Received-SPF: pass client-ip=2001:4860:4864:20::35;
 envelope-from=stefankangas@HIDDEN; helo=mail-oa1-x35.google.com
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.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,
 RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -1.3 (-)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)

From reading its documentation, I don't understand what the
`flymake-reporting-backends' command does.

The docstring of `flymake-reporting-backends' says:

    Compute reporting Flymake backends in current buffer.

It is also not really explained in (info "(flymake) Troubleshooting").
More precisely, I think it must be spelled out how it's different from
`flymake-running-backends', and in which situations one would want to
use one or the other.

I understand that the "reporting" ones are basically the union of the
running and disabled ones, right?  But why are they considered
"reporting"?  That is not immediately clear to me.  Surely if they are
disabled, they are *not* reporting?  This could use some explanation.

Also, why does the docstring of `flymake-running-backends' and
`flymake-disabled-backends' talk about "computing backends", instead of
simply saying that it "displays" the running/disabled backends?

On a side note, and not necessarily part of this bug report, it would
also be useful with some documentation that says to find out more about
a particular back-end.  Currently, I guess `C-h f' is the recommended
way to do that?




Acknowledgement sent to Stefan Kangas <stefankangas@HIDDEN>:
New bug report received and forwarded. Copy sent to joaotavora@HIDDEN, bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to joaotavora@HIDDEN, bug-gnu-emacs@HIDDEN:
bug#59954; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Mon, 4 Sep 2023 15:30:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.