OSDN Git Service

Add Git official document to help
[tortoisegit/TortoiseGitJp.git] / doc / source / en / TortoiseGit / git_doc / git-patch-id.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-patch-id(1)">\r
5 <articleinfo>\r
6     <title>git-patch-id(1)</title>\r
7         <indexterm>\r
8                 <primary>git-patch-id(1)</primary>\r
9         </indexterm>\r
10 </articleinfo>\r
11 <simplesect id="_name">\r
12 <title>NAME</title>\r
13 <simpara>git-patch-id - Compute unique ID for a patch</simpara>\r
14 </simplesect>\r
15 <simplesect id="_synopsis">\r
16 <title>SYNOPSIS</title>\r
17 <simpara><emphasis>git patch-id</emphasis> &lt; &lt;patch&gt;</simpara>\r
18 </simplesect>\r
19 <simplesect id="_description">\r
20 <title>DESCRIPTION</title>\r
21 <simpara>A "patch ID" is nothing but a SHA1 of the diff associated with a patch, with\r
22 whitespace and line numbers ignored.  As such, it&#8217;s "reasonably stable", but at\r
23 the same time also reasonably unique, i.e., two patches that have the same "patch\r
24 ID" are almost guaranteed to be the same thing.</simpara>\r
25 <simpara>IOW, you can use this thing to look for likely duplicate commits.</simpara>\r
26 <simpara>When dealing with <emphasis>git-diff-tree</emphasis> output, it takes advantage of\r
27 the fact that the patch is prefixed with the object name of the\r
28 commit, and outputs two 40-byte hexadecimal string.  The first\r
29 string is the patch ID, and the second string is the commit ID.\r
30 This can be used to make a mapping from patch ID to commit ID.</simpara>\r
31 </simplesect>\r
32 <simplesect id="_options">\r
33 <title>OPTIONS</title>\r
34 <variablelist>\r
35 <varlistentry>\r
36 <term>\r
37 &lt;patch&gt;\r
38 </term>\r
39 <listitem>\r
40 <simpara>\r
41         The diff to create the ID of.\r
42 </simpara>\r
43 </listitem>\r
44 </varlistentry>\r
45 </variablelist>\r
46 </simplesect>\r
47 <simplesect id="_author">\r
48 <title>Author</title>\r
49 <simpara>Written by Linus Torvalds &lt;<ulink url="mailto:torvalds@osdl.org">torvalds@osdl.org</ulink>&gt;</simpara>\r
50 </simplesect>\r
51 <simplesect id="_documentation">\r
52 <title>Documentation</title>\r
53 <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
54 </simplesect>\r
55 <simplesect id="_git">\r
56 <title>GIT</title>\r
57 <simpara>Part of the <xref linkend="git(1)"/> suite</simpara>\r
58 </simplesect>\r
59 </article>\r