]> git.ipfire.org Git - thirdparty/git.git/commit
doc: git-pull: clarify options for integrating remote branch
authorJulia Evans <julia@jvns.ca>
Wed, 15 Oct 2025 13:13:29 +0000 (13:13 +0000)
committerJunio C Hamano <gitster@pobox.com>
Wed, 15 Oct 2025 20:17:52 +0000 (13:17 -0700)
commit59b28f928b2b3b91033ee4e9cbe0cf51a781e55b
tree7a399b6c454a22dc49d8cb37e0f2a37ea27fdb2a
parent85abbfc59b070816871ff64bba3eba94e749ce08
doc: git-pull: clarify options for integrating remote branch

From user feedback:

- One user is confused about the current default ("I was convinced that
  the git default was still to merge on pull")
- One user is confused about why "git fetch" isn't mentioned earlier
- One user says they always forget what the arguments to `git pull` are
  and that it's not immediately obvious that `--no-rebase` means "merge"
- One user wants `--ff-only` to be mentioned

Resolve this by listing the options for integrating the the remote
branch. This should help users figure out at a glance which one they
want to do, and make it clearer that --ff-only is the default.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-pull.adoc