]> git.ipfire.org Git - thirdparty/git.git/commitdiff
doc: replace git config --list/-l with `list`
authorKristoffer Haugsbakk <code@khaugsbakk.name>
Sun, 5 Apr 2026 10:31:59 +0000 (12:31 +0200)
committerJunio C Hamano <gitster@pobox.com>
Mon, 6 Apr 2026 16:57:07 +0000 (09:57 -0700)
Replace uses of `git config --list` (short or long) with the subcommand
`list` since `--list` is deprecated.

We will change the “man page” phrasing in gitcvs-migration(7) in the
next commit, since we are already visiting that sentence. But note
that we leave the “man page” phrasing in the sentence that we touch in
gittutorial(7) since it’s a tutorial and not a manual page. We can be
more wordy in a tutorial context.

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-var.adoc
Documentation/gitcvs-migration.adoc
Documentation/gitprotocol-v2.adoc
Documentation/gittutorial.adoc
Documentation/technical/api-trace2.adoc
Documentation/user-manual.adoc

index b606c2d649979f80e70605742270ade1587691b4..697c10adedcca6005849f6b5ace99f4f68599219 100644 (file)
@@ -22,7 +22,7 @@ OPTIONS
        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`.)
+       is deprecated in favor of `git config list`.)
 
 EXAMPLES
 --------
index 1cd1283d0f817d06e42ed41c31e7c02f69c1f821..2883834b7147015d8a4d5f9168a0a4d19042e7a1 100644 (file)
@@ -49,7 +49,7 @@ them first before running git pull.
 ================================
 The 'pull' command knows where to get updates from because of certain
 configuration variables that were set by the first 'git clone'
-command; see `git config -l` and the linkgit:git-config[1] man
+command; see `git config list` and the linkgit:git-config[1] man
 page for details.
 ================================
 
index f985cb4c4749533f4653ae5c2eeec1551e9218bb..ac5102b64f99ecf592dfc5c6d851df4cc0e9c96f 100644 (file)
@@ -659,7 +659,7 @@ use by the client, MUST indicate prerequisites (in any) with standard
 applicable.
 +
 The advertised URI may alternatively contain a plaintext file that `git
-config --list` would accept (with the `--file` option). The key-value
+config list` would accept (with the `--file` option). The key-value
 pairs in this list are in the `bundle.*` namespace (see
 linkgit:git-config[1]).
 
index f89ad30cf652b49b6864b89b9174299f65954bd8..519b8d8be2cc46ee5aa9305c17e0f215a4d734c8 100644 (file)
@@ -432,7 +432,7 @@ bob$ git config --get remote.origin.url
 -------------------------------------
 
 (The complete configuration created by `git clone` is visible using
-`git config -l`, and the linkgit:git-config[1] man page
+`git config list`, and the linkgit:git-config[1] man page
 explains the meaning of each option.)
 
 Git also keeps a pristine copy of Alice's `master` branch under the
index cf493dae03f3ac00f61e32fd22527a904741651a..918e517c2e6edb83fd556fd6304c371a7acf6561 100644 (file)
@@ -1253,7 +1253,7 @@ it.
 $ git config --system color.ui never
 $ git config --global color.ui always
 $ git config --local color.ui auto
-$ git config --list --show-scope | grep 'color.ui'
+$ git config list --show-scope | grep 'color.ui'
 system  color.ui=never
 global  color.ui=always
 local   color.ui=auto
index 64009baf3702318bf384a24020853ff161640bcc..5ec65cebe29dd7e4ba6be98a92de7753c0001259 100644 (file)
@@ -2865,7 +2865,7 @@ stored in Git configuration variables, which you can see using
 linkgit:git-config[1]:
 
 -------------------------------------------------
-$ git config -l
+$ git config list
 core.repositoryformatversion=0
 core.filemode=true
 core.logallrefupdates=true