]> git.ipfire.org Git - thirdparty/git.git/commit - Documentation/config.txt
Documentation/config.txt: describe the structure first and then meaning
authorJunio C Hamano <gitster@pobox.com>
Wed, 4 Mar 2015 18:33:38 +0000 (10:33 -0800)
committerJunio C Hamano <gitster@pobox.com>
Wed, 4 Mar 2015 19:42:34 +0000 (11:42 -0800)
commitff5507ed2a34f0eb8c8d4f0bd300d2b786031aff
treefc748e1a1cc828f4c5b4068946a1fc715dde3021
parenta5285b6c231b55e71007d89a4a29b151302abe09
Documentation/config.txt: describe the structure first and then meaning

A line can be continued via a backquote-LF and can be chomped at a
comment character.  But that is not specific to string-typed values.
It is common to all, just like unquoted leading and trailing
whitespaces are stripped and inter-word spacing are retained.

Move the description around and desribe these structural rules
first, then introduce the double-quote facility as a way to override
them, and finally mention various types of values.

Note that these structural rules only apply to the value part of the
configuration file.  E.g.

    [aSection] \
        name \
= value

does not work, because the rules kick in only after seeing "name =".
Both the original and the updated text are phrased in an awkward way
by singling out the "value" part of the line because of this.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/config.txt