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

[PATCH] ls-remote: document the '--get-url' option

From
Stefan Naewe <stefan.naewe@gmail.com>
Date
Sep 7, 2012, 06:41 UTC
Message-ID
<1347000079-7945-1-git-send-email-stefan.naewe@gmail.com>
In-Reply-To
<7v7gs63mio.fsf@alter.siamese.dyndns.org>

While looking for a way to expand the URL of a remote that uses a 'url.<name>.insteadOf' config option I stumbled over the undocumented '--get-url' option of 'git ls-remote'. This adds some minimum documentation for that option.

And while at it, also add that option to the '-h' output.
Signed-off-by: Stefan Naewe <stefan.naewe@gmail.com>
---
 Documentation/git-ls-remote.txt | 4 ++++
 builtin/ls-remote.c             | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/Documentation/git-ls-remote.txt b/Documentation/git-ls-remote.txt
index 7a9b86a..a2ebf1d 100644
--- a/Documentation/git-ls-remote.txt
+++ b/Documentation/git-ls-remote.txt
@@ -42,6 +42,10 @@ OPTIONS
 	it successfully talked with the remote repository, whether it
 	found any matching refs.
 
+--get-url::
+	Expand the URL of the given remote repository taking into account any
+	"url.<base>.insteadOf" config setting (See linkgit:git-config[1]).
+
 <repository>::
 	Location of the repository.  The shorthand defined in
 	$GIT_DIR/branches/ can be used. Use "." (dot) to list references in
diff --git a/builtin/ls-remote.c b/builtin/ls-remote.c
index 41c88a9..25e83cf 100644
--- a/builtin/ls-remote.c
+++ b/builtin/ls-remote.c
@@ -5,7 +5,7 @@
 
 static const char ls_remote_usage[] =
 "git ls-remote [--heads] [--tags]  [-u <exec> | --upload-pack <exec>]\n"
-"                     [-q|--quiet] [--exit-code] [<repository> [<refs>...]]";
+"                     [-q|--quiet] [--exit-code] [--get-url] [<repository> [<refs>...]]";
 
 /*
  * Is there one among the list of patterns that match the tail part
-- 
1.7.12
Previous: Junio C HamanoNext: Andreas Schwab
Message 3 of 6 in “ls-remote: document the '--get-url' option”
  1. ls-remote: document the '--get-url' optionStefan Naewe, Sep 6, 2012
  2. Junio C HamanoSep 6, 2012
  3. ls-remote: document the '--get-url' optionStefan Naewe, Sep 7, 2012
  4. Andreas SchwabSep 7, 2012
  5. Stefan NaeweSep 7, 2012
  6. Junio C HamanoSep 7, 2012

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.