NEWS/--help: correct/be clearer on bootclt -R vs. -RR

The NEWS file was simply wrong. Let's also improve the --help text on
this.

Fixes: #28221

diff --git a/NEWS b/NEWS
index 3e673557daa1135531a0b0be0b74216e4fe3ede1..ed9c8d51fe2df2439c9b635b0f61df812dd64b90 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -221,9 +221,11 @@ CHANGES WITH 254 in spe:
         systemd-boot, systemd-stub, ukify, bootctl, kernel-install:
 
         * bootctl gained a new switch --print-root-device/-R that prints the
-          main block device the root file system is backed by. It's useful for
-          invocations such as "cfdisk $(bootctl -R)" to quickly show the
-          partition table of the running OS.
+          block device the root file system is backed by. If specified twice,
+          it returns the whole disk block device (as opposed to partition block
+          device) the root file system is on. It's useful for invocations such
+          as "cfdisk $(bootctl -RR)" to quickly show the partition table of the
+          running OS.
 
         * systemd-stub will now look for the SMBIOS Type 1 field
           "io.systemd.stub.kernel-cmdline-extra" and append its value to the

diff --git a/src/boot/bootctl.c b/src/boot/bootctl.c
index 160cf83ce6a6df8c1b7219971a23bdd17f065a67..a86ab84d1907c5d52b56f125d5601df79b93d761 100644 (file)
--- a/src/boot/bootctl.c
+++ b/src/boot/bootctl.c
@@ -178,7 +178,10 @@ static int help(int argc, char *argv[], void *userdata) {
                "  -p --print-esp-path  Print path to the EFI System Partition mount point\n"
                "  -x --print-boot-path Print path to the $BOOT partition mount point\n"
                "  -R --print-root-device\n"
-               "                       Print path to the root device node\n"
+               "                       Print path to the block device node backing the\n"
+               "                       root file system (returns e.g. /dev/nvme0n1p5)\n"
+               "  -RR                  Print path to the whole disk block device node\n"
+               "                       backing the root FS (returns e.g. /dev/nvme0n1)\n"
                "     --no-variables    Don't touch EFI variables\n"
                "     --no-pager        Do not pipe output into a pager\n"
                "     --graceful        Don't fail when the ESP cannot be found or EFI\n"