diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index a97c96619d..c64914a304 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2348,7 +2348,7 @@
Most software provides some means of setting build-time
configuration options before compilation.
Typically, setting these options is accomplished by running a
- configure script with some options, or by modifying a build
+ configure script with options, or by modifying a build
configuration file.
As of Yocto Project Release 1.7, some of the core recipes
@@ -2388,6 +2388,7 @@
software is built using Autotools.
If this is the case, you just need to worry about
modifying the configuration.
+
When using Autotools, your recipe needs to inherit
the
autotools
@@ -2400,13 +2401,15 @@
or
PACKAGECONFIG_CONFARGS
to pass any needed configure options that are specific
- to the recipe.
+ to the recipe.
+
CMake:
If your source files have a
CMakeLists.txt file, then your
software is built using CMake.
If this is the case, you just need to worry about
modifying the configuration.
+
When you use CMake, your recipe needs to inherit
the
cmake
@@ -2416,7 +2419,16 @@
You can make some adjustments by setting
EXTRA_OECMAKE
to pass any needed configure options that are specific
- to the recipe.
+ to the recipe.
+
+ If you need to install one or more custom CMake
+ toolchain files that are supplied by the
+ application you are building, install the files to
+ ${D}${datadir}/cmake/ Modules
+ during
+ do_install.
+
+
Other:
If your source files do not have a
configure.ac or
@@ -2779,6 +2791,14 @@
PARALLEL_MAKEINST
for additional information.
+
+ If you need to install one or more custom CMake
+ toolchain files that are supplied by the
+ application you are building, install the files to
+ ${D}${datadir}/cmake/ Modules
+ during
+ do_install.
+
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index ece47e757b..76ae334b24 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -445,6 +445,14 @@
variable to specify additional configuration options to be passed
using the cmake command line.
+
+
+ On the occasion that you would be installing custom CMake toolchain
+ files supplied by the application being built, you should install them
+ to the preferred CMake Module directory:
+ ${D}${datadir}/cmake/ Modules during
+ do_install.
+