diff --git a/documentation/poky-ref-manual/ref-classes.xml b/documentation/poky-ref-manual/ref-classes.xml
index 09b3161fb7..e2bf9fed99 100644
--- a/documentation/poky-ref-manual/ref-classes.xml
+++ b/documentation/poky-ref-manual/ref-classes.xml
@@ -567,6 +567,9 @@
BBCLASSEXTEND variable.
When you do, the B variable must support the
recipe's ability to build variants in different working directories.
+ Most autotools-based recipes support separating these directories.
+ The Yocto Project defaults to using separate directories for gcc
+ and some kernel recipes.
Alternatively, you can make sure that separate recipes exist that each
use the BBCLASSEXTEND variable to build each variant.
The separate recipes can inherit a single target recipe.
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 07715bea4e..fe1c63528c 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -76,8 +76,9 @@
You can separate the source directory (S) and the directory pointed to
by the B variable.
- In general, autotools, recipes such as gcc,
- and some kernel recipes separate these directories by default.
+ Most autotools-based recipes support separating these directories.
+ The Yocto Project defaults to using separate directories for gcc
+ and some kernel recipes.