Documentation: revise top of git man page
[git.git] / Documentation / git-cherry.txt
blob9a5e37186fcd03972d490e2e996ce8b078112bbb
1 git-cherry(1)
2 =============
4 NAME
5 ----
6 git-cherry - Find commits not merged upstream
8 SYNOPSIS
9 --------
10 'git-cherry' [-v] <upstream> [<head>]
12 DESCRIPTION
13 -----------
14 Each commit between the fork-point and <head> is examined, and compared against
15 the change each commit between the fork-point and <upstream> introduces.
16 Commits already included in upstream are prefixed with '-' (meaning "drop from
17 my local pull"), while commits missing from upstream are prefixed with '+'
18 (meaning "add to the updated upstream").
20 OPTIONS
21 -------
22 -v::
23         Verbose.
25 <upstream>::
26         Upstream branch to compare against.
28 <head>::
29         Working branch; defaults to HEAD.
31 Author
32 ------
33 Written by Junio C Hamano <junkio@cox.net>
35 Documentation
36 --------------
37 Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
39 GIT
40 ---
41 Part of the gitlink:git[7] suite