diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index ba182acaf4..ddff77cdc2 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -3603,11 +3603,10 @@ Additional Implementation Details - Different packaging systems have different levels of - native Multilib support (i.e. support for the host build - machine). - For the RPM Package Management System, the following - implementation details exist: + Different packaging systems have different levels of native Multilib + support. + For the RPM Package Management System, the following implementation details + exist: A unique architecture is defined for the Multilib packages, along with creating a unique deploy folder under @@ -6377,9 +6376,8 @@ developers when building for multiple machines. When you use the same TMPDIR for multiple machine builds, the OpenEmbedded build system can - reuse the existing native (i.e. host system) and often - cross-recipes (i.e. nativesdk - for multiple machines. + reuse the existing native and often cross-recipes for + multiple machines. Thus, build time decreases. If @@ -7582,14 +7580,16 @@ Consequently, you usually need to add a cross-compilation function to the package. + Many packages based on Automake compile and run the test suite by using a single command such as make check. - However, the native make check - that runs on the host system + However, the host make check builds and runs on the same computer, while cross-compiling requires that the package is built - on the host but executed on the target. + on the host but executed for the target + architecture (though often, as in the case for + ptest, the execution occurs on the host). The built version of Automake that ships with the Yocto Project includes a patch that separates building and execution. diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml index 750d9c681c..57e4a25853 100644 --- a/documentation/ref-manual/introduction.xml +++ b/documentation/ref-manual/introduction.xml @@ -450,9 +450,7 @@ $ sh poky-glibc-x86_64-buildtools-tarball-x86_64-buildtools-nativesdk-standalone-&DISTRO;.sh During execution, a prompt appears that allows you to - choose the installation directory for these tools - designed to run on the target machine - (SDKMACHINE). + choose the installation directory. For example, you could choose the following: /home/your-username/buildtools @@ -532,8 +530,7 @@ On the machine that does not meet the requirements, run the .sh file - to install the tools built to run on the target machine - (SDKMACHINE). + to install the tools. Here is an example: $ sh poky-glibc-x86_64-buildtools-tarball-x86_64-buildtools-nativesdk-standalone-&DISTRO;.sh diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml index 62f792bf7b..6fc39d0b56 100644 --- a/documentation/ref-manual/migration.xml +++ b/documentation/ref-manual/migration.xml @@ -193,9 +193,10 @@ as a prefix, which simplifies a lot of the packaging code for nativesdk recipes. All custom nativesdk recipes, which are - recipes built on the host system to create packages for the - target machine, and any - references need to be updated to use + relocatable packages for the native architecture as specified + in + SDK_ARCH, + and any references need to be updated to use nativesdk-* instead of *-nativesdk. diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index f994a2269d..c4f15c9f9d 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml @@ -463,11 +463,10 @@ The chrpath class - is a wrapper around the "chrpath" utility. - This utility is used during the build process for - nativesdk, cross, and - cross-canadian recipes, which run on the host - system to create packages for the target hardware and change + is a wrapper around the "chrpath" utility, which is used during the + build process for nativesdk, + cross, and + cross-canadian recipes to change RPATH records within binaries in order to make them relocatable. diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml index b4f6a832ed..e26994503b 100644 --- a/documentation/ref-manual/technical-details.xml +++ b/documentation/ref-manual/technical-details.xml @@ -477,7 +477,12 @@ It does not matter if the work directory changes because it should not affect the output for target packages. Also, the build process has the objective of making native - (build host) or cross packages (target hardware) relocatable. + or cross packages relocatable. + + Both native and cross packages run on the build host. + However, cross packages generate output for the target + architecture. + The checksum therefore needs to exclude WORKDIR. The simplistic approach for excluding the work directory is to set