OSDN Git Service

Add Git official document to help
[tortoisegit/TortoiseGitJp.git] / doc / source / en / TortoiseGit / git_doc / git-cherry.html.xml
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\r
3 \r
4 <article lang="en" id="git-cherry(1)">\r
5 <articleinfo>\r
6     <title>git-cherry(1)</title>\r
7         <indexterm>\r
8                 <primary>git-cherry(1)</primary>\r
9         </indexterm>\r
10 </articleinfo>\r
11 <simplesect id="_name">\r
12 <title>NAME</title>\r
13 <simpara>git-cherry - Find commits not merged upstream</simpara>\r
14 </simplesect>\r
15 <simplesect id="_synopsis">\r
16 <title>SYNOPSIS</title>\r
17 <simpara><emphasis>git cherry</emphasis> [-v] [&lt;upstream&gt; [&lt;head&gt; [&lt;limit&gt;]]]</simpara>\r
18 </simplesect>\r
19 <simplesect id="_description">\r
20 <title>DESCRIPTION</title>\r
21 <simpara>The changeset (or "diff") of each commit between the fork-point and &lt;head&gt;\r
22 is compared against each commit between the fork-point and &lt;upstream&gt;.\r
23 The commits are compared with their <emphasis>patch id</emphasis>, obtained from\r
24 the <emphasis>git-patch-id</emphasis> program.</simpara>\r
25 <simpara>Every commit that doesn&#8217;t exist in the &lt;upstream&gt; branch\r
26 has its id (sha1) reported, prefixed by a symbol.  The ones that have\r
27 equivalent change already\r
28 in the &lt;upstream&gt; branch are prefixed with a minus (-) sign, and those\r
29 that only exist in the &lt;head&gt; branch are prefixed with a plus (+) symbol:</simpara>\r
30 <literallayout class="monospaced">           __*__*__*__*__&gt; &lt;upstream&gt;\r
31           /\r
32 fork-point\r
33           \__+__+__-__+__+__-__+__&gt; &lt;head&gt;</literallayout>\r
34 <simpara>If a &lt;limit&gt; has been given then the commits along the &lt;head&gt; branch up\r
35 to and including &lt;limit&gt; are not reported:</simpara>\r
36 <literallayout class="monospaced">           __*__*__*__*__&gt; &lt;upstream&gt;\r
37           /\r
38 fork-point\r
39           \__*__*__&lt;limit&gt;__-__+__&gt; &lt;head&gt;</literallayout>\r
40 <simpara>Because <emphasis>git-cherry</emphasis> compares the changeset rather than the commit id\r
41 (sha1), you can use <emphasis>git-cherry</emphasis> to find out if a commit you made locally\r
42 has been applied &lt;upstream&gt; under a different commit id.  For example,\r
43 this will happen if you&#8217;re feeding patches &lt;upstream&gt; via email rather\r
44 than pushing or pulling commits directly.</simpara>\r
45 </simplesect>\r
46 <simplesect id="_options">\r
47 <title>OPTIONS</title>\r
48 <variablelist>\r
49 <varlistentry>\r
50 <term>\r
51 -v\r
52 </term>\r
53 <listitem>\r
54 <simpara>\r
55         Verbose.\r
56 </simpara>\r
57 </listitem>\r
58 </varlistentry>\r
59 <varlistentry>\r
60 <term>\r
61 &lt;upstream&gt;\r
62 </term>\r
63 <listitem>\r
64 <simpara>\r
65         Upstream branch to compare against.\r
66         Defaults to the first tracked remote branch, if available.\r
67 </simpara>\r
68 </listitem>\r
69 </varlistentry>\r
70 <varlistentry>\r
71 <term>\r
72 &lt;head&gt;\r
73 </term>\r
74 <listitem>\r
75 <simpara>\r
76         Working branch; defaults to HEAD.\r
77 </simpara>\r
78 </listitem>\r
79 </varlistentry>\r
80 <varlistentry>\r
81 <term>\r
82 &lt;limit&gt;\r
83 </term>\r
84 <listitem>\r
85 <simpara>\r
86         Do not report commits up to (and including) limit.\r
87 </simpara>\r
88 </listitem>\r
89 </varlistentry>\r
90 </variablelist>\r
91 </simplesect>\r
92 <simplesect id="_see_also">\r
93 <title>SEE ALSO</title>\r
94 <simpara><xref linkend="git-patch-id(1)"/></simpara>\r
95 </simplesect>\r
96 <simplesect id="_author">\r
97 <title>Author</title>\r
98 <simpara>Written by Junio C Hamano &lt;<ulink url="mailto:gitster@pobox.com">gitster@pobox.com</ulink>&gt;</simpara>\r
99 </simplesect>\r
100 <simplesect id="_documentation">\r
101 <title>Documentation</title>\r
102 <simpara>Documentation by Junio C Hamano and the git-list &lt;<ulink url="mailto:git@vger.kernel.org">git@vger.kernel.org</ulink>&gt;.</simpara>\r
103 </simplesect>\r
104 <simplesect id="_git">\r
105 <title>GIT</title>\r
106 <simpara>Part of the <xref linkend="git(1)"/> suite</simpara>\r
107 </simplesect>\r
108 </article>\r