65878a
From 69924ed702e14592ba0aae1510fca652c7d306df Mon Sep 17 00:00:00 2001
65878a
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
65878a
Date: Sat, 14 Dec 2013 17:30:25 -0500
65878a
Subject: [PATCH] man: remove advice to avoid setting the same var more than
65878a
 once
65878a
65878a
So far the compatibility with .desktop settings hasn't been imporant
65878a
at all, and we do not want people to write convoluted unit
65878a
files.
65878a
---
65878a
 man/systemd.service.xml |  6 +-----
65878a
 man/systemd.unit.xml    | 11 +++++++++++
65878a
 2 files changed, 12 insertions(+), 5 deletions(-)
65878a
65878a
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
65878a
index ca297ba..8f9137c 100644
65878a
--- a/man/systemd.service.xml
65878a
+++ b/man/systemd.service.xml
65878a
@@ -321,11 +321,7 @@
65878a
                                 (these semicolons must be passed as
65878a
                                 separate words). Alternatively, this
65878a
                                 directive may be specified more than
65878a
-                                once with the same effect. However,
65878a
-                                the latter syntax is not recommended
65878a
-                                for compatibility with parsers
65878a
-                                suitable for XDG
65878a
-                                <filename>.desktop</filename> files.
65878a
+                                once with the same effect.
65878a
                                 Lone semicolons may be escaped as
65878a
                                 <literal>\;</literal>. If the empty
65878a
                                 string is assigned to this option, the
65878a
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
65878a
index 029392c..77127ff 100644
65878a
--- a/man/systemd.unit.xml
65878a
+++ b/man/systemd.unit.xml
65878a
@@ -120,6 +120,17 @@
65878a
                 <citerefentry><refentrytitle>systemd.scope</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
65878a
                 </para>
65878a
 
65878a
+                <para>Various settings are allowed to be specified
65878a
+                more than once, in which case the interpretation
65878a
+                depends on the setting. Often, multiple settings form
65878a
+                a list, and setting to an empty value "resets", which
65878a
+                means that previous assignments are ignored. When this
65878a
+                is allowed, it is mentioned in the description of the
65878a
+                setting. Note that using multiple assignments to the
65878a
+                same value makes the unit file incompatible with
65878a
+                parsers for the XDG <filename>.desktop</filename> file
65878a
+                format.</para>
65878a
+
65878a
                 <para>Unit files are loaded from a set of paths
65878a
                 determined during compilation, described in the next section.
65878a
                 </para>