[rtems-docs commit] hosts/windows.rst: Add warning for spaces in PATH

[Joel Sherrill]

Module:    rtems-docs
Branch:    master
Commit:    16ba6ca0b75c86afc4763384b2aa0df18f3ac9c2
Changeset: http://git.rtems.org/rtems-docs/commit/?id=16ba6ca0b75c86afc4763384b2aa0df18f3ac9c2

Author:    Joel Sherrill <joel at rtems.org>
Date:      Mon Jun  3 11:23:01 2019 -0500

hosts/windows.rst: Add warning for spaces in PATH

---

 user/hosts/windows.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/user/hosts/windows.rst b/user/hosts/windows.rst
index 7aaa9c3..fac1366 100644
--- a/user/hosts/windows.rst
+++ b/user/hosts/windows.rst
@@ -58,6 +58,22 @@ The release packages of the RSB when unpacked have top level file names that
 are too big to build RTEMS. You need to change or rename that path to something
 smaller to build. This is indicated in :ref:`released-version`.
 
+.. _windows-spaces-in-paths:
+
+Windows Spaces In Paths
+-----------------------
+
+Occasionally, a program will fail on Windows with errors that
+appear as if a directory or file name was partially parsed by
+some utility or program. This can be caused by having directories
+of file names with spaces. Programs written in scripting languages
+sometimes fail to properly quote file names and the space is
+incorrectly interpreted. 
+
+Parts of the PATH inherited from the native Windows environment often
+include directory names with spaces. Sometimes it is necessary to set
+the PATH explicitly to avoid these.
+
 .. _msys2_parallel_builds:
 
 Parallel Builds with Make