mirror of
https://github.com/git/git
synced 2024-08-28 12:09:19 +00:00
Merge branch 'jk/doc-ls-remote-matching'
Doc update. * jk/doc-ls-remote-matching: doc/ls-remote: clarify pattern format doc/ls-remote: cosmetic cleanups for examples
This commit is contained in:
commit
6aac634f81
|
@ -11,7 +11,7 @@ SYNOPSIS
|
||||||
[verse]
|
[verse]
|
||||||
'git ls-remote' [--heads] [--tags] [--refs] [--upload-pack=<exec>]
|
'git ls-remote' [--heads] [--tags] [--refs] [--upload-pack=<exec>]
|
||||||
[-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]
|
[-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]
|
||||||
[--symref] [<repository> [<refs>...]]
|
[--symref] [<repository> [<patterns>...]]
|
||||||
|
|
||||||
DESCRIPTION
|
DESCRIPTION
|
||||||
-----------
|
-----------
|
||||||
|
@ -85,25 +85,32 @@ OPTIONS
|
||||||
either a URL or the name of a remote (see the GIT URLS and
|
either a URL or the name of a remote (see the GIT URLS and
|
||||||
REMOTES sections of linkgit:git-fetch[1]).
|
REMOTES sections of linkgit:git-fetch[1]).
|
||||||
|
|
||||||
<refs>...::
|
<patterns>...::
|
||||||
When unspecified, all references, after filtering done
|
When unspecified, all references, after filtering done
|
||||||
with --heads and --tags, are shown. When <refs>... are
|
with --heads and --tags, are shown. When <patterns>... are
|
||||||
specified, only references matching the given patterns
|
specified, only references matching one or more of the given
|
||||||
are displayed.
|
patterns are displayed. Each pattern is interpreted as a glob
|
||||||
|
(see `glob` in linkgit:gitglossary[7]) which is matched against
|
||||||
|
the "tail" of a ref, starting either from the start of the ref
|
||||||
|
(so a full name like `refs/heads/foo` matches) or from a slash
|
||||||
|
separator (so `bar` matches `refs/heads/bar` but not
|
||||||
|
`refs/heads/foobar`).
|
||||||
|
|
||||||
EXAMPLES
|
EXAMPLES
|
||||||
--------
|
--------
|
||||||
|
|
||||||
----
|
----
|
||||||
$ git ls-remote --tags ./.
|
$ git ls-remote --tags .
|
||||||
d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
|
d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
|
||||||
f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
|
f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
|
||||||
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
|
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
|
||||||
c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
|
c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
|
||||||
0918385dbd9656cab0d1d81ba7453d49bbc16250 refs/tags/junio-gpg-pub
|
0918385dbd9656cab0d1d81ba7453d49bbc16250 refs/tags/junio-gpg-pub
|
||||||
|
|
||||||
$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
|
$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
|
||||||
5fe978a5381f1fbad26a80e682ddd2a401966740 refs/heads/master
|
5fe978a5381f1fbad26a80e682ddd2a401966740 refs/heads/master
|
||||||
c781a84b5204fb294c9ccc79f8b3baceeb32c061 refs/heads/seen
|
c781a84b5204fb294c9ccc79f8b3baceeb32c061 refs/heads/seen
|
||||||
|
|
||||||
$ git remote add korg http://www.kernel.org/pub/scm/git/git.git
|
$ git remote add korg http://www.kernel.org/pub/scm/git/git.git
|
||||||
$ git ls-remote --tags korg v\*
|
$ git ls-remote --tags korg v\*
|
||||||
d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
|
d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
|
||||||
|
|
|
@ -8,7 +8,7 @@
|
||||||
static const char * const ls_remote_usage[] = {
|
static const char * const ls_remote_usage[] = {
|
||||||
N_("git ls-remote [--heads] [--tags] [--refs] [--upload-pack=<exec>]\n"
|
N_("git ls-remote [--heads] [--tags] [--refs] [--upload-pack=<exec>]\n"
|
||||||
" [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]\n"
|
" [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]\n"
|
||||||
" [--symref] [<repository> [<refs>...]]"),
|
" [--symref] [<repository> [<patterns>...]]"),
|
||||||
NULL
|
NULL
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue