undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation: show-ref: document --exclude-existing

Browse Source 
Use the comment in the code to document the --exclude-existing
function to git-show-ref.

Signed-off-by: Julian Phillips <julian@quantumfyre.co.uk>
Signed-off-by: Junio C Hamano <junkio@cox.net>
This commit is contained in:
Julian Phillips 2007-04-09 21:57:36 +01:00 committed by Junio C Hamano
parent fc1f458c35
commit 8bd26c4a2f
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Documentation/git-show-ref.txt
View File

@ -10,6 +10,7 @@ SYNOPSIS
[verse] [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] [--] <pattern>... [-s|--hash] [--abbrev] [--tags] [--heads] [--] <pattern>...
'git-show-ref' --exclude-existing[=pattern]
DESCRIPTION DESCRIPTION
----------- -----------
@ -19,6 +20,9 @@ commit IDs. Results can be filtered using a pattern and tags can be
dereferenced into object IDs. Additionally, it can be used to test whether a dereferenced into object IDs. Additionally, it can be used to test whether a
particular ref exists. particular ref exists.
The --exclude-existing form is a filter that does the inverse, it shows the
refs from stdin that don't exist in the local repository.
Use of this utility is encouraged in favor of directly accessing files under Use of this utility is encouraged in favor of directly accessing files under
in the `.git` directory. in the `.git` directory.
@ -61,6 +65,18 @@ OPTIONS
Do not print any results to stdout. When combined with '--verify' this Do not print any results to stdout. When combined with '--verify' this
can be used to silently check if a reference exists. can be used to silently check if a reference exists.
--exclude-existing, --exclude-existing=pattern::
Make git-show-ref act as a filter that reads refs from stdin of the
form "^(?:<anything>\s)?<refname>(?:\^\{\})?$" and performs the
following actions on each:
(1) strip "^{}" at the end of line if any;
(2) ignore if pattern is provided and does not head-match refname;
(3) warn if refname is not a well-formed refname and skip;
(4) ignore if refname is a ref that exists in the local repository;
(5) otherwise output the line.
<pattern>:: <pattern>::
Show references matching one or more patterns. Show references matching one or more patterns.