GNU bug report logs - #41373
GNU ELPA: Add "reporting bugs" to individual package pages

Previous Next

Package: emacs;

Reported by: Stefan Kangas <stefankangas <at> gmail.com>

Date: Mon, 18 May 2020 02:16:02 UTC

Severity: wishlist

To reply to this bug, email your comments to 41373 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 18 May 2020 02:16:02 GMT) Full text and rfc822 format available.

Acknowledgement sent to Stefan Kangas <stefankangas <at> gmail.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Mon, 18 May 2020 02:16:02 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: GNU ELPA: Add "reporting bugs" to individual package pages
Date: Sun, 17 May 2020 19:14:57 -0700
One user reports:

    That change fixes the issue! Great! Let’s file a bug and then submit the
    fix for it… except… the project.el file contains absolutely no
    information about how to submit bugs or patches. There’s nothing on the
    project.el web page. No websites, no bug tracker, no email addresses.

    Folks, if you maintain Open Source software and you ever wonder why
    you’re not getting contributions… this is why you’re not getting
    contributions: because you don’t spend any time thinking about making it
    easy (or in this case, even possible) for folks to contribute back to
    your project.

    So, instead of supplying a bug report and a patch, so that other folks
    might avoid this problem when they upgrade their Emacs packages (and
    instead of working on PROJECT APOLLO, like I planned to do today), I’m
    writing this blog post. Hopefully, after I post this online in a few
    places, Cunningham’s Law will kick in and somebody will show up and tell
    me where I can send this patch after all…

    https://genehack.blog/2020/05/open-source-annoyances-and-affordances/

I think this is situation could be alleviated by including a static
section on the pages for individual packages which explains how to
report bugs.

Best regards,
Stefan Kangas




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 18 May 2020 18:05:02 GMT) Full text and rfc822 format available.

Message #8 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 18 May 2020 14:04:45 -0400
Stefan Kangas wrote:

> I think this is situation could be alleviated by including a static
> section on the pages for individual packages which explains how to
> report bugs.

This will vary from package to package. I doubt "M-x report-emacs-bug"
is right in anything more than a small minority of cases (because it
would require the package developer to subscribe to bug-gnu-emacs).
I would think that the package itself needs to contain its bug reporting
information, independent of elpa.gnu.org.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 18 May 2020 18:08:01 GMT) Full text and rfc822 format available.

Message #11 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 18 May 2020 21:07:45 +0300
> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Sun, 17 May 2020 19:14:57 -0700
> 
> One user reports:
> 
>     That change fixes the issue! Great! Let’s file a bug and then submit the
>     fix for it… except… the project.el file contains absolutely no
>     information about how to submit bugs or patches. There’s nothing on the
>     project.el web page. No websites, no bug tracker, no email addresses.
> 
>     Folks, if you maintain Open Source software and you ever wonder why
>     you’re not getting contributions… this is why you’re not getting
>     contributions: because you don’t spend any time thinking about making it
>     easy (or in this case, even possible) for folks to contribute back to
>     your project.
> 
>     So, instead of supplying a bug report and a patch, so that other folks
>     might avoid this problem when they upgrade their Emacs packages (and
>     instead of working on PROJECT APOLLO, like I planned to do today), I’m
>     writing this blog post. Hopefully, after I post this online in a few
>     places, Cunningham’s Law will kick in and somebody will show up and tell
>     me where I can send this patch after all…
> 
>     https://genehack.blog/2020/05/open-source-annoyances-and-affordances/
> 
> I think this is situation could be alleviated by including a static
> section on the pages for individual packages which explains how to
> report bugs.

Is this about project.el that's in Emacs?  That one says it is part of
GNU Emacs, like any other bundled package, and thus bugs should be
reported to the Emacs bug tracker, see "emacs --help".  Not sure what
you mean by "pages for individual packages".




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 18 May 2020 18:13:01 GMT) Full text and rfc822 format available.

Message #14 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Dmitry Gutov <dgutov <at> yandex.ru>
To: Stefan Kangas <stefankangas <at> gmail.com>, 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 18 May 2020 21:12:07 +0300
On 18.05.2020 05:14, Stefan Kangas wrote:
> I think this is situation could be alleviated by including a static
> section on the pages for individual packages which explains how to
> report bugs.

Since the example was about project.el, we could limit our response to 
adding an explanatory section to :core packages.

I have a rough patch ready, but having trouble building the HTML pages 
of GNU ELPA locally thus far.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Tue, 19 May 2020 00:16:02 GMT) Full text and rfc822 format available.

Message #17 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Dmitry Gutov <dgutov <at> yandex.ru>, 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 18 May 2020 17:15:28 -0700
Dmitry Gutov <dgutov <at> yandex.ru> writes:

> On 18.05.2020 05:14, Stefan Kangas wrote:
>> I think this is situation could be alleviated by including a static
>> section on the pages for individual packages which explains how to
>> report bugs.
>
> Since the example was about project.el, we could limit our response to
> adding an explanatory section to :core packages.
>
> I have a rough patch ready, but having trouble building the HTML pages
> of GNU ELPA locally thus far.

Indeed, that probably makes more sense.  Thanks.

Best regards,
Stefan Kangas




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Tue, 19 May 2020 00:21:02 GMT) Full text and rfc822 format available.

Message #20 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 18 May 2020 17:20:48 -0700
Eli Zaretskii <eliz <at> gnu.org> writes:

> Not sure what you mean by "pages for individual packages".

For example: https://elpa.gnu.org/packages/project.html

Best regards,
Stefan Kangas




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Wed, 20 May 2020 03:55:02 GMT) Full text and rfc822 format available.

Message #23 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Richard Stallman <rms <at> gnu.org>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 41373 <at> debbugs.gnu.org, dgutov <at> yandex.ru
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Tue, 19 May 2020 23:54:12 -0400
[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

We could have report-emacs-bug ask for which package the bug is in.
The Bug Subject argument could be one of the acceptable package names,
including 'emacs' and whichever ELPA packages have been loaded.  The
user could specify one of those.

If the definition of a package says where to send bug reports for it,
report-emacs-bug could send each bug to the right place.

If Bug Subject argument isn't on that list, report-emacs-bug could ask,
"Would you like to specify one of the ELPA packages that have been
loaded?"  But you would not have to do that.  If Bug Subject is unknown,
the message would go to bug-gnu-emacs, as now.


-- 
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)






Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Wed, 20 May 2020 05:31:02 GMT) Full text and rfc822 format available.

Message #26 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
To: Richard Stallman <rms <at> gnu.org>
Cc: dgutov <at> yandex.ru, Stefan Kangas <stefankangas <at> gmail.com>,
 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Tue, 19 May 2020 22:30:40 -0700
[Message part 1 (text/plain, inline)]
Richard Stallman <rms <at> gnu.org> writes:

> [[[ To any NSA and FBI agents reading my email: please consider    ]]]
> [[[ whether defending the US Constitution against all enemies,     ]]]
> [[[ foreign or domestic, requires you to follow Snowden's example. ]]]
>
> We could have report-emacs-bug ask for which package the bug is in.
> The Bug Subject argument could be one of the acceptable package names,
> including 'emacs' and whichever ELPA packages have been loaded.  The
> user could specify one of those.
>
> If the definition of a package says where to send bug reports for it,
> report-emacs-bug could send each bug to the right place.
>
> If Bug Subject argument isn't on that list, report-emacs-bug could ask,
> "Would you like to specify one of the ELPA packages that have been
> loaded?"  But you would not have to do that.  If Bug Subject is unknown,
> the message would go to bug-gnu-emacs, as now.

Several years ago I cooked up something basic like that. I've attached
the patch from that thread, which might serve as the basis for something
usable.

Eric

[0001-Cc-package-maintainers-when-reporting-emacs-bugs.patch (text/x-patch, attachment)]

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 25 May 2020 09:06:02 GMT) Full text and rfc822 format available.

Message #29 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Bastien <bzg <at> gnu.org>
To: Eric Abrahamsen <eric <at> ericabrahamsen.net>
Cc: dgutov <at> yandex.ru, Stefan Kangas <stefankangas <at> gmail.com>,
 Richard Stallman <rms <at> gnu.org>, 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 25 May 2020 11:04:44 +0200
Hi Eric,

Eric Abrahamsen <eric <at> ericabrahamsen.net> writes:

> Richard Stallman <rms <at> gnu.org> writes:
>
>> [[[ To any NSA and FBI agents reading my email: please consider    ]]]
>> [[[ whether defending the US Constitution against all enemies,     ]]]
>> [[[ foreign or domestic, requires you to follow Snowden's example. ]]]
>>
>> We could have report-emacs-bug ask for which package the bug is in.
>> The Bug Subject argument could be one of the acceptable package names,
>> including 'emacs' and whichever ELPA packages have been loaded.  The
>> user could specify one of those.
>>
>> If the definition of a package says where to send bug reports for it,
>> report-emacs-bug could send each bug to the right place.
>>
>> If Bug Subject argument isn't on that list, report-emacs-bug could ask,
>> "Would you like to specify one of the ELPA packages that have been
>> loaded?"  But you would not have to do that.  If Bug Subject is unknown,
>> the message would go to bug-gnu-emacs, as now.
>
> Several years ago I cooked up something basic like that. I've attached
> the patch from that thread, which might serve as the basis for something
> usable.

I tested your patch and it looks really useful to me.

Two things that come to my mind:

- Package completion could not find "org" as a package: still, a bare
  emacs -q list Org as a built-in package.  Maybe we can add those to
  the completion list?

- If completion fails, then the bug reporting process is stopped,
  which may be confusing for users -- when there is no completion,
  I suggest to fall back on the current report-emacs-bug behavior.

- I wonder what happens if the "maintainer" email is a mailing list
  address: this might lead to confusion, with people cross-posting to
  both bug-gnu-emacs <at> gnu.org and emacs-orgmode <at> gnu.org for example,
  which would perhaps lead to some more confusion because bugs on
  bug-gnu-emacs <at> gnu.org are posted to emacs-orgmode <at> gnu.org when they
  are tagged "org-mode" (if I understand correctly).

A simple solution for the last issue would be to forbid mailing list
addresses in the "maintainer" email field.  In the case of org-mode,
for example, the address could be that of someone in charge of doing
bug triage, assigning tags to bug-gnu-emacs <at> gnu.org when needed.

In any case, thanks for spending time on this!

-- 
 Bastien




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 25 May 2020 11:52:01 GMT) Full text and rfc822 format available.

Message #32 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Dmitry Gutov <dgutov <at> yandex.ru>
To: rms <at> gnu.org, Stefan Kangas <stefankangas <at> gmail.com>
Cc: 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 25 May 2020 14:51:14 +0300
On 20.05.2020 06:54, Richard Stallman wrote:
> We could have report-emacs-bug ask for which package the bug is in.
> The Bug Subject argument could be one of the acceptable package names,
> including 'emacs' and whichever ELPA packages have been loaded.  The
> user could specify one of those.

I hope people understand that this won't solve the problem reported by 
the user: they didn't know that 'M-x report-emacs-bug' should be used in 
this case at all.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 25 May 2020 15:40:01 GMT) Full text and rfc822 format available.

Message #35 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
To: Bastien <bzg <at> gnu.org>
Cc: dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org, Richard Stallman <rms <at> gnu.org>,
 Stefan Kangas <stefankangas <at> gmail.com>
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 25 May 2020 08:39:10 -0700
Bastien <bzg <at> gnu.org> writes:

> Hi Eric,
>
> Eric Abrahamsen <eric <at> ericabrahamsen.net> writes:
>
>> Richard Stallman <rms <at> gnu.org> writes:
>>
>>> [[[ To any NSA and FBI agents reading my email: please consider    ]]]
>>> [[[ whether defending the US Constitution against all enemies,     ]]]
>>> [[[ foreign or domestic, requires you to follow Snowden's example. ]]]
>>>
>>> We could have report-emacs-bug ask for which package the bug is in.
>>> The Bug Subject argument could be one of the acceptable package names,
>>> including 'emacs' and whichever ELPA packages have been loaded.  The
>>> user could specify one of those.
>>>
>>> If the definition of a package says where to send bug reports for it,
>>> report-emacs-bug could send each bug to the right place.
>>>
>>> If Bug Subject argument isn't on that list, report-emacs-bug could ask,
>>> "Would you like to specify one of the ELPA packages that have been
>>> loaded?"  But you would not have to do that.  If Bug Subject is unknown,
>>> the message would go to bug-gnu-emacs, as now.
>>
>> Several years ago I cooked up something basic like that. I've attached
>> the patch from that thread, which might serve as the basis for something
>> usable.
>
> I tested your patch and it looks really useful to me.
>
> Two things that come to my mind:
>
> - Package completion could not find "org" as a package: still, a bare
>   emacs -q list Org as a built-in package.  Maybe we can add those to
>   the completion list?

I think in the original discussion the patch went back and forth between
completing on `package-alist' and completing on `features'. The former
didn't offer enough, the latter offered too much.

> - If completion fails, then the bug reporting process is stopped,
>   which may be confusing for users -- when there is no completion,
>   I suggest to fall back on the current report-emacs-bug behavior.

Yes, that's a bug! It shouldn't require a package.

> - I wonder what happens if the "maintainer" email is a mailing list
>   address: this might lead to confusion, with people cross-posting to
>   both bug-gnu-emacs <at> gnu.org and emacs-orgmode <at> gnu.org for example,
>   which would perhaps lead to some more confusion because bugs on
>   bug-gnu-emacs <at> gnu.org are posted to emacs-orgmode <at> gnu.org when they
>   are tagged "org-mode" (if I understand correctly).

If we complete on `features', that's definitely an issue. I think my
solution in that version of the patch simply dropped the issue if the
Maintainer header was emacs-devel, or there was no Maintainer.

> A simple solution for the last issue would be to forbid mailing list
> addresses in the "maintainer" email field.  In the case of org-mode,
> for example, the address could be that of someone in charge of doing
> bug triage, assigning tags to bug-gnu-emacs <at> gnu.org when needed.
>
> In any case, thanks for spending time on this!

My pleasure -- as Dmitry notes, this might not solve the problem that
this thread is about, but I think it's definitely worthwhile on its own.

Eric




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 25 May 2020 17:10:01 GMT) Full text and rfc822 format available.

Message #38 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Eric Abrahamsen <eric <at> ericabrahamsen.net>
Cc: Bastien <bzg <at> gnu.org>, dgutov <at> yandex.ru,
 Stefan Kangas <stefankangas <at> gmail.com>, Richard Stallman <rms <at> gnu.org>,
 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 25 May 2020 13:09:03 -0400
This should use "X-Debbugs-CC" rather than "Cc".
Experience with c-submit-bug-report is that some mail clients don't
support X- headers, so it should also add a pseudo-header to the start
of the message body.

Maintainers of some packages may have no interest in interacting with
debbugs.gnu.org, so Someone will need to tidy up those reports.





Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 25 May 2020 17:50:02 GMT) Full text and rfc822 format available.

Message #41 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
To: Glenn Morris <rgm <at> gnu.org>
Cc: Bastien <bzg <at> gnu.org>, dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org,
 Richard Stallman <rms <at> gnu.org>, Stefan Kangas <stefankangas <at> gmail.com>
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 25 May 2020 10:49:47 -0700
Glenn Morris <rgm <at> gnu.org> writes:

> This should use "X-Debbugs-CC" rather than "Cc".
> Experience with c-submit-bug-report is that some mail clients don't
> support X- headers, so it should also add a pseudo-header to the start
> of the message body.

Thanks for these notes! I'll make this change.

> Maintainers of some packages may have no interest in interacting with
> debbugs.gnu.org, so Someone will need to tidy up those reports.

By "tidy up" do you mean close the reports and let them get resolved
elsewhere? Interacting with debbugs seems fairly low-overhead when it's
just a matter of keeping it in the cc.

Thanks again,
Eric




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 06:33:02 GMT) Full text and rfc822 format available.

Message #44 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Bastien <bzg <at> gnu.org>
To: Eric Abrahamsen <eric <at> ericabrahamsen.net>
Cc: dgutov <at> yandex.ru, Stefan Kangas <stefankangas <at> gmail.com>,
 Richard Stallman <rms <at> gnu.org>, 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 08:32:24 +0200
Hi Eric,

Eric Abrahamsen <eric <at> ericabrahamsen.net> writes:

> I think in the original discussion the patch went back and forth between
> completing on `package-alist' and completing on `features'. The former
> didn't offer enough, the latter offered too much.

While not offering "enough", the former is already an improvement, I'd
be in favor of implementing it.  The latter really offers too much IMO.

> If we complete on `features', that's definitely an issue. I think my
> solution in that version of the patch simply dropped the issue if the
> Maintainer header was emacs-devel, or there was no Maintainer.

Yes, it looks fine to me like this.

> My pleasure -- as Dmitry notes, this might not solve the problem that
> this thread is about, but I think it's definitely worthwhile on its own.

Definitely.  What is still needed here so that you can make this change?

-- 
 Bastien




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 18:30:02 GMT) Full text and rfc822 format available.

Message #47 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
To: Bastien <bzg <at> gnu.org>
Cc: dgutov <at> yandex.ru, Stefan Kangas <stefankangas <at> gmail.com>,
 Richard Stallman <rms <at> gnu.org>, 41373 <at> debbugs.gnu.org
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 11:29:14 -0700
[Message part 1 (text/plain, inline)]
On 06/01/20 08:32 AM, Bastien wrote:
> Hi Eric,
>
> Eric Abrahamsen <eric <at> ericabrahamsen.net> writes:
>
>> I think in the original discussion the patch went back and forth between
>> completing on `package-alist' and completing on `features'. The former
>> didn't offer enough, the latter offered too much.
>
> While not offering "enough", the former is already an improvement, I'd
> be in favor of implementing it.  The latter really offers too much IMO.

Yes, I've come to the same conclusion over time.

>> If we complete on `features', that's definitely an issue. I think my
>> solution in that version of the patch simply dropped the issue if the
>> Maintainer header was emacs-devel, or there was no Maintainer.
>
> Yes, it looks fine to me like this.
>
>> My pleasure -- as Dmitry notes, this might not solve the problem that
>> this thread is about, but I think it's definitely worthwhile on its own.
>
> Definitely.  What is still needed here so that you can make this change?

Here's a new version of the patch. It:

1. doesn't require a package
2. only honors the Maintainer header (not the Author header, if there's no
   Maintainer)
3. screens out "emacs.devel <at> gnu.org" as a Maintainer value (we
   could easily add more values to screen out)
4. uses X-Debbugs-CC instead of Cc
5. Adds a "Package:" pseudo-header

Remaining questions:

1. I've seen some reference to a X-Debbugs-Package header, is that
   honored?
2. Glenn mentioned the fact that some package maintainers might not want
   anything to do with debbugs. I'm not sure how to handle that
   situation, except manually. I suppose, if we do end up adding a
   package maintainer, we could also add a line of text in the
   intangible instructions saying, "If you don't want to deal with this
   bug on the Emacs bug tracker, please send a message to
   XXX-done <at> debbugs.gnu.org to close it."
3. Lastly, this is a fairly in-your-face change to how Emacs bugs are
   reported, and I'm not sure everyone agrees it's a good idea! Adding
   an extra prompt to the process is a bit intrusive.

Eric

[0001-Cc-package-maintainers-when-reporting-emacs-bugs.patch (text/x-patch, attachment)]

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 18:43:01 GMT) Full text and rfc822 format available.

Message #50 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Eric Abrahamsen <eric <at> ericabrahamsen.net>
Cc: bzg <at> gnu.org, dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org, rms <at> gnu.org,
 stefankangas <at> gmail.com
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 21:41:55 +0300
> From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
> Date: Mon, 01 Jun 2020 11:29:14 -0700
> Cc: 41373 <at> debbugs.gnu.org, Stefan Kangas <stefankangas <at> gmail.com>,
>  Richard Stallman <rms <at> gnu.org>, dgutov <at> yandex.ru
> 
> +  (interactive (list
> +                (read-string "Bug Subject: ")
> +                (completing-read
> +                 "Package: "
> +                 (progn
> +                   (package-initialize)
> +                   package-alist)
> +                 nil nil)))

Does this mean reporting a bug will initialize all the packages that
are installed?  Will it also access the network and check for
upgrades?

I'm not sure I understand the need to produce a potentially huge list
of completion candidates, when it isn't even clear that the bug is
about some add-on package.  Can we be smarter about this?




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 19:26:02 GMT) Full text and rfc822 format available.

Message #53 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: bzg <at> gnu.org, dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org, rms <at> gnu.org,
 stefankangas <at> gmail.com
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 12:25:11 -0700
On 06/01/20 21:41 PM, Eli Zaretskii wrote:
>> From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
>> Date: Mon, 01 Jun 2020 11:29:14 -0700
>> Cc: 41373 <at> debbugs.gnu.org, Stefan Kangas <stefankangas <at> gmail.com>,
>>  Richard Stallman <rms <at> gnu.org>, dgutov <at> yandex.ru
>> 
>> +  (interactive (list
>> +                (read-string "Bug Subject: ")
>> +                (completing-read
>> +                 "Package: "
>> +                 (progn
>> +                   (package-initialize)
>> +                   package-alist)
>> +                 nil nil)))
>
> Does this mean reporting a bug will initialize all the packages that
> are installed?  Will it also access the network and check for
> upgrades?

I don't believe so, no. But we should probably call `package-initialize'
with the NO-ACTIVATE argument, which will skip loading autoloads and
some other stuff. Or, for minimum invasiveness, just skip everything if
`package-alist' is nil.

> I'm not sure I understand the need to produce a potentially huge list
> of completion candidates, when it isn't even clear that the bug is
> about some add-on package.  Can we be smarter about this?

Right, this is the part of the suggestion with the biggest question
marks. I can imagine the prompt would get annoying for frequent
contributors who are mostly filing bugs against emacs itself.

The only thing I can think of is providing a separate command,
`report-emacs-package-bug', that is a thin wrapper around
`report-emacs-bug'. That could live in package.el.

Actually, maybe that's the way to go?




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 19:39:02 GMT) Full text and rfc822 format available.

Message #56 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Eric Abrahamsen <eric <at> ericabrahamsen.net>
Cc: bzg <at> gnu.org, dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org, rms <at> gnu.org,
 stefankangas <at> gmail.com
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 22:38:04 +0300
> From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
> Cc: bzg <at> gnu.org,  41373 <at> debbugs.gnu.org,  stefankangas <at> gmail.com,
>   rms <at> gnu.org,  dgutov <at> yandex.ru
> Date: Mon, 01 Jun 2020 12:25:11 -0700
> 
> > I'm not sure I understand the need to produce a potentially huge list
> > of completion candidates, when it isn't even clear that the bug is
> > about some add-on package.  Can we be smarter about this?
> 
> Right, this is the part of the suggestion with the biggest question
> marks. I can imagine the prompt would get annoying for frequent
> contributors who are mostly filing bugs against emacs itself.
> 
> The only thing I can think of is providing a separate command,
> `report-emacs-package-bug', that is a thin wrapper around
> `report-emacs-bug'. That could live in package.el.

I thought about making some conclusions from the text of the report,
which may contain function names.  Of course, this is only possible
after the report is written and is about to be sent.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 19:54:01 GMT) Full text and rfc822 format available.

Message #59 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Eric Abrahamsen <eric <at> ericabrahamsen.net>
Cc: Bastien <bzg <at> gnu.org>, dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org,
 Richard Stallman <rms <at> gnu.org>, Stefan Kangas <stefankangas <at> gmail.com>
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 15:52:47 -0400
Eric Abrahamsen wrote:

> 5. Adds a "Package:" pseudo-header

That is not the right thing to do.
A debbugs.gnu.org package is not the same thing as an elpa.gnu.org package. [1]
The valid debbugs.gnu.org packages are listed at
https://debbugs.gnu.org/Packages.html
Trying to use one not listed there will result in the mail going to the
help-debbugs list.

Separately, you should add an "X-Debbugs-CC" pseudo-header, because it
seems some mail clients don't allow arbitrary (real) X- mail headers.

I hope this is at most restricted to elpa.gnu.org packages.
There are already thousands of open Emacs bug reports.
If reports for melpa packages start getting funnelled into the same
system, it will make it harder than it already is to find relevant reports.

(Also IMO this doesn't actually fix the issue from this bug report.
Each elpa.gnu.org package should still be defining where it wants its
bug reports to go to. This may be the maintainer address, github issue,
or whatever.)


[1] With some effort, someone could in principle automatically create an
elpa-X package on debbugs for every package X on elpa.gnu.org.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 20:08:02 GMT) Full text and rfc822 format available.

Message #62 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: bzg <at> gnu.org, dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org, rms <at> gnu.org,
 stefankangas <at> gmail.com
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 13:06:55 -0700
On 06/01/20 22:38 PM, Eli Zaretskii wrote:
>> From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
>> Cc: bzg <at> gnu.org,  41373 <at> debbugs.gnu.org,  stefankangas <at> gmail.com,
>>   rms <at> gnu.org,  dgutov <at> yandex.ru
>> Date: Mon, 01 Jun 2020 12:25:11 -0700
>> 
>> > I'm not sure I understand the need to produce a potentially huge list
>> > of completion candidates, when it isn't even clear that the bug is
>> > about some add-on package.  Can we be smarter about this?
>> 
>> Right, this is the part of the suggestion with the biggest question
>> marks. I can imagine the prompt would get annoying for frequent
>> contributors who are mostly filing bugs against emacs itself.
>> 
>> The only thing I can think of is providing a separate command,
>> `report-emacs-package-bug', that is a thin wrapper around
>> `report-emacs-bug'. That could live in package.el.
>
> I thought about making some conclusions from the text of the report,
> which may contain function names.  Of course, this is only possible
> after the report is written and is about to be sent.

Huh, so just before sending build a regexp like:

(mapconcat
 (lambda (p)
   (format "\\_<%s-" (symbol-name (car p))))
 package-alist "\\|")

run it over the subject and body, and then either automatically add the
package header, or stop and prompt the user?

Feels a bit guess-worky to me, but it would certainly be possible!




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#41373; Package emacs. (Mon, 01 Jun 2020 20:32:02 GMT) Full text and rfc822 format available.

Message #65 received at 41373 <at> debbugs.gnu.org (full text, mbox):

From: Eric Abrahamsen <eric <at> ericabrahamsen.net>
To: Glenn Morris <rgm <at> gnu.org>
Cc: Bastien <bzg <at> gnu.org>, dgutov <at> yandex.ru, 41373 <at> debbugs.gnu.org,
 Richard Stallman <rms <at> gnu.org>, Stefan Kangas <stefankangas <at> gmail.com>
Subject: Re: bug#41373: GNU ELPA: Add "reporting bugs" to individual package
 pages
Date: Mon, 01 Jun 2020 13:31:29 -0700
On 06/01/20 15:52 PM, Glenn Morris wrote:
> Eric Abrahamsen wrote:
>
>> 5. Adds a "Package:" pseudo-header
>
> That is not the right thing to do.
> A debbugs.gnu.org package is not the same thing as an elpa.gnu.org package. [1]
> The valid debbugs.gnu.org packages are listed at
> https://debbugs.gnu.org/Packages.html
> Trying to use one not listed there will result in the mail going to the
> help-debbugs list.
>
> Separately, you should add an "X-Debbugs-CC" pseudo-header, because it
> seems some mail clients don't allow arbitrary (real) X- mail headers.

Thanks for this. You'd mentioned a pseudo-header in your previous
message, and all I could see defined was "Package" and "Version", so I
assumed you meant Package; my mistake.

> I hope this is at most restricted to elpa.gnu.org packages.
> There are already thousands of open Emacs bug reports.
> If reports for melpa packages start getting funnelled into the same
> system, it will make it harder than it already is to find relevant reports.

Good point. You could also argue that, by putting their packages on
Melpa, these authors have already implicitly hinted that they'd rather
not interact with the Emacs organization/infrastructure.

> (Also IMO this doesn't actually fix the issue from this bug report.
> Each elpa.gnu.org package should still be defining where it wants its
> bug reports to go to. This may be the maintainer address, github issue,
> or whatever.)

While I was succumbing to mission-creep this afternoon, I thought of the
same thing: an "Issues-to" package header. This would also give package
authors an explicit mechanism to opt out of debbugs.

> [1] With some effort, someone could in principle automatically create an
> elpa-X package on debbugs for every package X on elpa.gnu.org.

Dunno about this. I started with this idea from the point of view of an
(ELPA) package maintainer. At this point, I'm happy to just implement
whatever everyone agrees makes the most sense.

Eric




This bug report was last modified 5 years and 14 days ago.

Previous Next


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