[PATCH v2 1/2] doc: replace git config --list/-l with `list`
From: Kristoffer Haugsbakk <code@khaugsbakk.name>
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>
---
Notes (series):
v2: Now do all the deprecated --list/-l changes in one step
v1: (was spread over the three patches) Documentation/git-var.adoc | 2 +-
Documentation/gitcvs-migration.adoc | 2 +-
Documentation/gitprotocol-v2.adoc | 2 +-
Documentation/gittutorial.adoc | 2 +-
Documentation/technical/api-trace2.adoc | 2 +-
Documentation/user-manual.adoc | 2 +-
6 files changed, 6 insertions(+), 6 deletions(-)
Show changes to 6 files +6 −6
Documentation/git-var.adoc, Documentation/gitcvs-migration.adoc, Documentation/gitprotocol-v2.adoc, Documentation/gittutorial.adoc, Documentation/technical/api-trace2.adoc, Documentation/user-manual.adoc
diff --git a/Documentation/git-var.adoc b/Documentation/git-var.adoc
index b606c2d6499..697c10adedc 100644
--- a/Documentation/git-var.adoc
+++ b/Documentation/git-var.adoc
@@ -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
--------
diff --git a/Documentation/gitcvs-migration.adoc b/Documentation/gitcvs-migration.adoc
index 1cd1283d0f8..2883834b714 100644
--- a/Documentation/gitcvs-migration.adoc
+++ b/Documentation/gitcvs-migration.adoc
@@ -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.
================================
diff --git a/Documentation/gitprotocol-v2.adoc b/Documentation/gitprotocol-v2.adoc
index c7db103299a..ec2562fb0a1 100644
--- a/Documentation/gitprotocol-v2.adoc
+++ b/Documentation/gitprotocol-v2.adoc
@@ -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]).
diff --git a/Documentation/gittutorial.adoc b/Documentation/gittutorial.adoc
index f89ad30cf65..519b8d8be2c 100644
--- a/Documentation/gittutorial.adoc
+++ b/Documentation/gittutorial.adoc
@@ -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
diff --git a/Documentation/technical/api-trace2.adoc b/Documentation/technical/api-trace2.adoc
index cf493dae03f..918e517c2e6 100644
--- a/Documentation/technical/api-trace2.adoc
+++ b/Documentation/technical/api-trace2.adoc
@@ -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
diff --git a/Documentation/user-manual.adoc b/Documentation/user-manual.adoc
index 76969871176..3cd94c7afa1 100644
--- a/Documentation/user-manual.adoc
+++ b/Documentation/user-manual.adoc
@@ -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
--
2.53.0.32.gf6228eaf9cc