From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#59954: 29.0.50; flymake-reporting-backends documentation could use some work Date: Sat, 10 Dec 2022 15:26:18 -0800 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33456"; mail-complaints-to="usenet@ciao.gmane.io" Cc: =?UTF-8?Q?Jo=C3=A3o_?= =?UTF-8?Q?T=C3=A1vora?= To: 59954@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Dec 11 00:27:21 2022 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 1p49FZ-0008ah-Lm for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 11 Dec 2022 00:27:21 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p49FL-00027F-8Q; Sat, 10 Dec 2022 18:27:07 -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 1p49FH-00026T-0b for bug-gnu-emacs@gnu.org; Sat, 10 Dec 2022 18:27:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p49FF-0000C7-TM for bug-gnu-emacs@gnu.org; Sat, 10 Dec 2022 18:27:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1p49FF-0001S9-MH; Sat, 10 Dec 2022 18:27:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: joaotavora@gmail.com, bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Dec 2022 23:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 59954 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org X-Debbugs-Original-Xcc: =?UTF-8?Q?Jo=C3=A3o_?= =?UTF-8?Q?T=C3=A1vora?= Original-Received: via spool by submit@debbugs.gnu.org id=B.16707147875574 (code B ref -1); Sat, 10 Dec 2022 23:27:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 10 Dec 2022 23:26:27 +0000 Original-Received: from localhost ([127.0.0.1]:45739 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p49Eh-0001Rq-9i for submit@debbugs.gnu.org; Sat, 10 Dec 2022 18:26:27 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:48144) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p49Ed-0001Rk-Eu for submit@debbugs.gnu.org; Sat, 10 Dec 2022 18:26:25 -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 1p49Ed-0001vm-74 for bug-gnu-emacs@gnu.org; Sat, 10 Dec 2022 18:26:23 -0500 Original-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 ) id 1p49Eb-0007xL-7n for bug-gnu-emacs@gnu.org; Sat, 10 Dec 2022 18:26:22 -0500 Original-Received: by mail-oa1-x35.google.com with SMTP id 586e51a60fabf-1445ca00781so4277921fac.1 for ; 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) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 10 Dec 2022 15:26:18 -0800 X-Hashcash: 1:20:221210:bug-gnu-emacs@gnu.org::txISo0vQlU2lZMnA:2iTI Received-SPF: pass client-ip=2001:4860:4864:20::35; envelope-from=stefankangas@gmail.com; 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-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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:250570 Archived-At: >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?