Documentation/config.txt: explain multi-valued variables once
The syntax section repeats what the preamble explained already. That a variable can have multiple values is more about what a variable is than the syntax of the file. Signed-off-by: Junio C Hamano <gitster@pobox.com>
Junio C Hamano committed
Mar 4, 2015 at 10:26 UTC
a5285b6c231b55e71007d89a4a29b151302abe09
1 file changed
+3
-4
Documentation/config.txt
+3
-4
@@ -14,7 +14,8 @@ the fully qualified variable name of the variable itself is the last
14
dot-separated segment and the section name is everything before the last
15
dot. The variable names are case-insensitive, allow only alphanumeric
16
characters and `-`, and must start with an alphabetic character. Some
17
-variables may appear multiple times.
17
+variables may appear multiple times; we say then that the variable is
18
+multivalued.
19
20
Syntax
21
~~~~~~
@@ -56,9 +57,7 @@ header) are recognized as setting variables, in the form
57
'name = value'. If there is no equal sign on the line, the entire line
58
is taken as 'name' and the variable is recognized as boolean "true".
59
The variable names are case-insensitive, allow only alphanumeric characters
59
-and `-`, and must start with an alphabetic character. There can be more
60
-than one value for a given variable; we say then that the variable is
61
-multivalued.
60
+and `-`, and must start with an alphabetic character.
61
62
Leading and trailing whitespace in a variable value is discarded.
63
Internal whitespace within a variable value is retained verbatim.