summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorLibravatar Junio C Hamano <junkio@cox.net>2006-01-11 00:09:16 -0800
committerLibravatar Junio C Hamano <junkio@cox.net>2006-01-15 00:04:23 -0800
commit54f9734ec84a351395bfdd332fee3f0e7006c1da (patch)
treeff2df84a500d1fb54377560be5324520fb2d4060 /Documentation
parentgit-push: avoid falling back on pushing "matching" refs. (diff)
downloadtgif-54f9734ec84a351395bfdd332fee3f0e7006c1da.tar.xz
Documentation: show-branch.
Describe showbranch.default configuration item and give an example. Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git-show-branch.txt24
1 files changed, 23 insertions, 1 deletions
diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt
index 5b76f3b99e..9cc44a8161 100644
--- a/Documentation/git-show-branch.txt
+++ b/Documentation/git-show-branch.txt
@@ -18,6 +18,9 @@ and/or $GIT_DIR/refs/tags) semi-visually.
It cannot show more than 29 branches and commits at a time.
+It uses `showbranch.default` multi-valued configuration items if
+no <rev> nor <glob> is given on the command line.
+
OPTIONS
-------
@@ -50,7 +53,7 @@ OPTIONS
tree.
--list::
- Synomym to `--more=-1`
+ Synonym to `--more=-1`
--merge-base::
Instead of showing the commit list, just act like the
@@ -115,6 +118,25 @@ adds one commit 'Introduce "reset type"'. "mhf" branch has many
other commits.
+EXAMPLE
+-------
+
+If you keep your primary branches immediately under
+`$GIT_DIR/refs/heads`, and topic branches in subdirectories of
+it, having the following in the configuration file may help:
+
+------------
+[showbranch]
+ default = --topo-order
+ default = heads/*
+
+------------
+
+With this,`git show-branch` without extra parameters would show
+only the primary branches.
+
+
+
Author
------
Written by Junio C Hamano <junkio@cox.net>