diff --git a/man/bootctl.xml b/man/bootctl.xml
index 03d01ffe44..9aa5a6b59d 100644
--- a/man/bootctl.xml
+++ b/man/bootctl.xml
@@ -34,10 +34,10 @@
Description
- bootctl can check the EFI boot loader status, list
- available entries, and install, update, or remove the
- systemd-boot7
- boot loader on the current system.
+ bootctl can check the EFI boot loader status, list available boot loaders and boot loader
+ entries, and install, update, or remove the
+ systemd-boot7 boot loader on the
+ current system.
@@ -62,7 +62,7 @@
- Do not touch the EFI boot variables.
+ Do not touch the firmware's boot loader list stored in EFI variables.
@@ -78,42 +78,44 @@
- Shows the currently installed versions of the boot loader binaries and all current
- EFI boot variables. If no command is specified, this is the implied default.
+ Shows brief information about the system firmware, the boot loader that was used to boot the
+ system, the boot loaders currently available in the ESP, the boot loaders listed in the firmware's list of boot
+ loaders and the current default boot loader entry. If no command is specified, this is the implied
+ default.
- Shows all configured boot loader entries.
+ Shows all available boot loader entries implementing the Boot Loader
+ Specification.
+
+
+
+
+
+ Installs systemd-boot into the EFI system partition. A copy of systemd-boot
+ will be stored as the EFI default/fallback loader at
+ ESP/EFI/BOOT/BOOT*.EFI. The boot loader is then added to the
+ top of the firmware's boot loader list.Updates all installed versions of
- systemd-boot7,
- if the current version is newer than the version installed in the EFI system
- partition. This also includes the EFI default/fallback loader at
- ESP/EFI/BOOT/BOOT*.EFI. A
- systemd-boot entry in the EFI boot variables is created if there is no current
- entry. The created entry will be added to the end of the boot order list.
-
-
-
-
-
- Installs systemd-boot into the EFI system partition. A copy of systemd-boot will
- be stored as the EFI default/fallback loader at
- ESP/EFI/BOOT/BOOT*.EFI. A systemd-boot entry in
- the EFI boot variables is created and added to the top of the boot order list.
+ systemd-boot7, if the
+ available version is newer than the version installed in the EFI system partition. This also includes the EFI
+ default/fallback loader at ESP/EFI/BOOT/BOOT*.EFI. The boot
+ loader is then added to end of the firmware's boot loader list if missing.
- Removes all installed versions of systemd-boot from the EFI system partition,
- and removes systemd-boot from the EFI boot variables.
+ Removes all installed versions of systemd-boot from the EFI system partition
+ and the firmware's boot loader list.