]> git.ipfire.org Git - thirdparty/git.git/blob - Documentation/merge-options.txt
Merge git://ozlabs.org/~paulus/gitk
[thirdparty/git.git] / Documentation / merge-options.txt
1 --commit::
2 --no-commit::
3 Perform the merge and commit the result. This option can
4 be used to override --no-commit.
5 +
6 With --no-commit perform the merge but pretend the merge
7 failed and do not autocommit, to give the user a chance to
8 inspect and further tweak the merge result before committing.
9
10 --edit::
11 -e::
12 Invoke editor before committing successful merge to further
13 edit the default merge message.
14
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 +
21 With --no-ff Generate a merge commit even if the merge
22 resolved as a fast-forward.
23
24 --log[=<n>]::
25 --no-log::
26 In addition to branch names, populate the log message with
27 one-line descriptions from at most <n> actual commits that are being
28 merged. See also linkgit:git-fmt-merge-msg[1].
29 +
30 With --no-log do not list one-line descriptions from the
31 actual commits being merged.
32
33
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 +
40 With -n or --no-stat do not show a diffstat at the end of the
41 merge.
42
43 --squash::
44 --no-squash::
45 Produce the working tree and index state as if a real
46 merge happened (except for the merge information),
47 but do not actually make a commit or
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).
53 +
54 With --no-squash perform the merge and commit the result. This
55 option can be used to override --squash.
56
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
62 -s <strategy>::
63 --strategy=<strategy>::
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
67 is used instead ('git merge-recursive' when merging a single
68 head, 'git merge-octopus' otherwise).
69
70 -X <option>::
71 --strategy-option=<option>::
72 Pass merge strategy specific option through to the merge
73 strategy.
74
75 --summary::
76 --no-summary::
77 Synonyms to --stat and --no-stat; these are deprecated and will be
78 removed in the future.
79
80 ifndef::git-pull[]
81 -q::
82 --quiet::
83 Operate quietly. Implies --no-progress.
84
85 -v::
86 --verbose::
87 Be verbose.
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
96 endif::git-pull[]