From: Junio C Hamano Date: Wed, 11 Jan 2006 08:09:16 +0000 (-0800) Subject: Documentation: show-branch. X-Git-Tag: v1.2.0~143^5~2 X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=54f9734ec84a351395bfdd332fee3f0e7006c1da;p=git.git Documentation: show-branch. Describe showbranch.default configuration item and give an example. Signed-off-by: Junio C Hamano --- diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt index 5b76f3b99..9cc44a816 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 nor 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