summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
Commit message (Collapse)AuthorAgeFilesLines
...
* classes: document new go-vendor classJoao Marcos Costa2024-04-081-0/+14
| | | | | | | | | | | A reference to this class in the release notes will be added in a follow-up commit. (From yocto-docs rev: bfd38ad1056ded01a25acfa37e89302df2290ddf) Signed-off-by: Joao Marcos Costa <joaomarcos.costa@bootlin.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: refer to new yocto-patches mailing list wherever appropriateQuentin Schulz2024-04-081-0/+3
| | | | | | | | | | | | | | There's a new yocto-patches mailing list available for all layers that do not have their own mailing list. c.f. https://lists.yoctoproject.org/g/yocto/topic/105197684 Cc: Quentin Schulz <foss+yocto@0leil.net> (From yocto-docs rev: ac512f76b93a20507a6835ddafa954b4ae45e268) Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev/ref-manual: document conf-summary.txt together with conf-notes.txtAlexander Kanavin2024-03-191-3/+4
| | | | | | | | (From yocto-docs rev: b92f2eac3b7455ebfc87f668b9442122dbf1c66f) Signed-off-by: Alexander Kanavin <alex@linutronix.de> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: add documentation of the variable SPDX_NAMESPACE_PREFIXBELOUARGA Mohamed2024-03-191-0/+5
| | | | | | | | | | | The documentation of the variable SPDX_NAMESPACE_PREFIX does not exist. This variable is used to change the prefix of some links in SPDX docs. (From yocto-docs rev: 85c56d8f7f65875628ab63abf661705b26f55224) Signed-off-by: BELOUARGA Mohamed <m.belouarga@technologyandstrategy.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: use "manual page(s)"Michael Opdenacker2024-03-192-2/+2
| | | | | | | | | | Instead of "manpage(s)" or "man page(s)". To address one of the errors reported by "make stylecheck" (From yocto-docs rev: 86f5f5cd385f09c48c4cf0b1ab222d6e1e7c7e54) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: classes: update description of class 'image_types'Ulrich Ölmann2024-03-191-2/+6
| | | | | | | | | | | | | Cite usage of IMGCLASSES variable in class 'image' as found in OE-Core's commit [1]. [1] 451363438d38 ("classes/recipes: Switch to use inherit_defer") (From yocto-docs rev: 674f376ece98466d3498459d5b5428a8bfbd5112) Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: document VIRTUAL-RUNTIME variablesMichael Opdenacker2024-03-061-5/+32
| | | | | | | | | | | | | | 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 <michael.opdenacker@bootlin.com> Reported-by: Tim Orling <ticotimo@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: adding multiple groups in GROUPADD_PARAMGeoff Parker2024-03-061-0/+8
| | | | | | | | | | | 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 <geoffrey.parker@arthrex.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: correct sdk installation default pathJohan Bezem2024-03-061-1/+5
| | | | | | | | | | | | | | | | | | 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 <jbezem.extern@arri.de> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: tasks: do_cleansstate: recommend using '-f' instead for a shared ↵Luca Ceresoli2024-03-061-0/+12
| | | | | | | | | | | | | | | | | 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 (From yocto-docs rev: 6fb06bb4a917c1515e54fa3e699119f6bbb85767) Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com> Reviewed-by: Quentin Schulz <quentin.schulz@theobroma-systems.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: tasks: do_cleanall: recommend using '-f' insteadLuca Ceresoli2024-03-061-3/+23
| | | | | | | | | | | | | | | | | | 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 <luca.ceresoli@bootlin.com> Reviewed-by: Quentin Schulz <quentin.schulz@theobroma-systems.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: classes: add cve status check for oe.qaSimone Weiß2024-03-061-0/+5
| | | | | | | | | | | | | 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ß <simone.p.weiss@posteo.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: remove PYTHON_PNKhem Raj2024-02-241-14/+0
| | | | | | | | | | | 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 <raj.khem@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: suppress excess use of "following" wordMichael Opdenacker2024-02-249-21/+21
| | | | | | | | | | | | | | | | | | 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 <michael.opdenacker@bootlin.com> CC: Daniel Ammann <daniel.ammann@bytesatwork.ch> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: release-process: grammar fixMichael Opdenacker2024-02-241-1/+1
| | | | | | | (From yocto-docs rev: e8a59c67a8719096f8b67942cec4f8a0656c410c) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: system-requirements: update packages to build docsMichael Opdenacker2024-02-241-5/+5
| | | | | | | | | | | | | | | | - "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 <michael.opdenacker@bootlin.com> Reported-by: <mhagans@skyviewsat.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Add UBOOT_BINARY, extend UBOOT_CONFIGJörg Sommer2024-01-122-17/+24
| | | | | | | | | | | | 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. (From yocto-docs rev: 8b227582efbe9957026cdce4aef5621661af1fa5) Signed-off-by: Jörg Sommer <joerg.sommer@navimatix.de> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: document VSCode extensionEnguerrand de Ribaucourt2024-01-121-0/+5
| | | | | | | | | | | | | | | | 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. (From yocto-docs rev: 645153504690aa8a69b028e95a5e9d2da9644cf1) Signed-off-by: Enguerrand de Ribaucourt <enguerrand.de-ribaucourt@savoirfairelinux.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document cmake-qemu classAdrian Freihofer2024-01-121-0/+29
| | | | | | | | (From yocto-docs rev: b2e396bd970ea8f27ba575b49c1489e2181442b8) Signed-off-by: Adrian Freihofer <adrian.freihofer@siemens.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: classes: remove insserv bbclassMaxin B. John2024-01-121-10/+0
| | | | | | | | | | | | | | | | 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 (From yocto-docs rev: 41a15a80a325cb63a41be81e632ec2799bfb2957) Signed-off-by: Maxin John <maxin.john@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: update tested and supported distrosMichael Opdenacker2024-01-121-10/+7
| | | | | | | | | | | | | | | | According to currently active workers https://autobuilder.yoctoproject.org/typhoon/#/workers 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. (From yocto-docs rev: bceadfad0954e8473b0e87bba8d6b1e67fd88eef) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: document minidebuginfoEtienne Cordonnier2023-12-181-0/+3
| | | | | | | | (From yocto-docs rev: 1a6327f2d92b390248afb45119d79bb05cda3dcc) Signed-off-by: Etienne Cordonnier <ecordonnier@snap.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: releases.svg: update nanbield release statusMichael Opdenacker2023-11-201-16/+16
| | | | | | | | | | - nanbield is now released - update the start and end dates (From yocto-docs rev: 81afa3c95276f9e3fbd1f282ad5954d591fbbb95) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Fix reference to MIRRORS/PREMIRRORS defaultsPaul Barker2023-11-201-6/+4
| | | | | | | | | | | | | | 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") (From yocto-docs rev: bc84dd0b6cdb1b2432ae60c036df9ee15cd53f34) Signed-off-by: Paul Barker <paul.barker.ct@bp.renesas.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: classes: explain cml1 class nameMichael Opdenacker2023-11-061-1/+3
| | | | | | | | (From yocto-docs rev: 0ee4b7417087c105a4419b316c6b2c195c343f82) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> CC: Martin Jansa <martin.jansa@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: remove semicolons from *PROCESS_COMMAND variablesPaul Eggleton2023-11-061-17/+19
| | | | | | | | | | | | | In nanbield these are no longer needed - spaces are sufficient. The code still handles any semicolons (replacing them with spaces before interpreting the value), but let's avoid people adding them from now on in case we decide to change that in future. (From yocto-docs rev: 2947f6309f86cdf5322a39d4420e77431a8e3572) Signed-off-by: Paul Eggleton <bluelightning@bluelightning.org> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: update SDK_NAME variable documentationPaul Eggleton2023-11-061-7/+10
| | | | | | | | | | | | Update for changes in nanbield. Note that I am documenting what is set by poky.conf here (since this is Yocto Project documentation), which is slightly different from what is done in meta/conf/bitbake.conf. (From yocto-docs rev: 9764cb9e19788eb1caea0d2e95fbe7a5c19887d4) Signed-off-by: Paul Eggleton <bluelightning@bluelightning.org> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* Remove references to apm in MACHINE_FEATURESPaul Eggleton2023-11-061-2/+0
| | | | | | | | | | apm is no longer supported in nanbield. (From yocto-docs rev: fa07d34db3b5ba670ed2dc1228ffb3c0c09b3c08) Signed-off-by: Paul Eggleton <bluelightning@bluelightning.org> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: remove SERIAL_CONSOLES_CHECKMichael Opdenacker2023-11-061-17/+0
| | | | | | | | | | No longer in use in Poky (dropped in Nanbield through multiple commits) (From yocto-docs rev: e5d39e85a0db27bfc857fae9649f799179888eee) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: add RECIPE_MAINTAINERMichael Opdenacker2023-11-061-0/+16
| | | | | | | (From yocto-docs rev: 30e41530402a4f9c37f77e89bae7469b68aad901) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: mention new CDN for SSTATE_MIRRORSMichael Opdenacker2023-11-061-0/+10
| | | | | | | (From yocto-docs rev: 4ef0c24b206d71c348ff657a2ab83ab857539fb6) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document cargo_c classMichael Opdenacker2023-11-061-0/+13
| | | | | | | | (From yocto-docs rev: 74fc6a70d4636b37fe4eab290ea974e0f1531dbf) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> CC: Frederic Martinsons <frederic.martinsons@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document MESON_TARGETMichael Opdenacker2023-10-302-3/+9
| | | | | | | | (From yocto-docs rev: 8109eeb5b7a4e5b2f50047e049ce0295bdc94856) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> CC: Ross Burton <ross.burton@arm.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: improve description of CVE_STATUS and CVE_STATUS_GROUPSMichael Opdenacker2023-10-301-1/+2
| | | | | | | | | | | | | | - Mention CVE_STATUS_GROUPS in the development manual (otherwise only present in the reference manual, but with no reference to it) - In the reference manual description of CVE_STATUS, link back to the development manual, to provide context. (From yocto-docs rev: cfef5fe41b6c819e783c88829448ae38141650a5) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document KERNEL_STRIPMichael Opdenacker2023-10-301-0/+4
| | | | | | | (From yocto-docs rev: 0e1861dcb8819b86aba6a3e024efb8bfe4c300ad) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: document OEQA_REPRODUCIBLE_TEST_PACKAGEMichael Opdenacker2023-10-301-0/+5
| | | | | | | | | | Introduced by https://git.yoctoproject.org/poky/commit/?id=88abdec715ed0c1f613c9b5132cd45db741d5c65 (From yocto-docs rev: 2e64352653cd7e89a2b08d84d6f7a1e039d4346a) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document KERNEL_LOCALVERSIONMichael Opdenacker2023-10-301-0/+10
| | | | | | | | | | | Introduced by https://git.yoctoproject.org/poky/commit/?id=66ed174ccdf7a89cb998f503cc6b631e2d1adcc0 (From yocto-docs rev: 4bdd4976667b802895b13541b77191a65335a175) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> CC: Bruce Ashfield <bruce.ashfield@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: add systemd-resolved to distro featuresEero Aaltonen2023-10-301-0/+4
| | | | | | | | | | | systemd-resolved is a distro feature added in poky commit 6f30e3586eb1b8e853cf23dd039f258d0dc0bc6b (From yocto-docs rev: 2adb9c0a37f7bdbb293e78d71c872ca3bd9c06c4) Signed-off-by: Eero Aaltonen <eero.aaltonen@vaisala.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: add example for SYSROOT_DIRS variableBELHADJ SALEM Talel2023-10-201-0/+29
| | | | | | | | (From yocto-docs rev: 65b62118da6f355e56c489c6be08ba9ea94b9f04) Signed-off-by: Talel BELHAJSALEM <bhstalel@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: add TOOLCHAIN_OPTIONS variableBELHADJ SALEM Talel2023-10-201-0/+10
| | | | | | | | (From yocto-docs rev: 6f7bd97a6d3d6d8cfd149a7e07df35da4141e650) Signed-off-by: Talel BELHAJSALEM <bhstalel@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: add RECIPE_SYSROOT and RECIPE_SYSROOT_NATIVEBELHADJ SALEM Talel2023-10-201-0/+35
| | | | | | | | (From yocto-docs rev: 8aa25e2a668d35bab2f79457248abcde92dc92aa) Signed-off-by: Talel BELHAJSALEM <bhstalel@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Add documentation for the unimplemented-ptest QA warningJérémy Rosen2023-10-202-0/+14
| | | | | | | | | (From yocto-docs rev: d90106ff2d905e457659acdb65a91ce5dcfdd05e) Signed-off-by: Jérémy Rosen <jeremy.rosen@smile.fr> Reviewed-by: Yoann Congal <yoann.congal@smile.fr> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: variables: provide no-match example for COMPATIBLE_MACHINEQuentin Schulz2023-10-201-1/+20
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | COMPATIBLE_MACHINE is used to forbid the use of a recipe or its packages for a specific set of machines. In some cases, it may make more sense to have the logic inverted and have the recipe always forbidden except for hand-picked machines. Such could be the case for pieces of software that only support some architectures. In that scenario, it is sometimes a bit easier on the eye and for maintenance to use the OVERRIDES mechanism but for that, a default should be set. COMPATIBLE_MACHINE:aarch64 = "^(aarch64)$" COMPATIBLE_MACHINE:mips64 = "^(mips64)$" wouldn't do much because if COMPATIBLE_MACHINE isn't set, the recipe is assumed compatible and therefore, if no default is provided we enter that case. Hence, we need to add COMPATIBLE_MACHINE = "^$" as default so that it only matches the empty string, which isn't possible for MACHINEOVERRIDES. Cc: Quentin Schulz <foss+yocto@0leil.net> (From yocto-docs rev: 52196d39bc85de267daffb0074eb59786751f57d) Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Fix PACKAGECONFIG term and add an exampleBELHADJ SALEM Talel2023-10-201-6/+36
| | | | | | | | | | | | | | PACKAGECONFIG's first and second flag value will be added to PACKAGECONFIG_CONFARGS and then it will be added to the appropriate variable (EXTRA_OECMAKE, or ...) So we need to only mention PACKAGECONFIG_CONFARGS and it will lead to other variables. I added a custom example that can help understanding very well PACKAGECONFIG. (From yocto-docs rev: 7f26b0c0a08d6be9810128369265b0c494e7191b) Signed-off-by: Talel BELHAJSALEM <bhstalel@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: update list of supported machinesMichael Opdenacker2023-10-201-2/+1
| | | | | | | | | | The EdgeRouter machine is no longer supported. https://git.yoctoproject.org/poky/commit/?id=0c64d0e4317e3749f7f7ed9ecd5d08bbb0cedc9e (From yocto-docs rev: e600522f2d2514bdd888c91043b9c59563ee7a6d) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: update linux-yocto append examplesMichael Opdenacker2023-10-201-6/+5
| | | | | | | (From yocto-docs rev: 0d195d66e434ddedd33bf8db89643fa5ab192e29) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Warn about COMPATIBLE_MACHINE skipping native recipesArne Schwerdt2023-10-201-0/+7
| | | | | | | | (From yocto-docs rev: fcc9b54cc46a0831f79a96e041cbe8deed58cf66) Signed-off-by: Arne Schwerdt <arne.schwerdt@elbbits.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: releases.svg: Scarthgap is now version 5.0Michael Opdenacker2023-10-091-1/+1
| | | | | | | | | According to https://wiki.yoctoproject.org/wiki/Releases (From yocto-docs rev: 88348eb6eaa589a735b35b8ee726b9523f46e54f) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: point outdated link to the new locationRoland Hieber2023-09-191-5/+5
| | | | | | | | (From yocto-docs rev: afdfa717aec5cd382054030a2d1e1655277bc5a5) Signed-off-by: Roland Hieber <rhi@pengutronix.de> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: document LICENSE_FLAGS_DETAILSRoss Burton2023-09-191-0/+17
| | | | | | | | | (From yocto-docs rev: 299c9b295a8476abdb32fba01ac2f45efacea6f1) Signed-off-by: Ross Burton <ross.burton@arm.com> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> CC: Quentin Schulz <foss+yocto@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>