diff --git a/Documentation/btrfs-man5.asciidoc b/Documentation/btrfs-man5.asciidoc
index c358cef1..ddb2e739 100644
--- a/Documentation/btrfs-man5.asciidoc
+++ b/Documentation/btrfs-man5.asciidoc
@@ -16,9 +16,11 @@ tools.  Currently covers:
 
 3. filesystem limits
 
-4. file attributes
+4. bootloader support
 
-5. control device
+5. file attributes
+
+6. control device
 
 
 MOUNT OPTIONS
@@ -657,6 +659,16 @@ maximum number of hardlinks of a file in a directory::
 100 otherwise
 
 
+BOOTLOADER SUPPORT
+------------------
+
+GRUB2 (https://www.gnu.org/software/grub) has the most advanced support of
+booting from BTRFS with respect to features.
+
+EXTLINUX (from the https://syslinux.org project) can boot but does not support
+all features. Please check the upstream documentation before you use it.
+
+
 FILE ATTRIBUTES
 ---------------
 The btrfs filesystem supports setting the following file attributes using the