linux/poky.git/documentation/sdk-manual, branch scarthgap

sdk-manual: appendix-obtain: fix default path for eSDK installer script

2026-02-10T13:11:48+00:00

The eSDK installer script installs in poky_sdk directory but under the user's home directory so let's make that explicit. (From yocto-docs rev: 9811bee2e33002b449d073a3f3be1889e249ee2a) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 52ec12522bad3bbdff937f1c66224aa9b2d299cd) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: using: fix SDK filename example

2026-02-10T13:11:48+00:00

I'm pretty sure we meant to use the DISTRO poky.yaml.in placeholder which can only be replaced when surrounding by & and ; characters. Therefore let's fix this oversight. Also, the example isn't actually pointing at the snapshot, but the actual release, so let's reword that as well so it matches the example. I decided to do that instead of adding +snapshot to the filename because the example in the next section is actually using that same filename so for consistency it seemed more appropriate. (From yocto-docs rev: 27f259434f5bc3914d2c2b74961d744f7bffbcdc) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit ede411d70ffc837e5bea4666da9706e67960b0f2) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: appendix-obtain: use parsed-literal block for naming convention of the installer scripts

2026-02-10T13:11:48+00:00

It's easier on the eye to use a parsed-literal block for highlighting things that must be changed than simply stating the word, so this makes use of a parsed-literal block instead of a simple inline code-block and also highlight in italic which words are placeholders. Also make the explanation below the literal-block use the same highlighting (italic). (From yocto-docs rev: 648b3c3e80a3916917763e3892a5e8c8d8a72162) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 41ee642c33cc2e7435e6037bf49fe7495ffa6133) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: delete sdk-title PNG

2026-02-10T13:11:48+00:00

It hasn't been used since the migration to Sphinx so let's remove it. (From yocto-docs rev: 5ad326e61cf9f1d5fb8718dcf4e5f693bd3c4c28) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit ffaea8391b3d78c2ccf964474e03c50a1c043c6c) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: replace sdk-environment PNG with SVG

2026-02-10T13:11:48+00:00

This replaces the PNG figure with an SVG. (From yocto-docs rev: 2b14e4d9646b6be25876865def28c07334194874) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 39fb148792cd6b8e567a496bdbe63a50759eef36) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: appendix-obtain: replace eSDK directory structure PNG with a parsed-literal block

2026-02-10T13:11:48+00:00

This PNG is totally unnecessary and makes accessibility much worse, so let's simply replace the PNG with a parsed-literal block showing the same directory layout with the same highlighted placeholders. While at it, update the layout to match the more recent one (5.0.15) and have it alphabetically sorted (mixed files and directories). The placeholders are highlighted the same way inside and outside the parsed-literal block for consistency. (From yocto-docs rev: 923a35a87f72af7a678bb942186cef1cc81e1ab9) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 77b24b4a8d437797ab25dfeb37ae5cd911c52d31) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: appendix-obtain: replace directory structure PNG with a parsed-literal block

2026-02-10T13:11:48+00:00

This PNG is totally unnecessary and makes accessibility much worse, so let's simply replace the PNG with a parsed-literal block showing the same directory layout with the same highlighted placeholders. While at it, update the layout to match the more recent one (5.0.15) and have it alphabetically sorted (mixed files and directories). The placeholders are highlighted the same way inside and outside the parsed-literal block for consistency. (From yocto-docs rev: 56355f9dacc9b5cdfa6ad86d6c07dcb0511bc394) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 0c68497ec5f6525483e5a98e15db24f651bf28ba) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: appending-customizing: use none lexer for BitBake code blocks

2026-02-10T13:11:48+00:00

No lexer exists for BitBake right now, so let's simply disable the lexer entirely by using the "none" lexer. I'm using "none" instead of "text" to be able to "easily" replace none code blocks the day a BitBake lexer exists. I "reserve" "text" for actual text content (e.g. a filename, or the output of a command line without the command line). (From yocto-docs rev: 27d3921725b71a3346a6b76c7de4c11ebbced01c) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit d682bce63cdc5aad9c2d3b932a6ba2d27ecfe107) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: working-projects: properly highlight code code-blocks

2026-02-10T13:11:48+00:00

There are some blocks containing C code so highlight them as C with the "c" lexer. For autotool'ed files, there's no lexer available so "none" will do just fine. Finally, there's one Makefile code block so highlight it with the "makefile" lexer. (From yocto-docs rev: 6c3802113231393ff02d8ac96418f59cfc4c0124) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 10d40604cb4affb17dda2253f82a2422d5a9bcf6) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

sdk-manual: fix improper indent of general form of tarball installer scripts

2026-02-10T13:11:48+00:00

poky-glibc-host_system-image_type-arch-toolchain-ext-release_version.sh is in a code-block and thus requires to be indented (it is). Sphinx knows a block has ended when the indentation of the next line is smaller than in the block, otherwise it's all in the same block. The explanation of the replaceable parts in the tarball installer script filename should be text and not part of the block, so let's do that. While at it, reformat by putting each replaceable part in a bullet list, highlight the replaceable part or what it can replaced with as well as putting the replacement on the same line instead of making it a quote by having them indented in the bullet list. Finally, replace the literal block (::) with a parsed-literal block so we can highlight the placeholders appropriately. (From yocto-docs rev: 0f0ce9012349f4bb18a0c209b77b45a125f2d387) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 04c883216158edafe6a4c4ddfb38f63ffb5d5c24) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie