Skip to content

Commit 38c594d

Browse files
BenabikJunio C Hamano
authored andcommitted
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 d320a54. Signed-off-by: Brian Gernhardt <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent b3d9899 commit 38c594d

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

Documentation/git-show-branch.txt

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ SYNOPSIS
1010
[verse]
1111
'git-show-branch' [--all] [--heads] [--tags] [--topo-order] [--current]
1212
[--more=<n> | --list | --independent | --merge-base]
13-
[--no-name | --sha1-name] [<rev> | <glob>]...
13+
[--no-name | --sha1-name] [--topics] [<rev> | <glob>]...
1414

1515
DESCRIPTION
1616
-----------
@@ -86,6 +86,14 @@ OPTIONS
8686
of "master"), name them with the unique prefix of their
8787
object names.
8888

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+
8997
Note that --more, --list, --independent and --merge-base options
9098
are mutually exclusive.
9199

0 commit comments

Comments
 (0)