diff --git a/docs/content/docs.md b/docs/content/docs.md
index b053a8f89..392399aba 100644
--- a/docs/content/docs.md
+++ b/docs/content/docs.md
@@ -853,6 +853,9 @@ only.
 Dump HTTP headers and bodies - may contain sensitive info.  Can be
 very verbose.  Useful for debugging only.
 
+Note that the bodies are buffered in memory so don't use this for
+enormous files.
+
 ### --dump-filters ###
 
 Dump the filters to the output.  Useful to see exactly what include