aboutsummaryrefslogtreecommitdiffstats
AgeCommit message (Collapse)Author
2024-03-14manuals: document VIRTUAL-RUNTIME variablescontrib/nanbield-nextMichael Opdenacker
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 Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reported-by: Tim Orling <ticotimo@gmail.com>
2024-03-14contributor-guide: add notes for testsSimone Weiß
This adds some hints that and how changes should be tested when contributing. Fixes [YOCTO #15412] Signed-off-by: Simone Weiß <simone.p.weiss@posteo.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-03-14dev-manual: packages: fix capitalizationMichael Opdenacker
Using "PR service" instead of "PR Service", like in the other two instances in this document. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reported-by: Quentin Schulz <quentin.schulz@theobroma-systems.com> Reviewed-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
2024-03-14ref-manual: variables: adding multiple groups in GROUPADD_PARAMGeoff Parker
Add missing documentation on how to add multiple groups with a single GROUPADD_PARAM:${PN} Signed-off-by: Geoff Parker <geoffrey.parker@arthrex.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-03-14ref-manual: variables: correct sdk installation default pathJohan Bezem
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. Signed-off-by: Johan Bezem <jbezem.extern@arri.de> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-03-14ref-manual: tasks: do_cleansstate: recommend using '-f' instead for a shared ↵Luca Ceresoli
sstate 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 <quentin.schulz@theobroma-systems.com> Link: https://lore.kernel.org/yocto-docs/20240219155513.76738-1-luca.ceresoli@bootlin.com/T/#m5529687ecb0f9ec2dacddcb6ff58e2df73af9cde Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com> Reviewed-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
2024-03-14ref-manual: tasks: do_cleanall: recommend using '-f' insteadLuca Ceresoli
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 Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com> Reviewed-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
2024-02-27dev-manual: packages: need enough free spaceMichael Opdenacker
Enough free storage space is needed to apply package upgrades. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-02-27dev-manual: packages: clarify shared PR service constraintMichael Opdenacker
Explicit the problems previous described as "obvious". Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Suggested-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2024-02-27manuals: suppress excess use of "following" wordMichael Opdenacker
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. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> CC: Daniel Ammann <daniel.ammann@bytesatwork.ch> --- Changes in V2: - Further simplication of some "Here are" and "Here is" statements as suggested by Daniel Ammann <daniel.ammann@bytesatwork.ch> - Remove some sentences which were just repeating the preceding title.
2024-02-27ref-manual: release-process: grammar fixMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-02-27ref-manual: system-requirements: update packages to build docsMichael Opdenacker
- "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 Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reported-by: <mhagans@skyviewsat.com>
2024-02-27dev-manual: Rephrase spdx creationSimone Weiß
Make the options more clear by providing them in a list instead of plain prosa. Also add a ref for a presentation wrt spdx 3.0 in the Yocto project. Fixes [YOCTO 7476] Signed-off-by: Simone Weiß <simone.p.weiss@posteo.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-02-20migration-guides: fix release notes for 4.3.3Michael Opdenacker
Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-02-19migration-guide: add release notes for 4.3.3Lee Chee Yang
Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-02-06release-notes-4.3: fix spacingyocto-4.3.3yocto-4.0.17nanbield-4.3.3kirkstone-4.0.17Michael Opdenacker
This fixes an ugly formatting issue in the HTML output Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-02-06contributor-guide: fix lore URLBaruch Siach
Cc: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Baruch Siach <baruch@tkos.co.il> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-02-06dev-manual: gen-tapdevs need iptables installedSimone Weiß
Add the hint to the test setup that runqemu-gen-tapdevs will need the iptables package installed. Signed-off-by: Simone Weiß <simone.p.weiss@posteo.com>
2024-01-30migration-guide: add release notes for 4.0.16Lee Chee Yang
Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-21migration-guide: add release notes for 4.3.2Lee Chee Yang
Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-21documentation: Add UBOOT_BINARY, extend UBOOT_CONFIGJörg Sommer
UBOOT_CONFIG accepts a third parameter for the UBOOT_BINARY that isn't documented. To show its usage another example from the meta-freescale layer was picked. Signed-off-by: Jörg Sommer <joerg.sommer@navimatix.de> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-21manuals: document VSCode extensionEnguerrand de Ribaucourt
The VSCode extension is now officially maintained and published by the Yocto Project so it should be referenced in the manuals to help users discover it. I located the most relevant places to reference the extension by looking at how the old Eclipse plugin was documented in the 2.6 manuals as well as the current Toaster references. Signed-off-by: Enguerrand de Ribaucourt <enguerrand.de-ribaucourt@savoirfairelinux.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-21ref-manual: classes: remove insserv bbclassMaxin B. John
insserv.bbclass was removed from oe-core: commit e6bb5dbb62257a7de730ea9085dfd89520f3e47d Author: Richard Purdie <richard.purdie@linuxfoundation.org> Date: Sun May 10 12:30:49 2015 +0100 insserv: Remove Signed-off-by: Maxin John <maxin.john@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-21dev-manual: update license manifest pathIlya A. Kriveshko
After changes in openembedded-core@1a4ab9f, image licenses moved one directory down into ${SSTATE_PKGARCH} subdir. Signed-off-by: Ilya A. Kriveshko <iillyyaa@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-21contributor-guide: use "apt" instead of "aptitude"Michael Opdenacker
As used in the rest of the manual. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-21dev-manual: start.rst: Update use of Download pageSimone Weiß
The yocto website has changed its structure. Update the section for Accessing the Downloads page to match the new structure. Signed-off-by: Simone Weiß <simone.p.weiss@posteo.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2024-01-08dev-manual: start.rst: Update use of Download pageSimone Weiß
The yocto website has changed its structure. Update the section for Accessing the Downloads page to match the new structure. Signed-off-by: Simone Weiß <simone.p.weiss@posteo.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-22ref-manual: update tested and supported distrosMichael Opdenacker
According to currently active workers https://autobuilder.yoctoproject.org/typhoon/#/workers and to the "workers_prev_releases" definition in https://git.yoctoproject.org/yocto-autobuilder2/tree/config.py Also correct the text saying that SANITY_TESTED_DISTROS lists currently tested distros. Also replace AlmaLinux 8.8 and 9.2 by just AlmaLinux 8 and 9, as we update our workers anyway. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> --- Changes in V3: - Replace AlmaLinux 8.8 and 9.2 by just AlmaLinux 8 and 9 Changes in V2: - CentOS Stream 8 is still a supported distribution
2023-12-18test-manual: use working exampleyocto-4.3.2nanbield-4.3.2Michael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18migration-guides: add release notes for 4.0.15Lee Chee Yang
Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18dev-manual: runtime-testing: fix test module nameMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18manuals: brief-yoctoprojectqs: align variable order with default local.confSimone Weiß
Align the order from `BB_SIGNATURE_HANDLER` to `SSTATE_MIRRORS` in Quick Build with the order in the default local conf. While trivial it is easier to find, if the order matches. Signed-off-by: Simone Weiß <simone.p.weiss@posteo.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18migration-guides: reword fix in release-notes-4.3.1Lee Chee Yang
Reword a fix to align with the final release notes. Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18test-manual: add or improve hyperlinksMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18test-manual: explicit or fix file pathsMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18test-manual: add links to python unittestMichael Opdenacker
Better than using "python unittest" without any special formatting. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18test-manual: resource updatesMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18test-manual: text and formatting fixesMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18dev-manual: Discourage the use of SRC_URI[md5sum]Peter Kjellerstedt
SRC_URI[md5sum] has been deprecated for a long time. Discourage its use by removing it from examples and note that it should be replaced by SRC_URI[sha256sum] when updating recipes. Also mention that bitbake supports other checksums, though they are not commonly used. Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@axis.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18ref-manual: Fix reference to MIRRORS/PREMIRRORS defaultsPaul Barker
After the following meta-yocto commits, MIRRORS & PREMIRRORS are no longer set in the poky distro config file: 67b79df4fbff ("poky.conf: remove redundant MIRRORS") 1b71a3b9418f ("poky: Drop PREMIRRORS entries for scms") Signed-off-by: Paul Barker <paul.barker.ct@bp.renesas.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18migration-guide: add release notes for 4.0.14Lee Chee Yang
Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18manuals: fix URLMichael Opdenacker
[YOCTO #15279] Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reported-by: Steve Landherr <steve-yocto@chiquapin.com>
2023-12-18ref-manual: releases.svg: update nanbield release statusMichael Opdenacker
- nanbield is now released - update the start and end dates Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18migration-guide: add release notes for 4.2.4Lee Chee Yang
release notes based on 4.2.4 rc3. Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18dev-manual: layers: update link to YP Compatible formMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reported-by: Megan Knight <megankn@amazon.com>
2023-12-18contributor-guide: add License-Update tagJustin Bronder
Porting from the old wiki https://www.openembedded.org/index.php?title=Commit_Patch_Message_Guidelines&oldid=10935#Describing_license_changes Signed-off-by: Justin Bronder <jsbronder@cold-front.org> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18contributor-guide: fix command optionMichael Opdenacker
"--subject-prefix" applies to "git format-patch", not "git send-email" Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-12-18migration-guides: release 3.5 is actually 4.0Michael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2023-11-29migration-guides: add release notes for 4.3.1Lee Chee Yang
Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> --- Changes in V2: - Split CVE fixes between linux-yocto/6.1 and 6.5
2023-11-14release-notes-4.3: add Repositories / Downloads sectionyocto-4.3.1nanbield-4.3.1Lee Chee Yang
Add Repositories/Downloads Section for 4.3 release notes. Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>