blob: 5b4a62e93624bc8289c835631aab5d5f13dff708 [file] [log] [blame]
Jari Aalto7c85d272009-10-22 22:25:20 +03001--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.
Tuncer Ayaz7f87aff2008-11-15 01:14:24 +01009
Jay Soffian66f4b982011-10-08 14:39:52 -040010--edit::
Richard Hansen66fa1b22013-05-16 18:26:00 -040011-e::
Junio C Hamanof8246282012-01-10 22:44:45 -080012--no-edit::
13 Invoke an editor before committing successful mechanical merge to
14 further edit the auto-generated merge message, so that the user
15 can explain and justify the merge. The `--no-edit` option can be
16 used to accept the auto-generated message (this is generally
Junio C Hamano08f19cf2014-01-14 10:26:21 -080017 discouraged).
18ifndef::git-pull[]
19The `--edit` (or `-e`) option is still useful if you are
20giving a draft message with the `-m` option from the command line
21and want to edit it in the editor.
22endif::git-pull[]
Jay Soffian66f4b982011-10-08 14:39:52 -040023+
Junio C Hamanof8246282012-01-10 22:44:45 -080024Older scripts may depend on the historical behaviour of not allowing the
25user to edit the merge log message. They will see an editor opened when
26they run `git merge`. To make it easier to adjust such scripts to the
27updated behaviour, the environment variable `GIT_MERGE_AUTOEDIT` can be
28set to `no` at the beginning of them.
Jay Soffian66f4b982011-10-08 14:39:52 -040029
Jari Aalto7c85d272009-10-22 22:25:20 +030030--ff::
Junio C Hamano690b2972012-02-22 14:27:07 -080031 When the merge resolves as a fast-forward, only update the branch
32 pointer, without creating a merge commit. This is the default
33 behavior.
34
Jari Aalto7c85d272009-10-22 22:25:20 +030035--no-ff::
Junio C Hamano690b2972012-02-22 14:27:07 -080036 Create a merge commit even when the merge resolves as a
Junio C Hamano77c72782013-03-21 22:57:48 +010037 fast-forward. This is the default behaviour when merging an
38 annotated (and possibly signed) tag.
Junio C Hamano690b2972012-02-22 14:27:07 -080039
40--ff-only::
41 Refuse to merge and exit with a non-zero status unless the
42 current `HEAD` is already up-to-date or the merge can be
43 resolved as a fast-forward.
SZEDER Gábord8abe142008-04-06 03:23:43 +020044
Ramkumar Ramachandra96e94202010-09-08 23:29:54 +053045--log[=<n>]::
Jari Aalto7c85d272009-10-22 22:25:20 +030046--no-log::
SZEDER Gáborefb779f2008-04-06 03:23:46 +020047 In addition to branch names, populate the log message with
Ramkumar Ramachandra96e94202010-09-08 23:29:54 +053048 one-line descriptions from at most <n> actual commits that are being
49 merged. See also linkgit:git-fmt-merge-msg[1].
Jari Aalto7c85d272009-10-22 22:25:20 +030050+
51With --no-log do not list one-line descriptions from the
52actual commits being merged.
SZEDER Gáborefb779f2008-04-06 03:23:46 +020053
SZEDER Gáborefb779f2008-04-06 03:23:46 +020054
Jari Aalto7c85d272009-10-22 22:25:20 +030055--stat::
56-n::
57--no-stat::
58 Show a diffstat at the end of the merge. The diffstat is also
59 controlled by the configuration option merge.stat.
60+
61With -n or --no-stat do not show a diffstat at the end of the
62merge.
Lars Hjemlid08af0a2007-09-24 00:51:44 +020063
Junio C Hamano7d0c6882006-06-23 01:37:02 -070064--squash::
Jari Aalto7c85d272009-10-22 22:25:20 +030065--no-squash::
Justin Lebara58088a2014-03-31 15:11:44 -070066 Produce the working tree and index state as if a real merge
67 happened (except for the merge information), but do not actually
68 make a commit, move the `HEAD`, or record `$GIT_DIR/MERGE_HEAD`
69 (to cause the next `git commit` command to create a merge
70 commit). This allows you to create a single commit on top of
71 the current branch whose effect is the same as merging another
72 branch (or more in case of an octopus).
Jari Aalto7c85d272009-10-22 22:25:20 +030073+
74With --no-squash perform the merge and commit the result. This
75option can be used to override --squash.
Lars Hjemlid66424c2007-09-24 00:51:45 +020076
Stephan Beyer32402402008-06-08 03:36:09 +020077-s <strategy>::
78--strategy=<strategy>::
Jon Loeliger93d69d82005-11-06 23:30:56 -060079 Use the given merge strategy; can be supplied more than
80 once to specify them in the order they should be tried.
81 If there is no `-s` option, a built-in list of strategies
Thomas Rast0b444cd2010-01-10 00:33:00 +010082 is used instead ('git merge-recursive' when merging a single
83 head, 'git merge-octopus' otherwise).
Jari Aalto7c85d272009-10-22 22:25:20 +030084
Marc Branchaudadda3c32010-04-12 12:28:13 -040085-X <option>::
86--strategy-option=<option>::
87 Pass merge strategy specific option through to the merge
88 strategy.
89
Sebastian Götteefed0022013-03-31 18:02:24 +020090--verify-signatures::
91--no-verify-signatures::
Keller Fuchs05a58692016-05-13 09:51:01 +000092 Verify that the tip commit of the side branch being merged is
93 signed with a valid key, i.e. a key that has a valid uid: in the
94 default trust model, this means the signing key has been signed by
95 a trusted key. If the tip commit of the side branch is not signed
96 with a valid key, the merge is aborted.
Sebastian Götteefed0022013-03-31 18:02:24 +020097
Jari Aalto7c85d272009-10-22 22:25:20 +030098--summary::
99--no-summary::
100 Synonyms to --stat and --no-stat; these are deprecated and will be
101 removed in the future.
102
Tay Ray Chuan409b8d82010-02-24 20:50:21 +0800103ifndef::git-pull[]
Jari Aalto7c85d272009-10-22 22:25:20 +0300104-q::
105--quiet::
Jeff King99bfc662011-02-20 04:53:21 -0500106 Operate quietly. Implies --no-progress.
Jari Aalto7c85d272009-10-22 22:25:20 +0300107
108-v::
109--verbose::
110 Be verbose.
Jeff King99bfc662011-02-20 04:53:21 -0500111
112--progress::
113--no-progress::
114 Turn progress on/off explicitly. If neither is specified,
115 progress is shown if standard error is connected to a terminal.
116 Note that not all merge strategies may support progress
117 reporting.
118
Tay Ray Chuan409b8d82010-02-24 20:50:21 +0800119endif::git-pull[]
Junio C Hamano09c2cb82016-03-18 13:21:09 -0700120
121--allow-unrelated-histories::
122 By default, `git merge` command refuses to merge histories
123 that do not share a common ancestor. This option can be
124 used to override this safety when merging histories of two
125 projects that started their lives independently. As that is
126 a very rare occasion, no configuration variable to enable
127 this by default exists and will not be added.