linux/poky.git/documentation/ref-manual, branch 5.0_M3

manuals: document VIRTUAL-RUNTIME variables

2024-03-06T16:54:54+00:00

Document the convention to use variables prefixed by VIRTUAL_RUNTIME. Add references to the new term where possible. Another reason is that such variables are recommended in a warning issued by meta/classes-global/insane.bbclass (From yocto-docs rev: 11e1ba97edac979868f199e43c1004db6678044c) Signed-off-by: Michael Opdenacker Reported-by: Tim Orling Signed-off-by: Richard Purdie

ref-manual: variables: adding multiple groups in GROUPADD_PARAM

2024-03-06T16:54:54+00:00

Add missing documentation on how to add multiple groups with a single GROUPADD_PARAM:${PN} (From yocto-docs rev: e55d2aa6a0ee58ee980de2a6ca8d531c7c0cd44a) Signed-off-by: Geoff Parker Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: variables: correct sdk installation default path

2024-03-06T16:54:54+00:00

The SDKPATH variable seems mistakenly identified as the default path where the SDK will be installed by the generated installation script, unless option '-d' or a manual input overrides this default. The intended variable is SDKPATHINSTALL. SDKPATH indicates where the SDK is being composed and built. The definitions have been added/updated. (From yocto-docs rev: d5b9c4b9c443cc728a11fd1e0a26a11aac8ee2c5) Signed-off-by: Johan Bezem Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: tasks: do_cleansstate: recommend using '-f' instead for a shared sstate

2024-03-06T16:54:54+00:00

do_cleansstat can produce build errors when using a shared sstate cache. Add a note to clearly discourage, provide a safe alternative (bitbake -f), and the rationale. Suggested-by: Quentin Schulz Link: https://lore.kernel.org/yocto-docs/20240219155513.76738-1-luca.ceresoli@bootlin.com/T/#m5529687ecb0f9ec2dacddcb6ff58e2df73af9cde (From yocto-docs rev: 6fb06bb4a917c1515e54fa3e699119f6bbb85767) Signed-off-by: Luca Ceresoli Reviewed-by: Quentin Schulz Signed-off-by: Richard Purdie

ref-manual: tasks: do_cleanall: recommend using '-f' instead

2024-03-06T16:54:54+00:00

do_cleanall can produce failures when used in legitimate cases, such as with recipe variants (foo and foo-native) or a shared DL_DIR. This is why it is forbidden when writing tests that will run on the autobuilders (https://docs.yoctoproject.org/test-manual/intro.html?highlight=cleanall#considerations-when-writing-tests). Reword the documentation to clearly discourage, provide a safe alternative (bitbake -f -c fetch), and the rationale with an example. Reported-by: Sam Liddicott Link: https://bootlin.com/blog/yocto-sharing-the-sstate-cache-and-download-directories/#comment-2650335 (From yocto-docs rev: bfeb00f9213b9d2650ccf03ea666387415227be4) Signed-off-by: Luca Ceresoli Reviewed-by: Quentin Schulz Signed-off-by: Richard Purdie

ref-manual: classes: add cve status check for oe.qa

2024-03-06T16:54:54+00:00

With a new check was added for oe.qa for CVE_STATUS via commit 3c5b7605acd9cd68b ("cve-check: Log if CVE_STATUS set but not reported for component") in poky. Add related documentation here. (From yocto-docs rev: 04e1ff01e1b43daa0e5832904a82f95d0cfab678) Signed-off-by: Simone Weiß Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: variables: remove PYTHON_PN

2024-02-24T16:13:29+00:00

PYTHON_PN is on its way out, therefore it's good to remove it from documentation so its use is not promoted anymore. (From yocto-docs rev: 74180c0f6bcdeadbd6f9a69d26f733c716f420fd) Signed-off-by: Khem Raj Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

manuals: suppress excess use of "following" word

2024-02-24T16:13:28+00:00

To simplify the style, replace "Following is" and "Following are" by "here is" and "here are", sounding more natural. In some cases, also go further by simplifying "Here are/is xxx" by "xxx are/is" when the "are" or "is" are not two far at the end of the sentence. In some cases too, completely remove the sentence, when it's redundant with the preceding title. (From yocto-docs rev: 52ba6bb16c73cbc2c0e77496d5226c49bce786f5) Signed-off-by: Michael Opdenacker CC: Daniel Ammann Signed-off-by: Richard Purdie

ref-manual: release-process: grammar fix

2024-02-24T16:13:28+00:00

(From yocto-docs rev: e8a59c67a8719096f8b67942cec4f8a0656c410c) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: system-requirements: update packages to build docs

2024-02-24T16:13:28+00:00

- "git" is now required to run "set_versions.py" - Fix Ubuntu / Debian packages. The previous instructions didn't run on Debian 12 Tested on Ubuntu 22.04 and Debian 12. Reported on https://lists.yoctoproject.org/g/docs/message/4789 (From yocto-docs rev: cd0525f1a081567d5d8722d368511179655ca541) Signed-off-by: Michael Opdenacker Reported-by: Signed-off-by: Richard Purdie