config: document --[no-]show-names

These options were introduced in 4e51389000 (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>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Kristoffer Haugsbakk 2025-07-01 17:14:28 +02:00 committed by Junio C Hamano
parent 16bd9f20a4
commit 88a4ed40c0
1 changed files with 6 additions and 0 deletions

View File

@ -259,6 +259,12 @@ Valid `<type>`'s include:
Output only the names of config variables for `list` or Output only the names of config variables for `list` or
`get`. `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:: --show-origin::
Augment the output of all queried config options with the Augment the output of all queried config options with the
origin type (file, standard input, blob, command line) and origin type (file, standard input, blob, command line) and