mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation/config.txt: explain multi-valued variables once

Browse Source 
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>
This commit is contained in:
Junio C Hamano
2015-03-04 10:26:17 -08:00
parent 05c3e5c771
commit a5285b6c23
1 changed files with 3 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
Documentation/config.txt
View File

@ -14,7 +14,8 @@ the fully qualified variable name of the variable itself is the last
dot-separated segment and the section name is everything before the last dot-separated segment and the section name is everything before the last
dot. The variable names are case-insensitive, allow only alphanumeric dot. The variable names are case-insensitive, allow only alphanumeric
characters and `-`, and must start with an alphabetic character. Some characters and `-`, and must start with an alphabetic character. Some
variables may appear multiple times. variables may appear multiple times; we say then that the variable is
multivalued.
Syntax Syntax
~~~~~~ ~~~~~~
@ -56,9 +57,7 @@ header) are recognized as setting variables, in the form
'name = value'. If there is no equal sign on the line, the entire line 'name = value'. If there is no equal sign on the line, the entire line
is taken as 'name' and the variable is recognized as boolean "true". is taken as 'name' and the variable is recognized as boolean "true".
The variable names are case-insensitive, allow only alphanumeric characters The variable names are case-insensitive, allow only alphanumeric characters
and `-`, and must start with an alphabetic character. There can be more and `-`, and must start with an alphabetic character.
than one value for a given variable; we say then that the variable is
multivalued.
Leading and trailing whitespace in a variable value is discarded. Leading and trailing whitespace in a variable value is discarded.
Internal whitespace within a variable value is retained verbatim. Internal whitespace within a variable value is retained verbatim.