2009-10-23 03:25:20 +08:00
|
|
|
--commit::
|
|
|
|
|
--no-commit::
|
|
|
|
|
Perform the merge and commit the result. This option can
|
|
|
|
|
be used to override --no-commit.
|
|
|
|
|
+
|
|
|
|
|
With --no-commit perform the merge but pretend the merge
|
|
|
|
|
failed and do not autocommit, to give the user a chance to
|
|
|
|
|
inspect and further tweak the merge result before committing.
|
2005-11-07 13:30:56 +08:00
|
|
|
|
2009-10-23 03:25:20 +08:00
|
|
|
--ff::
|
|
|
|
|
--no-ff::
|
|
|
|
|
Do not generate a merge commit if the merge resolved as
|
|
|
|
|
a fast-forward, only update the branch pointer. This is
|
|
|
|
|
the default behavior of git-merge.
|
|
|
|
|
+
|
|
|
|
|
With --no-ff Generate a merge commit even if the merge
|
|
|
|
|
resolved as a fast-forward.
|
2008-04-06 09:23:43 +08:00
|
|
|
|
2008-04-06 09:23:46 +08:00
|
|
|
--log::
|
2009-10-23 03:25:20 +08:00
|
|
|
--no-log::
|
2008-04-06 09:23:46 +08:00
|
|
|
In addition to branch names, populate the log message with
|
|
|
|
|
one-line descriptions from the actual commits that are being
|
|
|
|
|
merged.
|
2009-10-23 03:25:20 +08:00
|
|
|
+
|
|
|
|
|
With --no-log do not list one-line descriptions from the
|
|
|
|
|
actual commits being merged.
|
2008-04-06 09:23:46 +08:00
|
|
|
|
2005-11-07 13:30:56 +08:00
|
|
|
|
2009-10-23 03:25:20 +08:00
|
|
|
--stat::
|
|
|
|
|
-n::
|
|
|
|
|
--no-stat::
|
|
|
|
|
Show a diffstat at the end of the merge. The diffstat is also
|
|
|
|
|
controlled by the configuration option merge.stat.
|
|
|
|
|
+
|
|
|
|
|
With -n or --no-stat do not show a diffstat at the end of the
|
|
|
|
|
merge.
|
2007-09-24 06:51:44 +08:00
|
|
|
|
git-merge --squash
Some people tend to do many little commits on a topic branch,
recording all the trials and errors, and when the topic is
reasonably cooked well, would want to record the net effect of
the series as one commit on top of the mainline, removing the
cruft from the history. The topic is then abandoned or forked
off again from that point at the mainline.
The barebone porcelainish that comes with core git tools does
not officially support such operation, but you can fake it by
using "git pull --no-merge" when such a topic branch is not a
strict superset of the mainline, like this:
git checkout mainline
git pull --no-commit . that-topic-branch
: fix conflicts if any
rm -f .git/MERGE_HEAD
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
This however does not work when the topic branch is a fast
forward of the mainline, because normal "git pull" will never
create a merge commit in such a case, and there is nothing
special --no-commit could do to begin with.
This patch introduces a new option, --squash, to support such a
workflow officially in both fast-forward case and true merge
case. The user-level operation would be the same in both cases:
git checkout mainline
git pull --squash . that-topic-branch
: fix conflicts if any -- naturally, there would be
: no conflict if fast forward.
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
When the current branch is already up-to-date with respect to
the other branch, there truly is nothing to do, so the new
option does not have any effect.
This was brought up in #git IRC channel recently.
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-06-23 16:37:02 +08:00
|
|
|
--squash::
|
2009-10-23 03:25:20 +08:00
|
|
|
--no-squash::
|
git-merge --squash
Some people tend to do many little commits on a topic branch,
recording all the trials and errors, and when the topic is
reasonably cooked well, would want to record the net effect of
the series as one commit on top of the mainline, removing the
cruft from the history. The topic is then abandoned or forked
off again from that point at the mainline.
The barebone porcelainish that comes with core git tools does
not officially support such operation, but you can fake it by
using "git pull --no-merge" when such a topic branch is not a
strict superset of the mainline, like this:
git checkout mainline
git pull --no-commit . that-topic-branch
: fix conflicts if any
rm -f .git/MERGE_HEAD
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
This however does not work when the topic branch is a fast
forward of the mainline, because normal "git pull" will never
create a merge commit in such a case, and there is nothing
special --no-commit could do to begin with.
This patch introduces a new option, --squash, to support such a
workflow officially in both fast-forward case and true merge
case. The user-level operation would be the same in both cases:
git checkout mainline
git pull --squash . that-topic-branch
: fix conflicts if any -- naturally, there would be
: no conflict if fast forward.
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
When the current branch is already up-to-date with respect to
the other branch, there truly is nothing to do, so the new
option does not have any effect.
This was brought up in #git IRC channel recently.
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-06-23 16:37:02 +08:00
|
|
|
Produce the working tree and index state as if a real
|
2009-05-26 00:00:10 +08:00
|
|
|
merge happened (except for the merge information),
|
|
|
|
|
but do not actually make a commit or
|
git-merge --squash
Some people tend to do many little commits on a topic branch,
recording all the trials and errors, and when the topic is
reasonably cooked well, would want to record the net effect of
the series as one commit on top of the mainline, removing the
cruft from the history. The topic is then abandoned or forked
off again from that point at the mainline.
The barebone porcelainish that comes with core git tools does
not officially support such operation, but you can fake it by
using "git pull --no-merge" when such a topic branch is not a
strict superset of the mainline, like this:
git checkout mainline
git pull --no-commit . that-topic-branch
: fix conflicts if any
rm -f .git/MERGE_HEAD
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
This however does not work when the topic branch is a fast
forward of the mainline, because normal "git pull" will never
create a merge commit in such a case, and there is nothing
special --no-commit could do to begin with.
This patch introduces a new option, --squash, to support such a
workflow officially in both fast-forward case and true merge
case. The user-level operation would be the same in both cases:
git checkout mainline
git pull --squash . that-topic-branch
: fix conflicts if any -- naturally, there would be
: no conflict if fast forward.
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
When the current branch is already up-to-date with respect to
the other branch, there truly is nothing to do, so the new
option does not have any effect.
This was brought up in #git IRC channel recently.
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-06-23 16:37:02 +08:00
|
|
|
move the `HEAD`, nor record `$GIT_DIR/MERGE_HEAD` to
|
|
|
|
|
cause the next `git commit` command to create a merge
|
|
|
|
|
commit. This allows you to create a single commit on
|
|
|
|
|
top of the current branch whose effect is the same as
|
|
|
|
|
merging another branch (or more in case of an octopus).
|
2009-10-23 03:25:20 +08:00
|
|
|
+
|
|
|
|
|
With --no-squash perform the merge and commit the result. This
|
|
|
|
|
option can be used to override --squash.
|
2007-09-24 06:51:45 +08:00
|
|
|
|
2009-10-30 06:08:31 +08:00
|
|
|
--ff-only::
|
|
|
|
|
Refuse to merge and exit with a non-zero status unless the
|
|
|
|
|
current `HEAD` is already up-to-date or the merge can be
|
|
|
|
|
resolved as a fast-forward.
|
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
-s <strategy>::
|
|
|
|
|
--strategy=<strategy>::
|
2005-11-07 13:30:56 +08:00
|
|
|
Use the given merge strategy; can be supplied more than
|
|
|
|
|
once to specify them in the order they should be tried.
|
|
|
|
|
If there is no `-s` option, a built-in list of strategies
|
2010-01-10 07:33:00 +08:00
|
|
|
is used instead ('git merge-recursive' when merging a single
|
|
|
|
|
head, 'git merge-octopus' otherwise).
|
2009-10-23 03:25:20 +08:00
|
|
|
|
2010-04-13 00:28:13 +08:00
|
|
|
-X <option>::
|
|
|
|
|
--strategy-option=<option>::
|
|
|
|
|
Pass merge strategy specific option through to the merge
|
|
|
|
|
strategy.
|
|
|
|
|
|
2009-10-23 03:25:20 +08:00
|
|
|
--summary::
|
|
|
|
|
--no-summary::
|
|
|
|
|
Synonyms to --stat and --no-stat; these are deprecated and will be
|
|
|
|
|
removed in the future.
|
|
|
|
|
|
2010-02-24 20:50:21 +08:00
|
|
|
ifndef::git-pull[]
|
2009-10-23 03:25:20 +08:00
|
|
|
-q::
|
|
|
|
|
--quiet::
|
|
|
|
|
Operate quietly.
|
|
|
|
|
|
|
|
|
|
-v::
|
|
|
|
|
--verbose::
|
|
|
|
|
Be verbose.
|
2010-02-24 20:50:21 +08:00
|
|
|
endif::git-pull[]
|
