[PATCH 1/4] Doc/config.txt: explain repeated sections

From: astian <astian@eclipso.at>
Date: Jul 8, 2017, 20:34 UTC
Message-ID: <20170708203413.16442-2-astian@eclipso.at>
In-Reply-To: <20170708203413.16442-1-astian@eclipso.at>

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@eclipso.at>
---
 Documentation/config.txt | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/config.txt b/Documentation/config.txt
index d5c9c4cab..afce25705 100644
--- a/Documentation/config.txt
+++ b/Documentation/config.txt
@@ -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:

-- 
2.13.2