diff options
| author | Ludovic Courtès <ludo@gnu.org> | 2026-02-21 19:06:51 +0100 |
|---|---|---|
| committer | Ludovic Courtès <ludo@gnu.org> | 2026-03-14 16:07:34 +0100 |
| commit | 5b6b54c95c9c223fe76a3981287149dc68653087 (patch) | |
| tree | 8580ae19a8820ce1bd0e045705fe93b6122fa1fa /doc | |
| parent | c917ece6d97266c990ea351c85019d19ca37e6ae (diff) | |
doc: Remove “Viewing Bugs within Emacs”.
This is a followup to d499253d47cca2694944c5fd1f4b582e5206890a and related
commits.
* doc/contributing.texi (Viewing Bugs within Emacs): Remove.
(Debbugs User Interfaces): Refer to the ‘debbugs-ug’ manual.
Change-Id: Idddff940302efe5689c8b459e0b141acaae74395
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/contributing.texi | 85 |
1 files changed, 2 insertions, 83 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi index e4d87ed91ef..db24703271b 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -629,87 +629,6 @@ copyright-update}. If you want to do it automatically after each buffer 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 -combined with @samp{emacs-debbugs} (the Emacs package), can be used to -open links such as @samp{<https://bugs.gnu.org/58697>} or -@samp{<https://issues.guix.gnu.org/58697>} as bug report buffers. From -there you can easily consult the email thread via the Gnus interface, -reply or modify the bug status, all without leaving the comfort of -Emacs! Below is a sample configuration to add to your @file{~/.emacs} -configuration file: - -@lisp -;;; Bug references. -(require 'bug-reference) -(add-hook 'prog-mode-hook #'bug-reference-prog-mode) -(add-hook 'gnus-mode-hook #'bug-reference-mode) -(add-hook 'erc-mode-hook #'bug-reference-mode) -(add-hook 'gnus-summary-mode-hook #'bug-reference-mode) -(add-hook 'gnus-article-mode-hook #'bug-reference-mode) - -;;; This extends the default expression (the top-most, first expression -;;; provided to 'or') to also match URLs such as -;;; <https://issues.guix.gnu.org/58697> or <https://bugs.gnu.org/58697>. -;;; It is also extended to detect "Fixes: #NNNNN" git trailers. -(setq bug-reference-bug-regexp - (rx (group (or (seq word-boundary - (or (seq (char "Bb") "ug" - (zero-or-one " ") - (zero-or-one "#")) - (seq (char "Pp") "atch" - (zero-or-one " ") - "#") - (seq (char "Ff") "ixes" - (zero-or-one ":") - (zero-or-one " ") "#") - (seq "RFE" - (zero-or-one " ") "#") - (seq "PR " - (one-or-more (char "a-z+-")) "/")) - (group (one-or-more (char "0-9")) - (zero-or-one - (seq "#" (one-or-more - (char "0-9")))))) - (seq (? "<") "https://bugs.gnu.org/" - (group-n 2 (one-or-more (char "0-9"))) - (? ">")) - (seq (? "<") "https://issues.guix.gnu.org/" - (? "issue/") - (group-n 2 (one-or-more (char "0-9"))) - (? ">")))))) -(setq bug-reference-url-format "https://issues.guix.gnu.org/%s") - -(require 'debbugs) -(require 'debbugs-browse) -(add-hook 'bug-reference-mode-hook #'debbugs-browse-mode) -(add-hook 'bug-reference-prog-mode-hook #'debbugs-browse-mode) - -;; The following allows Emacs Debbugs user to open the issue directly within -;; Emacs. -(setq debbugs-browse-url-regexp - (rx line-start - "http" (zero-or-one "s") "://" - (or "debbugs" "issues.guix" "bugs") - ".gnu.org" (one-or-more "/") - (group (zero-or-one "cgi/bugreport.cgi?bug=")) - (group-n 3 (one-or-more digit)) - line-end)) - -;; Change the default when run as '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 -Emacs Manual} and @ref{Minor Mode,,, debbugs-ug, The Debbugs User -Guide}. - @node Alternative Setups @section Alternative Setups @@ -2510,8 +2429,8 @@ For example, to list all open issues on @code{guix-patches}, hit: 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}). +@code{debbugs-gnu-default-severities} Emacs variables (@pxref{Minor +Mode,,, debbugs-ug, The Debbugs User Guide}). To search for bugs, @samp{@kbd{M-x} debbugs-gnu-guix-search} can be used. |
