diff mbox series

[v2] pull: warn if the user didn't say whether to rebase or to merge

Message ID 20200229010927.335119-1-alexhenrie24@gmail.com (mailing list archive)
State New, archived
Headers show
Series [v2] pull: warn if the user didn't say whether to rebase or to merge | expand

Commit Message

Alex Henrie Feb. 29, 2020, 1:09 a.m. UTC
Often novice Git users forget to say "pull --rebase" and end up with an
unnecessary merge from upstream. What they usually want is either "pull
--rebase" in the simpler cases, or "pull --ff-only" to update the copy
of main integration branches, and rebase their work separately. The
pull.rebase configuration variable exists to help them in the simpler
cases, but there is no mechanism to make these users aware of it.

Issue a warning message when no --[no-]rebase option from the command
line and no pull.rebase configuration variable is given. This will
inconvenience those who never want to "pull --rebase", who haven't had
to do anything special, but the cost of the inconvenience is paid only
once per user, which should be a reasonable cost to help a number of new
users.

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
---
v2:
- Use the commit message that Junio suggested
- Drop "!= 0" from the if condition
- Mention in the warning that --ff-only will also suppress the warning
---
 builtin/pull.c | 7 +++++++
 1 file changed, 7 insertions(+)

Comments

Junio C Hamano Feb. 29, 2020, 4:51 p.m. UTC | #1
Alex Henrie <alexhenrie24@gmail.com> writes:

> +		warning(_("Pulling without specifying whether to rebase or to merge is discouraged\n"
> +			"and will be disallowed in a future Git release.\n"

Sorry for not catching this in the earlier round, but I do not think
anybody argued, let alone the community came to a concensus on
doing, such a strong move.  Am I mistaken?

I certainly did not intend to, at least when I commented on the
earlier round and proposed an updated log message, I wasn't even
aware of the possibility that we may want to turn this into die()
after a transition period.

Not that I'd object strongly to the idea, but it was somewhat
unexpected.

If we are proposing to make it a long-term plan, that should
certainly be written down in the proposed log message.

> +			"Next time, run `git config pull.rebase (true|false)` first\n"
> +			"or pass --rebase, --no-rebase, or --ff-only on the command line.\n

I am somewhat puzzled by "first, or".  You certainly mean the config
to be "set and forget", and you do not want to say "before you pull,
do this first, always", but somehow the latter is the impression I
got.

But it does not sound to me like "Next time, and only next time, do
this configuration.  You can countermand the choice you make from
the command line later if needed", which I think is what you meant
to convey to your readers.
 
    You can squelch this message by `pull.rebase` configuration
    variable to show your preference.  By passing --[no-]rebase
    or --ff-only from the command line, you can countermand the
    choice per invocation.

is what I came up with, but I am not quite happy with it.  It is
overly long to start with X-<.

"));
> +	}
> +
>  	return REBASE_FALSE;
>  }
Alex Henrie Feb. 29, 2020, 9:21 p.m. UTC | #2
On Sat, Feb 29, 2020 at 9:51 AM Junio C Hamano <gitster@pobox.com> wrote:
>
> Alex Henrie <alexhenrie24@gmail.com> writes:
>
> > +             warning(_("Pulling without specifying whether to rebase or to merge is discouraged\n"
> > +                     "and will be disallowed in a future Git release.\n"
>
> Sorry for not catching this in the earlier round, but I do not think
> anybody argued, let alone the community came to a concensus on
> doing, such a strong move.  Am I mistaken?
>
> I certainly did not intend to, at least when I commented on the
> earlier round and proposed an updated log message, I wasn't even
> aware of the possibility that we may want to turn this into die()
> after a transition period.
>
> Not that I'd object strongly to the idea, but it was somewhat
> unexpected.
>
> If we are proposing to make it a long-term plan, that should
> certainly be written down in the proposed log message.

I really don't think it's a good idea to start making a merge commit
without confirming that that's what the user wants. Elijah and Robert
seemed to agree. However, we can start by just putting in a friendly
educational message and then continue the discussion about whether or
not to make a future version of Git abort upon printing the warning.

> > +                     "Next time, run `git config pull.rebase (true|false)` first\n"
> > +                     "or pass --rebase, --no-rebase, or --ff-only on the command line.\n
>
> I am somewhat puzzled by "first, or".  You certainly mean the config
> to be "set and forget", and you do not want to say "before you pull,
> do this first, always", but somehow the latter is the impression I
> got.
>
> But it does not sound to me like "Next time, and only next time, do
> this configuration.  You can countermand the choice you make from
> the command line later if needed", which I think is what you meant
> to convey to your readers.

I'll send a new version that has a longer and more clear warning message.

-Alex
diff mbox series

Patch

diff --git a/builtin/pull.c b/builtin/pull.c
index 3e624d1e00..96512a4b27 100644
--- a/builtin/pull.c
+++ b/builtin/pull.c
@@ -327,6 +327,13 @@  static enum rebase_type config_get_rebase(void)
 	if (!git_config_get_value("pull.rebase", &value))
 		return parse_config_rebase("pull.rebase", value, 1);
 
+	if (strcmp(opt_ff, "--ff-only")) {
+		warning(_("Pulling without specifying whether to rebase or to merge is discouraged\n"
+			"and will be disallowed in a future Git release.\n"
+			"Next time, run `git config pull.rebase (true|false)` first\n"
+			"or pass --rebase, --no-rebase, or --ff-only on the command line.\n"));
+	}
+
 	return REBASE_FALSE;
 }