X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-show-ref.txt;h=2f173fff356282df7c906da6edeac1fcd4430025;hb=104d3794481c83f8db00ccf85134fc55c76852f9;hp=6b99529b6bb659ec1e1ffd741208ef03762c0356;hpb=7ac749c96d143ba4f76723959892cbaddbe8ed07;p=git.git diff --git a/Documentation/git-show-ref.txt b/Documentation/git-show-ref.txt index 6b99529b6..2f173fff3 100644 --- a/Documentation/git-show-ref.txt +++ b/Documentation/git-show-ref.txt @@ -8,9 +8,9 @@ git-show-ref - List references in a local repository SYNOPSIS -------- [verse] -'git-show-ref' [-q|--quiet] [--verify] [-h|--head] [-d|--dereference] +'git show-ref' [-q|--quiet] [--verify] [-h|--head] [-d|--dereference] [-s|--hash] [--abbrev] [--tags] [--heads] [--] ... -'git-show-ref' --exclude-existing[=pattern] +'git show-ref' --exclude-existing[=pattern] DESCRIPTION ----------- @@ -74,7 +74,7 @@ OPTIONS --exclude-existing:: --exclude-existing=pattern:: - Make git-show-ref act as a filter that reads refs from stdin of the + Make 'git-show-ref' act as a filter that reads refs from stdin of the form "^(?:\s)?(?:\^\{\})?$" and performs the following actions on each: (1) strip "^{}" at the end of line if any; @@ -84,7 +84,7 @@ OPTIONS (5) otherwise output the line. -:: +...:: Show references matching one or more patterns. @@ -137,14 +137,14 @@ When using the '--verify' flag, the command requires an exact path: will only match the exact branch called "master". -If nothing matches, linkgit:git-show-ref[1] will return an error code of 1, +If nothing matches, 'git-show-ref' will return an error code of 1, and in the case of verification, it will show an error message. For scripting, you can ask it to be quiet with the "--quiet" flag, which allows you to do things like ----------------------------------------------------------------------------- - git-show-ref --quiet --verify -- "refs/heads/$headname" || + git show-ref --quiet --verify -- "refs/heads/$headname" || echo "$headname is not a valid branch" -----------------------------------------------------------------------------