From patchwork Thu Jan 29 15:23:15 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 80007 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 48B94D6B067 for ; Thu, 29 Jan 2026 15:24:29 +0000 (UTC) Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.17200.1769700262249523716 for ; Thu, 29 Jan 2026 07:24:22 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=uoYjzpbV; spf=pass (domain: bootlin.com, ip: 185.246.85.4, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id B3A264E42322; Thu, 29 Jan 2026 15:24:20 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 8BC4E606FD; Thu, 29 Jan 2026 15:24:20 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 6C0D9119A886E; Thu, 29 Jan 2026 16:24:19 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1769700260; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=NJRoEhvXUcXqe4SBxQDow6KNXUmkJjx3x5ek92NyWic=; b=uoYjzpbV/dtPUbKKMF8ehzKPT6lF2+hnVSyRfn8kkAdVmgQ1ePn8XFg0KOgspzPqa1tPD5 SDbyoMjI33ppziVsfHicbwvbLyThHxNYMwTNdE6eqEZ7Ojz7bUKmxHFZeZ0KSixZq6GCKa +F4TkYqghsAntJTMTZ630cOX2zDciYxEtF+h7holVDscHE91j+kgfSBGWllB5eyTCZky6C zmc76oU7MVOCn+zU0Gg5po2NFfbczmjcl77b1SpzVZbwkofI9WEsvMnAK9m4EyhE1d8/O3 mFEySLOzMvQ5KF/DNycqUs/Cs8PU+LP2F9DXA+ab2rI4iX9vzfCd+I+VQUdyDQ== From: Antonin Godard Date: Thu, 29 Jan 2026 16:23:15 +0100 Subject: [PATCH v3 24/57] ref-manual/classes.rst: remove obsolete poky repo references MIME-Version: 1.0 Message-Id: <20260129-remove-poky-references-v3-24-804acc3d9b7a@bootlin.com> References: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> In-Reply-To: <20260129-remove-poky-references-v3-0-804acc3d9b7a@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard , Quentin Schulz X-Mailer: b4 0.15-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=6248; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=nY8TXckqhUv8F6yLaHugu/ItnyI/YLncG19SeUfwYW4=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBpe3uM9JBzGuz4gLzE7dphLd4kU+eKSiuPWrkAZ op4vzlqoPuJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCaXt7jAAKCRDRgEFAKaOo NkcSD/9EZ5HtYWA9fTee8TDB6+7qlv0mrMspVr2AlBx5XRrBl9h5l+hbVQ4339t4jZyOktM5L7e FaqKzGqdZtc+qPNP6Aa8ssMK4itVSIOVWTmGw57gtwNIEOKxpGEYYf8fnowmhuVZwqkaGswmrDW nBOJtsCZSNd6WVrmCifBMOhCAXHCdDazBY5RSDg27vPfmyv0Tw9XN1NDzmFsGK1Sb1Z//TbsGYN jIUCkldVq8PsajntDP1Ueec9Gh/pHXK9Wr0mav8sybOKpsRnOT2lIOuYCtIjXTpDSdlA5G5W1sG nxOeJk3uffw6GH4G9bDfseor1DfdOzjsi/OxsEVvb81I/9tzeZMdUZLrrDO2Q7MH54BLIaT5S/+ sUH/BTBgQfPSauurD7h2XAr31bzz+RoCCduCklsXIyR4ta71lAMjKnRHsNOI72mVj8MS7GzIs+F +pK/f1uf5ZF8jmx+YLUVcmgDKrS01TR3j5/SCDAeX8fToPHWyHEftkymjjnnERDibyVFUYIgkTq EC8Vpg/5np66It6kZb1nYNAKHWDGyiuffiEuvqrD/Cdr9re2jQ5S4OkmyW5dbm/VH/Dr/IP7nMB zIxpF8HNtZomoFWvRzTS9xR4PypSVWQzb5WFDX+8E44AZEOkOlViIzfD5V2ap4o8Xy1QzFWZGFf c3MFxii19Vgrf4w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Thu, 29 Jan 2026 15:24:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8810 Remove references to the Poky repository, replace by OpenEmbedded-Core. Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard --- documentation/ref-manual/classes.rst | 34 ++++++++++++++++++---------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 2e219a59c..ef05372f0 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -9,12 +9,13 @@ amongst multiple recipe (``.bb``) files. To use a class file, you simply make sure the recipe inherits the class. In most cases, when a recipe inherits a class it is enough to enable its features. There are cases, however, where in the recipe you might need to set variables or override -some default behavior. +some default behavior. A class can also be inherited globally (in every recipe) +with the :term:`INHERIT` variable. Any :term:`Metadata` usually found in a recipe can also be placed in a class file. Class files are identified by the extension -``.bbclass`` and are usually placed in one of a set of subdirectories -beneath the ``meta*/`` directory found in the :term:`Source Directory`: +``.bbclass`` and are usually placed in one of the following subdirectories +of a :term:`layer`: - ``classes-recipe/`` - classes intended to be inherited by recipes individually @@ -28,9 +29,9 @@ in :term:`BBPATH` using the same method by which ``.conf`` files are searched. This chapter discusses only the most useful and important classes. Other -classes do exist within the ``meta/classes*`` directories in the Source -Directory. You can reference the ``.bbclass`` files directly for more -information. +classes do exist within the ``meta/classes*`` directories of +:term:`OpenEmbedded-Core (OE-Core)`. You can refer to the ``.bbclass`` files +directly for more information. .. _ref-classes-allarch: @@ -338,8 +339,8 @@ The :ref:`ref-classes-cargo_c` class can be inherited by a recipe to generate a Rust library that can be called by C/C++ code. The recipe which inherits this class has to only replace ``inherit cargo`` by ``inherit cargo_c``. -See the :yocto_git:`rust-c-lib-example_git.bb -` +See the :oe_git:`rust-c-lib-example_git.bb +` example recipe. .. _ref-classes-cargo_common: @@ -602,8 +603,9 @@ inherited globally from a configuration file:: INHERIT += "cve-check" -To filter out obsolete CVE database entries which are known not to impact software from Poky and OE-Core, -add following line to the build configuration file:: +To filter out obsolete CVE database entries which are known not to impact +software from :term:`OpenEmbedded-Core (OE-Core)`, add the following line to the +build configuration file:: include cve-extra-exclusions.inc @@ -827,7 +829,7 @@ See these variables for more information: :term:`PV`, For more information on the :ref:`ref-classes-externalsrc` class, see the comments in -``meta/classes/externalsrc.bbclass`` in the :term:`Source Directory`. +``meta/classes/externalsrc.bbclass`` in :term:`OpenEmbedded-Core (OE-Core)`. For information on how to use the :ref:`ref-classes-externalsrc` class, see the ":ref:`dev-manual/building:building software from an external source`" section in the Yocto Project Development Tasks Manual. @@ -1009,7 +1011,7 @@ this class is controlled by the mandatory :term:`GO_IMPORT` variable, and by the optional :term:`GO_INSTALL` and :term:`GO_INSTALL_FILTEROUT` ones. To build a Go program with the Yocto Project, you can use the -:yocto_git:`go-helloworld_0.1.bb ` +:oe_git:`go-helloworld_0.1.bb ` recipe as an example. .. _ref-classes-go-mod: @@ -3471,10 +3473,10 @@ is one reason we don't use static linking for our :ref:`ref-classes-native` binaries. With this class enabled, a tarball containing a pre-built C library is -downloaded at the start of the build. In the Poky reference distribution this is +downloaded at the start of the build. In :term:`OpenEmbedded-Core (OE-Core)` this is enabled by default through :oe_git:`meta/conf/distro/include/yocto-uninative.inc `. Other distributions that do -not derive from Poky can also "``require conf/distro/include/yocto-uninative.inc``" +not derive from :term:`Poky` can also "``require conf/distro/include/yocto-uninative.inc``" to use this. Alternatively if you prefer, you can build the uninative-tarball recipe yourself, publish the resulting tarball (e.g. via HTTP) and set :term:`UNINATIVE_URL` and :term:`UNINATIVE_CHECKSUM` appropriately. For an @@ -3516,7 +3518,7 @@ To use this class, you need to define a number of variables: These variables list alternative commands needed by a package, provide pathnames for links, default links for targets, and so forth. For details on how to use this class, see the comments in the -:yocto_git:`update-alternatives.bbclass ` +:oe_git:`update-alternatives.bbclass ` file. .. note:: @@ -3549,7 +3551,7 @@ that contain system services that should be run under their own user or group, you can use these classes to enable creation of the user or group. The :oe_git:`meta-skeleton/recipes-skeleton/useradd/useradd-example.bb ` -recipe in the :term:`Source Directory` provides a simple +recipe in :term:`OpenEmbedded-Core (OE-Core)` provides a simple example that shows how to add three users and groups to two packages. The :ref:`useradd_base ` class provides basic functionality for user or