[PATCH v2 1/5] doc: config: document --[no-]show-names
- From
- kristofferhaugsbakk@fastmail.com <kristofferhaugsbakk@fastmail.com>
- Date
- Jul 1, 2025, 15:14 UTC
- Message-ID
- <3c90ec17459096bab7f1268c7b5e5e3e7f7bcccd.1751382830.git.code@khaugsbakk.name>
- In-Reply-To
- <cover.1751382830.git.code@khaugsbakk.name>
From: Kristoffer Haugsbakk <code@khaugsbakk.name>
These options were introduced in 4e513890008 (builtin/config: introduce "get" subcommand, 2024-05-06) but not documented here. Use the description from the source code.
Document this option and the negated form according to the current convention.[1]
`--show-names` is also the default when `--get-regexp` is given. But don’t mention it here since all the deprecated modes are quarantined in the “Deprecated Modes” section.
[1]: https://lore.kernel.org/git/xmqqcyct1mtq.fsf@gitster.g/
Acked-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name> ---
Notes (series):
>The default is `--no-show-names` unless `--url` is given and there are
> no subsections in _<name>_.
See: d4770964d50 (config: "git config --get-urlmatch" parses
section.<url>.key, 2013-07-31)Documentation/git-config.adoc | 6 ++++++ 1 file changed, 6 insertions(+)
diff --git a/Documentation/git-config.adoc b/Documentation/git-config.adoc index 936e0c5130f..e05bf813d46 100644 --- a/Documentation/git-config.adoc +++ b/Documentation/git-config.adoc @@ -259,6 +259,12 @@ Valid `<type>`'s include: Output only the names of config variables for `list` or `get`. +`--show-names`:: +`--no-show-names`:: + With `get`, show config keys in addition to their values. The + default is `--no-show-names` unless `--url` is given and there + are no subsections in _<name>_. + --show-origin:: Augment the output of all queried config options with the origin type (file, standard input, blob, command line) and
-- 2.50.0.136.g303b50f9132