GNU bug report logs - #71481
[PATCH 1/3] doc: Document mumi am, compose and www subcommands.

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Arun Isaac <arunisaac <at> systemreboot.net>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#71481: closed ([PATCH 1/3] doc: Document mumi am, compose and
 www subcommands.)
Date: Wed, 12 Jun 2024 21:19:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Wed, 12 Jun 2024 22:17:54 +0100
with message-id <875xudamil.fsf <at> systemreboot.net>
and subject line Re: [bug#71481] [PATCH 1/3] doc: Document mumi am, compose and www subcommands.
has caused the debbugs.gnu.org bug report #71481,
regarding [PATCH 1/3] doc: Document mumi am, compose and www subcommands.
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
71481: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=71481
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Arun Isaac <arunisaac <at> systemreboot.net>
To: guix-patches <at> gnu.org
Cc: Arun Isaac <arunisaac <at> systemreboot.net>
Subject: [PATCH 1/3] doc: Document mumi am, compose and www subcommands.
Date: Mon, 10 Jun 2024 14:19:47 +0100

* doc/contributing.texi (Debbugs User Interfaces)[Command-line interface]:
Document mumi am, compose and www subcommands.
* doc/guix.texi: Bump copyright year.

Change-Id: I28bde9454ad35115ed60fe4d6ffa35fad599b2d1
---
 doc/contributing.texi | 70 ++++++++++++++++++++++++++++++++++++-------
 doc/guix.texi         |  2 +-
 2 files changed, 61 insertions(+), 11 deletions(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index b8adc169d8..1fdf9b4db5 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -2395,9 +2395,9 @@ Debbugs User Interfaces
 @subsubsection 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.
+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
@@ -2434,8 +2434,61 @@ Debbugs User Interfaces
 opened on 24 Jan 09:42 Z by Efraim Flashner
 @end example
 
-Once an issue is the current issue, you can easily create and send
-patches to it using
+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
+
+@example
+~/guix [env]$ mumi www
+@end example
+
+Compose a reply using
+
+@example
+~/guix [env]$ mumi compose
+@end example
+
+Compose a reply and close the issue using
+
+@example
+~/guix [env]$ mumi compose --close
+@end example
+
+@command{mumi compose} opens your mail client by passing @samp{mailto:}
+URIs to @command{xdg-open}.  So, you need to have @command{xdg-open} set
+up to open your mail client correctly.
+
+Apply the latest patchset from the issue using
+
+@example
+~/guix [env]$ mumi am
+@end example
+
+You may also apply a patchset of a specific version (say, v3) using
+
+@example
+~/guix [env]$ mumi am v3
+@end example
+
+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
+
+@example
+~/guix [env]$ mumi am @@4
+@end example
+
+@command{mumi am} is a wrapper around @command{git am}.  You can pass
+@command{git am} arguments to it after a @samp{--}.  For example, to add
+a Signed-off-by trailer, run
+
+@example
+~/guix [env]$ mumi am -- -s
+@end example
+
+Create and send patches to the issue using
 
 @example
 ~/guix [env]$ git format-patch origin/master
@@ -2452,11 +2505,8 @@ Debbugs User Interfaces
 ~/guix [env]$ mumi new
 @end example
 
-and send patches
-
-@example
-~/guix [env]$ mumi send-email foo.patch bar.patch
-@end example
+and send an email (using @command{mumi compose}) or patches (using
+@command{mumi send-email}).
 
 @command{mumi send-email} is really a wrapper around @command{git
 send-email} that automates away all the nitty-gritty of sending patches.
diff --git a/doc/guix.texi b/doc/guix.texi
index 769ca1399f..e1d1d4696c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -53,7 +53,7 @@
 Copyright @copyright{} 2017–2022 Tobias Geerinckx-Rice@*
 Copyright @copyright{} 2017 George Clemmer@*
 Copyright @copyright{} 2017 Andy Wingo@*
-Copyright @copyright{} 2017, 2018, 2019, 2020, 2023 Arun Isaac@*
+Copyright @copyright{} 2017, 2018, 2019, 2020, 2023, 2024 Arun Isaac@*
 Copyright @copyright{} 2017 nee@*
 Copyright @copyright{} 2018 Rutger Helling@*
 Copyright @copyright{} 2018, 2021, 2023 Oleg Pykhalov@*

base-commit: df5648daa1a5d097a430131bbff353b865b476b6
-- 
2.45.1

[Message part 3 (message/rfc822, inline)]

From: Arun Isaac <arunisaac <at> systemreboot.net>
To: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
Cc: Ludovic Courtès <ludo <at> gnu.org>,
 Florian Pelz <pelzflorian <at> pelzflorian.de>, 71481-done <at> debbugs.gnu.org,
 Matthew Trzcinski <matt <at> excalamus.com>
Subject: Re: [bug#71481] [PATCH 1/3] doc: Document mumi am, compose and www
 subcommands.
Date: Wed, 12 Jun 2024 22:17:54 +0100

Hi Maxim,

Thanks for the review! I have pushed these patches now.

Regards,
Arun

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.