linux/poky.git/documentation/ref-manual, branch walnascar-5.2

Fix dead links that use the DISTRO macro

2025-04-21T20:17:02+00:00

After introducing the DISTRO_LATEST_TAG and DISTRO_REL_LATEST_TAG macros, use them in links that currently use DISTRO/DISTRO_REL_TAG. When building for the tip of a branch, this will replace the current A.B.999 in links to the latest existing tag. The links were found across the documentation by running 'grep -r "http.*5\.2\.999"' inside the _build/html output after building the docs. [YOCTO #14802] (From yocto-docs rev: 29be069ebbf2c55d72fc51d99ed5a558af37c05e) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/variables.rst: improve the PKGV documentation

2025-04-21T20:17:02+00:00

It may be confusing for users that source control information is not present in the BitBake environment. Document it as a warning block. (From yocto-docs rev: 39967b9cc87cf216c4658598806fd7a68db5053a) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/variables.rst: HOST_CC_ARCH: fix wrong SDK reference

2025-04-03T15:29:51+00:00

When building for nativesdk recipes, HOST_CC_ARCH equals SDK_CC_ARCH, not BUILDSDK_CC_ARCH which doesn't exist. Reviewed-by: Quentin Schulz (From yocto-docs rev: a4a8aca22bb854756eb2ed1e652331bec3c7c68e) Signed-off-by: Antonin Godard (cherry picked from commit 08fc3446cb13b5bd8781874d2d996899ce12b082) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/variables.rst: document HOST_*_ARCH variables

2025-04-03T15:29:51+00:00

These variables control the flags for the assembler, compiler and linker, but depend on the context. Reviewed-by: Quentin Schulz (From yocto-docs rev: 8f070b788c9cd6cc16e03505d978177b4c82de03) Signed-off-by: Antonin Godard (cherry picked from commit f8eb33569a5e8cadc036855e2d95eee77e627cb4) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/variables.rst: document missing SDK_*_ARCH variables

2025-04-03T15:29:51+00:00

These variables control the flags for the assembler, compiler and linker when building for nativesdk recipes. Reviewed-by: Quentin Schulz (From yocto-docs rev: 978300e5f14874f2586efa3474c6f3803e3d9031) Signed-off-by: Antonin Godard (cherry picked from commit c08f6d3c8aee86264c069b7c30850cb02de76076) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/variables.rst: add missing documentation for BUILD_* variables

2025-04-03T15:29:51+00:00

These toolchain variables are used in a native context. Some of the BUILD_* variables missed documentation. Also, some of the base commands were also not there so document them. Some of existing BUILD_* variable documentation were missing the note about their usage in a native context, so add it too so that all BUILD_* variables are documented the same way. [YOCTO #15719] Reviewed-by: Quentin Schulz (From yocto-docs rev: e42d49218945a030f300dbb608e7cfb0611f5733) Signed-off-by: Antonin Godard (cherry picked from commit 87103afa1cb6690e9aaa87ca1f23e45eaaa359ac) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/variables.rst: add manpage links for toolchain variables

2025-04-03T15:29:51+00:00

Use the :manpage: role to provide links to common toolchain utilities. Reviewed-by: Quentin Schulz (From yocto-docs rev: 8a25963c8dfc36482582294f0d2e7c7555d96399) Signed-off-by: Antonin Godard (cherry picked from commit 7023e5f176efde05a6798476712c8a4e006a6b0d) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

documentation/conf.py: define a manpage url

2025-04-03T15:29:51+00:00

By defining the manpages_url we can use the :manpage: role in the documentation for providing links to manpages. See: https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-manpages_url Replace existing manpages links to use this role. Reviewed-by: Quentin Schulz (From yocto-docs rev: 0d0115cb2d96960837678f775cf5c2297494c51c) Signed-off-by: Antonin Godard (cherry picked from commit 4e63cd74cd1a330ea5e96bb04243a90f607b2857) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/classes: ptest-python-pytest: improve the current documentation

2025-04-03T15:29:51+00:00

Improve the current ptest-python-pytest documentation and PTEST_PYTEST_DIR variable definition. Namely remove the default value that may evolve over time. Suggested-by: Quentin Schulz (From yocto-docs rev: a83406103ca73d84fc8f5c50a8968faf91276a62) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

ref-manual/variables.rst: document the SPDX_PACKAGE_VERSION variable

2025-03-28T13:17:13+00:00

This variable controls the package version as seen in the SPDX 3.0 JSON output (software_packageVersion). The default value for this variable is PV. (From yocto-docs rev: 3b483c5295b26748c6f2cd63074b20ac3da97b32) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie