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

From: [email-masked]
Date: Tue, 31 Mar 2026 22:48:08 +0200

From: Kristoffer Haugsbakk <[email-masked]>

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 <[email-masked]>
---
 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