Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 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. |
Junio C Hamano | 610d176 | 2008-11-28 06:27:13 | [diff] [blame] | 9 | |
Junio C Hamano | 11821ed | 2011-10-19 18:42:09 | [diff] [blame] | 10 | --edit:: |
Junio C Hamano | 795a5a3 | 2012-02-02 01:36:37 | [diff] [blame] | 11 | --no-edit:: |
| 12 | Invoke an editor before committing successful mechanical merge to |
| 13 | further edit the auto-generated merge message, so that the user |
| 14 | can explain and justify the merge. The `--no-edit` option can be |
| 15 | used to accept the auto-generated message (this is generally |
| 16 | discouraged). The `--edit` option is still useful if you are |
| 17 | giving a draft message with the `-m` option from the command line |
| 18 | and want to edit it in the editor. |
| 19 | + |
| 20 | Older scripts may depend on the historical behaviour of not allowing the |
| 21 | user to edit the merge log message. They will see an editor opened when |
| 22 | they run `git merge`. To make it easier to adjust such scripts to the |
| 23 | updated behaviour, the environment variable `GIT_MERGE_AUTOEDIT` can be |
| 24 | set to `no` at the beginning of them. |
Junio C Hamano | 11821ed | 2011-10-19 18:42:09 | [diff] [blame] | 25 | |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 26 | --ff:: |
Junio C Hamano | f54f08e | 2012-02-27 07:49:19 | [diff] [blame] | 27 | When the merge resolves as a fast-forward, only update the branch |
| 28 | pointer, without creating a merge commit. This is the default |
| 29 | behavior. |
| 30 | |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 31 | --no-ff:: |
Junio C Hamano | f54f08e | 2012-02-27 07:49:19 | [diff] [blame] | 32 | Create a merge commit even when the merge resolves as a |
| 33 | fast-forward. |
| 34 | |
| 35 | --ff-only:: |
| 36 | Refuse to merge and exit with a non-zero status unless the |
| 37 | current `HEAD` is already up-to-date or the merge can be |
| 38 | resolved as a fast-forward. |
Junio C Hamano | 6d76d61 | 2008-05-09 05:46:08 | [diff] [blame] | 39 | |
Junio C Hamano | 3b4609d | 2010-09-30 00:04:34 | [diff] [blame] | 40 | --log[=<n>]:: |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 41 | --no-log:: |
Junio C Hamano | 6d76d61 | 2008-05-09 05:46:08 | [diff] [blame] | 42 | In addition to branch names, populate the log message with |
Junio C Hamano | 3b4609d | 2010-09-30 00:04:34 | [diff] [blame] | 43 | one-line descriptions from at most <n> actual commits that are being |
| 44 | merged. See also linkgit:git-fmt-merge-msg[1]. |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 45 | + |
| 46 | With --no-log do not list one-line descriptions from the |
| 47 | actual commits being merged. |
Junio C Hamano | 6d76d61 | 2008-05-09 05:46:08 | [diff] [blame] | 48 | |
Junio C Hamano | 6d76d61 | 2008-05-09 05:46:08 | [diff] [blame] | 49 | |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 50 | --stat:: |
| 51 | -n:: |
| 52 | --no-stat:: |
| 53 | Show a diffstat at the end of the merge. The diffstat is also |
| 54 | controlled by the configuration option merge.stat. |
| 55 | + |
| 56 | With -n or --no-stat do not show a diffstat at the end of the |
| 57 | merge. |
Junio C Hamano | 1b50ce9 | 2007-10-03 12:05:53 | [diff] [blame] | 58 | |
Junio C Hamano | 3901ffb | 2006-06-26 23:46:53 | [diff] [blame] | 59 | --squash:: |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 60 | --no-squash:: |
Junio C Hamano | 3901ffb | 2006-06-26 23:46:53 | [diff] [blame] | 61 | Produce the working tree and index state as if a real |
Junio C Hamano | 9f10ed3 | 2009-05-26 08:38:52 | [diff] [blame] | 62 | merge happened (except for the merge information), |
| 63 | but do not actually make a commit or |
Junio C Hamano | 3901ffb | 2006-06-26 23:46:53 | [diff] [blame] | 64 | move the `HEAD`, nor record `$GIT_DIR/MERGE_HEAD` to |
| 65 | cause the next `git commit` command to create a merge |
| 66 | commit. This allows you to create a single commit on |
| 67 | top of the current branch whose effect is the same as |
| 68 | merging another branch (or more in case of an octopus). |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 69 | + |
| 70 | With --no-squash perform the merge and commit the result. This |
| 71 | option can be used to override --squash. |
Junio C Hamano | 1b50ce9 | 2007-10-03 12:05:53 | [diff] [blame] | 72 | |
Junio C Hamano | eb41599 | 2008-06-08 22:49:47 | [diff] [blame] | 73 | -s <strategy>:: |
| 74 | --strategy=<strategy>:: |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 75 | Use the given merge strategy; can be supplied more than |
| 76 | once to specify them in the order they should be tried. |
| 77 | If there is no `-s` option, a built-in list of strategies |
Junio C Hamano | 1aa40d2 | 2010-01-21 17:46:43 | [diff] [blame] | 78 | is used instead ('git merge-recursive' when merging a single |
| 79 | head, 'git merge-octopus' otherwise). |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 80 | |
Junio C Hamano | b04bb3f | 2010-04-14 14:07:36 | [diff] [blame] | 81 | -X <option>:: |
| 82 | --strategy-option=<option>:: |
| 83 | Pass merge strategy specific option through to the merge |
| 84 | strategy. |
| 85 | |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 86 | --summary:: |
| 87 | --no-summary:: |
| 88 | Synonyms to --stat and --no-stat; these are deprecated and will be |
| 89 | removed in the future. |
| 90 | |
Junio C Hamano | ea90ab3 | 2010-03-15 20:32:55 | [diff] [blame] | 91 | ifndef::git-pull[] |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 92 | -q:: |
| 93 | --quiet:: |
Junio C Hamano | d2c978f | 2011-03-20 19:42:22 | [diff] [blame] | 94 | Operate quietly. Implies --no-progress. |
Junio C Hamano | c21ab05 | 2009-10-31 04:03:55 | [diff] [blame] | 95 | |
| 96 | -v:: |
| 97 | --verbose:: |
| 98 | Be verbose. |
Junio C Hamano | d2c978f | 2011-03-20 19:42:22 | [diff] [blame] | 99 | |
| 100 | --progress:: |
| 101 | --no-progress:: |
| 102 | Turn progress on/off explicitly. If neither is specified, |
| 103 | progress is shown if standard error is connected to a terminal. |
| 104 | Note that not all merge strategies may support progress |
| 105 | reporting. |
| 106 | |
Junio C Hamano | ea90ab3 | 2010-03-15 20:32:55 | [diff] [blame] | 107 | endif::git-pull[] |