diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 329d97838e..585f4ad4da 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1911,18 +1911,18 @@
Installing
- During do_install, the files and their
- structure that your recipe built are copied to locations on the
- target device.
- The installation process moves the
+ During do_install, the task copies the
+ built files along with their hierarchy to locations that
+ would mirror their locations on the target device.
+ The installation process copies files from the
${S},
${B},
and
${WORKDIR}
- to the
+ directories to the
${D}
- to create the structure as it should appear on the target
- system.
+ directory to create the structure as it should appear on the
+ target system.
@@ -1939,6 +1939,12 @@
Consequently, you do not have to have a
do_install task as part of your
recipe.
+ However, if you wish to install additional files not
+ already being installed by
+ make install, you should do this
+ using a do_install_append function
+ using the install command as described in
+ Manual later in this list.
You just need to make sure the install portion of the
build completes with no issues.
Other (using
@@ -2003,7 +2009,10 @@
oe_runmake install, which can be run
- directly or can be run indirectly by the autotools and CMake
+ directly or can be run indirectly by the
+ autotools
+ and
+ cmake
classes, runs make install in parallel.
Sometimes, a Makefile can have missing dependencies between
targets that can result in race conditions.