From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Wed, 6 Sep 2023 07:59:11 +0000 (+0200)
Subject: man/systemd-id128: fix example
X-Git-Tag: v255-rc1~561^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b477c6949a4c3cd6b861b473134b3f2630292c68;p=thirdparty%2Fsystemd.git

man/systemd-id128: fix example

The example was supposed to show how
machine-id/new/machine-id --app-specific/show --app-specific tie together, but
the verb was ommitted.

I also extended the explanation a bit and used long option form in the first
example for more clarity. In the second, more complicated example, the
one-letter form is used for brevity.

Noticed in post-review:
https://github.com/systemd/systemd/pull/28988/commits/b37e8184a5a376749fbf68674ed6d7a4fc9901aa#r1315678438
---

diff --git a/man/systemd-id128.xml b/man/systemd-id128.xml
index 32226363cb2..32c5af96710 100644
--- a/man/systemd-id128.xml
+++ b/man/systemd-id128.xml
@@ -161,10 +161,10 @@
     <example>
       <title>Show a well-known UUID</title>
       <programlisting>
-$ systemd-id128 show -P user-home
+$ systemd-id128 show --value user-home
 773f91ef66d449b5bd83d683bf40ad16
 
-$ systemd-id128 show -Pu user-home
+$ systemd-id128 show --value --uuid user-home
 773f91ef-66d4-49b5-bd83-d683bf40ad16
 
 $ systemd-id128 show 773f91ef-66d4-49b5-bd83-d683bf40ad16
@@ -183,16 +183,18 @@ $ systemd-id128 machine-id -u
 $ systemd-id128 new -u
 1fb8f24b-02df-458d-9659-cc8ace68e28a
 
-$ systemd-id128 --app=1fb8f24b-02df-458d-9659-cc8ace68e28a
+$ systemd-id128 machine-id -u -a 1fb8f24b-02df-458d-9659-cc8ace68e28a
 47b82cb1-5339-43da-b2a6-1c350aef1bd1
 
-$ systemd-id128 -Pu show 3a9d668b-4db7-4939-8a4a-5e78a03bffb7 --app=1fb8f24b-02df-458d-9659-cc8ace68e28a
+$ systemd-id128 -Pu show 3a9d668b-4db7-4939-8a4a-5e78a03bffb7 \
+    -a 1fb8f24b-02df-458d-9659-cc8ace68e28a
 47b82cb1-5339-43da-b2a6-1c350aef1bd1
       </programlisting>
 
       <para>On a given machine with the ID 3a9d668b-4db7-4939-8a4a-5e78a03bffb7, for the application
-      1fb8f24b-02df-458d-9659-cc8ace68e28a, we generate an application-specific machine ID. If we want to
-      later recreate the same calculation on a different machine, we need to specify both IDs explicitly.
+      1fb8f24b-02df-458d-9659-cc8ace68e28a, we generate an application-specific machine ID
+      (47b82cb1-5339-43da-b2a6-1c350aef1bd1). If we want to later recreate the same calculation on a
+      different machine, we need to specify both IDs explicitly as parameters to <command>show</command>.
       </para>
     </example>
   </refsect1>