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

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

From
KHKristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date
Mar 31, 2026, 21:14 UTC
Message-ID
<7bb06f60-01e8-4d51-8ba2-9a510d18d32f@app.fastmail.com>
In-Reply-To
<xmqqv7ebya8j.fsf@gitster.g>
On Tue, Mar 31, 2026, at 23:12, Junio C Hamano wrote:
Show 25 quoted lines
>>[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.
Previous: Junio C HamanoNext: kristofferhaugsbakk@fastmail.com
Message 4 of 13 in “doc: replace mentions of deprecated git config --list”
  1. 0/3 doc: replace mentions of deprecated git config --listkristofferhaugsbakk@fastmail.com, Mar 31, 2026
  2. 1/3 doc: var: link -l to git config listkristofferhaugsbakk@fastmail.com, Mar 31, 2026
  3. Junio C HamanoMar 31, 2026
  4. Kristoffer HaugsbakkMar 31, 2026
  5. 2/3 doc: gitcvs-migration: replace config -l and rephrasekristofferhaugsbakk@fastmail.com, Mar 31, 2026
  6. Junio C HamanoMar 31, 2026
  7. Kristoffer HaugsbakkMar 31, 2026
  8. 3/3 doc: replace the rest of git config --list with `list`kristofferhaugsbakk@fastmail.com, Mar 31, 2026
  9. Junio C HamanoMar 31, 2026
  10. 0/2 doc: replace mentions of deprecated git config --listkristofferhaugsbakk@fastmail.com, Apr 5, 2026
  11. 1/2 doc: replace git config --list/-l with `list`kristofferhaugsbakk@fastmail.com, Apr 5, 2026
  12. 2/2 doc: gitcvs-migration: rephrase “man page”kristofferhaugsbakk@fastmail.com, Apr 5, 2026
  13. Junio C HamanoApr 6, 2026

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.