X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=Documentation%2Fgit-whatchanged.txt;h=6c150b0264ac5caf326ad5b0d2da225a241b77f2;hb=e3c3a550d4815d34b5674776c36cdd6d8a31ab85;hp=118a3fdb9eea4f44ee3cfe9800f574e038f943c2;hpb=98438bd0e893c23186fb82ea8b04964c0f1ef9d1;p=git.git

diff --git a/Documentation/git-whatchanged.txt b/Documentation/git-whatchanged.txt
index 118a3fdb..6c150b02 100644
--- a/Documentation/git-whatchanged.txt
+++ b/Documentation/git-whatchanged.txt
@@ -8,7 +8,7 @@ git-whatchanged - Show logs with difference each commit introduces.
 
 SYNOPSIS
 --------
-'git whatchanged' <option>...
+'git-whatchanged' <option>...
 
 DESCRIPTION
 -----------
@@ -43,6 +43,27 @@ OPTIONS
 	<format> can be one of 'raw', 'medium', 'short', 'full',
 	and 'oneline'.
 
+-m::
+	By default, differences for merge commits are not shown.
+	With this flag, show differences to that commit from all
+	of its parents.
+
+	However, it is not very useful in general, although it
+	*is* useful on a file-by-file basis.
+
+Examples
+--------
+git-whatchanged -p v2.6.12.. include/scsi drivers/scsi::
+
+	Show as patches the commits since version 'v2.6.12' that changed
+	any file in the include/scsi or drivers/scsi subdirectories
+
+git-whatchanged --since="2 weeks ago" -- gitk::
+
+	Show the changes during the last two weeks to the file 'gitk'.
+	The "--" is necessary to avoid confusion with the *branch* named
+	'gitk'
+
 
 Author
 ------