From b617cedbb6c49f3dd35cddbe87dfe9c701182c32 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Tue, 28 Nov 2006 02:22:45 +0000 Subject: [PATCH] Autogenerated man pages for v1.4.4.1-gf0df --- man1/git-diff-files.1 | 71 ++---------------------------------------- man1/git-diff-index.1 | 71 ++---------------------------------------- man1/git-diff-stages.1 | 71 ++---------------------------------------- man1/git-diff-tree.1 | 71 ++---------------------------------------- man7/git.7 | 50 +++++++++++++++++++++++++---- 5 files changed, 56 insertions(+), 278 deletions(-) diff --git a/man1/git-diff-files.1 b/man1/git-diff-files.1 index 77cf86a39..a2f3a6575 100755 --- a/man1/git-diff-files.1 +++ b/man1/git-diff-files.1 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT\-DIFF\-FILES" "1" "10/27/2006" "" "" +.TH "GIT\-DIFF\-FILES" "1" "11/28/2006" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -218,74 +218,9 @@ Example: When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively. .sp .SH "GENERATING PATCHES WITH \-P" -When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR option, they do not produce the output described above; instead they produce a patch file. +When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR 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. .sp -The patch generation can be customized at two levels. -.sp -.TP 3 -1. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is not set, these commands internally invoke "diff" like this: -.sp -.nf -diff \-L a/ \-L b/ \-pu -.fi -For added files, -/dev/null -is used for . For removed files, -/dev/null -is used for -.sp -The "diff" formatting options can be customized via the environment variable -\fIGIT_DIFF_OPTS\fR. For example, if you prefer context diff: -.sp -.nf -GIT_DIFF_OPTS=\-c git\-diff\-index \-p HEAD -.fi -.TP -2. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is set, the program named by it is called, instead of the diff invocation described above. -.sp -For a path that is added, removed, or modified, -\fIGIT_EXTERNAL_DIFF\fR -is called with 7 parameters: -.sp -.nf -path old\-file old\-hex old\-mode new\-file new\-hex new\-mode -.fi -where: -\-file - -are files GIT_EXTERNAL_DIFF can use to read the contents of , - -\-hex - -are the 40\-hexdigit SHA1 hashes, - -\-mode - -are the octal representation of the file modes. - -The file parameters can point at the user's working file (e.g. -new\-file -in "git\-diff\-files"), -/dev/null -(e.g. -old\-file -when a new file is added), or a temporary file (e.g. -old\-file -in the index). -\fIGIT_EXTERNAL_DIFF\fR -should not worry about unlinking the temporary file \-\-\- it is removed when -\fIGIT_EXTERNAL_DIFF\fR -exits. -For a path that is unmerged, \fIGIT_EXTERNAL_DIFF\fR is called with 1 parameter, . -.sp -.SH "GIT SPECIFIC EXTENSION TO DIFF FORMAT" -What \-p option produces is slightly different from the traditional diff format. +What the \-p option produces is slightly different from the traditional diff format. .sp .TP 3 1. diff --git a/man1/git-diff-index.1 b/man1/git-diff-index.1 index 828b6b10d..650bfa01d 100755 --- a/man1/git-diff-index.1 +++ b/man1/git-diff-index.1 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT\-DIFF\-INDEX" "1" "11/03/2006" "" "" +.TH "GIT\-DIFF\-INDEX" "1" "11/28/2006" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -214,74 +214,9 @@ Example: When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively. .sp .SH "GENERATING PATCHES WITH \-P" -When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR option, they do not produce the output described above; instead they produce a patch file. +When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR 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. .sp -The patch generation can be customized at two levels. -.sp -.TP 3 -1. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is not set, these commands internally invoke "diff" like this: -.sp -.nf -diff \-L a/ \-L b/ \-pu -.fi -For added files, -/dev/null -is used for . For removed files, -/dev/null -is used for -.sp -The "diff" formatting options can be customized via the environment variable -\fIGIT_DIFF_OPTS\fR. For example, if you prefer context diff: -.sp -.nf -GIT_DIFF_OPTS=\-c git\-diff\-index \-p HEAD -.fi -.TP -2. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is set, the program named by it is called, instead of the diff invocation described above. -.sp -For a path that is added, removed, or modified, -\fIGIT_EXTERNAL_DIFF\fR -is called with 7 parameters: -.sp -.nf -path old\-file old\-hex old\-mode new\-file new\-hex new\-mode -.fi -where: -\-file - -are files GIT_EXTERNAL_DIFF can use to read the contents of , - -\-hex - -are the 40\-hexdigit SHA1 hashes, - -\-mode - -are the octal representation of the file modes. - -The file parameters can point at the user's working file (e.g. -new\-file -in "git\-diff\-files"), -/dev/null -(e.g. -old\-file -when a new file is added), or a temporary file (e.g. -old\-file -in the index). -\fIGIT_EXTERNAL_DIFF\fR -should not worry about unlinking the temporary file \-\-\- it is removed when -\fIGIT_EXTERNAL_DIFF\fR -exits. -For a path that is unmerged, \fIGIT_EXTERNAL_DIFF\fR is called with 1 parameter, . -.sp -.SH "GIT SPECIFIC EXTENSION TO DIFF FORMAT" -What \-p option produces is slightly different from the traditional diff format. +What the \-p option produces is slightly different from the traditional diff format. .sp .TP 3 1. diff --git a/man1/git-diff-stages.1 b/man1/git-diff-stages.1 index 764bfe915..87e8e1e29 100755 --- a/man1/git-diff-stages.1 +++ b/man1/git-diff-stages.1 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT\-DIFF\-STAGES" "1" "10/27/2006" "" "" +.TH "GIT\-DIFF\-STAGES" "1" "11/28/2006" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -208,74 +208,9 @@ Example: When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively. .sp .SH "GENERATING PATCHES WITH \-P" -When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR option, they do not produce the output described above; instead they produce a patch file. +When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR 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. .sp -The patch generation can be customized at two levels. -.sp -.TP 3 -1. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is not set, these commands internally invoke "diff" like this: -.sp -.nf -diff \-L a/ \-L b/ \-pu -.fi -For added files, -/dev/null -is used for . For removed files, -/dev/null -is used for -.sp -The "diff" formatting options can be customized via the environment variable -\fIGIT_DIFF_OPTS\fR. For example, if you prefer context diff: -.sp -.nf -GIT_DIFF_OPTS=\-c git\-diff\-index \-p HEAD -.fi -.TP -2. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is set, the program named by it is called, instead of the diff invocation described above. -.sp -For a path that is added, removed, or modified, -\fIGIT_EXTERNAL_DIFF\fR -is called with 7 parameters: -.sp -.nf -path old\-file old\-hex old\-mode new\-file new\-hex new\-mode -.fi -where: -\-file - -are files GIT_EXTERNAL_DIFF can use to read the contents of , - -\-hex - -are the 40\-hexdigit SHA1 hashes, - -\-mode - -are the octal representation of the file modes. - -The file parameters can point at the user's working file (e.g. -new\-file -in "git\-diff\-files"), -/dev/null -(e.g. -old\-file -when a new file is added), or a temporary file (e.g. -old\-file -in the index). -\fIGIT_EXTERNAL_DIFF\fR -should not worry about unlinking the temporary file \-\-\- it is removed when -\fIGIT_EXTERNAL_DIFF\fR -exits. -For a path that is unmerged, \fIGIT_EXTERNAL_DIFF\fR is called with 1 parameter, . -.sp -.SH "GIT SPECIFIC EXTENSION TO DIFF FORMAT" -What \-p option produces is slightly different from the traditional diff format. +What the \-p option produces is slightly different from the traditional diff format. .sp .TP 3 1. diff --git a/man1/git-diff-tree.1 b/man1/git-diff-tree.1 index 850882c65..2c3294b43 100755 --- a/man1/git-diff-tree.1 +++ b/man1/git-diff-tree.1 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT\-DIFF\-TREE" "1" "11/23/2006" "" "" +.TH "GIT\-DIFF\-TREE" "1" "11/28/2006" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -431,74 +431,9 @@ Example: When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively. .sp .SH "GENERATING PATCHES WITH \-P" -When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR option, they do not produce the output described above; instead they produce a patch file. +When "git\-diff\-index", "git\-diff\-tree", or "git\-diff\-files" are run with a \fI\-p\fR 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. .sp -The patch generation can be customized at two levels. -.sp -.TP 3 -1. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is not set, these commands internally invoke "diff" like this: -.sp -.nf -diff \-L a/ \-L b/ \-pu -.fi -For added files, -/dev/null -is used for . For removed files, -/dev/null -is used for -.sp -The "diff" formatting options can be customized via the environment variable -\fIGIT_DIFF_OPTS\fR. For example, if you prefer context diff: -.sp -.nf -GIT_DIFF_OPTS=\-c git\-diff\-index \-p HEAD -.fi -.TP -2. -When the environment variable -\fIGIT_EXTERNAL_DIFF\fR -is set, the program named by it is called, instead of the diff invocation described above. -.sp -For a path that is added, removed, or modified, -\fIGIT_EXTERNAL_DIFF\fR -is called with 7 parameters: -.sp -.nf -path old\-file old\-hex old\-mode new\-file new\-hex new\-mode -.fi -where: -\-file - -are files GIT_EXTERNAL_DIFF can use to read the contents of , - -\-hex - -are the 40\-hexdigit SHA1 hashes, - -\-mode - -are the octal representation of the file modes. - -The file parameters can point at the user's working file (e.g. -new\-file -in "git\-diff\-files"), -/dev/null -(e.g. -old\-file -when a new file is added), or a temporary file (e.g. -old\-file -in the index). -\fIGIT_EXTERNAL_DIFF\fR -should not worry about unlinking the temporary file \-\-\- it is removed when -\fIGIT_EXTERNAL_DIFF\fR -exits. -For a path that is unmerged, \fIGIT_EXTERNAL_DIFF\fR is called with 1 parameter, . -.sp -.SH "GIT SPECIFIC EXTENSION TO DIFF FORMAT" -What \-p option produces is slightly different from the traditional diff format. +What the \-p option produces is slightly different from the traditional diff format. .sp .TP 3 1. diff --git a/man7/git.7 b/man7/git.7 index e812f608c..8df4203d2 100755 --- a/man7/git.7 +++ b/man7/git.7 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT" "7" "11/18/2006" "" "" +.TH "GIT" "7" "11/28/2006" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -573,11 +573,49 @@ see \fBgit\-commit\-tree\fR(1) .SS "git Diffs" .TP -\fIGIT_DIFF_OPTS\fR , \fIGIT_EXTERNAL_DIFF\fR -see the "generating patches" section in : -\fBgit\-diff\-index\fR(1); -\fBgit\-diff\-files\fR(1); -\fBgit\-diff\-tree\fR(1) +\fIGIT_DIFF_OPTS\fR +Only valid setting is "\-\-unified=??" or "\-u??" to set the number of context lines shown when a unified diff is created. This takes precedence over any "\-U" or "\-\-unified" option value passed on the git diff command line. +.TP +\fIGIT_EXTERNAL_DIFF\fR +When the environment variable +\fIGIT_EXTERNAL_DIFF\fR +is set, the program named by it is called, instead of the diff invocation described above. For a path that is added, removed, or modified, +\fIGIT_EXTERNAL_DIFF\fR +is called with 7 parameters: +.sp +.nf +path old\-file old\-hex old\-mode new\-file new\-hex new\-mode +.fi +where: +\-file + +are files GIT_EXTERNAL_DIFF can use to read the contents of , + +\-hex + +are the 40\-hexdigit SHA1 hashes, + +\-mode + +are the octal representation of the file modes. + +The file parameters can point at the user's working file (e.g. +new\-file +in "git\-diff\-files"), +/dev/null +(e.g. +old\-file +when a new file is added), or a temporary file (e.g. +old\-file +in the index). +\fIGIT_EXTERNAL_DIFF\fR +should not worry about unlinking the temporary file \-\-\- it is removed when +\fIGIT_EXTERNAL_DIFF\fR +exits. +.sp +For a path that is unmerged, +\fIGIT_EXTERNAL_DIFF\fR +is called with 1 parameter, . .SS "other" .TP \fIGIT_PAGER\fR -- 2.26.2