22.7.3.1 Web interface

A web interface (actually two web interfaces!) are available to browse issues:

• https://issues.guix.gnu.org provides a pleasant interface⁴³ to browse bug reports and patches, and to participate in discussions;
• https://bugs.gnu.org/guix lists bug reports;
• https://bugs.gnu.org/guix-patches lists patch submissions.

To view discussions related to issue number n, go to ‘https://issues.guix.gnu.org/n’ or ‘https://bugs.gnu.org/n’.

22.7.3.2 Command-line interface

Mumi also comes with a command-line interface that can be used to search existing issues, open new issues and send patches. You do not need to use Emacs to use the mumi command-line client. You interact with it only on the command-line.

To use the mumi command-line interface, navigate to a local clone of the Guix git repository, and drop into a shell with mumi, git and git:send-email installed.

$ cd guix
~/guix$ guix shell mumi git git:send-email

To search for issues, say all open issues about "zig", run

~/guix [env]$ mumi search zig is:open

#60889 Add zig-build-system
opened on 17 Jan 17:37 Z by Ekaitz Zarraga
#61036 [PATCH 0/3] Update zig to 0.10.1
opened on 24 Jan 09:42 Z by Efraim Flashner
#39136 [PATCH] gnu: services: Add endlessh.
opened on 14 Jan 2020 21:21 by Nicol? Balzarotti
#60424 [PATCH] gnu: Add python-online-judge-tools
opened on 30 Dec 2022 07:03 by gemmaro
#45601 [PATCH 0/6] vlang 0.2 update
opened on  1 Jan 2021 19:23 by Ryan Prior

Pick an issue and make it the "current" issue.

~/guix [env]$ mumi current 61036

#61036 [PATCH 0/3] Update zig to 0.10.1
opened on 24 Jan 09:42 Z by Efraim Flashner

Once an issue is the current issue, you can easily create and send patches to it using

~/guix [env]$ git format-patch origin/master
~/guix [env]$ mumi send-email foo.patch bar.patch

Note that you do not have to pass in ‘--to’ or ‘--cc’ arguments to git format-patch. mumi send-email will put them in correctly when sending the patches.

To open a new issue, run

~/guix [env]$ mumi new

and send patches

~/guix [env]$ mumi send-email foo.patch bar.patch

mumi send-email is really a wrapper around git send-email that automates away all the nitty-gritty of sending patches. It uses the current issue state to automatically figure out the correct ‘To’ address to send to, other participants to ‘Cc’, headers to add, etc.

Also note that, unlike git send-email, mumi send-email works perfectly well with single and multiple patches alike. It automates away the debbugs dance of sending the first patch, waiting for a response from debbugs and sending the remaining patches. It does so by sending the first patch, polling the server for a response, and then sending the remaining patches. This polling can unfortunately take a few minutes. So, please be patient.

22.7.3.3 Emacs interface

If you use Emacs, you may find it more convenient to interact with issues using debbugs.el, which you can install with:

guix install emacs-debbugs

For example, to list all open issues on guix-patches, hit:

C-u M-x debbugs-gnu RET RET guix-patches RET n y

Veja Debbugs User Guide, for more information on this nifty tool!