Add Git official document to help

[tortoisegit/TortoiseGitJp.git] / doc / source / en / TortoiseGit / git_doc / git-patch-id.html.xml

diff --git a/doc/source/en/TortoiseGit/git_doc/git-patch-id.html.xml b/doc/source/en/TortoiseGit/git_doc/git-patch-id.html.xml
new file mode 100644 (file)
index 0000000..c9102f9
--- /dev/null
+++ b/doc/source/en/TortoiseGit/git_doc/git-patch-id.html.xml
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\r
+\r
+<article lang="en" id="git-patch-id(1)">\r
+<articleinfo>\r
+    <title>git-patch-id(1)</title>\r
+        <indexterm>\r
+                <primary>git-patch-id(1)</primary>\r
+        </indexterm>\r
+</articleinfo>\r
+<simplesect id="_name">\r
+<title>NAME</title>\r
+<simpara>git-patch-id - Compute unique ID for a patch</simpara>\r
+</simplesect>\r
+<simplesect id="_synopsis">\r
+<title>SYNOPSIS</title>\r
+<simpara><emphasis>git patch-id</emphasis> &lt; &lt;patch&gt;</simpara>\r
+</simplesect>\r
+<simplesect id="_description">\r
+<title>DESCRIPTION</title>\r
+<simpara>A "patch ID" is nothing but a SHA1 of the diff associated with a patch, with\r
+whitespace and line numbers ignored.  As such, it&#8217;s "reasonably stable", but at\r
+the same time also reasonably unique, i.e., two patches that have the same "patch\r
+ID" are almost guaranteed to be the same thing.</simpara>\r
+<simpara>IOW, you can use this thing to look for likely duplicate commits.</simpara>\r
+<simpara>When dealing with <emphasis>git-diff-tree</emphasis> output, it takes advantage of\r
+the fact that the patch is prefixed with the object name of the\r
+commit, and outputs two 40-byte hexadecimal string.  The first\r
+string is the patch ID, and the second string is the commit ID.\r
+This can be used to make a mapping from patch ID to commit ID.</simpara>\r
+</simplesect>\r
+<simplesect id="_options">\r
+<title>OPTIONS</title>\r
+<variablelist>\r
+<varlistentry>\r
+<term>\r
+&lt;patch&gt;\r
+</term>\r
+<listitem>\r
+<simpara>\r
+        The diff to create the ID of.\r
+</simpara>\r
+</listitem>\r
+</varlistentry>\r
+</variablelist>\r
+</simplesect>\r
+<simplesect id="_author">\r
+<title>Author</title>\r
+<simpara>Written by Linus Torvalds &lt;<ulink url="mailto:torvalds@osdl.org">torvalds@osdl.org</ulink>&gt;</simpara>\r
+</simplesect>\r
+<simplesect id="_documentation">\r
+<title>Documentation</title>\r
+<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
+</simplesect>\r
+<simplesect id="_git">\r
+<title>GIT</title>\r
+<simpara>Part of the <xref linkend="git(1)"/> suite</simpara>\r
+</simplesect>\r
+</article>\r