diff options
| author | Matthias Pritschet <matthias@pritschet.eu> | 2024-07-15 18:23:48 +0200 |
|---|---|---|
| committer | Steve Sakoman <steve@sakoman.com> | 2024-08-26 05:18:44 -0700 |
| commit | e7bfd398dd2ce521eddb258bdfa9e516054fdbda (patch) | |
| tree | 765ae6a7f50f2c5e1c76b558685890a18446ae3a /documentation/ref-manual | |
| parent | 91bff5527f9bec8b63fd0f010f193c6c487d2d0e (diff) | |
| download | poky-e7bfd398dd2ce521eddb258bdfa9e516054fdbda.tar.gz | |
ref-manual: fix typo and move SYSROOT_DIRS example
1. Changed one letter (s/B/A), so the sentence is correct again.
2. Moved example from SYSROOT_DIRS_IGNORE into SYSROOT_DIRS section.
(From yocto-docs rev: 74cdaccd4cbe208de037b3b35c2cf0b8aa334748)
Signed-off-by: Matthias Pritschet <matthias@pritschet.eu>
Signed-off-by: Alexandre Belloni <alexandre.belloni@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
Diffstat (limited to 'documentation/ref-manual')
| -rw-r--r-- | documentation/ref-manual/variables.rst | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 3f37f42f21..f694640c00 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
| @@ -8536,29 +8536,6 @@ system and gives an overview of their function and contents. | |||
| 8536 | /sysroot-only \ | 8536 | /sysroot-only \ |
| 8537 | " | 8537 | " |
| 8538 | 8538 | ||
| 8539 | :term:`SYSROOT_DIRS_IGNORE` | ||
| 8540 | Directories that are not staged into the sysroot by the | ||
| 8541 | :ref:`ref-tasks-populate_sysroot` task. You | ||
| 8542 | can use this variable to exclude certain subdirectories of | ||
| 8543 | directories listed in :term:`SYSROOT_DIRS` from | ||
| 8544 | staging. By default, the following directories are not staged:: | ||
| 8545 | |||
| 8546 | SYSROOT_DIRS_IGNORE = " \ | ||
| 8547 | ${mandir} \ | ||
| 8548 | ${docdir} \ | ||
| 8549 | ${infodir} \ | ||
| 8550 | ${datadir}/X11/locale \ | ||
| 8551 | ${datadir}/applications \ | ||
| 8552 | ${datadir}/bash-completion \ | ||
| 8553 | ${datadir}/fonts \ | ||
| 8554 | ${datadir}/gtk-doc/html \ | ||
| 8555 | ${datadir}/installed-tests \ | ||
| 8556 | ${datadir}/locale \ | ||
| 8557 | ${datadir}/pixmaps \ | ||
| 8558 | ${datadir}/terminfo \ | ||
| 8559 | ${libdir}/${BPN}/ptest \ | ||
| 8560 | " | ||
| 8561 | |||
| 8562 | Consider the following example in which you need to manipulate this variable. | 8539 | Consider the following example in which you need to manipulate this variable. |
| 8563 | Assume you have a recipe ``A`` that provides a shared library ``.so.*`` that is | 8540 | Assume you have a recipe ``A`` that provides a shared library ``.so.*`` that is |
| 8564 | installed into a custom folder other than "``${libdir}``" | 8541 | installed into a custom folder other than "``${libdir}``" |
| @@ -8570,7 +8547,7 @@ system and gives an overview of their function and contents. | |||
| 8570 | is just to show the usefulness of setting :term:`SYSROOT_DIRS`. | 8547 | is just to show the usefulness of setting :term:`SYSROOT_DIRS`. |
| 8571 | 8548 | ||
| 8572 | When a recipe ``B`` :term:`DEPENDS` on ``A``, it means what is in | 8549 | When a recipe ``B`` :term:`DEPENDS` on ``A``, it means what is in |
| 8573 | :term:`SYSROOT_DIRS` will be copied from :term:`D` of the recipe ``B`` | 8550 | :term:`SYSROOT_DIRS` will be copied from :term:`D` of the recipe ``A`` |
| 8574 | into ``B``'s :term:`SYSROOT_DESTDIR` that is "``${WORKDIR}/sysroot-destdir``". | 8551 | into ``B``'s :term:`SYSROOT_DESTDIR` that is "``${WORKDIR}/sysroot-destdir``". |
| 8575 | 8552 | ||
| 8576 | Now, since ``/opt/lib`` is not in :term:`SYSROOT_DIRS`, it will never be copied to | 8553 | Now, since ``/opt/lib`` is not in :term:`SYSROOT_DIRS`, it will never be copied to |
| @@ -8588,6 +8565,29 @@ system and gives an overview of their function and contents. | |||
| 8588 | 8565 | ||
| 8589 | TARGET_LDFLAGS:append = " -L${RECIPE_SYSROOT}/opt/lib" | 8566 | TARGET_LDFLAGS:append = " -L${RECIPE_SYSROOT}/opt/lib" |
| 8590 | 8567 | ||
| 8568 | :term:`SYSROOT_DIRS_IGNORE` | ||
| 8569 | Directories that are not staged into the sysroot by the | ||
| 8570 | :ref:`ref-tasks-populate_sysroot` task. You | ||
| 8571 | can use this variable to exclude certain subdirectories of | ||
| 8572 | directories listed in :term:`SYSROOT_DIRS` from | ||
| 8573 | staging. By default, the following directories are not staged:: | ||
| 8574 | |||
| 8575 | SYSROOT_DIRS_IGNORE = " \ | ||
| 8576 | ${mandir} \ | ||
| 8577 | ${docdir} \ | ||
| 8578 | ${infodir} \ | ||
| 8579 | ${datadir}/X11/locale \ | ||
| 8580 | ${datadir}/applications \ | ||
| 8581 | ${datadir}/bash-completion \ | ||
| 8582 | ${datadir}/fonts \ | ||
| 8583 | ${datadir}/gtk-doc/html \ | ||
| 8584 | ${datadir}/installed-tests \ | ||
| 8585 | ${datadir}/locale \ | ||
| 8586 | ${datadir}/pixmaps \ | ||
| 8587 | ${datadir}/terminfo \ | ||
| 8588 | ${libdir}/${BPN}/ptest \ | ||
| 8589 | " | ||
| 8590 | |||
| 8591 | :term:`SYSROOT_DIRS_NATIVE` | 8591 | :term:`SYSROOT_DIRS_NATIVE` |
| 8592 | Extra directories staged into the sysroot by the | 8592 | Extra directories staged into the sysroot by the |
| 8593 | :ref:`ref-tasks-populate_sysroot` task for | 8593 | :ref:`ref-tasks-populate_sysroot` task for |
