From: Mike Yuan <me@yhndnzj.com>
Date: Wed, 8 May 2024 05:55:00 +0000 (+0800)
Subject: man/run0: remove the --user example for --machine=
X-Git-Tag: v256-rc2~78
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=18303adcd3a9b16339008b5fa909a7c09247072d;p=thirdparty%2Fsystemd.git

man/run0: remove the --user example for --machine=

run0's --user= option is different from other tools,
and the whole point of run0 is to connect to the system
manager. So the example is spurious.
---

diff --git a/man/run0.xml b/man/run0.xml
index c9be24da980..3c3d5622168 100644
--- a/man/run0.xml
+++ b/man/run0.xml
@@ -200,7 +200,23 @@
         </listitem>
       </varlistentry>
 
-      <xi:include href="user-system-options.xml" xpointer="machine" />
+      <varlistentry>
+        <term><option>-M</option></term>
+        <term><option>--machine=</option></term>
+
+        <listitem>
+          <para>Execute operation on a local container. Specify a container name to connect to, optionally
+          prefixed by a user name to connect as and a separating <literal>@</literal> character. If the special
+          string <literal>.host</literal> is used in place of the container name, a connection to the local
+          system is made. If the <literal>@</literal> syntax is not used, the connection is made as root user.
+          If the <literal>@</literal> syntax is used either the left hand side or the right hand side may be
+          omitted (but not both) in which case the local user name and <literal>.host</literal> are implied.
+          </para>
+
+          <xi:include href="version-info.xml" xpointer="v256"/>
+        </listitem>
+      </varlistentry>
+
       <xi:include href="standard-options.xml" xpointer="help" />
       <xi:include href="standard-options.xml" xpointer="version" />
     </variablelist>