From patchwork Fri Jun 6 15:01:47 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quentin Schulz X-Patchwork-Id: 64472 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 EAE41C61CE7 for ; Fri, 6 Jun 2025 15:02:02 +0000 (UTC) Received: from smtp-42ae.mail.infomaniak.ch (smtp-42ae.mail.infomaniak.ch [84.16.66.174]) by mx.groups.io with SMTP id smtpd.web11.35683.1749222121284373370 for ; Fri, 06 Jun 2025 08:02:01 -0700 Authentication-Results: mx.groups.io; dkim=none (message not signed); spf=pass (domain: 0leil.net, ip: 84.16.66.174, mailfrom: foss+yocto@0leil.net) Received: from smtp-3-0001.mail.infomaniak.ch (smtp-3-0001.mail.infomaniak.ch [10.4.36.108]) by smtp-3-3000.mail.infomaniak.ch (Postfix) with ESMTPS id 4bDPfv6M6FzDqy; Fri, 6 Jun 2025 17:01:59 +0200 (CEST) Received: from unknown by smtp-3-0001.mail.infomaniak.ch (Postfix) with ESMTPA id 4bDPfv1wVyzgWy; Fri, 6 Jun 2025 17:01:59 +0200 (CEST) From: Quentin Schulz Date: Fri, 06 Jun 2025 17:01:47 +0200 Subject: [PATCH 1/2] ref-manual: classes: reword to clarify that native/nativesdk options are exclusive MIME-Version: 1.0 Message-Id: <20250606-native-options-v1-1-2ad99a184f90@cherry.de> References: <20250606-native-options-v1-0-2ad99a184f90@cherry.de> In-Reply-To: <20250606-native-options-v1-0-2ad99a184f90@cherry.de> To: docs@lists.yoctoproject.org Cc: Joseph Maniaci , Ross Burton , Khem Raj , Quentin Schulz X-Mailer: b4 0.14.2 X-Infomaniak-Routing: alpha List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 06 Jun 2025 15:02:02 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/7023 From: Quentin Schulz We explain how to create a native (nativesdk) recipe in two different ways via a bullet list but reading quickly the instructions may mislead one into doing both options whereas they are incompatible. This rewords both the nativesdk and native sections so that the second bullet point starts with an Or and explicit that this applies to target recipes. Signed-off-by: Quentin Schulz --- documentation/ref-manual/classes.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 54a98bf24f3e75a20646a0daa87ce29c6df0e18c..b5121aec0f28eaaee43db107977f45d43ee45801 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -2050,7 +2050,8 @@ a couple different ways: Not using this naming convention can lead to subtle problems caused by existing code that depends on that naming convention. -- Create or modify a target recipe that contains the following:: +- Or, create a :ref:`ref-classes-native` variant of any target recipe (e.g. + ``myrecipe.bb``) by adding the following to the recipe:: BBCLASSEXTEND = "native" @@ -2081,7 +2082,8 @@ couple different ways: inherit statement in the recipe after all other inherit statements so that the :ref:`ref-classes-nativesdk` class is inherited last. -- Create a :ref:`ref-classes-nativesdk` variant of any recipe by adding the following:: +- Or, create a :ref:`ref-classes-nativesdk` variant of any target recipe (e.g. + ``myrecipe.bb``) by adding the following to the recipe:: BBCLASSEXTEND = "nativesdk" From patchwork Fri Jun 6 15:01:48 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Quentin Schulz X-Patchwork-Id: 64473 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 E5036C5B555 for ; Fri, 6 Jun 2025 15:02:02 +0000 (UTC) Received: from smtp-42a8.mail.infomaniak.ch (smtp-42a8.mail.infomaniak.ch [84.16.66.168]) by mx.groups.io with SMTP id smtpd.web11.35684.1749222121933765381 for ; Fri, 06 Jun 2025 08:02:02 -0700 Authentication-Results: mx.groups.io; dkim=none (message not signed); spf=pass (domain: 0leil.net, ip: 84.16.66.168, mailfrom: foss+yocto@0leil.net) Received: from smtp-3-0001.mail.infomaniak.ch (unknown [IPv6:2001:1600:4:17::246c]) by smtp-3-3000.mail.infomaniak.ch (Postfix) with ESMTPS id 4bDPfw3TrKzBbs; Fri, 6 Jun 2025 17:02:00 +0200 (CEST) Received: from unknown by smtp-3-0001.mail.infomaniak.ch (Postfix) with ESMTPA id 4bDPfv6TLwz5bN; Fri, 6 Jun 2025 17:01:59 +0200 (CEST) From: Quentin Schulz Date: Fri, 06 Jun 2025 17:01:48 +0200 Subject: [PATCH 2/2] ref-manual: classes: nativesdk: move note to appropriate section MIME-Version: 1.0 Message-Id: <20250606-native-options-v1-2-2ad99a184f90@cherry.de> References: <20250606-native-options-v1-0-2ad99a184f90@cherry.de> In-Reply-To: <20250606-native-options-v1-0-2ad99a184f90@cherry.de> To: docs@lists.yoctoproject.org Cc: Joseph Maniaci , Ross Burton , Khem Raj , Quentin Schulz X-Mailer: b4 0.14.2 X-Infomaniak-Routing: alpha List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 06 Jun 2025 15:02:02 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/7024 From: Quentin Schulz The nativesdk- prefix to the recipe filename should only be used when using the inherit method as the BBCLASSEXTEND method will do some magic when generating the "implicit" name of the recipe. This matches the instructions for the native class. Signed-off-by: Quentin Schulz --- documentation/ref-manual/classes.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index b5121aec0f28eaaee43db107977f45d43ee45801..da2bd028d8b96f27ca222fd72358ba0b64be5126 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -2082,6 +2082,16 @@ couple different ways: inherit statement in the recipe after all other inherit statements so that the :ref:`ref-classes-nativesdk` class is inherited last. + .. note:: + + When creating a recipe, you must follow this naming convention:: + + nativesdk-myrecipe.bb + + + Not doing so can lead to subtle problems because there is code that + depends on the naming convention. + - Or, create a :ref:`ref-classes-nativesdk` variant of any target recipe (e.g. ``myrecipe.bb``) by adding the following to the recipe:: @@ -2092,16 +2102,6 @@ couple different ways: specify any functionality specific to the respective SDK machine or target case. -.. note:: - - When creating a recipe, you must follow this naming convention:: - - nativesdk-myrecipe.bb - - - Not doing so can lead to subtle problems because there is code that - depends on the naming convention. - Although applied differently, the :ref:`ref-classes-nativesdk` class is used with both methods. The advantage of the second method is that you do not need to have two separate recipes (assuming you need both) for the SDK machine