Re: [PATCH 1/3] doc: var: link -l to git config list

["Kristoffer Haugsbakk" <kristofferhaugsbakk@fastmail.com>]

On Tue, Mar 31, 2026, at 23:12, Junio C Hamano wrote:
>>[snip]
>> ++
>> +WARNING: Deprecated in favor of `git config list`.
>
> This changes the meaning, and I am afraid in a bad way.
>
> Use if "git var -l" to ask values of configuration variables is
> deprecated, as we would encourage use of "git config [-l | list]".
> "git var -l" is and will stay to be the way to ask about logical
> variables.
>
> The new text, unlike the original, does not limit the deprecation
> only for asking about configuration variables.
>
> The logical variables are called logical because their values are
> synthesized from information taken from different places (e.g., you
> might not have user.name configured but may have GIT_AUTHOR_NAME
> environment variable set and exported or your name configured
> correctly in GECOS field.  We can ask what the value of
> GIT_AUTHOR_IDENT is, without knowing where that value comes from,
> and the source might be outside the usual Git configuration
> subsystem, which makes it "logical").
>
> I'd prefer to see this step just stick to `git config -l` => `git config list`
> rewrite without the separate WARNING: style change.

Aye! I missed that it was only talking about parts of the behavior.

I’ll drop the admonition change.