From: Junio C Hamano <junkio@cox.net>
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: http://git.osdn.net/view?a=commitdiff_plain;h=5aad72f2bc1527e1fcdf460f0a36b0bcc4117b4a;p=git-core%2Fgit.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 <junkio@cox.net>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
---

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] <tree-ish> <tree-ish> [<pattern>]*
+	git-diff-tree [-p] [-r] [-z] [--stdin] [-m] [-s] [-v] <tree-ish> <tree-ish> [<pattern>]*
 
 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
+	<tree-ish> arguments from the command line.  Instead, it
+	reads either one <commit> or a pair of <tree-ish>
+	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 <tree-ish> 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] <tree sha1> <tree sha1>";
+static char *diff_tree_usage =
+"diff-tree [-p] [-r] [-z] [--stdin] [-m] [-s] [-v] <tree sha1> <tree sha1>";
 
 int main(int argc, char **argv)
 {