diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2016-02-23 07:22:52 -0800 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2016-03-03 17:40:11 +0000 |
commit | 3b410498fec06cd09731571800405320d7ff4096 (patch) | |
tree | 6a4e6f065760de6ddd1d7e7c843b48c6952a5e92 /documentation/ref-manual | |
parent | a1970eb17bc8fde08aeca1128d5286c0bbc88ebf (diff) | |
download | poky-3b410498fec06cd09731571800405320d7ff4096.tar.gz |
ref-manual, dev-manual: Clarifying "native" and "sdknative"
Fixes [YOCTO #8620]
I applied some review comments for the changes made to several
areas in both these manuals. Minor wording fixes and the
dropping of some changes as directed by Joshua Lock.
(From yocto-docs rev: 71af89da612c37162ba27844c297879d643caf65)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/introduction.xml | 7 | ||||
-rw-r--r-- | documentation/ref-manual/migration.xml | 7 | ||||
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 9 | ||||
-rw-r--r-- | documentation/ref-manual/technical-details.xml | 7 |
4 files changed, 16 insertions, 14 deletions
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 @@ | |||
450 | $ sh poky-glibc-x86_64-buildtools-tarball-x86_64-buildtools-nativesdk-standalone-&DISTRO;.sh | 450 | $ sh poky-glibc-x86_64-buildtools-tarball-x86_64-buildtools-nativesdk-standalone-&DISTRO;.sh |
451 | </literallayout> | 451 | </literallayout> |
452 | During execution, a prompt appears that allows you to | 452 | During execution, a prompt appears that allows you to |
453 | choose the installation directory for these tools | 453 | choose the installation directory. |
454 | designed to run on the target machine | ||
455 | (<link linkend='var-SDKMACHINE'><filename>SDKMACHINE</filename></link>). | ||
456 | For example, you could choose the following: | 454 | For example, you could choose the following: |
457 | <literallayout class='monospaced'> | 455 | <literallayout class='monospaced'> |
458 | /home/<replaceable>your-username</replaceable>/buildtools | 456 | /home/<replaceable>your-username</replaceable>/buildtools |
@@ -532,8 +530,7 @@ | |||
532 | <listitem><para> | 530 | <listitem><para> |
533 | On the machine that does not meet the requirements, | 531 | On the machine that does not meet the requirements, |
534 | run the <filename>.sh</filename> file | 532 | run the <filename>.sh</filename> file |
535 | to install the tools built to run on the target machine | 533 | to install the tools. |
536 | (<link linkend='var-SDKMACHINE'><filename>SDKMACHINE</filename></link>). | ||
537 | Here is an example: | 534 | Here is an example: |
538 | <literallayout class='monospaced'> | 535 | <literallayout class='monospaced'> |
539 | $ sh poky-glibc-x86_64-buildtools-tarball-x86_64-buildtools-nativesdk-standalone-&DISTRO;.sh | 536 | $ 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 @@ | |||
193 | as a prefix, which simplifies a lot of the packaging code for | 193 | as a prefix, which simplifies a lot of the packaging code for |
194 | <filename>nativesdk</filename> recipes. | 194 | <filename>nativesdk</filename> recipes. |
195 | All custom <filename>nativesdk</filename> recipes, which are | 195 | All custom <filename>nativesdk</filename> recipes, which are |
196 | recipes built on the host system to create packages for the | 196 | relocatable packages for the native architecture as specified |
197 | target machine, and any | 197 | in |
198 | references need to be updated to use | 198 | <link linkend='var-SDK_ARCH'><filename>SDK_ARCH</filename></link>, |
199 | and any references need to be updated to use | ||
199 | <filename>nativesdk-*</filename> instead of | 200 | <filename>nativesdk-*</filename> instead of |
200 | <filename>*-nativesdk</filename>. | 201 | <filename>*-nativesdk</filename>. |
201 | </para> | 202 | </para> |
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 @@ | |||
463 | 463 | ||
464 | <para> | 464 | <para> |
465 | The <filename>chrpath</filename> class | 465 | The <filename>chrpath</filename> class |
466 | is a wrapper around the "chrpath" utility. | 466 | is a wrapper around the "chrpath" utility, which is used during the |
467 | This utility is used during the build process for | 467 | build process for <filename>nativesdk</filename>, |
468 | <filename>nativesdk</filename>, <filename>cross</filename>, and | 468 | <filename>cross</filename>, and |
469 | <filename>cross-canadian</filename> recipes, which run on the host | 469 | <filename>cross-canadian</filename> recipes to change |
470 | system to create packages for the target hardware and change | ||
471 | <filename>RPATH</filename> records within binaries in order to make | 470 | <filename>RPATH</filename> records within binaries in order to make |
472 | them relocatable. | 471 | them relocatable. |
473 | </para> | 472 | </para> |
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 @@ | |||
477 | It does not matter if the work directory changes because it should | 477 | It does not matter if the work directory changes because it should |
478 | not affect the output for target packages. | 478 | not affect the output for target packages. |
479 | Also, the build process has the objective of making native | 479 | Also, the build process has the objective of making native |
480 | (build host) or cross packages (target hardware) relocatable. | 480 | or cross packages relocatable. |
481 | <note> | ||
482 | Both native and cross packages run on the build host. | ||
483 | However, cross packages generate output for the target | ||
484 | architecture. | ||
485 | </note> | ||
481 | The checksum therefore needs to exclude | 486 | The checksum therefore needs to exclude |
482 | <filename>WORKDIR</filename>. | 487 | <filename>WORKDIR</filename>. |
483 | The simplistic approach for excluding the work directory is to set | 488 | The simplistic approach for excluding the work directory is to set |