GNU bug report logs - #66620
[PATCH] doc: Document extra Emacs-Debbugs configurations.

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 66620 in the body.
You can then email your comments to 66620 AT debbugs.gnu.org in the normal way.

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

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

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: guix-patches <at> gnu.org,
	maxim.cournoyer <at> gmail.com
Cc: Michael Albinus <michael.albinus <at> gmx.de>
Subject: [PATCH] doc: Document extra Emacs-Debbugs configurations.
Date: Wed, 18 Oct 2023 20:34:44 -0400

* doc/contributing.texi (Viewing Bugs within Emacs): Document
debbugs-gnu-default-packages, debbugs-gnu-default-severities.
(Debbugs User Interfaces): Likewise, and mention debbugs-gnu-guix-search.

Suggested-by: Michael Albinus <michael.albinus <at> gmx.de>
Change-Id: I8e9026bc394b0cf674c8498ca713c332e48c2700
---
 doc/contributing.texi | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 864190b119..c9e89ab25d 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -385,6 +385,7 @@ The Perfect Setup
 save then add @code{(add-hook 'after-save-hook 'copyright-update)} in
 Emacs.
 
+@node Viewing Bugs within Emacs
 @subsection Viewing Bugs within Emacs
 
 Emacs has a nice minor mode called @code{bug-reference}, which, when
@@ -452,6 +453,13 @@ The Perfect Setup
           (group (zero-or-one "cgi/bugreport.cgi?bug="))
           (group-n 3 (one-or-more digit))
           line-end))
+
+;; Reduce the number of prompts with 'M-x debbugs-gnu'.
+(setq debbugs-gnu-default-packages '("guix" "guix-patches"))
+
+;; Show feature requests.
+(setq debbugs-gnu-default-severities
+ '("serious" "important" "normal" "minor" "wishlist"))
 @end lisp
 
 For more information, refer to @ref{Bug Reference,,, emacs, The GNU
@@ -1960,6 +1968,15 @@ Debbugs User Interfaces
 @kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y
 @end example
 
+For a more convenient (shorter) way to access both the bugs and patches
+submissions, you may want to configure the
+@code{debbugs-gnu-default-packages} and
+@code{debbugs-gnu-default-severities} Emacs variables (@pxref{Viewing
+Bugs within Emacs}).
+
+To search for bugs, @samp{@kbd{M-x} debbugs-gnu-guix-search} can be
+used.
+
 @xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on
 this nifty tool!
 

base-commit: e80022ff3adde3184bed6758f604e3aa12942865
-- 
2.41.0

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

From: Michael Albinus <michael.albinus <at> gmx.de>
To: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
Cc: 66620 <at> debbugs.gnu.org
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Thu, 19 Oct 2023 09:08:48 +0200

Maxim Cournoyer <maxim.cournoyer <at> gmail.com> writes:

Hi,

> * doc/contributing.texi (Viewing Bugs within Emacs): Document
> debbugs-gnu-default-packages, debbugs-gnu-default-severities.
> (Debbugs User Interfaces): Likewise, and mention debbugs-gnu-guix-search.

FTR, if wanted by the Guix project, we could also extend
debbugs-gnu-guix.el. For example, loading this library could set
debbugs-gnu-default-packages and debbugs-gnu-default-severities as
proposed here.

Best regards, Michael.

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

From: Simon Tournier <zimon.toutoune <at> gmail.com>
To: Michael Albinus <michael.albinus <at> gmx.de>, Maxim Cournoyer
 <maxim.cournoyer <at> gmail.com>
Cc: 66620 <at> debbugs.gnu.org
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Thu, 19 Oct 2023 12:29:56 +0200

Hi,

On Thu, 19 Oct 2023 at 09:08, Michael Albinus <michael.albinus <at> gmx.de> wrote:

> FTR, if wanted by the Guix project, we could also extend
> debbugs-gnu-guix.el. For example, loading this library could set
> debbugs-gnu-default-packages and debbugs-gnu-default-severities as
> proposed here.

You mean debbugs-guix.el, right?

Cheers,
simon

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

From: Michael Albinus <michael.albinus <at> gmx.de>
To: Simon Tournier <zimon.toutoune <at> gmail.com>
Cc: 66620 <at> debbugs.gnu.org, Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Thu, 19 Oct 2023 12:44:36 +0200

Simon Tournier <zimon.toutoune <at> gmail.com> writes:

> Hi,

Hi Simon,

>> FTR, if wanted by the Guix project, we could also extend
>> debbugs-gnu-guix.el. For example, loading this library could set
>> debbugs-gnu-default-packages and debbugs-gnu-default-severities as
>> proposed here.
>
> You mean debbugs-guix.el, right?

Sure.

> Cheers,
> simon

Best regards, Michael.

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

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: Michael Albinus <michael.albinus <at> gmx.de>
Cc: 66620 <at> debbugs.gnu.org
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Thu, 19 Oct 2023 22:01:44 -0400

Hello,

Michael Albinus <michael.albinus <at> gmx.de> writes:

> Maxim Cournoyer <maxim.cournoyer <at> gmail.com> writes:
>
> Hi,
>
>> * doc/contributing.texi (Viewing Bugs within Emacs): Document
>> debbugs-gnu-default-packages, debbugs-gnu-default-severities.
>> (Debbugs User Interfaces): Likewise, and mention debbugs-gnu-guix-search.
>
> FTR, if wanted by the Guix project, we could also extend
> debbugs-gnu-guix.el. For example, loading this library could set
> debbugs-gnu-default-packages and debbugs-gnu-default-severities as
> proposed here.

Would that conflict with a user-set debbugs-gnu-default-packages or
debbugs-gnu-default-severities variables?  I'm thinking of a mainly
Emacs developer sometimes also dabbling with Guix, which may want to
have their debbugs-gnu-default-packages set to "emacs" and the likes
even if also using debbugs-guix.el.

If it'd be used as a fall-back to user-specified versions, then that'd
be nice, I think!

-- 
Thanks,
Maxim

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

From: Michael Albinus <michael.albinus <at> gmx.de>
To: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
Cc: 66620 <at> debbugs.gnu.org
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Fri, 20 Oct 2023 10:39:26 +0200

Maxim Cournoyer <maxim.cournoyer <at> gmail.com> writes:

> Hello,

Hi Maxim,

>> FTR, if wanted by the Guix project, we could also extend
>> debbugs-gnu-guix.el. For example, loading this library could set
>> debbugs-gnu-default-packages and debbugs-gnu-default-severities as
>> proposed here.
>
> Would that conflict with a user-set debbugs-gnu-default-packages or
> debbugs-gnu-default-severities variables?  I'm thinking of a mainly
> Emacs developer sometimes also dabbling with Guix, which may want to
> have their debbugs-gnu-default-packages set to "emacs" and the likes
> even if also using debbugs-guix.el.
>
> If it'd be used as a fall-back to user-specified versions, then that'd
> be nice, I think!

No, there's only one debbugs-gnu-default-packages or
debbugs-gnu-default-severities. If you change it globally, it's used
everywhere.

If you have situations where you need both Emacs and Guix defaults, you
could add Guix specific commands to debbugs-guix.el. Something like
debbugs-gnu-patches, debbugs-gnu-package, debbugs-gnu,
debbugs-gnu-usertags.

Or you define a hydra (see GNU ELPA package), which sets
debbugs-gnu-default-packages and debbugs-gnu-default-severities to the
preferred values. Then you can call the debbugs-gnu-* commands with that
hydra via the defined shortcuts.

Best regards, Michael.

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

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: Michael Albinus <michael.albinus <at> gmx.de>
Cc: 66620 <at> debbugs.gnu.org
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Fri, 20 Oct 2023 11:31:26 -0400

Hi Michael,

Michael Albinus <michael.albinus <at> gmx.de> writes:

> Maxim Cournoyer <maxim.cournoyer <at> gmail.com> writes:
>
>> Hello,
>
> Hi Maxim,
>
>>> FTR, if wanted by the Guix project, we could also extend
>>> debbugs-gnu-guix.el. For example, loading this library could set
>>> debbugs-gnu-default-packages and debbugs-gnu-default-severities as
>>> proposed here.
>>
>> Would that conflict with a user-set debbugs-gnu-default-packages or
>> debbugs-gnu-default-severities variables?  I'm thinking of a mainly
>> Emacs developer sometimes also dabbling with Guix, which may want to
>> have their debbugs-gnu-default-packages set to "emacs" and the likes
>> even if also using debbugs-guix.el.
>>
>> If it'd be used as a fall-back to user-specified versions, then that'd
>> be nice, I think!
>
> No, there's only one debbugs-gnu-default-packages or
> debbugs-gnu-default-severities. If you change it globally, it's used
> everywhere.
>
> If you have situations where you need both Emacs and Guix defaults, you
> could add Guix specific commands to debbugs-guix.el. Something like
> debbugs-gnu-patches, debbugs-gnu-package, debbugs-gnu,
> debbugs-gnu-usertags.
>
> Or you define a hydra (see GNU ELPA package), which sets
> debbugs-gnu-default-packages and debbugs-gnu-default-severities to the
> preferred values. Then you can call the debbugs-gnu-* commands with that
> hydra via the defined shortcuts.

Thank you for explaining.  Then I think perhaps it's best to leave these
globals documented in the manual to avoid surprising users.

Thanks for the continued suggestions!

-- 
Maxim

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

From: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
To: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
Cc: 66620 <at> debbugs.gnu.org, Michael Albinus <michael.albinus <at> gmx.de>
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Sat, 11 Nov 2023 13:37:16 +0100

[Message part 1 (text/plain, inline)]

Hello all.

Maxim Cournoyer <maxim.cournoyer <at> gmail.com> writes:
> * doc/contributing.texi (Viewing Bugs within Emacs): Document
> debbugs-gnu-default-packages, debbugs-gnu-default-severities.
> (Debbugs User Interfaces): Likewise, and mention debbugs-gnu-guix-search.
> […]
> +
> +;; Reduce the number of prompts with 'M-x debbugs-gnu'.
> +(setq debbugs-gnu-default-packages '("guix" "guix-patches"))
> +
> +;; Show feature requests.
> +(setq debbugs-gnu-default-severities
> + '("serious" "important" "normal" "minor" "wishlist"))

Not being very experienced with Emacs, I tried 'M-x debbugs-gnu' and it
does not prompt for the packages but shows bugs for Emacs by default.

I suggest the attached patch.

Regards,
Florian

[doc-Use-accurate-wording-in-Emacs-Debbugs-configurat.patch (text/x-patch, attachment)]

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

From: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
To: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
Cc: 66620 <at> debbugs.gnu.org, Michael Albinus <michael.albinus <at> gmx.de>
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Sat, 30 Dec 2023 15:45:11 +0100

[Message part 1 (text/plain, inline)]

"pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de> writes:
> Not being very experienced with Emacs, I tried 'M-x debbugs-gnu' and it
> does not prompt for the packages but shows bugs for Emacs by default.
>
> I suggest the attached patch.

Attached is v2 with better commit message.

Regards,
Florian

[v2-doc-Use-accurate-wording-in-Emacs-Debbugs-configu.patch (text/x-patch, attachment)]

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

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
Cc: 66620-done <at> debbugs.gnu.org
Subject: Re: [bug#66620] [PATCH] doc: Document extra Emacs-Debbugs
 configurations.
Date: Sun, 31 Dec 2023 01:06:36 -0500

Hi,

"pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de> writes:

> "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de> writes:
>> Not being very experienced with Emacs, I tried 'M-x debbugs-gnu' and it
>> does not prompt for the packages but shows bugs for Emacs by default.
>>
>> I suggest the attached patch.
>
> Attached is v2 with better commit message.

Applied, thanks!

-- 
Thanks,
Maxim

Previous Next

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