Skip to content

Commit 690b297

Browse files
committed
Documentation/merge-options.txt: group "ff" related options together
The --ff-only option was not described next to --ff and --no-ff options in "git merge" documentation, even though these three are logically together, describing how to choose one of three possibilities. Also the description for '--ff' and '--no-ff' discussed what '--ff' means, and mentioned '--no-ff' as if it were a side-note to '--ff'. Make them into three top-level entries and list them together. This way, it would be more clear that the user can choose one from these three. Signed-off-by: Junio C Hamano <[email protected]>
1 parent d0482e8 commit 690b297

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

Documentation/merge-options.txt

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,18 @@ inspect and further tweak the merge result before committing.
1313
edit the default merge message.
1414

1515
--ff::
16+
When the merge resolves as a fast-forward, only update the branch
17+
pointer, without creating a merge commit. This is the default
18+
behavior.
19+
1620
--no-ff::
17-
Do not generate a merge commit if the merge resolved as
18-
a fast-forward, only update the branch pointer. This is
19-
the default behavior of git-merge.
20-
+
21-
With --no-ff Generate a merge commit even if the merge
22-
resolved as a fast-forward.
21+
Create a merge commit even when the merge resolves as a
22+
fast-forward.
23+
24+
--ff-only::
25+
Refuse to merge and exit with a non-zero status unless the
26+
current `HEAD` is already up-to-date or the merge can be
27+
resolved as a fast-forward.
2328

2429
--log[=<n>]::
2530
--no-log::
@@ -54,11 +59,6 @@ merge.
5459
With --no-squash perform the merge and commit the result. This
5560
option can be used to override --squash.
5661

57-
--ff-only::
58-
Refuse to merge and exit with a non-zero status unless the
59-
current `HEAD` is already up-to-date or the merge can be
60-
resolved as a fast-forward.
61-
6262
-s <strategy>::
6363
--strategy=<strategy>::
6464
Use the given merge strategy; can be supplied more than

0 commit comments

Comments
 (0)