From: Junio C Hamano Date: Fri, 6 May 2005 20:17:13 +0000 (-0700) Subject: [PATCH] Document --stdin, -m, -s, and -v flags to git-diff-tree X-Git-Tag: v0.99~615 X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=5aad72f2bc1527e1fcdf460f0a36b0bcc4117b4a;p=git.git [PATCH] Document --stdin, -m, -s, and -v flags to git-diff-tree This updates the usage message string and Documentation/core-git.txt to describe the new flags added to the git-diff-tree command. Signed-off-by: Junio C Hamano Signed-off-by: Linus Torvalds --- diff --git a/Documentation/core-git.txt b/Documentation/core-git.txt index 1ccae4c09..8bd893197 100644 --- a/Documentation/core-git.txt +++ b/Documentation/core-git.txt @@ -352,7 +352,7 @@ special all-zero sha1. ################################################################ git-diff-tree - git-diff-tree [-p] [-r] [-z] []* + git-diff-tree [-p] [-r] [-z] [--stdin] [-m] [-s] [-v] []* Compares the content and mode of the blobs found via two tree objects. @@ -378,6 +378,34 @@ Note that git-diff-tree can use the tree encapsulated in a commit object. -z \0 line termination on output +--stdin + When --stdin is specified, the command does not take + arguments from the command line. Instead, it + reads either one or a pair of + separated with a single space from its standard input. + + When a single commit is given on one line of such input, + it compares the commit with its parents. The following + flags further affects its behaviour. This does not + apply to the case where two separated with a + single space are given. + +-m + By default, "git-diff-tree --stdin" does not show + differences for merge commits. With this flag, it shows + differences to that commit from all of its parents. + +-s + By default, "git-diff-tree --stdin" shows differences, + either in machine-readable form (without -p) or in patch + form (with -p). This output can be supressed. It is + only useful with -v flag. + +-v + This flag causes "git-diff-tree --stdin" to also show + the commit message before the differences. + + Limiting Output If you're only interested in differences in a subset of files, for diff --git a/diff-tree.c b/diff-tree.c index b8abe207c..cdd224c14 100644 --- a/diff-tree.c +++ b/diff-tree.c @@ -363,7 +363,8 @@ static int diff_tree_stdin(char *line) return -1; } -static char *diff_tree_usage = "diff-tree [-p] [-r] [-z] "; +static char *diff_tree_usage = +"diff-tree [-p] [-r] [-z] [--stdin] [-m] [-s] [-v] "; int main(int argc, char **argv) {