From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Thu, 8 Nov 2018 08:36:52 +0000 (+0100)
Subject: man: document the details of continuations and comments
X-Git-Tag: v240~381^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2ca4d779e021fdd94f4445980baa0aa8af6ffdc4;p=thirdparty%2Fsystemd.git

man: document the details of continuations and comments
---

diff --git a/man/systemd.syntax.xml b/man/systemd.syntax.xml
index 3c67e92dd58..67cd640eeac 100644
--- a/man/systemd.syntax.xml
+++ b/man/systemd.syntax.xml
@@ -73,7 +73,8 @@
     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
     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]
 KeyOne=value 1
@@ -85,6 +86,12 @@ KeyTwo=value 2
 Setting="something" "some thing" "…"
 KeyTwo=value 2 \
        value 2 continued
+
+[Section C]
+KeyThree=value 2\
+# this line is ignored
+; this line is ignored too
+       value 2 continued
 </programlisting></example>
 
     <para>Boolean arguments used in configuration files can be written in