summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/bsp-guide/bsp.rst12
-rw-r--r--documentation/dev-manual/common-tasks.rst159
-rw-r--r--documentation/kernel-dev/advanced.rst6
-rw-r--r--documentation/kernel-dev/concepts-appx.rst4
-rw-r--r--documentation/migration-guides/migration-1.6.rst2
-rw-r--r--documentation/migration-guides/migration-3.3.rst2
-rw-r--r--documentation/overview-manual/concepts.rst10
-rw-r--r--documentation/overview-manual/development-environment.rst45
-rw-r--r--documentation/overview-manual/yp-intro.rst2
-rw-r--r--documentation/ref-manual/classes.rst14
-rw-r--r--documentation/ref-manual/images.rst2
-rw-r--r--documentation/ref-manual/terms.rst2
-rw-r--r--documentation/ref-manual/variables.rst39
-rw-r--r--documentation/sdk-manual/appendix-customizing.rst11
14 files changed, 151 insertions, 159 deletions
diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst
index 65652ff898..f8d38ca484 100644
--- a/documentation/bsp-guide/bsp.rst
+++ b/documentation/bsp-guide/bsp.rst
@@ -1121,12 +1121,12 @@ list describes them in order of preference:
1121 how to use these variables. 1121 how to use these variables.
1122 1122
1123 If you build as you normally would, without specifying any recipes in 1123 If you build as you normally would, without specifying any recipes in
1124 the :term:`LICENSE_FLAGS_WHITELIST`, the build stops and provides you 1124 the :term:`LICENSE_FLAGS_WHITELIST` variable, the build stops and provides
1125 with the list of recipes that you have tried to include in the image 1125 you with the list of recipes that you have tried to include in the image
1126 that need entries in the :term:`LICENSE_FLAGS_WHITELIST`. Once you enter 1126 that need entries in the :term:`LICENSE_FLAGS_WHITELIST` variable. Once you
1127 the appropriate license flags into the whitelist, restart the build 1127 enter the appropriate license flags into it, restart the build to continue
1128 to continue where it left off. During the build, the prompt will not 1128 where it left off. During the build, the prompt will not appear again since
1129 appear again since you have satisfied the requirement. 1129 you have satisfied the requirement.
1130 1130
1131 Once the appropriate license flags are on the white list in the 1131 Once the appropriate license flags are on the white list in the
1132 :term:`LICENSE_FLAGS_WHITELIST` variable, you can build the encumbered 1132 :term:`LICENSE_FLAGS_WHITELIST` variable, you can build the encumbered
diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
index 0c267d5f48..c25af4eff2 100644
--- a/documentation/dev-manual/common-tasks.rst
+++ b/documentation/dev-manual/common-tasks.rst
@@ -5598,13 +5598,13 @@ file::
5598 ./mkefidisk-201804191017-sda.direct 5598 ./mkefidisk-201804191017-sda.direct
5599 5599
5600 The following build artifacts were used to create the image(s): 5600 The following build artifacts were used to create the image(s):
5601 ROOTFS_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs 5601 ROOTFS_DIR: /home/stephano/yocto/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs
5602 BOOTIMG_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share 5602 BOOTIMG_DIR: /home/stephano/yocto/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share
5603 KERNEL_DIR: /home/stephano/build/master/build/tmp-glibc/deploy/images/qemux86 5603 KERNEL_DIR: /home/stephano/yocto/build/tmp-glibc/deploy/images/qemux86
5604 NATIVE_SYSROOT: /home/stephano/build/master/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native 5604 NATIVE_SYSROOT: /home/stephano/yocto/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native
5605 5605
5606 INFO: The image(s) were created using OE kickstart file: 5606 INFO: The image(s) were created using OE kickstart file:
5607 /home/stephano/build/master/openembedded-core/scripts/lib/wic/canned-wks/mkefidisk.wks 5607 /home/stephano/yocto/openembedded-core/scripts/lib/wic/canned-wks/mkefidisk.wks
5608 5608
5609The previous example shows the easiest way to create an image by running 5609The previous example shows the easiest way to create an image by running
5610in cooked mode and supplying a kickstart file and the "-e" option to 5610in cooked mode and supplying a kickstart file and the "-e" option to
@@ -5665,8 +5665,8 @@ in the ``scripts/lib/image/canned-wks`` directory and then by changing
5665the lines that specify the target disk from which to boot. 5665the lines that specify the target disk from which to boot.
5666:: 5666::
5667 5667
5668 $ cp /home/stephano/poky/scripts/lib/wic/canned-wks/directdisk-gpt.wks \ 5668 $ cp /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisk-gpt.wks \
5669 /home/stephano/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks 5669 /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks
5670 5670
5671Next, the example modifies the ``directdisksdb-gpt.wks`` file and 5671Next, the example modifies the ``directdisksdb-gpt.wks`` file and
5672changes all instances of "``--ondisk sda``" to "``--ondisk sdb``". The 5672changes all instances of "``--ondisk sda``" to "``--ondisk sdb``". The
@@ -5698,13 +5698,13 @@ Computing (nuc) :term:`MACHINE` the
5698 ./directdisksdb-gpt-201710090938-sdb.direct 5698 ./directdisksdb-gpt-201710090938-sdb.direct
5699 5699
5700 The following build artifacts were used to create the image(s): 5700 The following build artifacts were used to create the image(s):
5701 ROOTFS_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs 5701 ROOTFS_DIR: /home/stephano/yocto/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs
5702 BOOTIMG_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share 5702 BOOTIMG_DIR: /home/stephano/yocto/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share
5703 KERNEL_DIR: /home/stephano/build/master/build/tmp-glibc/deploy/images/qemux86 5703 KERNEL_DIR: /home/stephano/yocto/build/tmp-glibc/deploy/images/qemux86
5704 NATIVE_SYSROOT: /home/stephano/build/master/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native 5704 NATIVE_SYSROOT: /home/stephano/yocto/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native
5705 5705
5706 INFO: The image(s) were created using OE kickstart file: 5706 INFO: The image(s) were created using OE kickstart file:
5707 /home/stephano/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks 5707 /home/stephano/yocto/poky/scripts/lib/wic/canned-wks/directdisksdb-gpt.wks
5708 5708
5709Continuing with the example, you can now directly ``dd`` the image to a 5709Continuing with the example, you can now directly ``dd`` the image to a
5710USB stick, or whatever media for which you built your image, and boot 5710USB stick, or whatever media for which you built your image, and boot
@@ -5724,11 +5724,11 @@ Mode) and uses a modified kickstart file. The example also uses the
5724``-o`` option to cause Wic to create the output somewhere other than the 5724``-o`` option to cause Wic to create the output somewhere other than the
5725default output directory, which is the current directory:: 5725default output directory, which is the current directory::
5726 5726
5727 $ wic create /home/stephano/my_yocto/test.wks -o /home/stephano/testwic \ 5727 $ wic create test.wks -o /home/stephano/testwic \
5728 --rootfs-dir /home/stephano/build/master/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/rootfs \ 5728 --rootfs-dir /home/stephano/yocto/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/rootfs \
5729 --bootimg-dir /home/stephano/build/master/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share \ 5729 --bootimg-dir /home/stephano/yocto/build/tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share \
5730 --kernel-dir /home/stephano/build/master/build/tmp/deploy/images/qemux86 \ 5730 --kernel-dir /home/stephano/yocto/build/tmp/deploy/images/qemux86 \
5731 --native-sysroot /home/stephano/build/master/build/tmp/work/i586-poky-linux/wic-tools/1.0-r0/recipe-sysroot-native 5731 --native-sysroot /home/stephano/yocto/build/tmp/work/i586-poky-linux/wic-tools/1.0-r0/recipe-sysroot-native
5732 5732
5733 INFO: Creating image(s)... 5733 INFO: Creating image(s)...
5734 5734
@@ -5736,13 +5736,13 @@ default output directory, which is the current directory::
5736 /home/stephano/testwic/test-201710091445-sdb.direct 5736 /home/stephano/testwic/test-201710091445-sdb.direct
5737 5737
5738 The following build artifacts were used to create the image(s): 5738 The following build artifacts were used to create the image(s):
5739 ROOTFS_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs 5739 ROOTFS_DIR: /home/stephano/yocto/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/rootfs
5740 BOOTIMG_DIR: /home/stephano/build/master/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share 5740 BOOTIMG_DIR: /home/stephano/yocto/build/tmp-glibc/work/qemux86-oe-linux/core-image-minimal/1.0-r0/recipe-sysroot/usr/share
5741 KERNEL_DIR: /home/stephano/build/master/build/tmp-glibc/deploy/images/qemux86 5741 KERNEL_DIR: /home/stephano/yocto/build/tmp-glibc/deploy/images/qemux86
5742 NATIVE_SYSROOT: /home/stephano/build/master/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native 5742 NATIVE_SYSROOT: /home/stephano/yocto/build/tmp-glibc/work/i586-oe-linux/wic-tools/1.0-r0/recipe-sysroot-native
5743 5743
5744 INFO: The image(s) were created using OE kickstart file: 5744 INFO: The image(s) were created using OE kickstart file:
5745 /home/stephano/my_yocto/test.wks 5745 test.wks
5746 5746
5747For this example, 5747For this example,
5748:term:`MACHINE` did not have to be 5748:term:`MACHINE` did not have to be
@@ -7097,7 +7097,7 @@ Generating and Using Signed Packages
7097In order to add security to RPM packages used during a build, you can 7097In order to add security to RPM packages used during a build, you can
7098take steps to securely sign them. Once a signature is verified, the 7098take steps to securely sign them. Once a signature is verified, the
7099OpenEmbedded build system can use the package in the build. If security 7099OpenEmbedded build system can use the package in the build. If security
7100fails for a signed package, the build system aborts the build. 7100fails for a signed package, the build system stops the build.
7101 7101
7102This section describes how to sign RPM packages during a build and how 7102This section describes how to sign RPM packages during a build and how
7103to use signed package feeds (repositories) when doing a build. 7103to use signed package feeds (repositories) when doing a build.
@@ -8392,11 +8392,11 @@ The OpenEmbedded build system can run tests on real hardware, and for
8392certain devices it can also deploy the image to be tested onto the 8392certain devices it can also deploy the image to be tested onto the
8393device beforehand. 8393device beforehand.
8394 8394
8395For automated deployment, a "master image" is installed onto the 8395For automated deployment, a "controller image" is installed onto the
8396hardware once as part of setup. Then, each time tests are to be run, the 8396hardware once as part of setup. Then, each time tests are to be run, the
8397following occurs: 8397following occurs:
8398 8398
83991. The master image is booted into and used to write the image to be 83991. The controller image is booted into and used to write the image to be
8400 tested to a second partition. 8400 tested to a second partition.
8401 8401
84022. The device is then rebooted using an external script that you need to 84022. The device is then rebooted using an external script that you need to
@@ -8465,15 +8465,15 @@ not need any information in this section. You can skip down to the
8465":ref:`dev-manual/common-tasks:running tests`" section. 8465":ref:`dev-manual/common-tasks:running tests`" section.
8466 8466
8467If you did set :term:`TEST_TARGET` to "SystemdbootTarget", you also need to 8467If you did set :term:`TEST_TARGET` to "SystemdbootTarget", you also need to
8468perform a one-time setup of your master image by doing the following: 8468perform a one-time setup of your controller image by doing the following:
8469 8469
84701. *Set EFI_PROVIDER:* Be sure that :term:`EFI_PROVIDER` is as follows:: 84701. *Set EFI_PROVIDER:* Be sure that :term:`EFI_PROVIDER` is as follows::
8471 8471
8472 EFI_PROVIDER = "systemd-boot" 8472 EFI_PROVIDER = "systemd-boot"
8473 8473
84742. *Build the master image:* Build the ``core-image-testmaster`` image. 84742. *Build the controller image:* Build the ``core-image-testmaster`` image.
8475 The ``core-image-testmaster`` recipe is provided as an example for a 8475 The ``core-image-testmaster`` recipe is provided as an example for a
8476 "master" image and you can customize the image recipe as you would 8476 "controller" image and you can customize the image recipe as you would
8477 any other recipe. 8477 any other recipe.
8478 8478
8479 Here are the image recipe requirements: 8479 Here are the image recipe requirements:
@@ -9588,51 +9588,51 @@ If you examine the output or the log file, you see the failure during
9588 | /bin/mkdir -p include/near 9588 | /bin/mkdir -p include/near
9589 | /bin/mkdir -p include/near 9589 | /bin/mkdir -p include/near
9590 | /bin/mkdir -p include/near 9590 | /bin/mkdir -p include/near
9591 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9591 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9592 0.14-r0/neard-0.14/include/types.h include/near/types.h 9592 0.14-r0/neard-0.14/include/types.h include/near/types.h
9593 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9593 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9594 0.14-r0/neard-0.14/include/log.h include/near/log.h 9594 0.14-r0/neard-0.14/include/log.h include/near/log.h
9595 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9595 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9596 0.14-r0/neard-0.14/include/plugin.h include/near/plugin.h 9596 0.14-r0/neard-0.14/include/plugin.h include/near/plugin.h
9597 | /bin/mkdir -p include/near 9597 | /bin/mkdir -p include/near
9598 | /bin/mkdir -p include/near 9598 | /bin/mkdir -p include/near
9599 | /bin/mkdir -p include/near 9599 | /bin/mkdir -p include/near
9600 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9600 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9601 0.14-r0/neard-0.14/include/tag.h include/near/tag.h 9601 0.14-r0/neard-0.14/include/tag.h include/near/tag.h
9602 | /bin/mkdir -p include/near 9602 | /bin/mkdir -p include/near
9603 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9603 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9604 0.14-r0/neard-0.14/include/adapter.h include/near/adapter.h 9604 0.14-r0/neard-0.14/include/adapter.h include/near/adapter.h
9605 | /bin/mkdir -p include/near 9605 | /bin/mkdir -p include/near
9606 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9606 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9607 0.14-r0/neard-0.14/include/ndef.h include/near/ndef.h 9607 0.14-r0/neard-0.14/include/ndef.h include/near/ndef.h
9608 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9608 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9609 0.14-r0/neard-0.14/include/tlv.h include/near/tlv.h 9609 0.14-r0/neard-0.14/include/tlv.h include/near/tlv.h
9610 | /bin/mkdir -p include/near 9610 | /bin/mkdir -p include/near
9611 | /bin/mkdir -p include/near 9611 | /bin/mkdir -p include/near
9612 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9612 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9613 0.14-r0/neard-0.14/include/setting.h include/near/setting.h 9613 0.14-r0/neard-0.14/include/setting.h include/near/setting.h
9614 | /bin/mkdir -p include/near 9614 | /bin/mkdir -p include/near
9615 | /bin/mkdir -p include/near 9615 | /bin/mkdir -p include/near
9616 | /bin/mkdir -p include/near 9616 | /bin/mkdir -p include/near
9617 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9617 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9618 0.14-r0/neard-0.14/include/device.h include/near/device.h 9618 0.14-r0/neard-0.14/include/device.h include/near/device.h
9619 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9619 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9620 0.14-r0/neard-0.14/include/nfc_copy.h include/near/nfc_copy.h 9620 0.14-r0/neard-0.14/include/nfc_copy.h include/near/nfc_copy.h
9621 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9621 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9622 0.14-r0/neard-0.14/include/snep.h include/near/snep.h 9622 0.14-r0/neard-0.14/include/snep.h include/near/snep.h
9623 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9623 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9624 0.14-r0/neard-0.14/include/version.h include/near/version.h 9624 0.14-r0/neard-0.14/include/version.h include/near/version.h
9625 | ln -s /home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/ 9625 | ln -s /home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/work/i586-poky-linux/neard/
9626 0.14-r0/neard-0.14/include/dbus.h include/near/dbus.h 9626 0.14-r0/neard-0.14/include/dbus.h include/near/dbus.h
9627 | ./src/genbuiltin nfctype1 nfctype2 nfctype3 nfctype4 p2p > src/builtin.h 9627 | ./src/genbuiltin nfctype1 nfctype2 nfctype3 nfctype4 p2p > src/builtin.h
9628 | i586-poky-linux-gcc -m32 -march=i586 --sysroot=/home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/ 9628 | i586-poky-linux-gcc -m32 -march=i586 --sysroot=/home/pokybuild/yocto-autobuilder/nightly-x86/
9629 build/build/tmp/sysroots/qemux86 -DHAVE_CONFIG_H -I. -I./include -I./src -I./gdbus -I/home/pokybuild/ 9629 build/build/tmp/sysroots/qemux86 -DHAVE_CONFIG_H -I. -I./include -I./src -I./gdbus -I/home/pokybuild/
9630 yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/sysroots/qemux86/usr/include/glib-2.0 9630 yocto-autobuilder/nightly-x86/build/build/tmp/sysroots/qemux86/usr/include/glib-2.0
9631 -I/home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/tmp/sysroots/qemux86/usr/ 9631 -I/home/pokybuild/yocto-autobuilder/nightly-x86/build/build/tmp/sysroots/qemux86/usr/
9632 lib/glib-2.0/include -I/home/pokybuild/yocto-autobuilder/yocto-slave/nightly-x86/build/build/ 9632 lib/glib-2.0/include -I/home/pokybuild/yocto-autobuilder/nightly-x86/build/build/
9633 tmp/sysroots/qemux86/usr/include/dbus-1.0 -I/home/pokybuild/yocto-autobuilder/yocto-slave/ 9633 tmp/sysroots/qemux86/usr/include/dbus-1.0 -I/home/pokybuild/yocto-autobuilder/
9634 nightly-x86/build/build/tmp/sysroots/qemux86/usr/lib/dbus-1.0/include -I/home/pokybuild/yocto-autobuilder/ 9634 nightly-x86/build/build/tmp/sysroots/qemux86/usr/lib/dbus-1.0/include -I/home/pokybuild/yocto-autobuilder/
9635 yocto-slave/nightly-x86/build/build/tmp/sysroots/qemux86/usr/include/libnl3 9635 nightly-x86/build/build/tmp/sysroots/qemux86/usr/include/libnl3
9636 -DNEAR_PLUGIN_BUILTIN -DPLUGINDIR=\""/usr/lib/near/plugins"\" 9636 -DNEAR_PLUGIN_BUILTIN -DPLUGINDIR=\""/usr/lib/near/plugins"\"
9637 -DCONFIGDIR=\""/etc/neard\"" -O2 -pipe -g -feliminate-unused-debug-types -c 9637 -DCONFIGDIR=\""/etc/neard\"" -O2 -pipe -g -feliminate-unused-debug-types -c
9638 -o tools/snep-send.o tools/snep-send.c 9638 -o tools/snep-send.o tools/snep-send.c
@@ -10810,12 +10810,12 @@ package::
10810 LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly license_emgd_1.10" 10810 LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly license_emgd_1.10"
10811 10811
10812As a convenience, you do not need to specify the 10812As a convenience, you do not need to specify the
10813complete license string in the whitelist for every package. You can use 10813complete license string for every package. You can use
10814an abbreviated form, which consists of just the first portion or 10814an abbreviated form, which consists of just the first portion or
10815portions of the license string before the initial underscore character 10815portions of the license string before the initial underscore character
10816or characters. A partial string will match any license that contains the 10816or characters. A partial string will match any license that contains the
10817given string as the first portion of its license. For example, the 10817given string as the first portion of its license. For example, the
10818following whitelist string will also match both of the packages 10818following value will also match both of the packages
10819previously mentioned as well as any other packages that have licenses 10819previously mentioned as well as any other packages that have licenses
10820starting with "commercial" or "license". 10820starting with "commercial" or "license".
10821:: 10821::
@@ -10828,8 +10828,8 @@ License Flag Matching
10828License flag matching allows you to control what recipes the 10828License flag matching allows you to control what recipes the
10829OpenEmbedded build system includes in the build. Fundamentally, the 10829OpenEmbedded build system includes in the build. Fundamentally, the
10830build system attempts to match :term:`LICENSE_FLAGS` strings found in 10830build system attempts to match :term:`LICENSE_FLAGS` strings found in
10831recipes against :term:`LICENSE_FLAGS_WHITELIST` strings found in the 10831recipes against strings found in :term:`LICENSE_FLAGS_WHITELIST`.
10832whitelist. A match causes the build system to include a recipe in the 10832A match causes the build system to include a recipe in the
10833build, while failure to find a match causes the build system to exclude 10833build, while failure to find a match causes the build system to exclude
10834a recipe. 10834a recipe.
10835 10835
@@ -10837,18 +10837,19 @@ In general, license flag matching is simple. However, understanding some
10837concepts will help you correctly and effectively use matching. 10837concepts will help you correctly and effectively use matching.
10838 10838
10839Before a flag defined by a particular recipe is tested against the 10839Before a flag defined by a particular recipe is tested against the
10840contents of the whitelist, the expanded string ``_${PN}`` is appended to 10840entries of :term:`LICENSE_FLAGS_WHITELIST`, the expanded
10841the flag. This expansion makes each :term:`LICENSE_FLAGS` value 10841string ``_${PN}`` is appended to the flag. This expansion makes each
10842recipe-specific. After expansion, the string is then matched against the 10842:term:`LICENSE_FLAGS` value recipe-specific. After expansion, the
10843whitelist. Thus, specifying ``LICENSE_FLAGS = "commercial"`` in recipe 10843string is then matched against the entries. Thus, specifying
10844"foo", for example, results in the string ``"commercial_foo"``. And, to 10844``LICENSE_FLAGS = "commercial"`` in recipe "foo", for example, results
10845create a match, that string must appear in the whitelist. 10845in the string ``"commercial_foo"``. And, to create a match, that string
10846must appear among the entries of :term:`LICENSE_FLAGS_WHITELIST`.
10846 10847
10847Judicious use of the :term:`LICENSE_FLAGS` strings and the contents of the 10848Judicious use of the :term:`LICENSE_FLAGS` strings and the contents of the
10848:term:`LICENSE_FLAGS_WHITELIST` variable allows you a lot of flexibility for 10849:term:`LICENSE_FLAGS_WHITELIST` variable allows you a lot of flexibility for
10849including or excluding recipes based on licensing. For example, you can 10850including or excluding recipes based on licensing. For example, you can
10850broaden the matching capabilities by using license flags string subsets 10851broaden the matching capabilities by using license flags string subsets
10851in the whitelist. 10852in :term:`LICENSE_FLAGS_WHITELIST`.
10852 10853
10853.. note:: 10854.. note::
10854 10855
@@ -10856,43 +10857,44 @@ in the whitelist.
10856 string that precedes the appended underscore character (e.g. 10857 string that precedes the appended underscore character (e.g.
10857 ``usethispart_1.3``, ``usethispart_1.4``, and so forth). 10858 ``usethispart_1.3``, ``usethispart_1.4``, and so forth).
10858 10859
10859For example, simply specifying the string "commercial" in the whitelist 10860For example, simply specifying the string "commercial" in the
10860matches any expanded :term:`LICENSE_FLAGS` definition that starts with the 10861:term:`LICENSE_FLAGS_WHITELIST` variable matches any expanded
10861string "commercial" such as "commercial_foo" and "commercial_bar", which 10862:term:`LICENSE_FLAGS` definition that starts with the string
10863"commercial" such as "commercial_foo" and "commercial_bar", which
10862are the strings the build system automatically generates for 10864are the strings the build system automatically generates for
10863hypothetical recipes named "foo" and "bar" assuming those recipes simply 10865hypothetical recipes named "foo" and "bar" assuming those recipes simply
10864specify the following:: 10866specify the following::
10865 10867
10866 LICENSE_FLAGS = "commercial" 10868 LICENSE_FLAGS = "commercial"
10867 10869
10868Thus, you can choose 10870Thus, you can choose to exhaustively enumerate each license flag in the
10869to exhaustively enumerate each license flag in the whitelist and allow 10871list and allow only specific recipes into the image, or you can use a
10870only specific recipes into the image, or you can use a string subset 10872string subset that causes a broader range of matches to allow a range of
10871that causes a broader range of matches to allow a range of recipes into 10873recipes into the image.
10872the image.
10873 10874
10874This scheme works even if the :term:`LICENSE_FLAGS` string already has 10875This scheme works even if the :term:`LICENSE_FLAGS` string already has
10875``_${PN}`` appended. For example, the build system turns the license 10876``_${PN}`` appended. For example, the build system turns the license
10876flag "commercial_1.2_foo" into "commercial_1.2_foo_foo" and would match 10877flag "commercial_1.2_foo" into "commercial_1.2_foo_foo" and would match
10877both the general "commercial" and the specific "commercial_1.2_foo" 10878both the general "commercial" and the specific "commercial_1.2_foo"
10878strings found in the whitelist, as expected. 10879strings found in the :term:`LICENSE_FLAGS_WHITELIST` variable, as expected.
10879 10880
10880Here are some other scenarios: 10881Here are some other scenarios:
10881 10882
10882- You can specify a versioned string in the recipe such as 10883- You can specify a versioned string in the recipe such as
10883 "commercial_foo_1.2" in a "foo" recipe. The build system expands this 10884 "commercial_foo_1.2" in a "foo" recipe. The build system expands this
10884 string to "commercial_foo_1.2_foo". Combine this license flag with a 10885 string to "commercial_foo_1.2_foo". Combine this license flag with a
10885 whitelist that has the string "commercial" and you match the flag 10886 :term:`LICENSE_FLAGS_WHITELIST` variable that has the string
10886 along with any other flag that starts with the string "commercial". 10887 "commercial" and you match the flag along with any other flag that
10888 starts with the string "commercial".
10887 10889
10888- Under the same circumstances, you can use "commercial_foo" in the 10890- Under the same circumstances, you can add "commercial_foo" in the
10889 whitelist and the build system not only matches "commercial_foo_1.2" 10891 :term:`LICENSE_FLAGS_WHITELIST` variable and the build system not only
10890 but also matches any license flag with the string "commercial_foo", 10892 matches "commercial_foo_1.2" but also matches any license flag with
10891 regardless of the version. 10893 the string "commercial_foo", regardless of the version.
10892 10894
10893- You can be very specific and use both the package and version parts 10895- You can be very specific and use both the package and version parts
10894 in the whitelist (e.g. "commercial_foo_1.2") to specifically match a 10896 in the :term:`LICENSE_FLAGS_WHITELIST` list (e.g.
10895 versioned recipe. 10897 "commercial_foo_1.2") to specifically match a versioned recipe.
10896 10898
10897Other Variables Related to Commercial Licenses 10899Other Variables Related to Commercial Licenses
10898~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 10900~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -10916,9 +10918,10 @@ file::
10916 LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly commercial_gst-plugins-bad commercial_qmmp" 10918 LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly commercial_gst-plugins-bad commercial_qmmp"
10917 10919
10918 10920
10919Of course, you could also create a matching whitelist for those 10921Of course, you could also create a matching list for those
10920components using the more general "commercial" in the whitelist, but 10922components using the more general "commercial" in the
10921that would also enable all the other packages with :term:`LICENSE_FLAGS` 10923:term:`LICENSE_FLAGS_WHITELIST` variable, but that would also enable all
10924the other packages with :term:`LICENSE_FLAGS`
10922containing "commercial", which you may or may not want:: 10925containing "commercial", which you may or may not want::
10923 10926
10924 LICENSE_FLAGS_WHITELIST = "commercial" 10927 LICENSE_FLAGS_WHITELIST = "commercial"
diff --git a/documentation/kernel-dev/advanced.rst b/documentation/kernel-dev/advanced.rst
index 5a6b466ffb..b5290b61b3 100644
--- a/documentation/kernel-dev/advanced.rst
+++ b/documentation/kernel-dev/advanced.rst
@@ -763,7 +763,7 @@ Organizing Your Source
763====================== 763======================
764 764
765Many recipes based on the ``linux-yocto-custom.bb`` recipe use Linux 765Many recipes based on the ``linux-yocto-custom.bb`` recipe use Linux
766kernel sources that have only a single branch - "master". This type of 766kernel sources that have only a single branch. This type of
767repository structure is fine for linear development supporting a single 767repository structure is fine for linear development supporting a single
768machine and architecture. However, if you work with multiple boards and 768machine and architecture. However, if you work with multiple boards and
769architectures, a kernel source repository with multiple branches is more 769architectures, a kernel source repository with multiple branches is more
@@ -772,7 +772,7 @@ board to boot. Sometimes, these patches are works-in-progress or
772fundamentally wrong, yet they are still necessary for specific boards. 772fundamentally wrong, yet they are still necessary for specific boards.
773In these situations, you most likely do not want to include these 773In these situations, you most likely do not want to include these
774patches in every kernel you build (i.e. have the patches as part of the 774patches in every kernel you build (i.e. have the patches as part of the
775lone "master" branch). It is situations like these that give rise to 775default branch). It is situations like these that give rise to
776multiple branches used within a Linux kernel sources Git repository. 776multiple branches used within a Linux kernel sources Git repository.
777 777
778Here are repository organization strategies maximizing source reuse, 778Here are repository organization strategies maximizing source reuse,
@@ -812,7 +812,7 @@ Machine Branches
812When you have multiple machines and architectures to support, or you are 812When you have multiple machines and architectures to support, or you are
813actively working on board support, it is more efficient to create 813actively working on board support, it is more efficient to create
814branches in the repository based on individual machines. Having machine 814branches in the repository based on individual machines. Having machine
815branches allows common source to remain in the "master" branch with any 815branches allows common source to remain in the development branch with any
816features specific to a machine stored in the appropriate machine branch. 816features specific to a machine stored in the appropriate machine branch.
817This organization method frees you from continually reintegrating your 817This organization method frees you from continually reintegrating your
818patches into a feature. 818patches into a feature.
diff --git a/documentation/kernel-dev/concepts-appx.rst b/documentation/kernel-dev/concepts-appx.rst
index cf2e75d853..910318e0f9 100644
--- a/documentation/kernel-dev/concepts-appx.rst
+++ b/documentation/kernel-dev/concepts-appx.rst
@@ -211,8 +211,8 @@ view, there is a linear path that travels from the baseline
211``kernel.org``, through a select group of features and ends with their 211``kernel.org``, through a select group of features and ends with their
212BSP-specific commits. In other words, the divisions of the kernel are 212BSP-specific commits. In other words, the divisions of the kernel are
213transparent and are not relevant to the developer on a day-to-day basis. 213transparent and are not relevant to the developer on a day-to-day basis.
214From the developer's perspective, this path is the "master" branch in 214From the developer's perspective, this path is the development branch.
215Git terms. The developer does not need to be aware of the existence of 215The developer does not need to be aware of the existence of
216any other branches at all. Of course, it can make sense to have these 216any other branches at all. Of course, it can make sense to have these
217branches in the tree, should a person decide to explore them. For 217branches in the tree, should a person decide to explore them. For
218example, a comparison between two BSPs at either the commit level or at 218example, a comparison between two BSPs at either the commit level or at
diff --git a/documentation/migration-guides/migration-1.6.rst b/documentation/migration-guides/migration-1.6.rst
index eea3d17676..e240038a7b 100644
--- a/documentation/migration-guides/migration-1.6.rst
+++ b/documentation/migration-guides/migration-1.6.rst
@@ -231,7 +231,7 @@ Build Changes
231------------- 231-------------
232 232
233Separate build and source directories have been enabled by default for 233Separate build and source directories have been enabled by default for
234selected recipes where it is known to work (a whitelist) and for all 234selected recipes where it is known to work and for all
235recipes that inherit the :ref:`cmake <ref-classes-cmake>` class. In 235recipes that inherit the :ref:`cmake <ref-classes-cmake>` class. In
236future releases the :ref:`autotools <ref-classes-autotools>` class 236future releases the :ref:`autotools <ref-classes-autotools>` class
237will enable a separate build directory by default as well. Recipes 237will enable a separate build directory by default as well. Recipes
diff --git a/documentation/migration-guides/migration-3.3.rst b/documentation/migration-guides/migration-3.3.rst
index f065a17e68..f982b1c80a 100644
--- a/documentation/migration-guides/migration-3.3.rst
+++ b/documentation/migration-guides/migration-3.3.rst
@@ -89,7 +89,7 @@ example::
89 S = "${WORKDIR}/git/python/pythonmodule" 89 S = "${WORKDIR}/git/python/pythonmodule"
90 90
91then in ``setup.py`` it works with source code in a relative fashion, such 91then in ``setup.py`` it works with source code in a relative fashion, such
92as ``../../src``. This causes pseudo to abort as it isn't able to track 92as ``../../src``. This causes pseudo to fail as it isn't able to track
93the paths properly. This release introduces a new :term:`DISTUTILS_SETUP_PATH` 93the paths properly. This release introduces a new :term:`DISTUTILS_SETUP_PATH`
94variable so that recipes can specify it explicitly, for example:: 94variable so that recipes can specify it explicitly, for example::
95 95
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index 33b4071026..bfd54208af 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -1718,7 +1718,7 @@ inputs still exits - items already built and present in the
1718:term:`Build Directory`. The checksum (or 1718:term:`Build Directory`. The checksum (or
1719signature) for a particular task needs to add the hashes of all the 1719signature) for a particular task needs to add the hashes of all the
1720tasks on which the particular task depends. Choosing which dependencies 1720tasks on which the particular task depends. Choosing which dependencies
1721to add is a policy decision. However, the effect is to generate a master 1721to add is a policy decision. However, the effect is to generate a
1722checksum that combines the basehash and the hashes of the task's 1722checksum that combines the basehash and the hashes of the task's
1723dependencies. 1723dependencies.
1724 1724
@@ -1735,12 +1735,8 @@ included in any checksum)::
1735 PRSERV_DUMPDIR PRSERV_DUMPFILE PRSERV_LOCKDOWN PARALLEL_MAKE \\ 1735 PRSERV_DUMPDIR PRSERV_DUMPFILE PRSERV_LOCKDOWN PARALLEL_MAKE \\
1736 CCACHE_DIR EXTERNAL_TOOLCHAIN CCACHE CCACHE_DISABLE LICENSE_PATH SDKPKGSUFFIX" 1736 CCACHE_DIR EXTERNAL_TOOLCHAIN CCACHE CCACHE_DISABLE LICENSE_PATH SDKPKGSUFFIX"
1737 1737
1738The 1738The previous example does not include :term:`WORKDIR` since that variable is
1739previous example excludes 1739actually constructed as a path within :term:`TMPDIR`, which is included above.
1740:term:`WORKDIR` since that variable
1741is actually constructed as a path within
1742:term:`TMPDIR`, which is on the
1743whitelist.
1744 1740
1745The rules for deciding which hashes of dependent tasks to include 1741The rules for deciding which hashes of dependent tasks to include
1746through dependency chains are more complex and are generally 1742through dependency chains are more complex and are generally
diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst
index d719ba69eb..fc193f3135 100644
--- a/documentation/overview-manual/development-environment.rst
+++ b/documentation/overview-manual/development-environment.rst
@@ -163,9 +163,9 @@ these tarballs gives you a snapshot of the released files.
163 163
164 - Be sure to always work in matching branches for both the selected 164 - Be sure to always work in matching branches for both the selected
165 BSP repository and the Source Directory (i.e. ``poky``) 165 BSP repository and the Source Directory (i.e. ``poky``)
166 repository. For example, if you have checked out the "master" 166 repository. For example, if you have checked out the "&DISTRO_NAME_NO_CAP;"
167 branch of ``poky`` and you are going to use ``meta-intel``, be 167 branch of ``poky`` and you are going to use ``meta-intel``, be
168 sure to checkout the "master" branch of ``meta-intel``. 168 sure to checkout the "&DISTRO_NAME_NO_CAP;" branch of ``meta-intel``.
169 169
170In summary, here is where you can get the project files needed for 170In summary, here is where you can get the project files needed for
171development: 171development:
@@ -233,8 +233,8 @@ all diverging functionality. Although there is no need to use Git, many
233open source projects do so. 233open source projects do so.
234 234
235For the Yocto Project, a key individual called the "maintainer" is 235For the Yocto Project, a key individual called the "maintainer" is
236responsible for the integrity of the "master" branch of a given Git 236responsible for the integrity of the development branch of a given Git
237repository. The "master" branch is the "upstream" repository from which 237repository. The development branch is the "upstream" repository from which
238final or most recent builds of a project occur. The maintainer is 238final or most recent builds of a project occur. The maintainer is
239responsible for accepting changes from other developers and for 239responsible for accepting changes from other developers and for
240organizing the underlying branch structure to reflect release strategies 240organizing the underlying branch structure to reflect release strategies
@@ -279,8 +279,8 @@ submitting patches and changes, see the
279":ref:`dev-manual/common-tasks:submitting a change to the yocto project`" 279":ref:`dev-manual/common-tasks:submitting a change to the yocto project`"
280section in the Yocto Project Development Tasks Manual. 280section in the Yocto Project Development Tasks Manual.
281 281
282In summary, there is a single point of entry for changes into a "master" 282In summary, there is a single point of entry for changes into the
283or development branch of the Git repository, which is controlled by the 283development branch of the Git repository, which is controlled by the
284project's maintainer. A set of developers independently 284project's maintainer. A set of developers independently
285develop, test, and submit changes to "contrib" areas for the maintainer 285develop, test, and submit changes to "contrib" areas for the maintainer
286to examine. The maintainer then chooses which changes are going to 286to examine. The maintainer then chooses which changes are going to
@@ -311,7 +311,7 @@ Book <https://book.git-scm.com>`__.
311 host. You can name these branches anything you like. It is helpful to 311 host. You can name these branches anything you like. It is helpful to
312 give them names associated with the particular feature or change on 312 give them names associated with the particular feature or change on
313 which you are working. Once you are done with a feature or change and 313 which you are working. Once you are done with a feature or change and
314 have merged it into your local master branch, simply discard the 314 have merged it into your local development branch, simply discard the
315 temporary branch. 315 temporary branch.
316 316
317- *Merge Changes:* The ``git merge`` command allows you to take the 317- *Merge Changes:* The ``git merge`` command allows you to take the
@@ -348,7 +348,7 @@ Book <https://book.git-scm.com>`__.
348 348
349- *Patch Workflow:* This workflow allows you to notify the maintainer 349- *Patch Workflow:* This workflow allows you to notify the maintainer
350 through an email that you have a change (or patch) you would like 350 through an email that you have a change (or patch) you would like
351 considered for the "master" branch of the Git repository. To send 351 considered for the development branch of the Git repository. To send
352 this type of change, you format the patch and then send the email 352 this type of change, you format the patch and then send the email
353 using the Git commands ``git format-patch`` and ``git send-email``. 353 using the Git commands ``git format-patch`` and ``git send-email``.
354 For information on how to use these scripts, see the 354 For information on how to use these scripts, see the
@@ -433,17 +433,12 @@ development branch in the repository. To help illustrate, consider the
433following example Git commands:: 433following example Git commands::
434 434
435 $ cd ~ 435 $ cd ~
436 $ git clone git://git.yoctoproject.org/poky 436 $ git clone git://git.yoctoproject.org/poky -b &DISTRO_NAME_NO_CAP;
437 $ cd poky
438 $ git checkout -b &DISTRO_NAME_NO_CAP; origin/&DISTRO_NAME_NO_CAP;
439 437
440In the previous example 438In the previous example
441after moving to the home directory, the ``git clone`` command creates a 439after moving to the home directory, the ``git clone`` command creates a
442local copy of the upstream ``poky`` Git repository. By default, Git 440local copy of the upstream ``poky`` Git repository and checks out a
443checks out the "master" branch for your work. After changing the working 441local branch named "&DISTRO_NAME_NO_CAP;", which tracks the upstream
444directory to the new local repository (i.e. ``poky``), the
445``git checkout`` command creates and checks out a local branch named
446"&DISTRO_NAME_NO_CAP;", which tracks the upstream
447"origin/&DISTRO_NAME_NO_CAP;" branch. Changes you make while in this 442"origin/&DISTRO_NAME_NO_CAP;" branch. Changes you make while in this
448branch would ultimately affect the upstream "&DISTRO_NAME_NO_CAP;" branch 443branch would ultimately affect the upstream "&DISTRO_NAME_NO_CAP;" branch
449of the ``poky`` repository. 444of the ``poky`` repository.
@@ -558,9 +553,9 @@ descriptions and strategies on how to use these commands:
558- *git pull --rebase:* Retrieves information from an upstream Git 553- *git pull --rebase:* Retrieves information from an upstream Git
559 repository and places it in your local Git repository. You use this 554 repository and places it in your local Git repository. You use this
560 command to make sure you are synchronized with the repository from 555 command to make sure you are synchronized with the repository from
561 which you are basing changes (.e.g. the "master" branch). The 556 which you are basing changes (e.g. the "&DISTRO_NAME_NO_CAP;"
562 "--rebase" option ensures that any local commits you have in your 557 branch). The "--rebase" option ensures that any local commits you
563 branch are preserved at the top of your local branch. 558 have in your branch are preserved at the top of your local branch.
564 559
565- *git push repo-name local-branch:upstream-branch:* Sends 560- *git push repo-name local-branch:upstream-branch:* Sends
566 all your committed local changes to the upstream Git repository that 561 all your committed local changes to the upstream Git repository that
@@ -571,13 +566,13 @@ descriptions and strategies on how to use these commands:
571 566
572- *git merge:* Combines or adds changes from one local branch of 567- *git merge:* Combines or adds changes from one local branch of
573 your repository with another branch. When you create a local Git 568 your repository with another branch. When you create a local Git
574 repository, the default branch is named "master". A typical workflow 569 repository, the default branch may be named "main". A typical
575 is to create a temporary branch that is based off "master" that you 570 workflow is to create a temporary branch that is based off "main"
576 would use for isolated work. You would make your changes in that 571 that you would use for isolated work. You would make your changes in
577 isolated branch, stage and commit them locally, switch to the 572 that isolated branch, stage and commit them locally, switch to the
578 "master" branch, and then use the ``git merge`` command to apply the 573 "main" branch, and then use the ``git merge`` command to apply the
579 changes from your isolated branch into the currently checked out 574 changes from your isolated branch into the currently checked out
580 branch (e.g. "master"). After the merge is complete and if you are 575 branch (e.g. "main"). After the merge is complete and if you are
581 done with working in that isolated branch, you can safely delete the 576 done with working in that isolated branch, you can safely delete the
582 isolated branch. 577 isolated branch.
583 578
diff --git a/documentation/overview-manual/yp-intro.rst b/documentation/overview-manual/yp-intro.rst
index 7aee9db04f..a8ca9e9440 100644
--- a/documentation/overview-manual/yp-intro.rst
+++ b/documentation/overview-manual/yp-intro.rst
@@ -371,7 +371,7 @@ Yocto Project:
371 371
372- *AutoBuilder:* AutoBuilder is a project that automates build tests 372- *AutoBuilder:* AutoBuilder is a project that automates build tests
373 and quality assurance (QA). By using the public AutoBuilder, anyone 373 and quality assurance (QA). By using the public AutoBuilder, anyone
374 can determine the status of the current "master" branch of Poky. 374 can determine the status of the current development branch of Poky.
375 375
376 .. note:: 376 .. note::
377 377
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index e258469dcb..2c191f407e 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -214,13 +214,13 @@ the class.
214===================== 214=====================
215 215
216The ``blacklist`` class prevents the OpenEmbedded build system from 216The ``blacklist`` class prevents the OpenEmbedded build system from
217building specific recipes (blacklists them). To use this class, inherit 217building specific recipes. To use this class, inherit
218the class globally and set :term:`PNBLACKLIST` for 218the class globally and set :term:`PNBLACKLIST` for
219each recipe you wish to blacklist. Specify the :term:`PN` 219each recipe you wish to ignore. Specify the :term:`PN`
220value as a variable flag (varflag) and provide a reason, which is 220value as a variable flag (varflag) and provide a reason, which is
221reported, if the package is requested to be built as the value. For 221reported, if the package is requested to be built as the value. For
222example, if you want to blacklist a recipe called "exoticware", you add 222example, if you want to ignore a recipe called "exoticware", you
223the following to your ``local.conf`` or distribution configuration:: 223add the following to your ``local.conf`` or distribution configuration::
224 224
225 INHERIT += "blacklist" 225 INHERIT += "blacklist"
226 PNBLACKLIST[exoticware] = "Not supported by our organization." 226 PNBLACKLIST[exoticware] = "Not supported by our organization."
@@ -845,10 +845,10 @@ provided by the recipe ``icecc-create-env-native.bb``.
845 icecc. 845 icecc.
846 846
847If you do not want the Icecream distributed compile support to apply to 847If you do not want the Icecream distributed compile support to apply to
848specific recipes or classes, you can effectively "blacklist" them by 848specific recipes or classes, you can ask them to be ignored by Icecream
849listing the recipes and classes using the 849by listing the recipes and classes using the
850:term:`ICECC_USER_PACKAGE_BL` and 850:term:`ICECC_USER_PACKAGE_BL` and
851:term:`ICECC_USER_CLASS_BL`, variables, 851:term:`ICECC_USER_CLASS_BL` variables,
852respectively, in your ``local.conf`` file. Doing so causes the 852respectively, in your ``local.conf`` file. Doing so causes the
853OpenEmbedded build system to handle these compilations locally. 853OpenEmbedded build system to handle these compilations locally.
854 854
diff --git a/documentation/ref-manual/images.rst b/documentation/ref-manual/images.rst
index c6a7239c7e..0e3351bb7b 100644
--- a/documentation/ref-manual/images.rst
+++ b/documentation/ref-manual/images.rst
@@ -112,7 +112,7 @@ Following is a list of supported recipes:
112 development headers and libraries to form a complete standalone SDK 112 development headers and libraries to form a complete standalone SDK
113 and is suitable for development using the target. 113 and is suitable for development using the target.
114 114
115- ``core-image-testmaster``: A "master" image designed to be used for 115- ``core-image-testmaster``: A "controller" image designed to be used for
116 automated runtime testing. Provides a "known good" image that is 116 automated runtime testing. Provides a "known good" image that is
117 deployed to a separate partition so that you can boot into it and use 117 deployed to a separate partition so that you can boot into it and use
118 it to deploy a second image to be tested. You can find more 118 it to deploy a second image to be tested. You can find more
diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst
index 89b140e3fe..09e0a98bb5 100644
--- a/documentation/ref-manual/terms.rst
+++ b/documentation/ref-manual/terms.rst
@@ -404,7 +404,7 @@ universal, the list includes them just in case:
404 404
405 :term:`Upstream` 405 :term:`Upstream`
406 A reference to source code or repositories that are not 406 A reference to source code or repositories that are not
407 local to the development system but located in a master area that is 407 local to the development system but located in a remote area that is
408 controlled by the maintainer of the source code. For example, in 408 controlled by the maintainer of the source code. For example, in
409 order for a developer to work on a particular piece of code, they 409 order for a developer to work on a particular piece of code, they
410 need to first get a copy of it from an "upstream" source. 410 need to first get a copy of it from an "upstream" source.
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 83f39af2cf..e5216b3f36 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -400,7 +400,7 @@ system and gives an overview of their function and contents.
400 where: 400 where:
401 401
402 action is: 402 action is:
403 ABORT: Immediately abort the build when 403 ABORT: Immediately stop the build when
404 a threshold is broken. 404 a threshold is broken.
405 STOPTASKS: Stop the build after the currently 405 STOPTASKS: Stop the build after the currently
406 executing tasks have finished when 406 executing tasks have finished when
@@ -438,7 +438,7 @@ system and gives an overview of their function and contents.
438 The first example works only if you also provide the 438 The first example works only if you also provide the
439 :term:`BB_DISKMON_WARNINTERVAL` 439 :term:`BB_DISKMON_WARNINTERVAL`
440 variable in the ``conf/local.conf``. This example causes the build 440 variable in the ``conf/local.conf``. This example causes the build
441 system to immediately abort when either the disk space in 441 system to immediately stop when either the disk space in
442 ``${TMPDIR}`` drops below 1 Gbyte or the available free inodes drops 442 ``${TMPDIR}`` drops below 1 Gbyte or the available free inodes drops
443 below 100 Kbytes. Because two directories are provided with the 443 below 100 Kbytes. Because two directories are provided with the
444 variable, the build system also issue a warning when the disk space 444 variable, the build system also issue a warning when the disk space
@@ -452,7 +452,7 @@ system and gives an overview of their function and contents.
452 directory drops below 1 Gbyte. No disk monitoring occurs for the free 452 directory drops below 1 Gbyte. No disk monitoring occurs for the free
453 inodes in this case. 453 inodes in this case.
454 454
455 The final example immediately aborts the build when the number of 455 The final example immediately stops the build when the number of
456 free inodes in the ``${TMPDIR}`` directory drops below 100 Kbytes. No 456 free inodes in the ``${TMPDIR}`` directory drops below 100 Kbytes. No
457 disk space monitoring for the directory itself occurs in this case. 457 disk space monitoring for the directory itself occurs in this case.
458 458
@@ -652,7 +652,7 @@ system and gives an overview of their function and contents.
652 " 652 "
653 653
654 This next example shows an error message that occurs because invalid 654 This next example shows an error message that occurs because invalid
655 entries are found, which cause parsing to abort: 655 entries are found, which cause parsing to fail:
656 656
657 .. code-block:: none 657 .. code-block:: none
658 658
@@ -2894,9 +2894,9 @@ system and gives an overview of their function and contents.
2894 :ref:`icecc <ref-classes-icecc>` class. You set this variable in 2894 :ref:`icecc <ref-classes-icecc>` class. You set this variable in
2895 your ``local.conf`` file. 2895 your ``local.conf`` file.
2896 2896
2897 When you list classes using this variable, you are "blacklisting" 2897 When you list classes using this variable, the recipes inheriting
2898 them from distributed compilation across remote hosts. Any classes 2898 those classes will not benefit from distributed compilation across
2899 you list will be distributed and compiled locally. 2899 remote hosts. Instead they will be built locally.
2900 2900
2901 :term:`ICECC_USER_PACKAGE_BL` 2901 :term:`ICECC_USER_PACKAGE_BL`
2902 Identifies user recipes that you do not want the Icecream distributed 2902 Identifies user recipes that you do not want the Icecream distributed
@@ -2904,9 +2904,9 @@ system and gives an overview of their function and contents.
2904 :ref:`icecc <ref-classes-icecc>` class. You set this variable in 2904 :ref:`icecc <ref-classes-icecc>` class. You set this variable in
2905 your ``local.conf`` file. 2905 your ``local.conf`` file.
2906 2906
2907 When you list packages using this variable, you are "blacklisting" 2907 When you list recipes using this variable, you are excluding them
2908 them from distributed compilation across remote hosts. Any packages 2908 from distributed compilation across remote hosts. Instead they will
2909 you list will be distributed and compiled locally. 2909 be built locally.
2910 2910
2911 :term:`ICECC_USER_PACKAGE_WL` 2911 :term:`ICECC_USER_PACKAGE_WL`
2912 Identifies user recipes that use an empty 2912 Identifies user recipes that use an empty
@@ -4366,9 +4366,9 @@ system and gives an overview of their function and contents.
4366 section in the Yocto Project Development Tasks Manual. 4366 section in the Yocto Project Development Tasks Manual.
4367 4367
4368 :term:`LICENSE_FLAGS` 4368 :term:`LICENSE_FLAGS`
4369 Specifies additional flags for a recipe you must whitelist through 4369 Specifies additional flags for a recipe you must allow through
4370 :term:`LICENSE_FLAGS_WHITELIST` in 4370 :term:`LICENSE_FLAGS_WHITELIST` in
4371 order to allow the recipe to be built. When providing multiple flags, 4371 order for the recipe to be built. When providing multiple flags,
4372 separate them with spaces. 4372 separate them with spaces.
4373 4373
4374 This value is independent of :term:`LICENSE` and is 4374 This value is independent of :term:`LICENSE` and is
@@ -4381,8 +4381,7 @@ system and gives an overview of their function and contents.
4381 :term:`LICENSE_FLAGS_WHITELIST` 4381 :term:`LICENSE_FLAGS_WHITELIST`
4382 Lists license flags that when specified in 4382 Lists license flags that when specified in
4383 :term:`LICENSE_FLAGS` within a recipe should not 4383 :term:`LICENSE_FLAGS` within a recipe should not
4384 prevent that recipe from being built. This practice is otherwise 4384 prevent that recipe from being built. For more information, see the
4385 known as "whitelisting" license flags. For more information, see the
4386 ":ref:`dev-manual/common-tasks:enabling commercially licensed recipes`" 4385 ":ref:`dev-manual/common-tasks:enabling commercially licensed recipes`"
4387 section in the Yocto Project Development Tasks Manual. 4386 section in the Yocto Project Development Tasks Manual.
4388 4387
@@ -5186,8 +5185,8 @@ system and gives an overview of their function and contents.
5186 .. note:: 5185 .. note::
5187 5186
5188 You can use the :term:`PACKAGE_FEED_ARCHS` 5187 You can use the :term:`PACKAGE_FEED_ARCHS`
5189 variable to whitelist specific package architectures. If you do 5188 variable to allow specific package architectures. If you do
5190 not need to whitelist specific architectures, which is a common 5189 not need to allow specific architectures, which is a common
5191 case, you can omit this variable. Omitting the variable results in 5190 case, you can omit this variable. Omitting the variable results in
5192 all available architectures for the current machine being included 5191 all available architectures for the current machine being included
5193 into remote package feeds. 5192 into remote package feeds.
@@ -6583,9 +6582,9 @@ system and gives an overview of their function and contents.
6583 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class. 6582 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class.
6584 6583
6585 This list overrides the variables specified using the 6584 This list overrides the variables specified using the
6586 :term:`SDK_LOCAL_CONF_BLACKLIST` 6585 :term:`SDK_LOCAL_CONF_BLACKLIST` variable as well as
6587 variable as well as any variables identified by automatic 6586 other variables automatically added due to the "/" character
6588 blacklisting due to the "/" character being found at the start of the 6587 being found at the start of the
6589 value, which is usually indicative of being a path and thus might not 6588 value, which is usually indicative of being a path and thus might not
6590 be valid on the system where the SDK is installed. 6589 be valid on the system where the SDK is installed.
6591 6590
@@ -8244,7 +8243,7 @@ system and gives an overview of their function and contents.
8244 variable is used. 8243 variable is used.
8245 8244
8246 :term:`TUNEABI_WHITELIST` 8245 :term:`TUNEABI_WHITELIST`
8247 A whitelist of permissible :term:`TUNEABI` values. If 8246 A list of permissible :term:`TUNEABI` values. If
8248 :term:`TUNEABI_WHITELIST` is not set, all tunes are allowed. Providers 8247 :term:`TUNEABI_WHITELIST` is not set, all tunes are allowed. Providers
8249 that use prebuilt libraries can use the :term:`TUNEABI_WHITELIST`, 8248 that use prebuilt libraries can use the :term:`TUNEABI_WHITELIST`,
8250 :term:`TUNEABI_OVERRIDE`, and :term:`TUNEABI` 8249 :term:`TUNEABI_OVERRIDE`, and :term:`TUNEABI`
diff --git a/documentation/sdk-manual/appendix-customizing.rst b/documentation/sdk-manual/appendix-customizing.rst
index 4eccc28e9b..cac199bf7a 100644
--- a/documentation/sdk-manual/appendix-customizing.rst
+++ b/documentation/sdk-manual/appendix-customizing.rst
@@ -43,7 +43,7 @@ build system applies them against ``local.conf`` and ``auto.conf``:
43 :term:`SDK_INHERIT_BLACKLIST` 43 :term:`SDK_INHERIT_BLACKLIST`
44 are disabled. Using :term:`SDK_INHERIT_BLACKLIST` to disable these 44 are disabled. Using :term:`SDK_INHERIT_BLACKLIST` to disable these
45 classes is the typical method to disable classes that are problematic 45 classes is the typical method to disable classes that are problematic
46 or unnecessary in the SDK context. The default value blacklists the 46 or unnecessary in the SDK context. The default value disables the
47 :ref:`buildhistory <ref-classes-buildhistory>` 47 :ref:`buildhistory <ref-classes-buildhistory>`
48 and :ref:`icecc <ref-classes-icecc>` classes. 48 and :ref:`icecc <ref-classes-icecc>` classes.
49 49
@@ -63,9 +63,8 @@ adjustments:
63- If your SDK configuration inherits additional classes using the 63- If your SDK configuration inherits additional classes using the
64 :term:`INHERIT` variable and you 64 :term:`INHERIT` variable and you
65 do not need or want those classes enabled in the SDK, you can 65 do not need or want those classes enabled in the SDK, you can
66 blacklist them by adding them to the 66 disable them by adding them to the :term:`SDK_INHERIT_BLACKLIST`
67 :term:`SDK_INHERIT_BLACKLIST` 67 variable as described in the previous section.
68 variable as described in the fourth bullet of the previous section.
69 68
70 .. note:: 69 .. note::
71 70
@@ -275,8 +274,8 @@ source, you need to do a number of things:
275 places or it will fail quickly on the OpenEmbedded build system 274 places or it will fail quickly on the OpenEmbedded build system
276 side, and its contents will not interfere with the build), then 275 side, and its contents will not interfere with the build), then
277 you can set the variable in your ``local.conf`` or custom distro 276 you can set the variable in your ``local.conf`` or custom distro
278 configuration file. You can then "whitelist" the variable through 277 configuration file. You can then pass the variable to the SDK by
279 to the SDK by adding the following:: 278 adding the following::
280 279
281 SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS" 280 SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS"
282 281