11b20ba1bf1f96bdc698453a462b831ec7ee51da
[git.git] / man1 / git-cherry-pick.1
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "GIT-CHERRY-PICK" 1 "" "" ""
21 .SH NAME
22 git-cherry-pick \- Apply the change introduced by an existing commit.
23 .SH "SYNOPSIS"
24
25
26 git\-cherry\-pick [\-\-edit] [\-n] [\-r] <commit>
27
28 .SH "DESCRIPTION"
29
30
31 Given one existing commit, apply the change the patch introduces, and record a new commit that records it\&. This requires your working tree to be clean (no modifications from the HEAD commit)\&.
32
33 .SH "OPTIONS"
34
35 .TP
36 <commit>
37 Commit to cherry\-pick\&.
38
39 .TP
40 \-e|\-\-edit
41 With this option, git\-cherry\-pick will let you edit the commit message prior committing\&.
42
43 .TP
44 \-r|\-\-replay
45 Usually the command appends which commit was cherry\-picked after the original commit message when making a commit\&. This option, \-\-replay, causes it to use the original commit message intact\&. This is useful when you are reordering the patches in your private tree before publishing\&.
46
47 .TP
48 \-n|\-\-no\-commit
49 Usually the command automatically creates a commit with a commit log message stating which commit was cherry\-picked\&. This flag applies the change necessary to cherry\-pick the named commit to your working tree, but does not make the commit\&. In addition, when this option is used, your working tree does not have to match the HEAD commit\&. The cherry\-pick is done against the beginning state of your working tree\&.
50
51 This is useful when cherry\-picking more than one commits' effect to your working tree in a row\&.
52
53 .SH "AUTHOR"
54
55
56 Written by Junio C Hamano <junkio@cox\&.net>
57
58 .SH "DOCUMENTATION"
59
60
61 Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
62
63 .SH "GIT"
64
65
66 Part of the \fBgit\fR(7) suite
67