summaryrefslogtreecommitdiffstats
path: root/man1/git-ls-remote.1
diff options
context:
space:
mode:
Diffstat (limited to 'man1/git-ls-remote.1')
-rw-r--r--man1/git-ls-remote.126
1 files changed, 19 insertions, 7 deletions
diff --git a/man1/git-ls-remote.1 b/man1/git-ls-remote.1
index abab6bec4..5b02c43df 100644
--- a/man1/git-ls-remote.1
+++ b/man1/git-ls-remote.1
@@ -2,12 +2,12 @@
.\" Title: git-ls-remote
.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\" Date: 02/14/2023
+.\" Date: 02/22/2023
.\" Manual: Git Manual
-.\" Source: Git 2.39.2.456.gb1485644f9
+.\" Source: Git 2.39.2.542.g06dd2baa8d
.\" Language: English
.\"
-.TH "GIT\-LS\-REMOTE" "1" "02/14/2023" "Git 2\&.39\&.2\&.456\&.gb14856" "Git Manual"
+.TH "GIT\-LS\-REMOTE" "1" "02/22/2023" "Git 2\&.39\&.2\&.542\&.g06dd2b" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -34,7 +34,7 @@ git-ls-remote \- List references in a remote repository
.nf
\fIgit ls\-remote\fR [\-\-heads] [\-\-tags] [\-\-refs] [\-\-upload\-pack=<exec>]
[\-q | \-\-quiet] [\-\-exit\-code] [\-\-get\-url] [\-\-sort=<key>]
- [\-\-symref] [<repository> [<refs>\&...]]
+ [\-\-symref] [<repository> [<patterns>\&...]]
.fi
.sp
.SH "DESCRIPTION"
@@ -112,9 +112,19 @@ The "remote" repository to query\&. This parameter can be either a URL or the na
\fBgit-fetch\fR(1))\&.
.RE
.PP
-<refs>\&...
+<patterns>\&...
.RS 4
-When unspecified, all references, after filtering done with \-\-heads and \-\-tags, are shown\&. When <refs>\&... are specified, only references matching the given patterns are displayed\&.
+When unspecified, all references, after filtering done with \-\-heads and \-\-tags, are shown\&. When <patterns>\&... are specified, only references matching one or more of the given patterns are displayed\&. Each pattern is interpreted as a glob (see
+\fBglob\fR
+in
+\fBgitglossary\fR(7)) which is matched against the "tail" of a ref, starting either from the start of the ref (so a full name like
+\fBrefs/heads/foo\fR
+matches) or from a slash separator (so
+\fBbar\fR
+matches
+\fBrefs/heads/bar\fR
+but not
+\fBrefs/heads/foobar\fR)\&.
.RE
.SH "EXAMPLES"
.sp
@@ -122,15 +132,17 @@ When unspecified, all references, after filtering done with \-\-heads and \-\-ta
.RS 4
.\}
.nf
-$ git ls\-remote \-\-tags \&./\&.
+$ git ls\-remote \-\-tags \&.
d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0\&.99
f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0\&.99\&.1
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0\&.99\&.3
c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0\&.99\&.2
0918385dbd9656cab0d1d81ba7453d49bbc16250 refs/tags/junio\-gpg\-pub
+
$ git ls\-remote http://www\&.kernel\&.org/pub/scm/git/git\&.git master seen rc
5fe978a5381f1fbad26a80e682ddd2a401966740 refs/heads/master
c781a84b5204fb294c9ccc79f8b3baceeb32c061 refs/heads/seen
+
$ git remote add korg http://www\&.kernel\&.org/pub/scm/git/git\&.git
$ git ls\-remote \-\-tags korg v\e*
d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0\&.99