git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 2/7] git-ls-remote(1): document --upload-pack

From
Jonas Fonseca <fonseca@diku.dk>
Date
Aug 25, 2006, 00:58 UTC
Message-ID
<20060825005820.GC4069@diku.dk>
In-Reply-To
<20060825005655.GB4069@diku.dk>
... and mention that '.' will list the local repo references.
Signed-off-by: Jonas Fonseca <fonseca@diku.dk>
---
 Documentation/git-ls-remote.txt |   18 ++++++++++++++----
 1 files changed, 14 insertions(+), 4 deletions(-)
diff --git a/Documentation/git-ls-remote.txt b/Documentation/git-ls-remote.txt
index ae4c1a2..c8a4c5a 100644
--- a/Documentation/git-ls-remote.txt
+++ b/Documentation/git-ls-remote.txt
@@ -3,16 +3,19 @@ git-ls-remote(1)
 
 NAME
 ----
-git-ls-remote - Look at references other repository has
+git-ls-remote - List references in a remote repository
 
 
 SYNOPSIS
 --------
-'git-ls-remote' [--heads] [--tags] <repository> <refs>...
+[verse]
+'git-ls-remote' [--heads] [--tags]  [-u <exec> | --upload-pack <exec>]
+	      <repository> <refs>...
 
 DESCRIPTION
 -----------
-Displays the references other repository has.
+Displays references available in a remote repository along with the associated
+commit IDs.
 
 
 OPTIONS
@@ -23,9 +26,16 @@ OPTIONS
 	both, references stored in refs/heads and refs/tags are
 	displayed.
 
+-u <exec>, --upload-pack=<exec>::
+	Specify the full path of gitlink:git-upload-pack[1] on the remote
+	host. This allows listing references from repositories accessed via
+	SSH and where the SSH deamon does not use the PATH configured by the
+	user. Also see the '--exec' option for gitlink:git-peek-remote[1].
+
 <repository>::
 	Location of the repository.  The shorthand defined in
-	$GIT_DIR/branches/ can be used.
+	$GIT_DIR/branches/ can be used. Use "." (dot) to list references in
+	the local repository.
 
 <refs>...::
 	When unspecified, all references, after filtering done
-- 
1.4.2.GIT

-- 
Jonas Fonseca
Previous: Jonas FonsecaNext: Jonas Fonseca
Message 4 of 9 in “git-apply: document remaining options in the man page”
  1. git-apply: document remaining options in the man pageJonas Fonseca, Aug 18, 2006
  2. Junio C HamanoAug 18, 2006
  3. 1/7 git-apply(1): document missing options and improve existing onesJonas Fonseca, Aug 25, 2006
  4. 2/7 git-ls-remote(1): document --upload-packJonas Fonseca, Aug 25, 2006
  5. 3/7 git-blame(1): mention options in the synopsis and advertise pickaxeJonas Fonseca, Aug 25, 2006
  6. 4/7 gitk(1): expand the manpage to look less like a templateJonas Fonseca, Aug 25, 2006
  7. 5/7 git(7): put the synopsis in a verse style paragraphJonas Fonseca, Aug 25, 2006
  8. 6/7 gitview.txt: improve asciidoc markupJonas Fonseca, Aug 25, 2006
  9. 7/7 git-svn(1): improve asciidoc markupJonas Fonseca, Aug 25, 2006

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.