diff options
| author | Ludovic Courtès <ludo@gnu.org> | 2026-01-23 10:26:45 +0100 |
|---|---|---|
| committer | Cayetano Santos <csantosb@inventati.org> | 2026-02-03 07:58:21 +0100 |
| commit | c36602a36d21f76d5ae71a39411b47a3b035fc76 (patch) | |
| tree | 5525efad8ae26ecd877f01dadb7a0a4b49d58b9d /doc/contributing.texi | |
| parent | 9d22a2eef773db24837ddcfc84a5b3b7078cce8c (diff) | |
doc: Remove “Debbugs Usertags” section.
* doc/contributing.texi (Debbugs Usertags): Remove.
Merges guix/guix!5840
Change-Id: If550e31918c495ed24578fcbaaa179eb36521687
Signed-off-by: Cayetano Santos <csantosb@inventati.org>
Diffstat (limited to 'doc/contributing.texi')
| -rw-r--r-- | doc/contributing.texi | 60 |
1 files changed, 1 insertions, 59 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi index 068c51f9a05..1f23f92b844 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi | |||
| @@ -2163,7 +2163,6 @@ patch submissions and topic branches. | |||
| 2163 | * The Issue Tracker:: The official bug and patch tracker. | 2163 | * The Issue Tracker:: The official bug and patch tracker. |
| 2164 | * Managing Patches and Branches:: How changes to Guix are managed. | 2164 | * Managing Patches and Branches:: How changes to Guix are managed. |
| 2165 | * Debbugs User Interfaces:: Ways to interact with Debbugs. | 2165 | * Debbugs User Interfaces:: Ways to interact with Debbugs. |
| 2166 | * Debbugs Usertags:: Tag reports with custom labels. | ||
| 2167 | * Cuirass Build Notifications:: Be alerted of any breakage via RSS feeds. | 2166 | * Cuirass Build Notifications:: Be alerted of any breakage via RSS feeds. |
| 2168 | @end menu | 2167 | @end menu |
| 2169 | 2168 | ||
| @@ -2487,63 +2486,6 @@ used. | |||
| 2487 | @xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on | 2486 | @xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on |
| 2488 | this nifty tool! | 2487 | this nifty tool! |
| 2489 | 2488 | ||
| 2490 | @node Debbugs Usertags | ||
| 2491 | @subsection Debbugs Usertags | ||
| 2492 | |||
| 2493 | @cindex usertags, for debbugs | ||
| 2494 | @cindex Debbugs usertags | ||
| 2495 | Debbugs provides a feature called @dfn{usertags} that allows any user to | ||
| 2496 | tag any bug with an arbitrary label. Bugs can be searched by usertag, | ||
| 2497 | so this is a handy way to organize bugs@footnote{The list of usertags is | ||
| 2498 | public information, and anyone can modify any user's list of usertags, | ||
| 2499 | so keep that in mind if you choose to use this feature.}. If you use | ||
| 2500 | Emacs Debbugs, the entry-point to consult existing usertags is the | ||
| 2501 | @samp{C-u M-x debbugs-gnu-usertags} procedure. To set a usertag, press | ||
| 2502 | @samp{C} while consulting a bug within the *Guix-Patches* buffer opened | ||
| 2503 | with @samp{C-u M-x debbugs-gnu-bugs} buffer, then select @code{usertag} | ||
| 2504 | and follow the instructions. | ||
| 2505 | |||
| 2506 | For example, to view all the bug reports (or patches, in the case of | ||
| 2507 | @code{guix-patches}) tagged with the usertag @code{powerpc64le-linux} | ||
| 2508 | for the user @code{guix}, open a URL like the following in a web | ||
| 2509 | browser: | ||
| 2510 | @url{https://debbugs.gnu.org/cgi-bin/pkgreport.cgi?tag=powerpc64le-linux;users=guix}. | ||
| 2511 | |||
| 2512 | For more information on how to use usertags, please refer to the | ||
| 2513 | documentation for Debbugs or the documentation for whatever tool you use | ||
| 2514 | to interact with Debbugs. | ||
| 2515 | |||
| 2516 | In Guix, we are experimenting with usertags to keep track of | ||
| 2517 | architecture-specific issues, as well as reviewed ones. To facilitate | ||
| 2518 | collaboration, all our usertags are associated with the single user | ||
| 2519 | @code{guix}. The following usertags currently exist for that user: | ||
| 2520 | |||
| 2521 | @table @code | ||
| 2522 | |||
| 2523 | @item powerpc64le-linux | ||
| 2524 | The purpose of this usertag is to make it easy to find the issues that | ||
| 2525 | matter most for the @code{powerpc64le-linux} system type. Please assign | ||
| 2526 | this usertag to bugs or patches that affect @code{powerpc64le-linux} but | ||
| 2527 | not other system types. In addition, you may use it to identify issues | ||
| 2528 | that for some reason are particularly important for the | ||
| 2529 | @code{powerpc64le-linux} system type, even if the issue affects other | ||
| 2530 | system types, too. | ||
| 2531 | |||
| 2532 | @item reproducibility | ||
| 2533 | For issues related to reproducibility. For example, it would be | ||
| 2534 | appropriate to assign this usertag to a bug report for a package that | ||
| 2535 | fails to build reproducibly. | ||
| 2536 | |||
| 2537 | @item reviewed-looks-good | ||
| 2538 | You have reviewed the series and it looks good to you (LGTM). | ||
| 2539 | |||
| 2540 | @end table | ||
| 2541 | |||
| 2542 | If you're a committer and you want to add a usertag, just start using it | ||
| 2543 | with the @code{guix} user. If the usertag proves useful to you, | ||
| 2544 | consider updating this section of the manual so that others will know | ||
| 2545 | what your usertag means. | ||
| 2546 | |||
| 2547 | @node Cuirass Build Notifications | 2489 | @node Cuirass Build Notifications |
| 2548 | @subsection Cuirass Build Notifications | 2490 | @subsection Cuirass Build Notifications |
| 2549 | 2491 | ||
| @@ -3045,7 +2987,7 @@ to that commit message. | |||
| 3045 | 2987 | ||
| 3046 | If you are not a committer, you can help others find a @emph{series} you | 2988 | If you are not a committer, you can help others find a @emph{series} you |
| 3047 | have reviewed more easily by adding a @code{reviewed-looks-good} usertag | 2989 | have reviewed more easily by adding a @code{reviewed-looks-good} usertag |
| 3048 | for the @code{guix} user (@pxref{Debbugs Usertags}). | 2990 | for the @code{guix} user. |
| 3049 | 2991 | ||
| 3050 | @node Updating the Guix Package | 2992 | @node Updating the Guix Package |
| 3051 | @section Updating the Guix Package | 2993 | @section Updating the Guix Package |
