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.