22.11.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 powered by mumi⁴⁷ to browse bug reports and patches, and to participate in discussions; mumi also has a command-line interface as we will see below;
• 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.11.3.2 Command-Line Interface

Mumi also comes with a command-line interface that can be used to search existing issues, open new issues, compose replies, apply 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 open the issue in a web browser, compose replies, apply patches, send patches, etc. with short succinct commands.

Open the issue in your web browser using

~/guix [env]$ mumi www

Compose a reply using

~/guix [env]$ mumi compose

Compose a reply and close the issue using

~/guix [env]$ mumi compose --close

mumi compose opens your mail client by passing ‘mailto:’ URIs to xdg-open. So, you need to have xdg-open set up to open your mail client correctly.

Apply the latest patchset from the issue using

~/guix [env]$ mumi am

You may also apply a patchset of a specific version (say, v3) using

~/guix [env]$ mumi am v3

Or, you may apply a patch from a specific e-mail message. For example, to apply the patch from the 4th message (message index starts from 0), run

~/guix [env]$ mumi am @4

mumi am is a wrapper around git am. You can pass git am arguments to it after a ‘--’. For example, to add a Signed-off-by trailer, run

~/guix [env]$ mumi am -- -s

Create and send patches to the issue 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 an email (using mumi compose) or patches (using mumi send-email).

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.11.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

For a more convenient (shorter) way to access both the bugs and patches submissions, you may want to configure the debbugs-gnu-default-packages and debbugs-gnu-default-severities Emacs variables (see Viewing Bugs within Emacs).

To search for bugs, ‘M-x debbugs-gnu-guix-search’ can be used.

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