man: document interaction of --root= and the user/group databases (#7344)

Fixes: #7032

diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index c1aab51..2b8927c 100644 (file)
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -148,12 +148,16 @@
         specified prefix. This option can be specified multiple
         times.</para></listitem>
       </varlistentry>
+
       <varlistentry>
         <term><option>--root=<replaceable>root</replaceable></option></term>
-        <listitem><para>Takes a directory path as an argument. All
-        paths will be prefixed with the given alternate
-        <replaceable>root</replaceable> path, including config search
-        paths. </para></listitem>
+        <listitem><para>Takes a directory path as an argument. All paths will be prefixed with the given alternate
+        <replaceable>root</replaceable> path, including config search paths.</para>
+
+        <para>Note that this option does not alter how the users and groups specified in the configuration files are
+        resolved. With or without this option, users and groups are always resolved according to the host's user and
+        group databases, any such databases stored under the specified root directories are not
+        consulted.</para></listitem>
       </varlistentry>
 
       <xi:include href="standard-options.xml" xpointer="help" />