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

[PATCH] config doc: indent descriptions of feature.* variables

From
Andrei Rybak <rybak.a.v@gmail.com>
Date
Jun 2, 2021, 00:11 UTC
Message-ID
<20210602001132.459705-1-rybak.a.v@gmail.com>

Config variables feature.experimental and feature.manyFiles are grouped together under "feature.*". However, this is not easily visible when scanning the help page of git-config.

Indent the descriptions of individual feature.* config variables to help the reader distinguish this group of variables.

Signed-off-by: Andrei Rybak <rybak.a.v@gmail.com>
---
 Documentation/config/feature.txt | 40 +++++++++++++++++---------------
 1 file changed, 21 insertions(+), 19 deletions(-)
diff --git a/Documentation/config/feature.txt b/Documentation/config/feature.txt
index cdecd04e5b..2c4dee170b 100644
--- a/Documentation/config/feature.txt
+++ b/Documentation/config/feature.txt
@@ -3,24 +3,26 @@ feature.*::
 	a group of other config settings. These groups are created by the Git
 	developer community as recommended defaults and are subject to change.
 	In particular, new config options may be added with different defaults.
-
-feature.experimental::
-	Enable config options that are new to Git, and are being considered for
-	future defaults. Config settings included here may be added or removed
-	with each release, including minor version updates. These settings may
-	have unintended interactions since they are so new. Please enable this
-	setting if you are interested in providing feedback on experimental
-	features. The new default values are:
 +
-* `fetch.negotiationAlgorithm=skipping` may improve fetch negotiation times by
-skipping more commits at a time, reducing the number of round trips.
+--
+	feature.experimental::
+		Enable config options that are new to Git, and are being considered for
+		future defaults. Config settings included here may be added or removed
+		with each release, including minor version updates. These settings may
+		have unintended interactions since they are so new. Please enable this
+		setting if you are interested in providing feedback on experimental
+		features. The new default values are:
+	+
+	* `fetch.negotiationAlgorithm=skipping` may improve fetch negotiation times by
+	skipping more commits at a time, reducing the number of round trips.
 
-feature.manyFiles::
-	Enable config options that optimize for repos with many files in the
-	working directory. With many files, commands such as `git status` and
-	`git checkout` may be slow and these new defaults improve performance:
-+
-* `index.version=4` enables path-prefix compression in the index.
-+
-* `core.untrackedCache=true` enables the untracked cache. This setting assumes
-that mtime is working on your machine.
+	feature.manyFiles::
+		Enable config options that optimize for repos with many files in the
+		working directory. With many files, commands such as `git status` and
+		`git checkout` may be slow and these new defaults improve performance:
+	+
+	* `index.version=4` enables path-prefix compression in the index.
+	+
+	* `core.untrackedCache=true` enables the untracked cache. This setting assumes
+	that mtime is working on your machine.
+--
-- 
2.31.1
Next: Đoàn Trần Công Danh
Message 1 of 9 in “config doc: indent descriptions of feature.* variables”
  1. config doc: indent descriptions of feature.* variablesAndrei Rybak, Jun 2, 2021
  2. Đoàn Trần Công DanhJun 2, 2021
  3. Derrick StoleeJun 2, 2021
  4. Taylor BlauJun 2, 2021
  5. Todd ZullingerJun 2, 2021
  6. Felipe ContrerasJun 2, 2021
  7. Ævar Arnfjörð BjarmasonJun 3, 2021
  8. Ævar Arnfjörð BjarmasonJun 3, 2021
  9. Felipe ContrerasJun 3, 2021

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.