man: say that we ignore ignored options
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 4 Mar 2022 13:13:56 +0000 (14:13 +0100)
committerLuca Boccassi <luca.boccassi@gmail.com>
Sat, 5 Mar 2022 21:03:32 +0000 (21:03 +0000)
Fixes #22057.

(cherry picked from commit 382586894b9c09974aa734a1f77d3f6f69126d76)

man/systemd.unit.xml

index 2a44b8cfd8ebd0fd4c8b43fe597dcab6309e8e60..f17fa66b110815c2b241f275bd27aa19429037b7 100644 (file)
     <literal>@</literal> and the unit type suffix. In the unit file itself, the instance parameter may be
     referred to using <literal>%i</literal> and other specifiers, see below.</para>
 
-    <para>Unit files may contain additional options on top of those
-    listed here. If systemd encounters an unknown option, it will
-    write a warning log message but continue loading the unit. If an
-    option or section name is prefixed with <option>X-</option>, it is
-    ignored completely by systemd. Options within an ignored section
-    do not need the prefix. Applications may use this to include
-    additional information in the unit files.</para>
+    <para>Unit files may contain additional options on top of those listed here. If systemd encounters an
+    unknown option, it will write a warning log message but continue loading the unit. If an option or
+    section name is prefixed with <option>X-</option>, it is ignored completely by systemd. Options within an
+    ignored section do not need the prefix. Applications may use this to include additional information in
+    the unit files. To access those options, applications need to parse the unit files on their own.</para>
 
     <para>Units can be aliased (have an alternative name), by creating a symlink from the new name to the
     existing name in one of the unit search paths. For example, <filename>systemd-networkd.service</filename>