linux/poky.git/documentation, branch scarthgap-5.0.13

ref-manual/variables.rst: fix the description of STAGING_DIR

2025-10-09T19:16:46+00:00

There is no single "recipe-sysroots" directory, but rather many "recipe-sysroot*" directories. (From yocto-docs rev: 6f086fd3d9dbbb0c80f6c3e89b8df4fed422e79a) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit f2d6e228409cb1dd1dbf339c405699ac6d3900be) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

ref-manual/structure: document the auto.conf file

2025-10-09T19:16:46+00:00

Add documentation for auto.conf, which is used by external tools for automatically setting variables. (From yocto-docs rev: c16beccd7fa836a6bc77bb0a9d3274508bd3c6ff) Signed-off-by: Antonin Godard (cherry picked from commit 134e54a75e0144c4629f702c6f43e92ed1f12dce) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

dev-manual/building.rst: add note about externalsrc variables absolute paths

2025-10-09T19:16:46+00:00

(From yocto-docs rev: ab776a0348877d8dbf6c37823a65715fe30e34f6) Signed-off-by: Talel BELHAJ SALEM Signed-off-by: Antonin Godard (cherry picked from commit 33166d70b6ad093bd95ffccafc0b07820682f656) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

ref-manual/variables.rst: fix the description of KBUILD_DEFCONFIG

2025-10-09T19:16:46+00:00

Remove some leftover confusing mention of KMACHINE. (From yocto-docs rev: fd6f21b40b7fb58e7b465bbe97b8308f7a09313d) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit 582ee9e0b4930aea03255542b3d3913df19af8b0) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

kernel-dev/common.rst: fix the in-tree defconfig description

2025-10-09T19:16:46+00:00

The description of the relation between KBUILD_DEFCONFIG and SRC_URI is reversed. In fact it is the SRC_URI provided defconfig which will be dropped by the kernel-yocto class if both are provided. (From yocto-docs rev: 3dc8212748d014f0b2cd1bb6777404bafe6d5a58) Signed-off-by: Adam Blank Signed-off-by: Antonin Godard (cherry picked from commit a808420655a0976ba08f013f468cf80f379b1d89) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

test-manual/yocto-project-compatible.rst: fix a typo

2025-09-30T15:01:59+00:00

Fix a typo in yocto-project-compatible.rst. Reviewed-by: Quentin Schulz (From yocto-docs rev: 6b248c541580eadab663f605ce6310302d7a2dae) Signed-off-by: Antonin Godard (cherry picked from commit a84c234acfedfa714419006c743405e2f9acaedc) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

contributor-guide: submit-changes: make "Crediting contributors" part of "Commit your changes"

2025-09-30T15:01:59+00:00

There's no need to differentiate crediting contributors from committing your changes, so let's simply make it the last step of "Commit your changes" section. This simply indents the text so it's now part of "Commit your changes" list instead of the main list in the "Implement and commit changes" section. Because of this reorganisation, the instruction to use "git commit --amend" to add the contributors is moved to a note, and the first few sentences are reworded to better match the wording of other items in the "Commit your changes" list of instructions. (From yocto-docs rev: 6ba61d7bc3e641b3d4194f2d99a276f3b29f82b8) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit eff4d14e28d323ebfdaeb0c5c805b5f1e2ad153d) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

contributor-guide: submit-changes: number instruction list in commit your changes

2025-09-30T15:01:59+00:00

... so that it's clear that you need to read and follow each and every instruction in this list. (From yocto-docs rev: 6dfef402b2785675870d513f4afeed6b7e7a4df1) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit c628a489f081925fabaabb5acac6752251150269) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

contributor-guide: submit-changes: reword commit message instructions

2025-09-30T15:01:59+00:00

This should hopefully make it clearer what is expected from the contributor. This follows my understanding of git-commit(1)[1] where the following is a git commit message: """ git commit title git commit description """ I'm putting the "Fixes [YOCTO" line in "body of the commit message" so it's understood as being different from the git commit description so that the note admonition allowing us to have an empty commit description doesn't apply to the "Fixes [YOCTO" line. [1] https://www.man7.org/linux/man-pages/man1/git-commit.1.html#DISCUSSION (From yocto-docs rev: f0f9d40a04cba684a476caaa053b6f24ade9fb99) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit b84903a760350bd118c56ea9ce4e98039edf6e55) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

contributor-guide: submit-changes: make the Cc tag follow kernel guidelines

2025-09-30T15:01:59+00:00

The kernel docs specifies[1] a Cc: tag and not CC: tag, so let's align with that. [1] https://www.kernel.org/doc/html/latest/process/submitting-patches.html#when-to-use-acked-by-cc-and-co-developed-by (From yocto-docs rev: 49934860119ccd0844b0c600ea6be0a776b11a12) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit f800fef4e9e2c1d3584ac49be8324638d2923b17) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman