Documentation: show-branch.
Describe showbranch.default configuration item and give an example. Signed-off-by: Junio C Hamano <junkio@cox.net>
Junio C Hamano committed
Jan 11, 2006 at 00:09 UTC
54f9734ec84a351395bfdd332fee3f0e7006c1da
1 file changed
+23
-1
Documentation/git-show-branch.txt
+23
-1
@@ -18,6 +18,9 @@ and/or $GIT_DIR/refs/tags) semi-visually.
18
19
It cannot show more than 29 branches and commits at a time.
20
21
+It uses `showbranch.default` multi-valued configuration items if
22
+no <rev> nor <glob> is given on the command line.
23
+
24
25
OPTIONS
26
-------
@@ -50,7 +53,7 @@ OPTIONS
53
tree.
54
55
--list::
53
- Synomym to `--more=-1`
56
+ Synonym to `--more=-1`
57
58
--merge-base::
59
Instead of showing the commit list, just act like the
@@ -115,6 +118,25 @@ adds one commit 'Introduce "reset type"'. "mhf" branch has many
118
other commits.
119
120
121
+EXAMPLE
122
+-------
123
+
124
+If you keep your primary branches immediately under
125
+`$GIT_DIR/refs/heads`, and topic branches in subdirectories of
126
+it, having the following in the configuration file may help:
127
+
128
+------------
129
+[showbranch]
130
+ default = --topo-order
131
+ default = heads/*
132
+
133
+------------
134
+
135
+With this,`git show-branch` without extra parameters would show
136
+only the primary branches.
137
+
138
+
139
+
140
Author
141
------
142
Written by Junio C Hamano <junkio@cox.net>