diff --git a/man/loader.conf.xml b/man/loader.conf.xml
index 3bd8597164..1d441654f8 100644
--- a/man/loader.conf.xml
+++ b/man/loader.conf.xml
@@ -53,6 +53,12 @@
Those files are described by the
Boot Loader
Specification.
+
+ Note: the behaviour of systemd-boot is also influenced by EFI variables. Some of
+ the settings specified in this file can be overridden by those, for example the default boot menu entry
+ or the menu timeouts. See
+ systemd-boot7 for
+ details.
diff --git a/man/systemd-boot.xml b/man/systemd-boot.xml
index 3482968812..14e5cd6f96 100644
--- a/man/systemd-boot.xml
+++ b/man/systemd-boot.xml
@@ -149,6 +149,8 @@
dMake selected entry the default
+ An EFI variable is set to allow this setting to persist.
+
@@ -164,6 +166,8 @@
tIncrease the timeout before default entry is booted
+ An EFI variable is set to allow this setting to persist.
+
@@ -172,6 +176,8 @@
TDecrease the timeout
+ An EFI variable is set to allow this setting to persist.
+
@@ -179,6 +185,8 @@
rChange screen resolution, skipping any unsupported modes.
+ An EFI variable is set to allow this setting to persist.
+
@@ -186,6 +194,8 @@
RReset screen resolution to firmware or configuration file default.
+ An EFI variable is set to allow this setting to persist.
+
@@ -389,9 +399,9 @@
EFI Variables
- The following EFI variables are defined, set and read by systemd-boot, under the
- vendor UUID 4a67b082-0a4c-41cf-b6c7-440b29bb8c4f, for communication between the boot
- loader and the OS:
+ The following EFI variables are defined, and may be set or read by systemd-boot
+ for communication between the boot loader and the OS. The vendor UUID
+ 4a67b082-0a4c-41cf-b6c7-440b29bb8c4f is used in all cases.
@@ -465,13 +475,13 @@
LoaderEntrySysFailLoaderEntryOneShot
- The identifier of the default boot loader entry. Set primarily by the OS and read by the boot
+ The identifier of the default boot loader entry. Can be set in the OS and the boot
loader. LoaderEntryOneShot sets the default entry for the next boot only, while
- LoaderEntryDefault sets it persistently for all future
- boots. bootctl1's
- and commands make use of these variables. The boot
- loader modifies LoaderEntryDefault on request, when the d key is used, see
- above.
+ LoaderEntryDefault sets it persistently for all future boots.
+ bootctl1's
+ and commands make use of these variables.
+ The boot loader modifies LoaderEntryDefault on request, when the
+ d key is used, see above.