From: kristofferhaugsbakk@fastmail.com
To: git@vger.kernel.org
Cc: Kristoffer Haugsbakk <code@khaugsbakk.name>, ps@pks.im
Subject: [PATCH 1/3] doc: var: link -l to git config list
Date: Tue, 31 Mar 2026 22:48:08 +0200 [thread overview]
Message-ID: <doc_var_no_config_-l.54b@msgid.xyz> (raw)
In-Reply-To: <CV_doc_deprecation_config_--list.54a@msgid.xyz>
From: Kristoffer Haugsbakk <code@khaugsbakk.name>
The option `-l` is deprecated and links to `git config -l` as the
replacement—which is also deprecated. Break the deprecation chain by
linking to `git config list`, the command which has superseded `git
config -l`.
Also promote this part from a parenthetical to a warning admonition.
Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---
Documentation/git-var.adoc | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-var.adoc b/Documentation/git-var.adoc
index b606c2d6499..98f4dc1a479 100644
--- a/Documentation/git-var.adoc
+++ b/Documentation/git-var.adoc
@@ -21,8 +21,9 @@ OPTIONS
`-l`::
Display the logical variables. In addition, all the
variables of the Git configuration file .git/config are listed
- as well. (However, the configuration variables listing functionality
- is deprecated in favor of `git config -l`.)
+ as well.
++
+WARNING: Deprecated in favor of `git config list`.
EXAMPLES
--------
--
2.53.0.32.gf6228eaf9cc
next prev parent reply other threads:[~2026-03-31 20:49 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-03-31 20:48 [PATCH 0/3] doc: replace mentions of deprecated git config --list kristofferhaugsbakk
2026-03-31 20:48 ` kristofferhaugsbakk [this message]
2026-03-31 21:12 ` [PATCH 1/3] doc: var: link -l to git config list Junio C Hamano
2026-03-31 21:14 ` Kristoffer Haugsbakk
2026-03-31 20:48 ` [PATCH 2/3] doc: gitcvs-migration: replace config -l and rephrase kristofferhaugsbakk
2026-03-31 21:09 ` Junio C Hamano
2026-03-31 21:17 ` Kristoffer Haugsbakk
2026-03-31 20:48 ` [PATCH 3/3] doc: replace the rest of git config --list with `list` kristofferhaugsbakk
2026-03-31 21:10 ` Junio C Hamano
2026-04-05 10:31 ` [PATCH v2 0/2] doc: replace mentions of deprecated git config --list kristofferhaugsbakk
2026-04-05 10:31 ` [PATCH v2 1/2] doc: replace git config --list/-l with `list` kristofferhaugsbakk
2026-04-05 10:32 ` [PATCH v2 2/2] doc: gitcvs-migration: rephrase “man page” kristofferhaugsbakk
2026-04-06 17:04 ` Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=doc_var_no_config_-l.54b@msgid.xyz \
--to=kristofferhaugsbakk@fastmail.com \
--cc=code@khaugsbakk.name \
--cc=git@vger.kernel.org \
--cc=ps@pks.im \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.