man: document the details of continuations and comments

This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2018-11-08 09:36:52 +01:00 committed by Yu Watanabe
parent 9adbfeb38a
commit 2ca4d779e0
1 changed files with 8 additions and 1 deletions

View File

@ -73,7 +73,8 @@
backslash is replaced by a space character. This may be used to wrap long lines. The limit on backslash is replaced by a space character. This may be used to wrap long lines. The limit on
line length is very large (currently 1 MB), but it is recommended to avoid such long lines and line length is very large (currently 1 MB), but it is recommended to avoid such long lines and
use multiple directives, variable substitution, or other mechanism as appropriate for the given use multiple directives, variable substitution, or other mechanism as appropriate for the given
file type.</para> file type. When a comment line or lines follow a line ending with a backslash, the comment block
is ignored, so the continued line is concatenated with whatever follows the comment block.</para>
<example><programlisting>[Section A] <example><programlisting>[Section A]
KeyOne=value 1 KeyOne=value 1
@ -85,6 +86,12 @@ KeyTwo=value 2
Setting="something" "some thing" "…" Setting="something" "some thing" "…"
KeyTwo=value 2 \ KeyTwo=value 2 \
value 2 continued value 2 continued
[Section C]
KeyThree=value 2\
# this line is ignored
; this line is ignored too
value 2 continued
</programlisting></example> </programlisting></example>
<para>Boolean arguments used in configuration files can be written in <para>Boolean arguments used in configuration files can be written in