diff mbox series

[bug#66620] doc: Document extra Emacs-Debbugs configurations.

Message ID 8e6236724a5ac34ad6969d245292dfb42b8bd4b6.1697675684.git.maxim.cournoyer@gmail.com
State New
Headers show
Series [bug#66620] doc: Document extra Emacs-Debbugs configurations. | expand

Commit Message

Maxim Cournoyer Oct. 19, 2023, 12:34 a.m. UTC
* 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@gmx.de>
Change-Id: I8e9026bc394b0cf674c8498ca713c332e48c2700
---
 doc/contributing.texi | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)


base-commit: e80022ff3adde3184bed6758f604e3aa12942865

Comments

Michael Albinus Oct. 19, 2023, 7:08 a.m. UTC | #1
Maxim Cournoyer <maxim.cournoyer@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.
Simon Tournier Oct. 19, 2023, 10:29 a.m. UTC | #2
Hi,

On Thu, 19 Oct 2023 at 09:08, Michael Albinus <michael.albinus@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
Michael Albinus Oct. 19, 2023, 10:44 a.m. UTC | #3
Simon Tournier <zimon.toutoune@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.
Maxim Cournoyer Oct. 20, 2023, 2:01 a.m. UTC | #4
Hello,

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

> Maxim Cournoyer <maxim.cournoyer@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!
Michael Albinus Oct. 20, 2023, 8:39 a.m. UTC | #5
Maxim Cournoyer <maxim.cournoyer@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.
Maxim Cournoyer Oct. 20, 2023, 3:31 p.m. UTC | #6
Hi Michael,

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

> Maxim Cournoyer <maxim.cournoyer@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!
diff mbox series

Patch

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!