linux/poky.git/documentation, branch yocto-4.0.24

ref-manual: move runtime-testing section to the test-manual

2025-01-09T16:41:04+00:00

In the same fashion as the previous commit ("ref-manual/packages: move ptest section to the test-manual"), move the runtime testing section of the development tasks manual to the test environment manual. Add a link to it from the test-manual/intro document. (From yocto-docs rev: 3128bf149f40928e6c2a3e264590a0c6c9778c6a) Signed-off-by: Antonin Godard (cherry picked from commit 6b44257874858db3aa426d3e84a79c41cb4937a3) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

ref-manual/packages: move ptest section to the test-manual

2025-01-09T16:41:04+00:00

[ YOCTO #15106 ] It makes more sense to document ptests in the test-manual. Since ptests are still related to packages, keep a link to ptests from packages.rst to the test-manual. Reported-by: Yoann Congal (From yocto-docs rev: 8b6ada020d595d86c7bbe78a27b7a6301715b039) Signed-off-by: Antonin Godard (cherry picked from commit b389c06b709e4791e1cce5e8a5b58f6b0cd03a14) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

SSTATE_MIRRORS/SOURCE_MIRROR_URL: add instructions for mirror authentication

2025-01-09T16:41:04+00:00

[ YOCTO #15218 ] There are different ways of configuring the build host when authentication to a mirror (SSTATE_MIRRORS or SOURCE_MIRROR_URL) is required. Document these methods, and begin with the preferred approach which is to edit ~/.netrc appropriately. When that is not possible, specifying the credentials from the URL is also possible, so document it as well. Reported-by: peter.zsifkovits@at.bosch.com Tested-by: Antonin Godard # Debian 12 container (From yocto-docs rev: e0f88c9595a084244691c6c6aee8d95ce29602fc) Signed-off-by: Antonin Godard (cherry picked from commit 4c303cce0627e0f2ce52e72597541e220585aaed) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

ref-manual/devtool-reference: add warning note on deploy-target and shared objects

2025-01-09T16:41:04+00:00

The command `devtool deploy-target` does not handle any dependency of the application, even when properly listed in DEPENDS or RDEPENDS. While the current documentation was clear on that, it felt needed to add a note on the fact that build-time dependencies may also result in runtime dependencies, especially for people new to the project. Add a warning block below the existing deploy-target documentation. Also, link to the Overview and Concepts page, which explains it thoroughly. [ YOCTO #14377 ] Reported-By: Robert Berger (From yocto-docs rev: daf514d81d08e01657ff2dc171a0afb56753dfc6) Signed-off-by: Antonin Godard (cherry picked from commit 56c84004daad5f8a5db53e36852331435d57c8af) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

contributor-guide/submit-changes.rst: suggest to remove the git signature

2025-01-09T16:41:04+00:00

By default when sending patches Git adds the git version at the bottom of the patch, which is not necessary in most cases. Suggest to remove it when configuring Git when sending patches. Suggested-By: Jaekyu Lee (From yocto-docs rev: b3223f919e0445c0059cddf0ce02cb27f83582c3) Signed-off-by: Antonin Godard (cherry picked from commit d3465691231f10466703198a831a681803ffdfad) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

reproducible-builds.rst: show how to build a single package

2025-01-09T16:41:04+00:00

Add a bit to the "Can we prove the project is reproducible?" section to show how OEQA_REPRODUCIBLE_TEST_TARGET can be used to test a single package (rather than the world build), as this may be useful for maintainers. [YOCTO #15619] (From yocto-docs rev: 6fda76e3a879e72979b3678ce583604783f178bb) Signed-off-by: Trevor Gamblin Reviewed-by: Antonin Godard Signed-off-by: Antonin Godard (cherry picked from commit c4bc09f61621938086be377653121d6b4e62b570) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

reproducible-builds.rst: document OEQA_REPRODUCIBLE_TEST_TARGET and OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS

2025-01-09T16:41:04+00:00

They are used to fine tune build reproducibility test for different build targets than "bitbake world" and to define which recipes can be rebuild using sstate cache. These are useful when ramping up build reproducibility in complex build configurations where "bitbake world" has too many failures. (From yocto-docs rev: 7d38b706441f1ae7154794f7df315924962cae40) Signed-off-by: Mikko Rapeli Reviewed-by: Michael Opdenacker (cherry picked from commit c74928b1a7b2f285ed70999539f0c630316ad364) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

system-requirements: update list of supported distros

2024-12-16T13:58:03+00:00

To match the list in meta-poky/conf/distro/poky.conf. (From yocto-docs rev: 802677ea3ef7b6c1ed43c71f7f33489288c0735a) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

poky.yaml.in: add missing locales dependency

2024-12-16T13:58:03+00:00

This is a requirement for building the documentation, otherwise we get (on Ubuntu 24.04): File "/usr/lib/python3.12/locale.py", line 615, in setlocale return _setlocale(category, locale) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ locale.Error: unsupported locale setting (From yocto-docs rev: cecf8bc678756790e9164000769e798be30d9d46) Signed-off-by: Antonin Godard (cherry picked from commit 0943a7b67ef0012b5d9badc15e0c579dbb9014ae) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

Gather dependencies in poky.yaml.in

2024-12-16T13:58:03+00:00

We used to have packages here and there in system-requirements.rst for each distro. Instead, gather all the dependencies in poky.yaml.in so we have an overview of what we provide for each distro. Use yaml ">" to list the dependencies in alphabetical order, one entry per line, which makes them easier to read and compare among distros. Rename UBUNTU_… variables to UBUNTU_DEBIAN_…, since these are used for both distros. (From yocto-docs rev: 580b410c535f3b24f901cdbf011bf817038ba4c3) Signed-off-by: Antonin Godard (cherry picked from commit 1ed6118b7cf1b5dcbfca753c83fa30fb97bf44ad) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman