Merge branch 'jc/bottomless'

[git.git] / Documentation / git-whatchanged.txt

diff --git a/Documentation/git-whatchanged.txt b/Documentation/git-whatchanged.txt
index e6f57d9bc1a318ed332c3b46a10d6de824a37a07..641cb7ea97feee2971f59cd6113dc85bd41b4480 100644 (file)
--- a/Documentation/git-whatchanged.txt
+++ b/Documentation/git-whatchanged.txt
@@ -3,7 +3,7 @@ git-whatchanged(1)
 
 NAME
 ----
 
 NAME
 ----

-git-whatchanged - Show logs with difference each commit introduces.
+git-whatchanged - Show logs with difference each commit introduces

 
 
 SYNOPSIS
 
 
 SYNOPSIS


@@ -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.
        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
 ------
 
 Author
 ------