Merge branch 'mm/empty-loose-error-message' into maint
[git] / Documentation / merge-options.txt
CommitLineData
7c85d274
JA
1--commit::
2--no-commit::
3 Perform the merge and commit the result. This option can
4 be used to override --no-commit.
5+
6With --no-commit perform the merge but pretend the merge
7failed and do not autocommit, to give the user a chance to
8inspect and further tweak the merge result before committing.
93d69d86 9
66f4b98a
JS
10--edit::
11-e::
66f4b98a
JS
12 Invoke editor before committing successful merge to further
13 edit the default merge message.
14
7c85d274
JA
15--ff::
16--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+
21With --no-ff Generate a merge commit even if the merge
22resolved as a fast-forward.
d8abe148 23
96e9420c 24--log[=<n>]::
7c85d274 25--no-log::
efb779f8 26 In addition to branch names, populate the log message with
96e9420c
RR
27 one-line descriptions from at most <n> actual commits that are being
28 merged. See also linkgit:git-fmt-merge-msg[1].
7c85d274
JA
29+
30With --no-log do not list one-line descriptions from the
31actual commits being merged.
efb779f8 32
93d69d86 33
7c85d274
JA
34--stat::
35-n::
36--no-stat::
37 Show a diffstat at the end of the merge. The diffstat is also
38 controlled by the configuration option merge.stat.
39+
40With -n or --no-stat do not show a diffstat at the end of the
41merge.
d08af0ad 42
7d0c6887 43--squash::
7c85d274 44--no-squash::
7d0c6887 45 Produce the working tree and index state as if a real
f5d4c4d0
MG
46 merge happened (except for the merge information),
47 but do not actually make a commit or
7d0c6887
JH
48 move the `HEAD`, nor record `$GIT_DIR/MERGE_HEAD` to
49 cause the next `git commit` command to create a merge
50 commit. This allows you to create a single commit on
51 top of the current branch whose effect is the same as
52 merging another branch (or more in case of an octopus).
7c85d274
JA
53+
54With --no-squash perform the merge and commit the result. This
55option can be used to override --squash.
d66424c4 56
13474835
BG
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
3240240f
SB
62-s <strategy>::
63--strategy=<strategy>::
93d69d86
JL
64 Use the given merge strategy; can be supplied more than
65 once to specify them in the order they should be tried.
66 If there is no `-s` option, a built-in list of strategies
0b444cdb
TR
67 is used instead ('git merge-recursive' when merging a single
68 head, 'git merge-octopus' otherwise).
7c85d274 69
adda3c3b
MB
70-X <option>::
71--strategy-option=<option>::
72 Pass merge strategy specific option through to the merge
73 strategy.
74
7c85d274
JA
75--summary::
76--no-summary::
77 Synonyms to --stat and --no-stat; these are deprecated and will be
78 removed in the future.
79
409b8d82 80ifndef::git-pull[]
7c85d274
JA
81-q::
82--quiet::
99bfc669 83 Operate quietly. Implies --no-progress.
7c85d274
JA
84
85-v::
86--verbose::
87 Be verbose.
99bfc669
JK
88
89--progress::
90--no-progress::
91 Turn progress on/off explicitly. If neither is specified,
92 progress is shown if standard error is connected to a terminal.
93 Note that not all merge strategies may support progress
94 reporting.
95
409b8d82 96endif::git-pull[]