diff options
Diffstat (limited to 'Documentation/git-patch-id.txt')
-rw-r--r-- | Documentation/git-patch-id.txt | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/Documentation/git-patch-id.txt b/Documentation/git-patch-id.txt new file mode 100644 index 0000000000..312c3b1fe5 --- /dev/null +++ b/Documentation/git-patch-id.txt @@ -0,0 +1,35 @@ +git-patch-id(1) +=============== + +NAME +---- +git-patch-id - Compute unique ID for a patch + +SYNOPSIS +-------- +[verse] +'git patch-id' < <patch> + +DESCRIPTION +----------- +A "patch ID" is nothing but a SHA-1 of the diff associated with a patch, with +whitespace and line numbers ignored. As such, it's "reasonably stable", but at +the same time also reasonably unique, i.e., two patches that have the same "patch +ID" are almost guaranteed to be the same thing. + +IOW, you can use this thing to look for likely duplicate commits. + +When dealing with 'git diff-tree' output, it takes advantage of +the fact that the patch is prefixed with the object name of the +commit, and outputs two 40-byte hexadecimal strings. The first +string is the patch ID, and the second string is the commit ID. +This can be used to make a mapping from patch ID to commit ID. + +OPTIONS +------- +<patch>:: + The diff to create the ID of. + +GIT +--- +Part of the linkgit:git[1] suite |