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

From: Shreyansh Paliwal <shreyanshpaliwalcmsmn@gmail.com>
Date: Jan 15, 2026, 21:14 UTC
Message-ID: <20260115211609.17420-1-shreyanshpaliwalcmsmn@gmail.com>
In-Reply-To: <20260115110832.15315-1-pushkarkumarsingh1970@gmail.com>

Show 28 quoted lines

> 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