diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 0dddb8b3bb..00741ee456 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2349,7 +2349,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
@@ -2389,6 +2389,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
@@ -2401,13 +2402,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
@@ -2417,7 +2420,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
@@ -2780,6 +2792,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 5403f20b6f..f9bbddd724 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -428,6 +428,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.
+