summaryrefslogtreecommitdiff
path: root/man/systemd.syntax.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2018-11-08 09:36:52 +0100
committerYu Watanabe <watanabe.yu+github@gmail.com>2018-11-08 18:09:04 +0900
commit2ca4d779e021fdd94f4445980baa0aa8af6ffdc4 (patch)
tree4b4ecdafb9bc1087751363de592f6d5e61a3f926 /man/systemd.syntax.xml
parent9adbfeb38ac101d6f73a033bb120d63513ffb240 (diff)
downloadsystemd-2ca4d779e021fdd94f4445980baa0aa8af6ffdc4.tar.gz
man: document the details of continuations and comments
Diffstat (limited to 'man/systemd.syntax.xml')
-rw-r--r--man/systemd.syntax.xml9
1 files changed, 8 insertions, 1 deletions
diff --git a/man/systemd.syntax.xml b/man/systemd.syntax.xml
index 3c67e92dd5..67cd640eea 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