22.8.3.1 Web interface

Une interface web (en fait deux interfaces web !) sont disponibles pour naviguer dans les tickets :

• 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 liste les rapports de bogues ;
• https://bugs.gnu.org/guix-patches liste les tickets soumis.

Pour consulter les discussions relatives au numéro d’édition n, rendez-vous sur ‘https://issues.guix.gnu.org/n’ ou ‘https://bugs.gnu.org/n’.

22.8.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.8.3.3 Emacs interface

Si vous utilisez Emacs, vous pourriez trouver plus confortable d’interagir avec les tickets en utilisant debbugs.el, que vous pouvez installer avec :

guix install emacs-debbugs

Par exemple, pour lister tous les tickets ouverts sur guix-patches, tapez :

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 (voir Viewing Bugs within Emacs).

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

Voir Debbugs User Guide, pour plus d’info sur cet outil pratique !