diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index e34843512a..3c8ed8249f 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2827,6 +2827,18 @@
those from foo-dev, into
the sysroot.
+
+ One recipe having another recipe in
+ DEPENDS does not by itself
+ add any runtime dependencies between the
+ packages produced by the two recipes.
+ However, as explained in the
+ RDEPENDS
+ glossary entry, runtime dependencies will often
+ be added automatically, meaning
+ DEPENDS alone is
+ sufficient for most recipes.
+
Counterintuitively,
DEPENDS is often necessary