linux/poky.git/bitbake/doc, branch 5.3_M2

bitbake: doc/bitbake-user-manual-fetching: update the Git fetcher tag description

2025-07-22T13:19:25+00:00

After commit d591d7633fe8 ("fetch/git: Rework tag parameter handling"), update the description of the tag= parameter for the Git fetcher. (Bitbake rev: 85b31a55d114a1430868233d56573b470fef8908) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

bitbake: doc/bitbake-user-manual-fetching: remove 'rev' default value

2025-07-18T14:56:17+00:00

Remove rev's "master" default value. Mention that it must match SRCREV, if set. Reported-by: Quentin Schulz (Bitbake rev: 2519b317e4afb1686f907274715a9e2b9c6457f4) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

bitbake: doc: bitbake-user-manual-ref-variables: improve BB_PRESSURE_* doc

2025-06-26T10:02:55+00:00

The current default value for BB_PRESSURE_MAX_CPU is 500, which is really low for most systems. Provide a value of 15000 which limits the load average without being extremely slow either. Provide similar values for BB_PRESSURE_MAX_IO and BB_PRESSURE_MAX_MEMORY. Mention that these should be adjusted depending on the need, and warn about the potential spam of messages when the value is too low. (Bitbake rev: 09baa527dafca4bdf56a9189f6b3f7512886cbfb) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

bitbake: doc: bitbake-user-manual-ref-variables: document BB_GIT_DEFAULT_DESTSUFFIX

2025-06-26T10:02:55+00:00

This variable was recently added with 378db0fdd95f ("fetch2/git: allow overriding default unpack directory with a variable"). (Bitbake rev: a569be0d369cb8b9457beedfeb75b984f751ba5a) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

bitbake: bitbake-user-manual: correctly reference UNPACKDIR when describing unpacking

2025-06-26T10:02:55+00:00

Also, drop an obsolete S = WORKDIR/git note. (Bitbake rev: 3884b386cda649030f59e3040dd08e6aa2ec50cf) Signed-off-by: Alexander Kanavin Signed-off-by: Richard Purdie

bitbake: parse/ast: add support for 'built-in' fragments

2025-06-20T11:03:37+00:00

When reviewing proposed fragments to add settings for DISTRO and MACHINE, RP noted that such fragments only add clutter and overhead, and there's no need to maintain them as separate files. Rather when bitbake sees 'fragmentvar/fragmentvalue' it can expand that into FRAGMENTVAR = "fragmentvalue". To achieve that, 'addfragments' directive is extended with a parameter that sets the name of the variable that holds definitions of such built-in fragments, for example like this: "machine:MACHINE distro:DISTRO" Then each enabled fragment name is matched against these definitions and the respective variable is set, e.g. 'machine/qemuarm' would match 'machine:MACHINE' and result in MACHINE set to 'qemuarm'. This happens before any fragment files are looked up on disk, and no such lookup happens if there was a match, which should prevent possible misuse of the feature. So the builtin fragment definition is also an allowlist for them. Please also see the patches for oe-core that show an application of the feature. (Bitbake rev: 3b9d7bea915dc7f10e845854f1dae325743f9456) Signed-off-by: Alexander Kanavin Signed-off-by: Richard Purdie

bitbake: doc: update releases.rst

2025-06-12T08:56:42+00:00

Add Walnascar as a supported release manual, and move Styhead to the outdated release manuals. (Bitbake rev: 629aff734794568510c30939a4584cee2e0185ec) Signed-off-by: Antonin Godard Signed-off-by: Mathieu Dubois-Briand Signed-off-by: Richard Purdie

bitbake: fetch/az: Add sanity check and clarify documentation

2025-06-02T21:17:43+00:00

AZ_SAS token should be prefixed with a question mark. Add a sanity check for this and fix the documentation. [YOCTO #15882] (Bitbake rev: 22011765202514600314732b97f1bb938e21f585) Signed-off-by: Robbin Van Damme Signed-off-by: Richard Purdie

bitbake: doc: bitbake-user-manual-metadata: provide link to new doc

2025-04-24T10:53:00+00:00

Replace the now obsolete paragraph of the "Other Functions" section by a link to the new "Library Functions" document. (Bitbake rev: 0eecb4b2ee4fe5339340ed0d08783aa03bf051cc) Signed-off-by: Antonin Godard Signed-off-by: Mathieu Dubois-Briand Signed-off-by: Richard Purdie

bitbake: doc: add a new Library Functions document

2025-04-24T10:53:00+00:00

Add a new document to the BitBake user manual that automatically documents the library functions from their docstrings. The docstrings can be formatted in reStructuredText. Here logging utilities and the bb.utils module is documented. Some members of the utils module were deliberately excluded as their usage is most likely only internal to BitBake. Fixes [YOCTO #9612] (Bitbake rev: 0a711949acc2696f32a61c591ee3ea37041acb91) Signed-off-by: Antonin Godard Signed-off-by: Mathieu Dubois-Briand Signed-off-by: Richard Purdie