From: Kristoffer Haugsbakk Date: Tue, 31 Mar 2026 21:14:54 GMT Subject: Re: [PATCH 1/3] doc: var: link -l to git config list Message-ID: <7bb06f60-01e8-4d51-8ba2-9a510d18d32f@app.fastmail.com> In-Reply-To: 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.