diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index bb01131c05..37f705b0ee 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -347,8 +347,13 @@
the poky Git repository
git://git.yoctoproject.org/poky.
Sometimes you might here the term "poky directory" used to refer to this
- directory structure.
-
+ directory structure.
+
+ The OpenEmbedded build system does not support file or directory names that
+ contain spaces.
+ Be sure that the Source Directory you use does not contain these types
+ of names.
+ The Source Directory contains BitBake, Documentation, metadata and
other files that all support the Yocto Project.
Consequently, you must have the Source Directory in place on your development
diff --git a/documentation/poky-ref-manual/ref-structure.xml b/documentation/poky-ref-manual/ref-structure.xml
index be2773b624..c2644df374 100644
--- a/documentation/poky-ref-manual/ref-structure.xml
+++ b/documentation/poky-ref-manual/ref-structure.xml
@@ -19,6 +19,13 @@
section in the Yocto Project Development Manual.
+
+ The OpenEmbedded build system does not support file or directory names that
+ contain spaces.
+ Be sure that the Source Directory you use does not contain these types
+ of names.
+
+
Top level core components
@@ -177,6 +184,15 @@
$ source &OE_INIT_FILE; ~/mybuilds
+
+ The OpenEmbedded build system does not support file or directory names that
+ contain spaces.
+ If you attempt to run the &OE_INIT_FILE; script
+ from a Source Directory that contains spaces in either the filenames
+ or directory names, the script returns an error indicating no such
+ file or directory.
+ Be sure to use a Source Directory free of names containing spaces.
+
diff --git a/documentation/poky-ref-manual/usingpoky.xml b/documentation/poky-ref-manual/usingpoky.xml
index bc82c70d90..567e721e4e 100644
--- a/documentation/poky-ref-manual/usingpoky.xml
+++ b/documentation/poky-ref-manual/usingpoky.xml
@@ -28,7 +28,7 @@
The first thing you need to do is set up the OpenEmbedded build environment by sourcing
- the environment setup script as follows:
+ the environment setup script as follows:
$ source &OE_INIT_FILE; [build_dir]
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index 3594b6ea50..78eb144162 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -407,7 +407,8 @@
directory.The third and fourth commands change the working directory to the
Source Directory
- and run the Yocto Project environment setup script.
+ and run the Yocto Project
+ environment setup script.
Running this script defines OpenEmbedded build environment settings needed to
complete the build.
The script also creates the