Merge branch 'lt/rev-list' into next
[gitweb.git] / Documentation / git-cherry.txt
index 14d0bd51cd6ea23696b8b60d4e804440f408ce1e..af87966e511184c4e29b3b07fac01e0df53a618a 100644 (file)
@@ -3,26 +3,30 @@ git-cherry(1)
 
 NAME
 ----
-git-cherry - Some git command not yet documented.
-
+git-cherry - Find commits not merged upstream.
 
 SYNOPSIS
 --------
-'git-cherry' [ --option ] <args>...
+'git-cherry' [-v] <upstream> [<head>]
 
 DESCRIPTION
 -----------
-Does something not yet documented.
-
+Each commit between the fork-point and <head> is examined, and compared against
+the change each commit between the fork-point and <upstream> introduces.
+Commits already included in upstream are prefixed with '-' (meaning "drop from
+my local pull"), while commits missing from upstream are prefixed with '+'
+(meaning "add to the updated upstream").
 
 OPTIONS
 -------
---option::
-       Some option not yet documented.
+-v::
+       Verbose.
 
-<args>...::
-       Some argument not yet documented.
+<upstream>::
+       Upstream branch to compare against.
 
+<head>::
+       Working branch; defaults to HEAD.
 
 Author
 ------
@@ -34,5 +38,5 @@ Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
 
 GIT
 ---
-Part of the link:git.html[git] suite
+Part of the gitlink:git[7] suite