diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml
index f41039b964d..a0ceb40db86 100644
--- a/man/file-hierarchy.xml
+++ b/man/file-hierarchy.xml
@@ -74,7 +74,7 @@
/boot
The boot partition used for bringing up the
system. On EFI systems, this is possibly the EFI System
- Partition, also see
+ Partition (ESP), also see
systemd-gpt-auto-generator8.
This directory is usually strictly local to the host, and
should be considered read-only, except when a new kernel or
@@ -83,6 +83,15 @@
requires boot loaders.
+
+ /efi/
+ If the boot partition /boot/ is maintained separately from the EFI System
+ Partition (ESP), the latter is mounted here. Tools that need to operate on the EFI system partition should look
+ for it at this mount point first, and fall back to /boot/ — if the former doesn't qualify
+ (for example if it is not a mount point or does not have the correct file system type
+ MSDOS_SUPER_MAGIC).
+
+
/etc
System-specific configuration. This directory