summaryrefslogtreecommitdiffstats
path: root/git-ls-remote.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2018-05-08 16:52:09 +0900
committerJunio C Hamano <gitster@pobox.com>2018-05-08 16:52:09 +0900
commitccb8252b46bfba5daf0cfcedaf0f9d2e14ba356f (patch)
treee714818e5948ab33af26c19fc8d205b9f5179e1a /git-ls-remote.txt
parent96153bf70f5b69b8c480445c9aed3782ef6776a3 (diff)
downloadgit-htmldocs-ccb8252b46bfba5daf0cfcedaf0f9d2e14ba356f.tar.gz
Autogenerated HTML docs for v2.17.0-582-gccdcb
Diffstat (limited to 'git-ls-remote.txt')
-rw-r--r--git-ls-remote.txt16
1 files changed, 15 insertions, 1 deletions
diff --git a/git-ls-remote.txt b/git-ls-remote.txt
index 5f2628c8f..6ad1e34af 100644
--- a/git-ls-remote.txt
+++ b/git-ls-remote.txt
@@ -10,7 +10,7 @@ SYNOPSIS
--------
[verse]
'git ls-remote' [--heads] [--tags] [--refs] [--upload-pack=<exec>]
- [-q | --quiet] [--exit-code] [--get-url]
+ [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]
[--symref] [<repository> [<refs>...]]
DESCRIPTION
@@ -60,6 +60,16 @@ OPTIONS
upload-pack only shows the symref HEAD, so it will be the only
one shown by ls-remote.
+--sort=<key>::
+ Sort based on the key given. Prefix `-` to sort in descending order
+ of the value. Supports "version:refname" or "v:refname" (tag names
+ are treated as versions). The "version:refname" sort order can also
+ be affected by the "versionsort.suffix" configuration variable.
+ See linkgit:git-for-each-ref[1] for more sort options, but be aware
+ keys like `committerdate` that require access to the objects
+ themselves will not work for refs whose objects have not yet been
+ fetched from the remote, and will give a `missing object` error.
+
<repository>::
The "remote" repository to query. This parameter can be
either a URL or the name of a remote (see the GIT URLS and
@@ -90,6 +100,10 @@ EXAMPLES
c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
+SEE ALSO
+--------
+linkgit:git-check-ref-format[1].
+
GIT
---
Part of the linkgit:git[1] suite