# [PATCH] Documentation/config: fix replacement for --get-urlmatch

2 messages from 2026-01-15 to 2026-01-15. Participants: Pushkar Singh, Shreyansh Paliwal.
Thread: https://gitlist.dev/t/64810

## Pushkar Singh, 2026-01-15 11:08

Subject: [PATCH] Documentation/config: fix replacement for --get-urlmatch
Message-ID: <20260115110832.15315-1-pushkarkumarsingh1970@gmail.com>
URL: https://gitlist.dev/e/20260115110832.15315-1-pushkarkumarsingh1970%40gmail.com

```
The documentation claims that --get-urlmatch is replaced by

  git config get --all --show-names --url=<URL> <name>

However, --url cannot be combined with --all, and this command
fails in practice.

Update the replacement to use only --url, which matches the
actual behavior of --get-urlmatch.

Signed-off-by: Pushkar Singh <pushkarkumarsingh1970@gmail.com>
---
 Documentation/git-config.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/git-config.adoc b/Documentation/git-config.adoc
index cc054fa7e1..ac3b536a15 100644
--- a/Documentation/git-config.adoc
+++ b/Documentation/git-config.adoc
@@ -332,7 +332,7 @@ recommended to migrate to the new syntax.
 	Replaced by `git config get --all --show-names --regexp <name-regexp>`.
 
 --get-urlmatch <name> <URL>::
-	Replaced by `git config get --all --show-names --url=<URL> <name>`.
+	Replaced by `git config get --url=<URL> <name>`.
 
 --get-color <name> [<default>]::
 	Replaced by `git config get --type=color [--default=<default>] <name>`.
-- 
2.43.0


```

## Shreyansh Paliwal, 2026-01-15 21:14

Subject: Re: [PATCH] Documentation/config: fix replacement for --get-urlmatch
Message-ID: <20260115211609.17420-1-shreyanshpaliwalcmsmn@gmail.com>
URL: https://gitlist.dev/e/20260115211609.17420-1-shreyanshpaliwalcmsmn%40gmail.com
In-Reply-To: <20260115110832.15315-1-pushkarkumarsingh1970@gmail.com>

```
> The documentation claims that --get-urlmatch is replaced by
> 
>   git config get --all --show-names --url=<URL> <name>
> 
> However, --url cannot be combined with --all, and this command
> fails in practice.
> 
> Update the replacement to use only --url, which matches the
> actual behavior of --get-urlmatch.
> 
> Signed-off-by: Pushkar Singh <pushkarkumarsingh1970@gmail.com>
> ---
>  Documentation/git-config.adoc | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/Documentation/git-config.adoc b/Documentation/git-config.adoc
> index cc054fa7e1..ac3b536a15 100644
> --- a/Documentation/git-config.adoc
> +++ b/Documentation/git-config.adoc
> @@ -332,7 +332,7 @@ recommended to migrate to the new syntax.
>  	Replaced by `git config get --all --show-names --regexp <name-regexp>`.
>  
>  --get-urlmatch <name> <URL>::
> -	Replaced by `git config get --all --show-names --url=<URL> <name>`.
> +	Replaced by `git config get --url=<URL> <name>`.
>  
>  --get-color <name> [<default>]::
>  	Replaced by `git config get --type=color [--default=<default>] <name>`.

Thanks for working on this, the change looks good to me.
I was also looking into this based on [1] and was planning
to send a similar fix, so I’m glad to see that it has been addressed.

While digging into this, I noticed that neither the documentation
nor the help output currently mention that --url cannot be combined with
options like --all, --default, or --regexp, even though there are checks
in code to prevent that.
I was thinking that might be added in a follow-up.
I also had a thought that we could modify the synopsis of git config as well,
showing two versions of git get, regular lookup and with --url,
not sure about the plausibility of this though.

Best,
Shreyansh

[1]- https://lore.kernel.org/git/CAGJzqs=0Zr2iqsTUZdjdwpbtaS7kuBOf=E_XT=vbdfyNTKkjNQ@mail.gmail.com/t/#u

```