From: Lennart Poettering <lennart@poettering.net>
Date: Fri, 10 Sep 2021 08:32:25 +0000 (+0200)
Subject: id128: clarify that the "well-known" IDs are about GPT partition types
X-Git-Tag: v250-rc1~703
X-Git-Url: http://git-history.diyao.me/?a=commitdiff_plain;h=215e19eb27991813acb363bdcff283b868da5619;p=systemd%2F.git

id128: clarify that the "well-known" IDs are about GPT partition types

At least for now they are all GPT partition types, and we should mention
that.
---

diff --git a/man/systemd-id128.xml b/man/systemd-id128.xml
index 21cbf1604f..5fc78a44fe 100644
--- a/man/systemd-id128.xml
+++ b/man/systemd-id128.xml
@@ -74,9 +74,11 @@
     <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
     </para>
 
-    <para>With <command>show</command>, well-known UUIDs are printed. When no arguments are specified, all
-    known UUIDs are shown. When arguments are specified, they must be the names or values of one or more
-    known UUIDs, which are then printed.</para>
+    <para>With <command>show</command>, well-known IDs are printed (for now, only GPT partition type UUIDs),
+    along with brief identifier strings. When no arguments are specified, all known IDs are shown. When
+    arguments are specified, they must be the identifiers or ID values of one or more known IDs, which are
+    then printed. Combine with <option>--uuid</option> to list the IDs in UUID style, i.e. the way GPT
+    partition type UUIDs are usually shown.</para>
   </refsect1>
 
   <refsect1>
diff --git a/src/id128/id128.c b/src/id128/id128.c
index 89b944f8c0..484a72677d 100644
--- a/src/id128/id128.c
+++ b/src/id128/id128.c
@@ -160,7 +160,7 @@ static int help(void) {
                "  machine-id              Print the ID of current machine\n"
                "  boot-id                 Print the ID of current boot\n"
                "  invocation-id           Print the ID of current invocation\n"
-               "  show [NAME]             Print one or more well-known IDs\n"
+               "  show [NAME]             Print one or more well-known GPT partition type IDs\n"
                "  help                    Show this help\n"
                "\nOptions:\n"
                "  -h --help               Show this help\n"