blob: 0bcbe0ac3c474ab12068f468476946b9db5ef3e8 [file] [log] [blame]
Junio C Hamanoc21ab052009-10-31 04:03:551--commit::
2--no-commit::
3Perform the merge and commit the result. This option can
4be 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.
Junio C Hamano610d1762008-11-28 06:27:139
Junio C Hamano11821ed2011-10-19 18:42:0910--edit::
Junio C Hamano795a5a32012-02-02 01:36:3711--no-edit::
12Invoke an editor before committing successful mechanical merge to
13further edit the auto-generated merge message, so that the user
14can explain and justify the merge. The `--no-edit` option can be
15used to accept the auto-generated message (this is generally
16discouraged). The `--edit` option is still useful if you are
17giving a draft message with the `-m` option from the command line
18and want to edit it in the editor.
19+
20Older scripts may depend on the historical behaviour of not allowing the
21user to edit the merge log message. They will see an editor opened when
22they run `git merge`. To make it easier to adjust such scripts to the
23updated behaviour, the environment variable `GIT_MERGE_AUTOEDIT` can be
24set to `no` at the beginning of them.
Junio C Hamano11821ed2011-10-19 18:42:0925
Junio C Hamanoc21ab052009-10-31 04:03:5526--ff::
Junio C Hamanof54f08e2012-02-27 07:49:1927When the merge resolves as a fast-forward, only update the branch
28pointer, without creating a merge commit. This is the default
29behavior.
30
Junio C Hamanoc21ab052009-10-31 04:03:5531--no-ff::
Junio C Hamanof54f08e2012-02-27 07:49:1932Create a merge commit even when the merge resolves as a
33fast-forward.
34
35--ff-only::
36Refuse to merge and exit with a non-zero status unless the
37current `HEAD` is already up-to-date or the merge can be
38resolved as a fast-forward.
Junio C Hamano6d76d612008-05-09 05:46:0839
Junio C Hamano3b4609d2010-09-30 00:04:3440--log[=<n>]::
Junio C Hamanoc21ab052009-10-31 04:03:5541--no-log::
Junio C Hamano6d76d612008-05-09 05:46:0842In addition to branch names, populate the log message with
Junio C Hamano3b4609d2010-09-30 00:04:3443one-line descriptions from at most <n> actual commits that are being
44merged. See also linkgit:git-fmt-merge-msg[1].
Junio C Hamanoc21ab052009-10-31 04:03:5545+
46With --no-log do not list one-line descriptions from the
47actual commits being merged.
Junio C Hamano6d76d612008-05-09 05:46:0848
Junio C Hamano6d76d612008-05-09 05:46:0849
Junio C Hamanoc21ab052009-10-31 04:03:5550--stat::
51-n::
52--no-stat::
53Show a diffstat at the end of the merge. The diffstat is also
54controlled by the configuration option merge.stat.
55+
56With -n or --no-stat do not show a diffstat at the end of the
57merge.
Junio C Hamano1b50ce92007-10-03 12:05:5358
Junio C Hamano3901ffb2006-06-26 23:46:5359--squash::
Junio C Hamanoc21ab052009-10-31 04:03:5560--no-squash::
Junio C Hamano3901ffb2006-06-26 23:46:5361Produce the working tree and index state as if a real
Junio C Hamano9f10ed32009-05-26 08:38:5262merge happened (except for the merge information),
63but do not actually make a commit or
Junio C Hamano3901ffb2006-06-26 23:46:5364move the `HEAD`, nor record `$GIT_DIR/MERGE_HEAD` to
65cause the next `git commit` command to create a merge
66commit. This allows you to create a single commit on
67top of the current branch whose effect is the same as
68merging another branch (or more in case of an octopus).
Junio C Hamanoc21ab052009-10-31 04:03:5569+
70With --no-squash perform the merge and commit the result. This
71option can be used to override --squash.
Junio C Hamano1b50ce92007-10-03 12:05:5372
Junio C Hamanoeb415992008-06-08 22:49:4773-s <strategy>::
74--strategy=<strategy>::
Junio C Hamano1a4e8412005-12-27 08:17:2375Use the given merge strategy; can be supplied more than
76once to specify them in the order they should be tried.
77If there is no `-s` option, a built-in list of strategies
Junio C Hamano1aa40d22010-01-21 17:46:4378is used instead ('git merge-recursive' when merging a single
79head, 'git merge-octopus' otherwise).
Junio C Hamanoc21ab052009-10-31 04:03:5580
Junio C Hamanob04bb3f2010-04-14 14:07:3681-X <option>::
82--strategy-option=<option>::
83Pass merge strategy specific option through to the merge
84strategy.
85
Junio C Hamanoc21ab052009-10-31 04:03:5586--summary::
87--no-summary::
88Synonyms to --stat and --no-stat; these are deprecated and will be
89removed in the future.
90
Junio C Hamanoea90ab32010-03-15 20:32:5591ifndef::git-pull[]
Junio C Hamanoc21ab052009-10-31 04:03:5592-q::
93--quiet::
Junio C Hamanod2c978f2011-03-20 19:42:2294Operate quietly. Implies --no-progress.
Junio C Hamanoc21ab052009-10-31 04:03:5595
96-v::
97--verbose::
98Be verbose.
Junio C Hamanod2c978f2011-03-20 19:42:2299
100--progress::
101--no-progress::
102Turn progress on/off explicitly. If neither is specified,
103progress is shown if standard error is connected to a terminal.
104Note that not all merge strategies may support progress
105reporting.
106
Junio C Hamanoea90ab32010-03-15 20:32:55107endif::git-pull[]