unofficial mirror of guix-patches@gnu.org 
 help / color / mirror / code / Atom feed
* [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
@ 2022-11-23 19:07 ( via Guix-patches via
  2022-11-23 19:30 ` Tobias Geerinckx-Rice via Guix-patches via
                   ` (2 more replies)
  0 siblings, 3 replies; 15+ messages in thread
From: ( via Guix-patches via @ 2022-11-23 19:07 UTC (permalink / raw)
  To: 59523; +Cc: (

* 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.
---
Heya Guix,

Turns out that due to a bug in ``git send-email'', using ``-v 2'' with
a space between the flag and the argument won't work. If you try it, it'll
print a confusing error message, so this patch updates the manual to note
this and remove the space in an example that uses it.

  -- (

 doc/contributing.texi | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 40ae33ecac..913c7cf436 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1462,10 +1462,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

base-commit: d33ed58169edc027cfb6c256ecabde87e59918ed
-- 
2.38.1





^ permalink raw reply related	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-23 19:07 [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email' ( via Guix-patches via
@ 2022-11-23 19:30 ` Tobias Geerinckx-Rice via Guix-patches via
  2022-11-23 22:31   ` ( via Guix-patches via
  2022-11-23 20:47 ` zimoun
  2022-11-26 11:54 ` [bug#59523] [PATCH v2 1/3] " ( via Guix-patches via
  2 siblings, 1 reply; 15+ messages in thread
From: Tobias Geerinckx-Rice via Guix-patches via @ 2022-11-23 19:30 UTC (permalink / raw)
  To: (; +Cc: 59523

[-- Attachment #1: Type: text/plain, Size: 171 bytes --]

"( via Guix-patches" via 写道:
> Turns out that due to a bug in ``git send-email'', using ``-v 
> 2''

Has this been reported upstream?

Kind regards,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 247 bytes --]

^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-23 19:07 [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email' ( via Guix-patches via
  2022-11-23 19:30 ` Tobias Geerinckx-Rice via Guix-patches via
@ 2022-11-23 20:47 ` zimoun
  2022-11-26 11:54 ` [bug#59523] [PATCH v2 1/3] " ( via Guix-patches via
  2 siblings, 0 replies; 15+ messages in thread
From: zimoun @ 2022-11-23 20:47 UTC (permalink / raw)
  To: 59523; +Cc: (

Hi,

On Wed, 23 Nov 2022 at 19:07, "\( via Guix-patches" via <guix-patches@gnu.org> wrote:

> Turns out that due to a bug in ``git send-email'', using ``-v 2'' with
> a space between the flag and the argument won't work. If you try it, it'll
> print a confusing error message, so this patch updates the manual to note
> this and remove the space in an example that uses it.

Arf clunky Git CLI. :-)  The git-format-patch manual says:

       -v <n>, --reroll-count=<n>

so the space is allowed and it seems to work.  The git-send-email
manual says,

       git send-email [<options>] <format-patch options>

and indeed,

--8<---------------cut here---------------start------------->8---
$ git send-email -1 -v 2 --to=trash@trash.com
fatal: ambiguous argument '2': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'
format-patch -o /tmp/bin67IOTaX -1 2: command returned error: 128
--8<---------------cut here---------------end--------------->8---

But it works without the space.  Arf, Git CLI…


Cheers,
simon




^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-23 19:30 ` Tobias Geerinckx-Rice via Guix-patches via
@ 2022-11-23 22:31   ` ( via Guix-patches via
  2022-11-24  2:04     ` Kyle Meyer
  0 siblings, 1 reply; 15+ messages in thread
From: ( via Guix-patches via @ 2022-11-23 22:31 UTC (permalink / raw)
  To: Tobias Geerinckx-Rice; +Cc: 59523

On Wed Nov 23, 2022 at 7:30 PM GMT, Tobias Geerinckx-Rice wrote:
> Has this been reported upstream?

Not afaik. The person who originally noticed this said they had
considered reporting it but it looked like a pain to report. I'll
have a look myself in a moment.

    -- (




^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-23 22:31   ` ( via Guix-patches via
@ 2022-11-24  2:04     ` Kyle Meyer
  2023-03-13 23:43       ` Kyle Meyer
  0 siblings, 1 reply; 15+ messages in thread
From: Kyle Meyer @ 2022-11-24  2:04 UTC (permalink / raw)
  To: (, Tobias Geerinckx-Rice; +Cc: 59523

"\( via Guix-patches" via writes:

> On Wed Nov 23, 2022 at 7:30 PM GMT, Tobias Geerinckx-Rice wrote:
>> Has this been reported upstream?
>
> Not afaik. The person who originally noticed this said they had
> considered reporting it but it looked like a pain to report. I'll
> have a look myself in a moment.

I've just sent a patch:

  https://lore.kernel.org/git/20221124020056.242185-1-kyle@kyleam.com




^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH v2 1/3] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-23 19:07 [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email' ( via Guix-patches via
  2022-11-23 19:30 ` Tobias Geerinckx-Rice via Guix-patches via
  2022-11-23 20:47 ` zimoun
@ 2022-11-26 11:54 ` ( via Guix-patches via
  2022-11-26 11:54   ` [bug#59523] [PATCH v2 2/3] doc: contributing: Fix incorrect guix-patches address ( via Guix-patches via
                     ` (3 more replies)
  2 siblings, 4 replies; 15+ messages in thread
From: ( via Guix-patches via @ 2022-11-26 11:54 UTC (permalink / raw)
  To: 59523; +Cc: (

* 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.
---
 doc/contributing.texi | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 40ae33ecac..913c7cf436 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1462,10 +1462,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

base-commit: d33ed58169edc027cfb6c256ecabde87e59918ed
-- 
2.38.1





^ permalink raw reply related	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH v2 2/3] doc: contributing: Fix incorrect guix-patches address.
  2022-11-26 11:54 ` [bug#59523] [PATCH v2 1/3] " ( via Guix-patches via
@ 2022-11-26 11:54   ` ( via Guix-patches via
  2022-11-26 11:54   ` [bug#59523] [PATCH v2 3/3] doc: contributing: Recommend --base=origin/master ( via Guix-patches via
                     ` (2 subsequent siblings)
  3 siblings, 0 replies; 15+ messages in thread
From: ( via Guix-patches via @ 2022-11-26 11:54 UTC (permalink / raw)
  To: 59523; +Cc: (

* doc/contributing.texi ("Submitting Patches")
["Sending a Patch Series"]<"Multiple Patches">: Correct
'guix-patches@debbugs.gnu.org' to 'guix-patches@gnu.org'.
---
 doc/contributing.texi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 913c7cf436..d2c1d69f69 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1515,7 +1515,7 @@ that we can send the rest of the patches to.
 
 @example
 $ git send-email outgoing/0000-cover-letter.patch -a \
-      --to=guix-patches@@debbugs.gnu.org \
+      --to=guix-patches@@gnu.org \
       $(etc/teams.scm cc-members ...)
 $ rm outgoing/0000-cover-letter.patch # we don't want to resend it!
 @end example
-- 
2.38.1





^ permalink raw reply related	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH v2 3/3] doc: contributing: Recommend --base=origin/master.
  2022-11-26 11:54 ` [bug#59523] [PATCH v2 1/3] " ( via Guix-patches via
  2022-11-26 11:54   ` [bug#59523] [PATCH v2 2/3] doc: contributing: Fix incorrect guix-patches address ( via Guix-patches via
@ 2022-11-26 11:54   ` ( via Guix-patches via
  2023-01-11 10:58     ` Christopher Baines
  2022-12-02 16:09   ` [bug#59523] [PATCH v2 1/3] doc: contributing: Note '-v REVISION' bug in 'git send-email' zimoun
  2023-01-11 10:57   ` Christopher Baines
  3 siblings, 1 reply; 15+ messages in thread
From: ( via Guix-patches via @ 2022-11-26 11:54 UTC (permalink / raw)
  To: 59523; +Cc: (

* doc/contributing.texi ("Submitting Patches")
["Sending a Patch Series"]: Recommend --base=origin/master instead
of --base=auto.
---
 doc/contributing.texi | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index d2c1d69f69..edbdf2fded 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1428,7 +1428,8 @@ open it in your @var{EDITOR} or @var{VISUAL} for editing, and send it to
 the Guix mailing list to be reviewed and merged:
 
 @example
-$ git send-email -1 -a --base=auto --to=guix-patches@@gnu.org
+$ git send-email -1 -a --base=origin/master \
+      --to=guix-patches@@gnu.org
 @end example
 
 @quotation Tip
@@ -1439,7 +1440,7 @@ other than the @code{master} branch of
 @url{https://git.savannah.gnu.org/cgit/guix.git}.
 
 @example
-git send-email -1 -a --base=auto \
+git send-email -1 -a --base=origin/master \
     --subject-prefix='PATCH core-updates' \
     --to=guix-patches@@gnu.org
 @end example
@@ -1450,9 +1451,11 @@ message.  You may ``annotate'' the patch with explanatory text by adding
 it under this line.  If you do not wish to annotate the email, you may
 drop the @option{-a} flag (which is short for @option{--annotate}).
 
-The @option{--base=auto} flag automatically adds a note at the bottom
-of the patch of the commit it was based on, making it easier for
-maintainers to rebase and merge your patch.
+The @option{--base=origin/master} flag automatically adds a note at the
+bottom of the patch of the commit hash of @code{origin/master}, making it
+easier for maintainers to rebase and merge your patch.  Of course, if
+your patchset is based on, say, @code{core-updates}, you need to use
+@option{--base=origin/core-updates}.
 
 If you need to send a revised patch, don't resend it like this or send
 a ``fix'' patch to be applied on top of the last one; instead, use
@@ -1462,7 +1465,7 @@ 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=origin/master -v@var{REVISION} \
       --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org
 @end example
 
@@ -1506,7 +1509,7 @@ with @command{git format-patch}.
 
 @example
 $ git format-patch -@var{NUMBER_COMMITS} -o outgoing \
-      --cover-letter --base=auto
+      --cover-letter --base=origin/master
 @end example
 
 We can now send @emph{just} the cover letter to the
@@ -1540,7 +1543,7 @@ the patchset.
 
 @example
 $ git send-email -@var{NUMBER_COMMITS} \
-      -v@var{REVISION} --base=auto \
+      -v@var{REVISION} --base=origin/master \
       --to @var{ISSUE_NUMBER}@@debbugs.gnu.org
 @end example
 
-- 
2.38.1





^ permalink raw reply related	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH v2 1/3] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-26 11:54 ` [bug#59523] [PATCH v2 1/3] " ( via Guix-patches via
  2022-11-26 11:54   ` [bug#59523] [PATCH v2 2/3] doc: contributing: Fix incorrect guix-patches address ( via Guix-patches via
  2022-11-26 11:54   ` [bug#59523] [PATCH v2 3/3] doc: contributing: Recommend --base=origin/master ( via Guix-patches via
@ 2022-12-02 16:09   ` zimoun
  2023-01-11 10:57   ` Christopher Baines
  3 siblings, 0 replies; 15+ messages in thread
From: zimoun @ 2022-12-02 16:09 UTC (permalink / raw)
  To: 59523; +Cc: (

Hi,

On Sat, 26 Nov 2022 at 11:54, "\( via Guix-patches" via <guix-patches@gnu.org> wrote:
> * 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.

This patch and all the 2 others LGTM.

Cheers,
simon




^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH v2 1/3] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-26 11:54 ` [bug#59523] [PATCH v2 1/3] " ( via Guix-patches via
                     ` (2 preceding siblings ...)
  2022-12-02 16:09   ` [bug#59523] [PATCH v2 1/3] doc: contributing: Note '-v REVISION' bug in 'git send-email' zimoun
@ 2023-01-11 10:57   ` Christopher Baines
  2023-03-21 12:41     ` bug#59523: [PATCH] " Maxim Cournoyer
  3 siblings, 1 reply; 15+ messages in thread
From: Christopher Baines @ 2023-01-11 10:57 UTC (permalink / raw)
  To: (; +Cc: 59523

[-- Attachment #1: Type: text/plain, Size: 411 bytes --]


"( via Guix-patches" via <guix-patches@gnu.org> writes:

> * 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.
> ---
>  doc/contributing.texi | 8 +++++++-
>  1 file changed, 7 insertions(+), 1 deletion(-)

I've pushed this to master now as
09cd488c973c2ea27cfa2224489aca317f596341.

Thanks,

Chris

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 987 bytes --]

^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH v2 3/3] doc: contributing: Recommend --base=origin/master.
  2022-11-26 11:54   ` [bug#59523] [PATCH v2 3/3] doc: contributing: Recommend --base=origin/master ( via Guix-patches via
@ 2023-01-11 10:58     ` Christopher Baines
  2023-01-11 17:05       ` ( via Guix-patches via
  0 siblings, 1 reply; 15+ messages in thread
From: Christopher Baines @ 2023-01-11 10:58 UTC (permalink / raw)
  To: (; +Cc: 59523

[-- Attachment #1: Type: text/plain, Size: 535 bytes --]


"( via Guix-patches" via <guix-patches@gnu.org> writes:

> * doc/contributing.texi ("Submitting Patches")
> ["Sending a Patch Series"]: Recommend --base=origin/master instead
> of --base=auto.
> ---
>  doc/contributing.texi | 19 +++++++++++--------
>  1 file changed, 11 insertions(+), 8 deletions(-)

I think this is the last patch associated with this bug that hasn't been
merged.

I did have a look at it, but the commit message is missing the reasoning
for the change, what's the intent behind changing the recommendation?

Chris

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 987 bytes --]

^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH v2 3/3] doc: contributing: Recommend --base=origin/master.
  2023-01-11 10:58     ` Christopher Baines
@ 2023-01-11 17:05       ` ( via Guix-patches via
  0 siblings, 0 replies; 15+ messages in thread
From: ( via Guix-patches via @ 2023-01-11 17:05 UTC (permalink / raw)
  To: Christopher Baines; +Cc: 59523

[-- Attachment #1: Type: text/plain, Size: 373 bytes --]

On Wed Jan 11, 2023 at 10:58 AM GMT, Christopher Baines wrote:
> I did have a look at it, but the commit message is missing the reasoning
> for the change, what's the intent behind changing the recommendation?

It's because with --base=auto, you need to git branch --set-upstream=<branch> first.
You might as well just use --base=origin/master instead...

    -- (

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 659 bytes --]

^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2022-11-24  2:04     ` Kyle Meyer
@ 2023-03-13 23:43       ` Kyle Meyer
  2023-03-21 12:34         ` Maxim Cournoyer
  0 siblings, 1 reply; 15+ messages in thread
From: Kyle Meyer @ 2023-03-13 23:43 UTC (permalink / raw)
  To: (; +Cc: 59523, Tobias Geerinckx-Rice

Kyle Meyer writes:

> I've just sent a patch:
>
>   https://lore.kernel.org/git/20221124020056.242185-1-kyle@kyleam.com

Just to close the loop here: that landed in Git v2.40.0.




^ permalink raw reply	[flat|nested] 15+ messages in thread

* [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2023-03-13 23:43       ` Kyle Meyer
@ 2023-03-21 12:34         ` Maxim Cournoyer
  0 siblings, 0 replies; 15+ messages in thread
From: Maxim Cournoyer @ 2023-03-21 12:34 UTC (permalink / raw)
  To: Kyle Meyer; +Cc: (, Tobias Geerinckx-Rice, 59523

Hi,

Kyle Meyer <kyle@kyleam.com> writes:

> Kyle Meyer writes:
>
>> I've just sent a patch:
>>
>>   https://lore.kernel.org/git/20221124020056.242185-1-kyle@kyleam.com
>
> Just to close the loop here: that landed in Git v2.40.0.

Awesome.  We're now at 2.39, so it seems we can just wait a bit to get
2.40 and then close this issue.

-- 
Thanks,
Maxim




^ permalink raw reply	[flat|nested] 15+ messages in thread

* bug#59523: [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email'.
  2023-01-11 10:57   ` Christopher Baines
@ 2023-03-21 12:41     ` Maxim Cournoyer
  0 siblings, 0 replies; 15+ messages in thread
From: Maxim Cournoyer @ 2023-03-21 12:41 UTC (permalink / raw)
  To: Christopher Baines; +Cc: (, 59523-done

Hi,

Christopher Baines <mail@cbaines.net> writes:

> "( via Guix-patches" via <guix-patches@gnu.org> writes:
>
>> * 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.
>> ---
>>  doc/contributing.texi | 8 +++++++-
>>  1 file changed, 7 insertions(+), 1 deletion(-)
>
> I've pushed this to master now as
> 09cd488c973c2ea27cfa2224489aca317f596341.

OK! Don't forget to revert when git 2.40 lands in master, as it includes
a fix.

-- 
Thanks,
Maxim




^ permalink raw reply	[flat|nested] 15+ messages in thread

end of thread, other threads:[~2023-03-21 12:42 UTC | newest]

Thread overview: 15+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-11-23 19:07 [bug#59523] [PATCH] doc: contributing: Note '-v REVISION' bug in 'git send-email' ( via Guix-patches via
2022-11-23 19:30 ` Tobias Geerinckx-Rice via Guix-patches via
2022-11-23 22:31   ` ( via Guix-patches via
2022-11-24  2:04     ` Kyle Meyer
2023-03-13 23:43       ` Kyle Meyer
2023-03-21 12:34         ` Maxim Cournoyer
2022-11-23 20:47 ` zimoun
2022-11-26 11:54 ` [bug#59523] [PATCH v2 1/3] " ( via Guix-patches via
2022-11-26 11:54   ` [bug#59523] [PATCH v2 2/3] doc: contributing: Fix incorrect guix-patches address ( via Guix-patches via
2022-11-26 11:54   ` [bug#59523] [PATCH v2 3/3] doc: contributing: Recommend --base=origin/master ( via Guix-patches via
2023-01-11 10:58     ` Christopher Baines
2023-01-11 17:05       ` ( via Guix-patches via
2022-12-02 16:09   ` [bug#59523] [PATCH v2 1/3] doc: contributing: Note '-v REVISION' bug in 'git send-email' zimoun
2023-01-11 10:57   ` Christopher Baines
2023-03-21 12:41     ` bug#59523: [PATCH] " Maxim Cournoyer

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).