X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-whatchanged.txt;h=399bff3bbcab89be96039c373cf1120dcab0efe1;hb=28a4d940443806412effa246ecc7768a21553ec7;hp=e6f57d9bc1a318ed332c3b46a10d6de824a37a07;hpb=e634aec752642dcf86c3fc82025e43381d6768c2;p=git.git

diff --git a/Documentation/git-whatchanged.txt b/Documentation/git-whatchanged.txt
index e6f57d9bc..399bff3bb 100644
--- a/Documentation/git-whatchanged.txt
+++ b/Documentation/git-whatchanged.txt
@@ -3,7 +3,7 @@ git-whatchanged(1)
 
 NAME
 ----
-git-whatchanged - Show logs with difference each commit introduces.
+git-whatchanged - Show logs with difference each commit introduces
 
 
 SYNOPSIS
@@ -27,7 +27,7 @@ OPTIONS
 	output format that is useful only to tell the changed
 	paths and their nature of changes.
 
---max-count=<n>::
+-<n>::
 	Limit output to <n> commits.
 
 <since>..<until>::
@@ -47,9 +47,23 @@ OPTIONS
 	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'
 
-	However, it is not very useful in general, although it
-	*is* useful on a file-by-file basis.
 
 Author
 ------