From 54f9734ec84a351395bfdd332fee3f0e7006c1da Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Wed, 11 Jan 2006 00:09:16 -0800 Subject: [PATCH] Documentation: show-branch. Describe showbranch.default configuration item and give an example. Signed-off-by: Junio C Hamano --- Documentation/git-show-branch.txt | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt index 5b76f3b9..9cc44a81 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 -- 2.11.0