diff --git a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
index 2bc394bba6..b9ff8cd61c 100644
--- a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
@@ -3553,6 +3553,18 @@ vfs.zfs.vdev.cache.size="5M"</programlisting>
 		    a partition rather than the entire disk.  This
 		    differs from recommendations made by the Solaris
 		    documentation.</para>
+
+		  <caution>
+		    <para>Using an entire disk as part of a bootable
+		      pool is strongly discouraged, as this may render
+		      the pool unbootable.  Likewise, you should not
+		      use an entire disk as part of a mirror or
+		      <acronym>RAID-Z</acronym> vdev.  These are
+		      because it it impossible to reliably determine
+		      the size of an unpartitioned disk at boot time
+		      and because there's no place to put in boot
+		      code.</para>
+                  </caution>
 		</listitem>
 
 		<listitem>