man: document --prompt-new-user which was added back in v256

(cherry picked from commit 6f496236bc3241a9aa191d9e084f566771286d3a)
(cherry picked from commit f207d22c780c1a641d79bb5f1b759bc3d2c05d59)

diff --git a/man/homectl.xml b/man/homectl.xml
index 0b0ec13284a1901d35bbf6f218c45c242f31605a..f0c6217f344bfc3cdbec3f705851c82bdaf2e8fa 100644 (file)
--- a/man/homectl.xml
+++ b/man/homectl.xml
@@ -179,6 +179,16 @@
         <xi:include href="version-info.xml" xpointer="v256"/></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><option>--prompt-new-user</option></term>
+
+        <listitem><para>If used in conjunction with <command>firstboot</command> and no regular user account
+        exists on the system so far the tool will interactively query for user information and create an
+        account.</para>
+
+        <xi:include href="version-info.xml" xpointer="v256"/></listitem>
+      </varlistentry>
+
       <xi:include href="user-system-options.xml" xpointer="host" />
       <xi:include href="user-system-options.xml" xpointer="machine" />
 
@@ -1212,9 +1222,10 @@
 
         <listitem><para>This command is supposed to be invoked during the initial boot of the system. It
         checks whether any regular home area exists so far, and if not queries the user interactively on the
-        console for user name and password and creates one. Alternatively, if one or more service credentials
-        whose name starts with <literal>home.create.</literal> are passed to the command (containing a user
-        record in JSON format) these users are automatically created at boot.</para>
+        console for user name and password and creates one (only if <option>--prompt-new-user</option> is
+        specified). Alternatively, if one or more service credentials whose name starts with
+        <literal>home.create.</literal> are passed to the command (containing a user record in JSON format)
+        these users are automatically created at boot.</para>
 
         <para>This command is invoked by the <filename>systemd-homed-firstboot.service</filename> service
         unit.</para>