revision: factor out add_pending_sha1
[gitweb.git] / Documentation / git-ls-remote.txt
index 8ad7a94f950068313722337610d336f761b70e72..7a9b86a58a1c00c08803e9ef40bb6a17146125a9 100644 (file)
@@ -9,8 +9,8 @@ git-ls-remote - List references in a remote repository
 SYNOPSIS
 --------
 [verse]
-'git-ls-remote' [--heads] [--tags]  [-u <exec> | --upload-pack <exec>]
-             <repository> <refs>...
+'git ls-remote' [--heads] [--tags]  [-u <exec> | --upload-pack <exec>]
+             [--exit-code] <repository> [<refs>...]
 
 DESCRIPTION
 -----------
@@ -20,18 +20,28 @@ commit IDs.
 
 OPTIONS
 -------
--h|--heads, -t|--tags::
+-h::
+--heads::
+-t::
+--tags::
        Limit to only refs/heads and refs/tags, respectively.
        These options are _not_ mutually exclusive; when given
        both, references stored in refs/heads and refs/tags are
        displayed.
 
--u <exec>, --upload-pack=<exec>::
-       Specify the full path of linkgit:git-upload-pack[1] on the remote
+-u <exec>::
+--upload-pack=<exec>::
+       Specify the full path of 'git-upload-pack' on the remote
        host. This allows listing references from repositories accessed via
        SSH and where the SSH daemon does not use the PATH configured by the
        user.
 
+--exit-code::
+       Exit with status "2" when no matching refs are found in the remote
+       repository. Usually the command exits with status "0" to indicate
+       it successfully talked with the remote repository, whether it
+       found any matching refs.
+
 <repository>::
        Location of the repository.  The shorthand defined in
        $GIT_DIR/branches/ can be used. Use "." (dot) to list references in
@@ -63,10 +73,6 @@ EXAMPLES
        c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
        7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3
 
-Author
-------
-Written by Junio C Hamano <junkio@cox.net>
-
 GIT
 ---
 Part of the linkgit:git[1] suite