From 2ca4d779e021fdd94f4445980baa0aa8af6ffdc4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Thu, 8 Nov 2018 09:36:52 +0100 Subject: [PATCH] man: document the details of continuations and comments --- man/systemd.syntax.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) 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. + 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. [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 Boolean arguments used in configuration files can be written in