tmpfiles,sysusers: rework path argument handling

[thirdparty/systemd.git] / man / systemd-tmpfiles.xml

diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index c30a046f72689168a073278ba6dc9d223d6b1868..3a3924a084f58cba13b1486a6c28c4c5abc2f5df 100644 (file)
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -62,14 +62,17 @@
     be invoked with one or more options <option>--create</option>, <option>--remove</option>, and
     <option>--clean</option>, to select the respective subset of operations.</para>
 
-    <para>By default, directives from all configuration files are applied. When invoked with
-    <option>--replace=<replaceable>PATH</replaceable></option>, arguments specified on the command line are
-    used instead of the configuration file <replaceable>PATH</replaceable>. Otherwise, if one or more
-    absolute filenames are passed on the command line, only the directives in these files are applied. If
-    <literal>-</literal> is specified instead of a filename, directives are read from standard input. If only
-    the basename of a configuration file is specified, all configuration directories as specified in
-    <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry> are
-    searched for a matching file and the file found that has the highest priority is executed.</para>
+    <para>If invoked with no arguments, directives from the configuration files found in the directories
+    specified by
+    <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>. When
+    invoked with positional arguments, if option <option>--replace=<replaceable>PATH</replaceable></option>
+    is specified, arguments specified on the command line are used instead of the configuration file
+    <replaceable>PATH</replaceable>. Otherwise, just the configuration specified by the command line
+    arguments is executed. If the string <literal>-</literal> is specified instead of a filename, the
+    configuration is read from standard input. If the argument is a file name (without any slashes), all
+    configuration directories are searched for a matching file and the file found that has the highest
+    priority is executed. If the argument is a path, that file is used directly without searching the
+    configuration directories for any other matching file.</para>
 
     <para>System services (<filename>systemd-tmpfiles-setup.service</filename>,
     <filename>systemd-tmpfiles-setup-dev-early.service</filename>,