2005-09-08 00:26:23 +00:00
|
|
|
git-cherry-pick(1)
|
|
|
|
==================
|
2005-08-28 10:01:09 +00:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2010-06-02 05:58:40 +00:00
|
|
|
git-cherry-pick - Apply the changes introduced by some existing commits
|
2005-08-28 10:01:09 +00:00
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2010-06-02 05:58:40 +00:00
|
|
|
'git cherry-pick' [--edit] [-n] [-m parent-number] [-s] [-x] [--ff] <commit>...
|
2005-08-28 10:01:09 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2010-06-02 05:58:40 +00:00
|
|
|
|
|
|
|
Given one or more existing commits, apply the change each one
|
|
|
|
introduces, recording a new commit for each. This requires your
|
|
|
|
working tree to be clean (no modifications from the HEAD commit).
|
2005-08-28 10:01:09 +00:00
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
2010-06-02 05:58:40 +00:00
|
|
|
<commit>...::
|
|
|
|
Commits to cherry-pick.
|
2010-07-05 16:11:41 +00:00
|
|
|
For a more complete list of ways to spell commits, see
|
|
|
|
linkgit:gitrevisions[1].
|
2010-06-02 05:58:40 +00:00
|
|
|
Sets of commits can be passed but no traversal is done by
|
|
|
|
default, as if the '--no-walk' option was specified, see
|
|
|
|
linkgit:git-rev-list[1].
|
2005-08-28 10:01:09 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-e::
|
|
|
|
--edit::
|
2010-01-09 23:33:00 +00:00
|
|
|
With this option, 'git cherry-pick' will let you edit the commit
|
2008-01-19 15:23:32 +00:00
|
|
|
message prior to committing.
|
2005-11-26 22:12:44 +00:00
|
|
|
|
2006-10-06 00:54:14 +00:00
|
|
|
-x::
|
2007-10-21 09:36:19 +00:00
|
|
|
When recording the commit, append to the original commit
|
|
|
|
message a note that indicates which commit this change
|
|
|
|
was cherry-picked from. Append the note only for cherry
|
|
|
|
picks without conflicts. Do not use this option if
|
|
|
|
you are cherry-picking from your private branch because
|
|
|
|
the information is useless to the recipient. If on the
|
2006-10-06 00:54:14 +00:00
|
|
|
other hand you are cherry-picking between two publicly
|
|
|
|
visible branches (e.g. backporting a fix to a
|
|
|
|
maintenance branch for an older release from a
|
|
|
|
development branch), adding this information can be
|
|
|
|
useful.
|
|
|
|
|
2007-04-19 03:03:26 +00:00
|
|
|
-r::
|
2006-10-06 00:54:14 +00:00
|
|
|
It used to be that the command defaulted to do `-x`
|
|
|
|
described above, and `-r` was to disable it. Now the
|
|
|
|
default is not to do `-x` so this option is a no-op.
|
2005-08-28 10:01:09 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-m parent-number::
|
|
|
|
--mainline parent-number::
|
2008-02-29 17:00:38 +00:00
|
|
|
Usually you cannot cherry-pick a merge because you do not know which
|
2007-10-23 20:33:26 +00:00
|
|
|
side of the merge should be considered the mainline. This
|
|
|
|
option specifies the parent number (starting from 1) of
|
|
|
|
the mainline and allows cherry-pick to replay the change
|
|
|
|
relative to the specified parent.
|
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-n::
|
|
|
|
--no-commit::
|
2010-06-02 05:58:40 +00:00
|
|
|
Usually the command automatically creates a sequence of commits.
|
|
|
|
This flag applies the changes necessary to cherry-pick
|
|
|
|
each named commit to your working tree and the index,
|
|
|
|
without making any commit. In addition, when this
|
2008-11-20 05:11:42 +00:00
|
|
|
option is used, your index does not have to match the
|
|
|
|
HEAD commit. The cherry-pick is done against the
|
2008-07-16 12:35:22 +00:00
|
|
|
beginning state of your index.
|
2005-10-03 17:16:30 +00:00
|
|
|
+
|
|
|
|
This is useful when cherry-picking more than one commits'
|
2008-07-16 12:35:22 +00:00
|
|
|
effect to your index in a row.
|
2005-08-28 10:01:09 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-s::
|
|
|
|
--signoff::
|
2008-04-26 20:14:28 +00:00
|
|
|
Add Signed-off-by line at the end of the commit message.
|
|
|
|
|
2010-03-06 20:34:44 +00:00
|
|
|
--ff::
|
|
|
|
If the current HEAD is the same as the parent of the
|
|
|
|
cherry-pick'ed commit, then a fast forward to this commit will
|
|
|
|
be performed.
|
2005-08-28 10:01:09 +00:00
|
|
|
|
2010-06-02 05:58:40 +00:00
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
git cherry-pick master::
|
|
|
|
|
|
|
|
Apply the change introduced by the commit at the tip of the
|
|
|
|
master branch and create a new commit with this change.
|
|
|
|
|
|
|
|
git cherry-pick ..master::
|
|
|
|
git cherry-pick ^HEAD master::
|
|
|
|
|
|
|
|
Apply the changes introduced by all commits that are ancestors
|
|
|
|
of master but not of HEAD to produce new commits.
|
|
|
|
|
|
|
|
git cherry-pick master\~4 master~2::
|
|
|
|
|
|
|
|
Apply the changes introduced by the fifth and third last
|
|
|
|
commits pointed to by master and create 2 new commits with
|
|
|
|
these changes.
|
|
|
|
|
|
|
|
git cherry-pick -n master~1 next::
|
|
|
|
|
|
|
|
Apply to the working tree and the index the changes introduced
|
|
|
|
by the second last commit pointed to by master and by the last
|
|
|
|
commit pointed to by next, but do not create any commit with
|
|
|
|
these changes.
|
|
|
|
|
|
|
|
git cherry-pick --ff ..next::
|
|
|
|
|
|
|
|
If history is linear and HEAD is an ancestor of next, update
|
|
|
|
the working tree and advance the HEAD pointer to match next.
|
|
|
|
Otherwise, apply the changes introduced by those commits that
|
|
|
|
are in next but not HEAD to the current branch, creating a new
|
|
|
|
commit for each new change.
|
|
|
|
|
2010-06-14 05:29:38 +00:00
|
|
|
git rev-list --reverse master \-- README | git cherry-pick -n --stdin::
|
|
|
|
|
|
|
|
Apply the changes introduced by all commits on the master
|
|
|
|
branch that touched README to the working tree and index,
|
|
|
|
so the result can be inspected and made into a single new
|
|
|
|
commit if suitable.
|
|
|
|
|
2005-08-28 10:01:09 +00:00
|
|
|
Author
|
|
|
|
------
|
2008-07-21 19:14:42 +00:00
|
|
|
Written by Junio C Hamano <gitster@pobox.com>
|
2005-08-28 10:01:09 +00:00
|
|
|
|
|
|
|
Documentation
|
|
|
|
--------------
|
|
|
|
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
|
|
|
|
|
2010-06-02 05:58:40 +00:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
|
|
|
linkgit:git-revert[1]
|
|
|
|
|
2005-08-28 10:01:09 +00:00
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|