linux/poky.git/documentation, branch scarthgap

overview-manual/concepts.rst: fix do_prepare_recipe_sysroot task description

2026-04-28T13:01:16+00:00

The description incorrectly stated that the sysroots are set up for use during the packaging phase. In fact, do_prepare_recipe_sysroot runs before do_configure, and the sysroots are consumed by do_configure and do_compile. Refer to do_configure and do_compile as the tasks that consume prepared sysroots. Briefly describe the role of each sysroot. Link do_configure, do_compile, and do_populate_sysroot via :ref: to ease navigation. Suggested-by: Alexander Kanavin Suggested-by: Antonin Godard (From yocto-docs rev: 1c5e7f136d7460fa5ad4c8a49ab1de31bd670e59) Signed-off-by: Dawid Bijak Signed-off-by: Antonin Godard (cherry picked from commit b50e8d36bdab53b004711ebc284d8ce8be593859) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

dev-manual: "--runonly" should be "--runall"

2026-04-28T13:01:16+00:00

To properly fetch all the sources as suggested by the docs, one should use "--runall=fetch". (From yocto-docs rev: eb6a87177cec679eae9b2dfae86f49d9789c0ab1) Signed-off-by: Robert P. J. Day Signed-off-by: Antonin Godard (cherry picked from commit 0be8663d1f9e910c304e0960dd9e024e38646480) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

variables.rst: expand explanation of RSUGGESTS

2026-04-22T08:48:06+00:00

Add that the RSUGGESTS variable would be processed only by a supporting package manager when installing packages from a package feed, and add a link to the appropriate section in the Developers Manual. (From yocto-docs rev: 2c80b891d85e0a7d9b70fc7b4a9c032325b56eca) Signed-off-by: Robert P. J. Day Signed-off-by: Antonin Godard (cherry picked from commit 48c832376cc3d33785d790a3e76b52ed2f8895bf) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

sphinx-static/theme_overrides.css: switch to a fixed width documentation

2026-04-22T08:48:06+00:00

Change the css rules of our theme to have a fixed-width documentation instead of it taking the full width of the page. I believe this makes it much more readable compared to having long lines with few line returns, especially on high-resolution displays. Set the width to 1000px instead of the previous 800px, which felt slightly too thin. I think the removed comment here does not make that much sense for us. It was added by commit 0c1e108bc6c4 ("sphinx: add CSS theme override"), and I believe is a simply copy and paste of what was is set in the Linux kernel, added by commit 9abaf979abb2 ("doc-rst: customize RTD theme, table & full width") [1]. [1]: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=9abaf979abb2 (From yocto-docs rev: 680edf7ffdf2286c64c32de74be5b6353294122f) Signed-off-by: Antonin Godard (cherry picked from commit 98234c9d3a0846d719630914bea8599da9f51374) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

migration-guide: add release notes for 5.0.17

2026-04-22T08:48:06+00:00

(From yocto-docs rev: 7e915dfcb25be6e038f01b96dee8ec388f15ec55) Signed-off-by: Lee Chee Yang Signed-off-by: Antonin Godard (cherry picked from commit 7b671218b3034f3774b6ca1759dd971c3ff5c4df) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

ref-manual/variables.rst: correct a reference to STAGING_DIR*

2026-04-16T13:28:12+00:00

The reference to STAGING_DIR* variables in the description of DEPENDS was misleading, as it pointed at STAGING_DIR which is unrelated in this context. (From yocto-docs rev: 48d15a62ed7c004fd6e1dced03923bac529c435e) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit 2da8e6334e3d3362c9177f78a1216156417903fc) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

ref-manual/variables.rst: update STAGING_DIR* descriptions

2026-04-16T13:28:12+00:00

Slightly reword to emphasize the sysroots' roles during the build. Drop double back-quote from the uses of '-native' to make it a bit easier on the eyes. (From yocto-docs rev: e98b2231e76243734820efc28895ab11d20b0330) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit 15bbfeee88eee706e06b63116c9bf0cbfb2fd91c) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

ref-manual/variables.rst: update RECIPE_SYSROOT* descriptions

2026-04-16T13:28:12+00:00

Slightly reword to emphasise the order of steps during staging. Further clarify those variables' relation to STAGING_DIR* variables. (From yocto-docs rev: 4b219d437a5674aa71b6b2544d1548987202203f) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit eeb22235d5310ed440692914851df0b7aac056a4) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

ref-manual/variables.rst: update PKGDATA_DIR's description

2026-04-16T13:28:11+00:00

Don't refer to it as temporary. Update the default value. (From yocto-docs rev: 3786a02e4478c4e73531479d50d1be6e8dd8b4c7) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit a1432f24c94a26b372164704cf18b3c6a73b34f5) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker

ref-manual/variables.rst: update COMPONENTS_DIR's description

2026-04-16T13:28:11+00:00

Make it more evident, that it is first populated by files from some recipes, and later used as source of those files for the others (staging and sharing files). (From yocto-docs rev: 156c7c685b97943bcfa5309f9656a4b9e05e44a3) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit cad256411e2bc380e27e2fc4ea3140476596c823) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker