Merge branch 'jc/shared' into next

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

diff --git a/Documentation/git-whatchanged.txt b/Documentation/git-whatchanged.txt
index db2efea14cf00335d5bb470a1b42f6cbe452c2e0..e8f21d02f774a914e7e8840150f6db86a2884178 100644 (file)
--- a/Documentation/git-whatchanged.txt
+++ b/Documentation/git-whatchanged.txt
@@ -1,15 +1,14 @@
 git-whatchanged(1)
 ==================
 git-whatchanged(1)
 ==================

-v0.99.4, Aug 2005

 
 NAME
 ----
 
 NAME
 ----

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

 
 
 SYNOPSIS
 --------
 
 
 SYNOPSIS
 --------

-'git whatchanged' <option>...
+'git-whatchanged' <option>...

 
 DESCRIPTION
 -----------
 
 DESCRIPTION
 -----------


@@ -48,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
 ------