[cmake-developers] [PATCH] WINCE: Add toolchain documentation for Windows CE

[Pascal Bach]

---
 Help/manual/cmake-toolchains.7.rst |   20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/Help/manual/cmake-toolchains.7.rst b/Help/manual/cmake-toolchains.7.rst
index f36a43c..095a43f 100644
--- a/Help/manual/cmake-toolchains.7.rst
+++ b/Help/manual/cmake-toolchains.7.rst
@@ -174,5 +174,25 @@ toolchain which will be used by the compiler driver. The
 :variable:`CMAKE_<LANG>_COMPILER_EXTERNAL_TOOLCHAIN` variable can be set in a
 toolchain file to pass the path to the compiler driver.
 
+Cross compiling for Windows CE requires the corresponding SDK being installed on
+your system. These SDKs are usually installed under: `C:\\Program Files (x86)\\Windows CE Tools\\SDKs`
+
+The :variable:`CMAKE_GENERATOR_PLATFORM` tells the generator which SDK to use.
+Further :variable:`CMAKE_SYSTEM_VERSION` tells the generator what version of Windows CE to use.
+Currently version 8.0 (Windows Embedded Compact 2013) is supported out of the box. Other versions
+my require to set :variable:`CMAKE_GENERATOR_TOOLSET` to the correct value.
+
+A toolchain file for Windows CE may look like this:
+
+.. code-block:: cmake
+
+  set(CMAKE_SYSTEM_NAME "WindowsCE")
+
+  set(CMAKE_SYSTEM_VERSION "8.0")
+  set(CMAKE_SYSTEM_PROCESSOR "arm" )
+
+  set(CMAKE_GENERATOR_TOOLSET "CE800") # Can be omitted for 8.0
+  set(CMAKE_GENERATOR_PLATFORM "SDK_AM335X_SK_WEC2013_V310")
+
 The :variable:`CMAKE_CROSSCOMPILING` variable is set to true when CMake is
 cross-compiling.
-- 
1.7.10.4