git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2 4/5] doc: config: use --value instead of value-pattern

From
Kkristofferhaugsbakk@fastmail.com <kristofferhaugsbakk@fastmail.com>
Date
Jul 1, 2025, 15:14 UTC
Message-ID
<e5eee1a0541b2b540bdac92b6b81858bf1eaed93.1751382830.git.code@khaugsbakk.name>
In-Reply-To
<cover.1751382830.git.code@khaugsbakk.name>
From: Kristoffer Haugsbakk <code@khaugsbakk.name>

This option was introduced in a series of commits from fe3ccc7aab (Merge branch 'ps/config-subcommands', 2024-05-15) and deprecated `value-pattern`. But `value-pattern` is still used throughout the doc.

The deprecated modes have been quarantined in the “Deprecated Modes” section. So let’s only use `--value=<pattern>` in the rest of the doc.

Acked-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
---
 Documentation/git-config.adoc | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/Documentation/git-config.adoc b/Documentation/git-config.adoc
index 03808b18d3e..9d8f9bb04e5 100644
--- a/Documentation/git-config.adoc
+++ b/Documentation/git-config.adoc
@@ -26,7 +26,7 @@ escaped.
 
 Multiple lines can be added to an option by using the `--append` option.
 If you want to update or unset an option which can occur on multiple
-lines, a `value-pattern` (which is an extended regular expression,
+lines, `--value=<pattern>` (which is an extended regular expression,
 unless the `--fixed-value` option is given) needs to be given.  Only the
 existing values that match the pattern are updated or unset.  If
 you want to handle the lines that do *not* match the pattern, just
@@ -109,7 +109,7 @@ OPTIONS
 
 --replace-all::
 	Default behavior is to replace at most one line. This replaces
-	all lines matching the key (and optionally the `value-pattern`).
+	all lines matching the key (and optionally `--value=<pattern>`).
 
 --append::
 	Adds a new line to the option without altering any existing
@@ -209,10 +209,10 @@ See also <<FILES>>.
 Use `--no-value` to unset _<pattern>_.
 
 --fixed-value::
-	When used with the `value-pattern` argument, treat `value-pattern` as
+	When used with `--value=<pattern>`, treat _<pattern>_ as
 	an exact string instead of a regular expression. This will restrict
 	the name/value pairs that are matched to only those where the value
-	is exactly equal to the `value-pattern`.
+	is exactly equal to _<pattern>_.
 
 --type <type>::
   'git config' will ensure that any input or output is valid under the given
-- 
2.50.0.136.g303b50f9132
Previous: kristofferhaugsbakk@fastmail.comNext: kristofferhaugsbakk@fastmail.com
Message 20 of 22 in “doc: config: update for the ps/config-subcommands series”
  1. 0/5 doc: config: update for the ps/config-subcommands serieskristofferhaugsbakk@fastmail.com, Jun 30, 2025
  2. 1/5 doc: config: document --[no-]show-nameskristofferhaugsbakk@fastmail.com, Jun 30, 2025
  3. 2/5 doc: config: use --value=<pattern> consistentlykristofferhaugsbakk@fastmail.com, Jun 30, 2025
  4. Kristoffer HaugsbakkJul 1, 2025
  5. Kristoffer HaugsbakkJul 1, 2025
  6. 3/5 doc: config: document --[no-]valuekristofferhaugsbakk@fastmail.com, Jun 30, 2025
  7. Eric SunshineJun 30, 2025
  8. 4/5 doc: config: use --value instead of value-patternkristofferhaugsbakk@fastmail.com, Jun 30, 2025
  9. 5/5 doc: config: mention --url in the synopsiskristofferhaugsbakk@fastmail.com, Jun 30, 2025
  10. Kristoffer HaugsbakkJul 1, 2025
  11. Junio C HamanoJun 30, 2025
  12. Kristoffer HaugsbakkJul 1, 2025
  13. Patrick SteinhardtJul 1, 2025
  14. Kristoffer HaugsbakkJul 1, 2025
  15. Junio C HamanoJul 1, 2025
  16. 0/5 doc: config: update for the ps/config-subcommands serieskristofferhaugsbakk@fastmail.com, Jul 1, 2025
  17. 1/5 doc: config: document --[no-]show-nameskristofferhaugsbakk@fastmail.com, Jul 1, 2025
  18. 2/5 config: use --value=<pattern> consistentlykristofferhaugsbakk@fastmail.com, Jul 1, 2025
  19. 3/5 doc: config: document --[no-]valuekristofferhaugsbakk@fastmail.com, Jul 1, 2025
  20. 4/5 doc: config: use --value instead of value-patternkristofferhaugsbakk@fastmail.com, Jul 1, 2025
  21. 5/5 config: mention --url in the synopsiskristofferhaugsbakk@fastmail.com, Jul 1, 2025
  22. Junio C HamanoJul 1, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.