[PATCH 1/4] Doc/config.txt: explain repeated sections
- Date: Sat, 8 Jul 2017 20:34:10 +0000
- From: astian <astian@xxxxxxxxxx>
- Subject: [PATCH 1/4] Doc/config.txt: explain repeated sections
Add a paragraph explaining what happens when a section name is repeated
in the configuration file(s).
The example configuration file shown in this document already implied
Git's behaviour, this patch simply tries to make it explicit.
Signed-off-by: astian <astian@xxxxxxxxxx>
Documentation/config.txt | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/Documentation/config.txt b/Documentation/config.txt
index d5c9c4cab..afce25705 100644
@@ -31,6 +31,10 @@ characters, `-` and `.` are allowed in section names. Each variable
must belong to some section, which means that there must be a section
header before the first setting of a variable.
+Multiple occurrences of the same section are all logically merged. (There's
+no special treatment for variables defined multiple times across physically
+different sections, the variable is simply made multivalued.)
Sections can be further divided into subsections. To begin a subsection
put its name in double quotes, separated by space from the section name,
in the section header, like in the example below: