diff options
Diffstat (limited to 'third_party/git/Documentation/diff-generate-patch.txt')
| -rw-r--r-- | third_party/git/Documentation/diff-generate-patch.txt | 32 |
1 files changed, 14 insertions, 18 deletions
diff --git a/third_party/git/Documentation/diff-generate-patch.txt b/third_party/git/Documentation/diff-generate-patch.txt index e8ed6470fb3a..f10ca410ad8a 100644 --- a/third_party/git/Documentation/diff-generate-patch.txt +++ b/third_party/git/Documentation/diff-generate-patch.txt @@ -1,15 +1,11 @@ -Generating patch text with -p ------------------------------ - -Running -linkgit:git-diff[1], -linkgit:git-log[1], -linkgit:git-show[1], -linkgit:git-diff-index[1], -linkgit:git-diff-tree[1], or -linkgit:git-diff-files[1] -with the `-p` option produces patch text. -You can customize the creation of patch text via the +Generating patches with -p +-------------------------- + +When "git-diff-index", "git-diff-tree", or "git-diff-files" are run +with a `-p` option, "git diff" without the `--raw` option, or +"git log" with the "-p" option, they +do not produce the output described above; instead they produce a +patch file. You can customize the creation of such patches via the `GIT_EXTERNAL_DIFF` and the `GIT_DIFF_OPTS` environment variables. What the -p option produces is slightly different from the traditional @@ -53,7 +49,7 @@ similarity index value of 100% is thus reserved for two equal files, while 100% dissimilarity means that no line from the old file made it into the new one. + -The index line includes the blob object names before and after the change. +The index line includes the SHA-1 checksum before and after the change. The <mode> is included if the file mode does not change; otherwise, separate lines indicate the old and the new mode. @@ -74,7 +70,7 @@ separate lines indicate the old and the new mode. rename to a -Combined diff format +combined diff format -------------------- Any diff-generating command can take the `-c` or `--cc` option to @@ -84,7 +80,7 @@ linkgit:git-show[1]. Note also that you can give the `-m` option to any of these commands to force generation of diffs with individual parents of a merge. -A "combined diff" format looks like this: +A 'combined diff' format looks like this: ------------ diff --combined describe.c @@ -117,11 +113,11 @@ index fabadb8,cc95eb0..4866510 ------------ 1. It is preceded with a "git diff" header, that looks like - this (when the `-c` option is used): + this (when `-c` option is used): diff --combined file + -or like this (when the `--cc` option is used): +or like this (when `--cc` option is used): diff --cc file @@ -164,7 +160,7 @@ parents. 4. Chunk header format is modified to prevent people from accidentally feeding it to `patch -p1`. Combined diff format was created for review of merge commit changes, and was not - meant to be applied. The change is similar to the change in the + meant for apply. The change is similar to the change in the extended 'index' header: @@@ <from-file-range> <from-file-range> <to-file-range> @@@ |