git-apply(1): document missing options and improve existing ones
[git/git.git] / Documentation / git-ls-remote.txt
CommitLineData
215a7ad1
JH
1git-ls-remote(1)
2================
972b6fe7
JH
3
4NAME
5----
7bd7f280 6git-ls-remote - Look at references other repository has
972b6fe7
JH
7
8
9SYNOPSIS
10--------
11'git-ls-remote' [--heads] [--tags] <repository> <refs>...
12
13DESCRIPTION
14-----------
15Displays the references other repository has.
16
17
18OPTIONS
19-------
5e34c99d 20-h|--heads, -t|--tags::
972b6fe7
JH
21 Limit to only refs/heads and refs/tags, respectively.
22 These options are _not_ mutually exclusive; when given
23 both, references stored in refs/heads and refs/tags are
24 displayed.
25
26<repository>::
27 Location of the repository. The shorthand defined in
28 $GIT_DIR/branches/ can be used.
29
30<refs>...::
31 When unspecified, all references, after filtering done
32 with --heads and --tags, are shown. When <refs>... are
33 specified, only references matching the given patterns
34 are displayed.
35
36EXAMPLES
37--------
38
39 $ git ls-remote --tags ./.
40 d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
41 f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
42 7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
43 c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
44 0918385dbd9656cab0d1d81ba7453d49bbc16250 refs/tags/junio-gpg-pub
45 $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master pu rc
46 5fe978a5381f1fbad26a80e682ddd2a401966740 refs/heads/master
47 c781a84b5204fb294c9ccc79f8b3baceeb32c061 refs/heads/pu
48 b1d096f2926c4e37c9c0b6a7bf2119bedaa277cb refs/heads/rc
49 $ echo http://www.kernel.org/pub/scm/git/git.git >.git/branches/public
50 $ git ls-remote --tags public v\*
51 d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
52 f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
53 c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
54 7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
55
56Author
57------
58Written by Junio C Hamano <junkio@cox.net>
59
60GIT
61---
a7154e91 62Part of the gitlink:git[7] suite
972b6fe7 63