diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index f660aa685c..b0b2f82ee0 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -862,8 +862,11 @@
be allowed to swap them out. For QEMU/KVM this requires
hard_limit
memory tuning
element to be used and set to the maximum memory configured for the
- domain plus any memory consumed by the QEMU process itself.
- Since 1.0.6
+ domain plus any memory consumed by the QEMU process itself. Beware of
+ setting the memory limit too high (and thus allowing the domain to lock
+ most of the host's memory). Doing so may be dangerous to both the
+ domain and the host itself since the host's kernel may run out of
+ memory. Since 1.0.6