From c3f1dbf06ea66503339550ea4b99b82a49c5aa93 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Tue, 10 Apr 2007 21:31:32 +0000 Subject: [PATCH] Autogenerated HTML docs for v1.5.1-108-gf8ce1 --- git-archive.html | 5 +++-- git-archive.txt | 3 ++- git-show-ref.html | 22 ++++++++++++++++++++-- git-show-ref.txt | 16 ++++++++++++++++ 4 files changed, 41 insertions(+), 5 deletions(-) diff --git a/git-archive.html b/git-archive.html index 77d03dd80..39cd9adce 100644 --- a/git-archive.html +++ b/git-archive.html @@ -297,7 +297,8 @@ comment.

- Format of the resulting archive: tar, zip… + Format of the resulting archive: tar, zip… The default + is tar.

@@ -444,7 +445,7 @@ git archive --format=zip --prefix=git-docs/ HEAD:Documentation/ > git-1.4.0-d diff --git a/git-archive.txt b/git-archive.txt index 493474b2e..8d1041598 100644 --- a/git-archive.txt +++ b/git-archive.txt @@ -30,7 +30,8 @@ OPTIONS ------- --format=:: - Format of the resulting archive: 'tar', 'zip'... + Format of the resulting archive: 'tar', 'zip'... The default + is 'tar'. --list:: Show all available formats. diff --git a/git-show-ref.html b/git-show-ref.html index b761cb391..45c2cc3ee 100644 --- a/git-show-ref.html +++ b/git-show-ref.html @@ -274,7 +274,8 @@ git-show-ref(1) Manual Page
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

@@ -282,6 +283,8 @@ git-show-ref(1) Manual Page 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 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 in the .git directory.

@@ -353,6 +356,21 @@ in the .git directory.

+--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>
@@ -442,7 +460,7 @@ Man page by Jonas Fonseca <fonseca@diku.dk>.

diff --git a/git-show-ref.txt b/git-show-ref.txt index 5973a8251..2355aa5e8 100644 --- a/git-show-ref.txt +++ b/git-show-ref.txt @@ -10,6 +10,7 @@ SYNOPSIS [verse] 'git-show-ref' [-q|--quiet] [--verify] [-h|--head] [-d|--dereference] [-s|--hash] [--abbrev] [--tags] [--heads] [--] ... +'git-show-ref' --exclude-existing[=pattern] 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 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 in the `.git` directory. @@ -61,6 +65,18 @@ OPTIONS Do not print any results to stdout. When combined with '--verify' this 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 "^(?:\s)?(?:\^\{\})?$" 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. + + :: Show references matching one or more patterns. -- 2.26.2