02/03: doc: contributing: Note '-v REVISION' bug in 'git send-email'.

[guix-commits]

cbaines pushed a commit to branch master
in repository guix.

commit 09cd488c973c2ea27cfa2224489aca317f596341
Author: ( <paren@disroot.org>
AuthorDate: Sat Nov 26 11:54:24 2022 +0000

    doc: contributing: Note '-v REVISION' bug in 'git send-email'.
    
    * doc/contributing.texi ("Submitting Patches")["Sending a Patch Series"]:
    Note that a bug in 'git send-email' means '-v REVISION' (with a
    space) will not work.
    
    Signed-off-by: Christopher Baines <mail@cbaines.net>
---
 doc/contributing.texi | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 97137963af..c436bc4a31 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1467,10 +1467,16 @@ address and the @option{-v} flag with @command{git 
send-email}.
 
 @example
 $ git commit -a
-$ git send-email -1 -a --base=auto -v @var{REVISION} \
+$ git send-email -1 -a --base=auto -v@var{REVISION} \
       --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org
 @end example
 
+@quotation Note
+Due to an apparent bug in @command{git send-email},
+@option{-v @var{REVISION}} (with the space) will not work; you
+@emph{must} use @option{-v@var{REVISION}}.
+@end quotation
+
 You can find out @var{ISSUE_NUMBER} either by searching on the mumi
 interface at @url{issues.guix.gnu.org} for the name of your patch or
 reading the acknowledgement email sent automatically by Debbugs in