diff options
| author |  Junio C Hamano <junkio@cox.net> | 2005-12-04 15:58:50 -0800 |
|---|---|---|
| committer | Junio C Hamano <junkio@cox.net> | 2005-12-04 16:06:35 -0800 |
| commit | 287f860054345505e4f737466279efa6c3ff04b5 (patch) | |
| tree | 240563de5898adcf52be5ea7b70839ba5db67ab3 /Documentation | |
| parent | Update the git-ls-tree documentation (diff) | |
| download | tgif-287f860054345505e4f737466279efa6c3ff04b5.tar.xz | |
show-branch: allow glob pattern to name branches to show.
With this, you can say "git-show-branch topic/* master" to show
all the topic branches you have under .git/refs/heads/topic/ and
your master branch. Another example is "git-show-branch --list
v1.0*" to show all the v1.0 tags. You can disambiguate by
saying "heads/topic/*" to show only topic branches if you have
tags under .git/refs/tags/topic/ as well.
Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/git-show-branch.txt | 23 |
1 files changed, 17 insertions, 6 deletions
diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt index c6c97b21c3..304101d818 100644 --- a/Documentation/git-show-branch.txt +++ b/Documentation/git-show-branch.txt @@ -7,18 +7,29 @@ git-show-branch - Show branches and their commits. SYNOPSIS -------- -'git-show-branch [--all] [--heads] [--tags] [--more=<n> | --list | --independent | --merge-base] [--no-name | --sha1-name] <reference>...' +'git-show-branch [--all] [--heads] [--tags] [--more=<n> | --list | --independent | --merge-base] [--no-name | --sha1-name] [<rev> | <glob>]...' DESCRIPTION ----------- -Shows the head commits from the named <reference> (or all refs under -$GIT_DIR/refs/heads), and displays concise list of commit logs -to show their relationship semi-visually. + +Shows the commit ancestry graph starting from the commits named +with <rev>s or <globs>s (or all refs under $GIT_DIR/refs/heads +and/or $GIT_DIR/refs/tags) semi-visually. + +It cannot show more than 29 branches and commits at a time. + OPTIONS ------- -<reference>:: - Name of the reference under $GIT_DIR/refs/. +<rev>:: + Arbitrary extended SHA1 expression (see `git-rev-parse`) + that typically names a branch HEAD or a tag. + +<glob>:: + A glob pattern that matches branch or tag names under + $GIT_DIR/refs. For example, if you have many topic + branches under $GIT_DIR/refs/heads/topic, giving + `topic/*` would show all of them. --all --heads --tags:: Show all refs under $GIT_DIR/refs, $GIT_DIR/refs/heads, |