Add documentation for show-branch --topics
Add a quick paragraph explaining the --topics option for show-branch. The explanation is an abbreviated version of the commit message from d320a5437f8304cf9ea3ee1898e49d643e005738. Signed-off-by: Brian Gernhardt <benji@silverinsanity.com> Signed-off-by: Junio C Hamano <junkio@cox.net>
Brian Gernhardt committed
Dec 18, 2006 at 10:48 UTC
38c594d3300b7640532a3716adf5a0778021542c
1 file changed
+9
-1
Documentation/git-show-branch.txt
+9
-1
@@ -10,7 +10,7 @@ SYNOPSIS
10
[verse]
11
'git-show-branch' [--all] [--heads] [--tags] [--topo-order] [--current]
12
[--more=<n> | --list | --independent | --merge-base]
13
- [--no-name | --sha1-name] [<rev> | <glob>]...
13
+ [--no-name | --sha1-name] [--topics] [<rev> | <glob>]...
14
15
DESCRIPTION
16
-----------
@@ -86,6 +86,14 @@ OPTIONS
86
of "master"), name them with the unique prefix of their
87
object names.
88
89
+--topics::
90
+ Shows only commits that are NOT on the first branch given.
91
+ This helps track topic branches by hiding any commit that
92
+ is already in the main line of development. When given
93
+ "git show-branch --topics master topic1 topic2", this
94
+ will show the revisions given by "git rev-list {caret}master
95
+ topic1 topic2"
96
+
97
Note that --more, --list, --independent and --merge-base options
98
are mutually exclusive.
99