diff --git a/documentation/ref-manual/ref-structure.xml b/documentation/ref-manual/ref-structure.xml
index 42c0fb3b68..0bb0cac7a7 100644
--- a/documentation/ref-manual/ref-structure.xml
+++ b/documentation/ref-manual/ref-structure.xml
@@ -797,6 +797,25 @@
+
+ build/tmp/sysroots-components/
+
+
+ This directory is the location of the sysroot contents that the
+ task
+ do_prepare_recipe_sysroot
+ links or copies into the recipe-specific sysroot for each
+ recipe listed in
+ DEPENDS.
+ Population of this directory is handled through shared state, while
+ the path is specified by the COMPONENTS_DIR
+ variable. Apart from a few unusual circumstances, handling of the
+ sysroots-components directory should be
+ automatic, and recipes should not directly reference
+ build/tmp/sysroots-components.
+
+
+
build/tmp/sysroots/