summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorMatthias Pritschet <matthias@pritschet.eu>2024-07-15 18:23:48 +0200
committerSteve Sakoman <steve@sakoman.com>2024-08-26 05:18:44 -0700
commite7bfd398dd2ce521eddb258bdfa9e516054fdbda (patch)
tree765ae6a7f50f2c5e1c76b558685890a18446ae3a /documentation/ref-manual
parent91bff5527f9bec8b63fd0f010f193c6c487d2d0e (diff)
downloadpoky-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.rst48
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