From patchwork Tue Jan 27 21:53:00 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daiane Angolini X-Patchwork-Id: 79892 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 E68FBD2FEF4 for ; Tue, 27 Jan 2026 21:53:20 +0000 (UTC) Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.1234.1769550799766424007 for ; Tue, 27 Jan 2026 13:53:19 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@foundries.io header.s=google header.b=SrhYXLzg; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: foundries.io, ip: 205.220.168.131, mailfrom: daiane.angolini@foundries.io) Received: from pps.filterd (m0279863.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 60RHhitm1953421 for ; Tue, 27 Jan 2026 21:53:19 GMT Received: from mail-dl1-f70.google.com (mail-dl1-f70.google.com [74.125.82.70]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4by2118rbj-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Tue, 27 Jan 2026 21:53:19 +0000 (GMT) Received: by mail-dl1-f70.google.com with SMTP id a92af1059eb24-1233b91de6bso10551775c88.1 for ; Tue, 27 Jan 2026 13:53:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=foundries.io; s=google; t=1769550798; x=1770155598; darn=lists.yoctoproject.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=ESse4nNoHkFl7Nd8RaCGODmg93SudfdI2uaP9m81xxE=; b=SrhYXLzgRPjc1dOOkAGuvdQ/VF9ZAiI8QVP50lZcgE62r4CmxATMKfFe0AxI6JZNLF vn23DZNHWyn2Qefd3bw+PmaXSdXUW0/h9g4zCvqXB3oXg4D5cyBn9ofEqERSbENCK9q+ xBewHOi6rj8+5oaE6fAVqXTcDZ1WEAb/RkfXMPLHo5Jgp4YGWIU3VD4HRg6sG/l/S7wQ 4JwDw/7bwm8QK5UEEhd1sDLkH347gxXVns6n1hMjtPCvNz3sfESARUoKO3rCOMBP84T6 r7qnI3bCNMIex8wGI/sPnhz1x3KOMOTlCjL51Mo4iUoUK4/PZU7RhIe12BsjxCGzkn6d I1Nw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1769550798; x=1770155598; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=ESse4nNoHkFl7Nd8RaCGODmg93SudfdI2uaP9m81xxE=; b=As1maIZYZFEZR4meu4autjbaY3uUt5/lX2hnLDUoNevbWVP7s6FNBBxyyzOJoC0TWz JHOKuBWXV5jwIhO2dCzWG5MNmUhD0ZPDGx2D3ECl36AUDWpa7jem1avWfZKydisc/+U9 o6LCIY5+C8FclclRgqx8gnaiZl1/iPRp+rHsA4Av7+IIJkID9+OkzvvcXoJ+agHV/Q4+ x+Ooyiei1QBZlxbwmYjKHKUJdVnA0vy9WBLnnQouXKgs1emVj7AE5r8pVTRsGw1nSZqB NVOkOlxQqxfaUvAb+Kd8xvTIfiTMIt1M2MVpUp/XhtYSaairyGh0q+lIXhDTY8BRGubM xgQA== X-Gm-Message-State: AOJu0Yy1jGB6ClH234MKNrlsvMc/Bw/a/70n9jtW7KydQ4q8rLNwsis1 ZwiiSFsxzCpxTUZ4NfOKvUikP7bu/hXHwN48hkCFIJtX81Z8A8CVsOIU21EFgiNR7fmqZilbKPT Nm6zLr9dy3FaIzD++gnWfgX0zc8Z4k+kTFJoSHq9eGjvXkx8+xFMvPyjz/5bQQ3JO X-Gm-Gg: AZuq6aJYxJA+jZjpjdIS0GsZKXHC+Uzx3oqc5+hNq7GAD3Wn8SHQucyd62q+AproLfB Byk3TXl723LN3TTLA30LSl/Js1BS0S+GwYIWDuzyM546lptLQm4o7llhIfbOxNwlXEoLvSSrg26 COBFINQy9Roz+3hk0IFlNFR2Rq44k/eoeAHjKsUK+Z133Y11da57IZyXjStK7JaLrkBT9DrvQVV InLptfT0M1pB5WYoHU5Dihl+s4AJFYnADI1d5qyzXy7W3uWRgnDeQ4Ipgf6WmExtNrI+bkEzB13 ZZxU521a/9EbdV0zBjwkx9gBnDWdgR3PoAnItLQ+G0RGoRRqKnENVrrDFrPoHKLiXvapdVTiyQt w5hj074mX6xSbGyjz6g2uf2kqBfiyzUBUtqsHqc8biluYethtWGQs7xz+bBAVpgr4nDPDxB4l3v h7Iw== X-Received: by 2002:a05:7022:fa3:b0:123:35cb:96e3 with SMTP id a92af1059eb24-124a00e4d53mr1984605c88.46.1769550798183; Tue, 27 Jan 2026 13:53:18 -0800 (PST) X-Received: by 2002:a05:7022:fa3:b0:123:35cb:96e3 with SMTP id a92af1059eb24-124a00e4d53mr1984581c88.46.1769550797492; Tue, 27 Jan 2026 13:53:17 -0800 (PST) Received: from lola.lan ([187.183.40.109]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-124a9cdcbcfsm31627c88.0.2026.01.27.13.53.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Jan 2026 13:53:17 -0800 (PST) From: Daiane Angolini To: bitbake-devel@lists.openembedded.org Cc: docs@lists.yoctoproject.org, Daiane Angolini Subject: [docs][PATCH v2 1/4] doc: change some terminology around bitbake-setup Date: Tue, 27 Jan 2026 18:53:00 -0300 Message-Id: <20260127215303.512936-2-daiane.angolini@foundries.io> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260127215303.512936-1-daiane.angolini@foundries.io> References: <20260127215303.512936-1-daiane.angolini@foundries.io> MIME-Version: 1.0 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwMTI3MDE3OCBTYWx0ZWRfXyuzcFJ6op1ai ZoJthua/cF0nmJx5hnNWIj/hSKi5evLI1zOdxZIlntOI0Me7vAKMMknFJDZZYlsaRb2WCUx4Vkn o50cDZ6/07FnrBegE6Fo9pcj77ilCbZu8sGXsL0+vWfqYSM9uDHgUu1V827rS6vxaiZH/dZ0xdn U6JUYBmHzbWt3jQc+rvq12pa3N9LJLDGb8dnMuyq5blnbN/Hb1RmbDDWkFXQN4BBlidgIJGwuwd uvWx5KuOse76FdQg9qYJbg5MY4PdTOoR1qjp06s+8rqJYiUT3t6/bPZlIqKaqnSeo46FGYiwbcR KJv/QzfpoSjQWXuQhWb6iqIkxIM46yuP8KqO8ii6N1EGFIIZfwxiF1ctVwJdH2+bcbGqa8v4qqo H8L4KSa6v7t4Rd+AnjqrM/JUMTzVAqw2oNQdIjaNvcYkyG+o43NRZiU4wt5hlAiPKfOD/moZMdO fZkKzeYtpoJko9tNyGQ== X-Authority-Analysis: v=2.4 cv=GuxPO01C c=1 sm=1 tr=0 ts=697933cf cx=c_pps a=SvEPeNj+VMjHSW//kvnxuw==:117 a=PIITv4rVe324bgT4salBLw==:17 a=vUbySO9Y5rIA:10 a=9UA2AVYIz8kA:10 a=VkNPw1HP01LnGYTKEx00:22 a=Q4-j1AaZAAAA:8 a=A1X0JdhQAAAA:8 a=YEfPZHoM8sb2t3cV5ooA:9 a=Kq8ClHjjuc5pcCNDwlU0:22 a=9H3Qd4_ONW2Ztcrla5EB:22 X-Proofpoint-GUID: YBjQOAikljw1Ar9qqhhSo-s5fVmalPD4 X-Proofpoint-ORIG-GUID: YBjQOAikljw1Ar9qqhhSo-s5fVmalPD4 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1121,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-01-27_04,2026-01-27_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=0 adultscore=0 malwarescore=0 lowpriorityscore=0 phishscore=0 bulkscore=0 impostorscore=0 spamscore=0 clxscore=1015 priorityscore=1501 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2601150000 definitions=main-2601270178 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 ; Tue, 27 Jan 2026 21:53:20 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8751 Change some terms to use more specific wording: Generic Configuration -> Configuration Template Specific Configuration -> Configuration Instance Signed-off-by: Daiane Angolini --- .../bitbake-user-manual-environment-setup.rst | 86 +++++++++---------- 1 file changed, 43 insertions(+), 43 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index 3b6a73fd8..76f5c41e3 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -41,8 +41,8 @@ Quick Start $ ./bitbake/bin/bitbake-setup init This command will ask you to choose which configurations to use available as - part of the default BitBake :term:`generic configurations `. + part of the default BitBake :term:`Configuration Templates `. .. note:: @@ -73,8 +73,8 @@ Quick Start The name of the directory will vary depending on the choices. - - ``config/``: holds the :term:`Specific Configuration`, which embeds the - :term:`Generic Configuration` (first choice of the :ref:`ref-bbsetup-command-init` command) + - ``config/``: holds the :term:`Configuration Instance`, which embeds the + :term:`Configuration Template` (first choice of the :ref:`ref-bbsetup-command-init` command) and the choices made during the initialization. - ``build/``: the :term:`BitBake Build` directory, where BitBake stores @@ -145,12 +145,12 @@ The "Top Directory" and "Setup" directories are defined as follows: :term:`Setup` A Setup is the result of the :ref:`ref-bbsetup-command-init` command, which creates a :term:`Setup` directory. It is constructed from a - :term:`Generic Configuration` and choices made during the ``init`` command. + :term:`Configuration Template` and choices made during the ``init`` command. It contains at least: - A :term:`BitBake Build` (``build/`` directory). - - A :term:`Specific Configuration` (``config/`` directory). + - A :term:`Configuration Instance` (``config/`` directory). - Sources such as :ref:`layers ` or other repositories managed by ``bitbake-setup`` (``layers/`` directory). @@ -173,8 +173,8 @@ The following components are involved to create the content of these directories Build` constitute the :ref:`BitBake configuration `. - :term:`Generic Configuration` - A Generic Configuration is a file in JSON format containing a template to + :term:`Configuration Template` + A Configuration Template is a file in JSON format containing a template to create a :term:`Setup`. These files are used during the :ref:`ref-bbsetup-command-init` command as a starting point to configure the :term:`Setup`. When the command runs, the user may be prompted with choices to further specify the @@ -183,42 +183,42 @@ The following components are involved to create the content of these directories It is also possible to specify the choices on the command line for a completely non-interactive initialization. - :term:`Generic Configuration` files are stored in :term:`registries + :term:`Configuration Template` files are stored in :term:`registries `, and can be listed with the :ref:`ref-bbsetup-command-list` command. - :term:`Generic Configuration` files must end with the ``.conf.json`` + :term:`Configuration Template` files must end with the ``.conf.json`` suffix for ``bitbake-setup`` to locate them. .. note:: - The default :term:`Generic Configurations ` are + The default :term:`Configuration Templates ` are located in the BitBake repository in a local registry. the ``default-registry/`` directory. This can be modified with the :ref:`ref-bbsetup-setting-registry` setting. :ref:`ref-bbsetup-command-status` will tell if a :term:`Setup` - is in sync with the :term:`Generic Configuration` it was constructed from + is in sync with the :term:`Configuration Template` it was constructed from (typically: layer updates). :ref:`ref-bbsetup-command-update` will bring a :term:`Setup` - in sync with its :term:`Generic Configuration`. + in sync with its :term:`Configuration Template`. - :term:`Specific Configuration` - The :term:`Specific Configuration` is stored in the ``config/`` directory - in a :term:`Setup`. It embeds the :term:`Generic Configuration` and the + :term:`Configuration Instance` + The :term:`Configuration Instance` is stored in the ``config/`` directory + in a :term:`Setup`. It embeds the :term:`Configuration Template` and the choices made during the initialization. - It is also a Git repository, that contains a history of the specific - configuration and updates made to it via :ref:`ref-bbsetup-command-update`. + It is also a Git repository, that contains a history of the configuration + instance and updates made to it via :ref:`ref-bbsetup-command-update`. :term:`Registry` - A configuration registry is a place where one or more :term:`Generic - Configurations ` are stored. + A configuration registry is a place where one or more :term:`Configuration + Templates ` are stored. The directory structure of the registry can be any: ``bitbake-setup`` recursively find files ending with ``.conf.json`` and consider it a - :term:`Generic Configuration`. + :term:`Configuration Template`. The registry location is configured through the :ref:`ref-bbsetup-setting-registry` setting. This location can be the URL to @@ -279,7 +279,7 @@ The ``bitbake-setup init`` sub-command helps initializing a :term:`Setup`. This command can be run without any arguments to prompt the user with configuration options to choose from. These configuration options are taken from -the input :term:`Generic Configuration` files in the :term:`registry`. +the input :term:`Configuration Template` files in the :term:`registry`. .. note:: @@ -288,9 +288,9 @@ the input :term:`Generic Configuration` files in the :term:`registry`. Otherwise, the first argument to :ref:`ref-bbsetup-command-init` can be: -- A generic configuration ID in the registry. -- A path to a generic configuration file on a local disk. -- An HTTP URI to the generic configuration file. +- A Configuration Template ID in the registry. +- A path to a Configuration Template file on a local disk. +- An HTTP URI to the Configuration Template file. The choices made during the bare ``bitbake-setup init`` command can also be passed directly on the command-line, for example:: @@ -331,7 +331,7 @@ In addition, the command can take the following arguments: ``bitbake-setup init`` Examples ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- This example prompts the user to choose a :term:`Generic Configuration` from +- This example prompts the user to choose a :term:`Configuration Template` from a custom registry: .. code-block:: shell @@ -340,18 +340,18 @@ In addition, the command can take the following arguments: --setting default registry 'git://example.com/bitbake-setup-configurations.git;protocol=https;branch=main;rev=main' \ init -- This example takes a :term:`Generic Configuration` from a remote location +- This example takes a :term:`Configuration Template` from a remote location (here, one of the default configuration in BitBake): .. code-block:: shell $ ./bitbake/bin/bitbake-setup init https://git.openembedded.org/bitbake/plain/default-registry/configurations/oe-nodistro-master.conf.json -- This example initializes a :term:`Setup` with: +- This example initializes a :term:`Setup` with: - A custom :ref:`ref-bbsetup-setting-top-dir-prefix` and :ref:`ref-bbsetup-setting-top-dir-name` - A :term:`source override`, and additionally overriding openembedded-core with a locally managed directory. - - A standalone :term:`generic configuration` file. + - A standalone :term:`Configuration Template` file. - Choices passed on the command-line, applied non-interactively. .. code-block:: shell @@ -371,8 +371,8 @@ In addition, the command can take the following arguments: ``bitbake-setup list`` ---------------------- -The ``bitbake-setup list`` sub-command lists the available :term:`generic -configurations ` in the current :term:`registry`. +The ``bitbake-setup list`` sub-command lists the available :term:`Configuration +Templates ` in the current :term:`registry`. In addition, the command can take the following arguments: @@ -388,8 +388,8 @@ In addition, the command can take the following arguments: ------------------------ The ``bitbake-setup status`` sub-command shows the status of a -:term:`Setup`. Any differences between the local copy of the :term:`generic -configuration` and the upstream one are printed on the console. +:term:`Setup`. Any differences between the local copy of the :term:`Configuration +Template` and the upstream one are printed on the console. If the BitBake environment is sourced and ready to build, the ``bitbake-setup status`` command (without any arguments) will show the status of the current @@ -407,7 +407,7 @@ In addition, the command can take the following arguments: ------------------------ The ``bitbake-setup update`` sub-command updates a :term:`Setup` to sync with -the latest changes from a :term:`generic configuration` it was constructed from. +the latest changes from the :term:`Configuration Template` it was constructed from. The :ref:`ref-bbsetup-command-status` command can be used to show the current status of the :term:`Setup` before updating it. @@ -617,16 +617,16 @@ manner. The :ref:`ref-bbsetup-setting-use-full-setup-dir-name` setting, if set to ``yes`` will override the suggestions for the :term:`Setup` directory name made by -``setup-dir-name`` entries in :term:`Generic Configuration` files. This +``setup-dir-name`` entries in :term:`Configuration Template` files. This will make the directory names longer, but fully specific: they will contain all selections made during initialization. .. _ref-bbsetup-section-config-reference: -Generic Configuration Files Reference -===================================== +Configuration Template Files Reference +====================================== -:term:`Generic Configurations ` are the input files given +:term:`Configuration Templates ` are the input files given to ``bitbake-setup`` to configure :term:`Setups `. These files are written in the JSON file format and are stored in a @@ -891,8 +891,8 @@ They contain the following sections: would expand to ``somebuild-machine_gadget``. -Generic Configuration Examples ------------------------------- +Configuration Template Examples +------------------------------- OpenEmbedded "nodistro" configuration for master branches: @@ -945,10 +945,10 @@ Here is an example file that overrides the branch of the BitBake repository to } - The ``version`` parameter contains the version of the used configuration, and - should match the one of the :term:`Generic Configuration` file in use. + should match the one of the :term:`Configuration Template` file in use. - The ``sources`` section contains the same options as the ``sources`` option - of a :term:`Generic Configuration` file. See the + of a :term:`Configuration Template` file. See the :ref:`ref-bbsetup-section-config-reference` section for more information. .. _ref-bbsetup-fixed-revisions: @@ -956,7 +956,7 @@ Here is an example file that overrides the branch of the BitBake repository to Fixed source revisions ====================== -:term:`Generic Configuration` can set source revisions in ``rev`` to a tag or a branch. +:term:`Configuration Template` can set source revisions in ``rev`` to a tag or a branch. Bitbake-setup will make sure the actual revision will match the tag or branch when performing initializations or updates, and will capture the revisions in a :ref:`ref-bbsetup-source-overrides` file. From patchwork Tue Jan 27 21:53:01 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daiane Angolini X-Patchwork-Id: 79893 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 E7A0FD2FEF3 for ; Tue, 27 Jan 2026 21:53:30 +0000 (UTC) Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.1235.1769550802029612961 for ; Tue, 27 Jan 2026 13:53:22 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@foundries.io header.s=google header.b=dXRqsBqV; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: foundries.io, ip: 205.220.168.131, mailfrom: daiane.angolini@foundries.io) Received: from pps.filterd (m0279865.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 60RJ0ms32436568 for ; Tue, 27 Jan 2026 21:53:21 GMT Received: from mail-dy1-f198.google.com (mail-dy1-f198.google.com [74.125.82.198]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4by355rfrg-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Tue, 27 Jan 2026 21:53:21 +0000 (GMT) Received: by mail-dy1-f198.google.com with SMTP id 5a478bee46e88-2b6f0b345e3so34358356eec.0 for ; Tue, 27 Jan 2026 13:53:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=foundries.io; s=google; t=1769550801; x=1770155601; darn=lists.yoctoproject.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=IA9D+gOmvMUJO3RRBaFRFNuQ47rZu/dEOy44dlbTsM4=; b=dXRqsBqVHsm/VEq0738LabqPMvjFKaBiZpkW1JSRI/WF6L8YZ9rGpVKUjk4yxeOAtk k0tV+JgNXYHMgBONHLLvS0Ujddop9eP0Ece/pGi4S3fmWnWEp6YTFMGi27JWD4EzZzDY bemSlXfxEbgN8YS3w+dTzcZjGsuPtnYkWEdTqSKEWgeh6sUigCx606J4ZQcSrUSaHdWK fmgAP1Kk7NpJdddm1pC3xywjSOxPpPUtsyaKUp8ZjSAmhf6D2RdwlTDUNdFuKU8QGxsW IKNEnttQeBIjTQsTa4uunT8y7BR4WF2bnNAh58XpODR/s8qXouEDRIUbYqQLzwiwBykx Q0lg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1769550801; x=1770155601; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=IA9D+gOmvMUJO3RRBaFRFNuQ47rZu/dEOy44dlbTsM4=; b=SMF1vxZN9FRyIJsLmBgk3xlzwsJFAQCyHbvoMk0H/dcum981NhhEyUGOhjXOYURUnO mdrmn8jVoDrdIExBA07t4SUuZJpR5ZR5Kai0Z5HORJWEfVqk/LyrXSQoZF12G+YHkZBL q00Z4rzaTNo0ZgdTL0qHFtOoZ3FtcymGkd72x4W4NgxL32H5hf001WFYdGpS0xjUHJY8 FsTcd3+T7mRWCArvJTrQRICEGlFgIn3FlGjAqsTH0wyci5McDKxT6wvrzSCJvIe4Tt4R zJ/PadeyzYI1TZLCKBdpau0grCXALwHo3USFHPqELCgIwX8abzdZLgcNyXvtnGxGmghe bH3A== X-Gm-Message-State: AOJu0Yy/HXOXZ7zDeZ6JRsiC6fPmre70sZSSV1zrw74CpXefhQXIUmm0 FaZ2inWwkpMYYk4rCxJztxfuBSmq15GwSK+7yKM6DScs50yiqNb3WzhnHibALZeylzAFe66C6Fg 9OmUAKaAzm8fFgFcKxY0N0sMxiJ6A0aG68bacT4OtjB1clu7xO/s0jdSB37zH+erF8xFf2DLy X-Gm-Gg: AZuq6aJ0uAXPpVcX9UmyHn9beJmcLozZIxuyC89OhCXqpLDcqKGVL3DxSFnFTj0ZXJ0 9Yimpd93c+ElsVeAjDiZPu8F9lyb8MnlJf5rOAy/yUYiPsgUbjHDHRonur1BE5g32PVAoTVG83p ZJYwNmNfxftQNMdUdiqSMrsDPWU67Z/1OHD2DGq0PbM3jhRj1VrtamRmuuEuCYsllaF1IwU4VWA sJ/7stzZuoUL+l7dzej2m+0w8ZQ+720yws55JRPtiSOuIa7LZx+M3Otc0vX8GV7LXIGW5jFOzpr qgIA5w3YytM87b7Uyep10JiNbLp7a7Bnlm9dvbxEFnWp0BnNUIi+0whuvSLZuJ7/DVC8euwIybQ jpsTIP0XQuqTM0Npl9G5Jqhd82Qro7pwTTKOg9W0fcp4bCFFab/CH8jO2nVZlkdkhJ3E9wwok7x YnAA== X-Received: by 2002:a05:7022:fa2:b0:11f:2c69:32 with SMTP id a92af1059eb24-124a005baa1mr1750930c88.7.1769550800701; Tue, 27 Jan 2026 13:53:20 -0800 (PST) X-Received: by 2002:a05:7022:fa2:b0:11f:2c69:32 with SMTP id a92af1059eb24-124a005baa1mr1750916c88.7.1769550800209; Tue, 27 Jan 2026 13:53:20 -0800 (PST) Received: from lola.lan ([187.183.40.109]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-124a9cdcbcfsm31627c88.0.2026.01.27.13.53.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Jan 2026 13:53:19 -0800 (PST) From: Daiane Angolini To: bitbake-devel@lists.openembedded.org Cc: docs@lists.yoctoproject.org, Daiane Angolini Subject: [docs][PATCH v2 2/4] bitbake-setup: Change the output to match the terminology in the docs Date: Tue, 27 Jan 2026 18:53:01 -0300 Message-Id: <20260127215303.512936-3-daiane.angolini@foundries.io> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260127215303.512936-1-daiane.angolini@foundries.io> References: <20260127215303.512936-1-daiane.angolini@foundries.io> MIME-Version: 1.0 X-Authority-Analysis: v=2.4 cv=YNWSCBGx c=1 sm=1 tr=0 ts=697933d1 cx=c_pps a=wEP8DlPgTf/vqF+yE6f9lg==:117 a=PIITv4rVe324bgT4salBLw==:17 a=LVY25okwlNza5Yhv:21 a=vUbySO9Y5rIA:10 a=9UA2AVYIz8kA:10 a=VkNPw1HP01LnGYTKEx00:22 a=1WldhAeflNbf4ZlfaWQA:9 a=bBxd6f-gb0O0v-kibOvt:22 X-Proofpoint-ORIG-GUID: k1_N4ll9VY-CWe28_BWzWFNIFcTnL6aR X-Proofpoint-GUID: k1_N4ll9VY-CWe28_BWzWFNIFcTnL6aR X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwMTI3MDE3OCBTYWx0ZWRfX7jyzd4zAWSjo R3pWrM0M+sMoswqd4CS8oyo+DcREoXHFWNaeeDFF+z7/yBvfUIZI1IjDGVKEfu79vQfhSRgEXMY Gyal3oNxHeq2yWAftPduBuiLIXpi45Grfh27jxfQqEGTUybEE4g2aZuMPg1HTRjAu7VUbKzsC+i B2TITA32QfUgWtMR5TTBkZKbfP45g3vEMXGFmrsOwZRX7mIAvrfNoqQ+NGEhmZslOD/F0MXCAAt B4Yne33ssXe7VDC6Q6AXW7ozxFx8EfVtnRvWWBA94Y0pk6qZ9svD45ULT7DGtAh4lKAHJPRzjAE JzUfaVY9JzYc8hO7ZTh2HWdtYcd26X3qHOtet1ZvTsYiMjPLyeQvC0hTTqHdsbTqQ8UxCS93Did oJ34TJ2C5O7EBFkTomGKI6kDLfm/vvSf6vHHHHiztsh4i97PKbGYNrX+lme2uGM0S0i6dQhr9QB FNjnig7VLxxagu/Shbw== X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1121,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-01-27_04,2026-01-27_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 phishscore=0 suspectscore=0 lowpriorityscore=0 adultscore=0 priorityscore=1501 spamscore=0 impostorscore=0 malwarescore=0 clxscore=1015 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2601150000 definitions=main-2601270178 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 ; Tue, 27 Jan 2026 21:53:30 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8752 Make the output to match the terminology used in the documentation for some terms. Signed-off-by: Daiane Angolini --- bin/bitbake-setup | 4 ++-- default-registry/configurations/poky-master.conf.json | 2 +- default-registry/configurations/poky-whinlatter.conf.json | 2 +- .../bitbake-user-manual-environment-setup.rst | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/bin/bitbake-setup b/bin/bitbake-setup index abe7614c8..d3654cac8 100755 --- a/bin/bitbake-setup +++ b/bin/bitbake-setup @@ -475,7 +475,7 @@ def choose_config(configs, non_interactive): if non_interactive: raise Exception("Unable to choose from configurations in non-interactive mode: {}".format(not_expired_configs)) - logger.plain("\nAvailable configurations:") + logger.plain("\nAvailable Configuration Templates:") for n, config_name in config_list: config_data = configs[config_name] expiry_date = config_data.get("expires", None) @@ -485,7 +485,7 @@ def choose_config(configs, non_interactive): else: logger.plain("{}. {}\t{}".format(n, config_name, config_desc)) config_n = int_input([i[0] for i in config_list], - "\nPlease select one of the above configurations by its number: ") - 1 + "\nPlease select one of the above Configuration Templates by its number: ") - 1 return config_list[config_n][1] def choose_fragments(possibilities, parameters, non_interactive, skip_selection): diff --git a/default-registry/configurations/poky-master.conf.json b/default-registry/configurations/poky-master.conf.json index 1de038bab..f248a4811 100644 --- a/default-registry/configurations/poky-master.conf.json +++ b/default-registry/configurations/poky-master.conf.json @@ -57,7 +57,7 @@ "options" : ["machine/qemux86-64", "machine/qemuarm64", "machine/qemuriscv64", "machine/genericarm64", "machine/genericx86-64"] }, "distro": { - "description": "Distribution configuration variants", + "description": "Target Distributions", "options" : ["distro/poky", "distro/poky-altcfg", "distro/poky-tiny"] } }, diff --git a/default-registry/configurations/poky-whinlatter.conf.json b/default-registry/configurations/poky-whinlatter.conf.json index bfa67426d..4827ebe11 100644 --- a/default-registry/configurations/poky-whinlatter.conf.json +++ b/default-registry/configurations/poky-whinlatter.conf.json @@ -58,7 +58,7 @@ "options" : ["machine/qemux86-64", "machine/qemuarm64", "machine/qemuriscv64", "machine/genericarm64", "machine/genericx86-64"] }, "distro": { - "description": "Distribution configuration variants", + "description": "Target Distributions", "options" : ["distro/poky", "distro/poky-altcfg", "distro/poky-tiny"] } }, diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index 76f5c41e3..6d76e3db4 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -762,7 +762,7 @@ They contain the following sections: "options" : ["machine/qemux86-64", "machine/qemuarm64", "machine/qemuriscv64", "machine/genericarm64", "machine/genericx86-64"] }, "distro": { - "description": "Distribution configuration variants", + "description": "Target Distributions", "options" : ["distro/poky", "distro/poky-altcfg", "distro/poky-tiny"] } }, From patchwork Tue Jan 27 21:53:02 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Daiane Angolini X-Patchwork-Id: 79894 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 F336ED2FEF5 for ; Tue, 27 Jan 2026 21:53:30 +0000 (UTC) Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.1236.1769550804102701128 for ; Tue, 27 Jan 2026 13:53:24 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@foundries.io header.s=google header.b=TIhADXkV; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: foundries.io, ip: 205.220.168.131, mailfrom: daiane.angolini@foundries.io) Received: from pps.filterd (m0279865.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 60RJ0gDV2436401 for ; Tue, 27 Jan 2026 21:53:23 GMT Received: from mail-dl1-f69.google.com (mail-dl1-f69.google.com [74.125.82.69]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4by355rfrq-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Tue, 27 Jan 2026 21:53:23 +0000 (GMT) Received: by mail-dl1-f69.google.com with SMTP id a92af1059eb24-124a95d580cso1306760c88.1 for ; Tue, 27 Jan 2026 13:53:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=foundries.io; s=google; t=1769550803; x=1770155603; darn=lists.yoctoproject.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=JhBeqlh+7XFSVtKGkqCNSyVPQct07oOIo+OIdBvLxjs=; b=TIhADXkVggyew3wg10vuU57Y/1UPHk3dZdVFUKH6zz8LXexn8LrZhyfZR3FOV/kkUG emGc145ZupNGO2uAH1IKYxOMjxgObyA1c6E7oEcGJ8DyHiS1rB+SNgdDVCVvbW+SKdUd w4gzNWXG1XBXs++4ZvCK4c1USZU54kQe7r9bRK74TeIY+ppI72NqKe1f4YA/ly66f9Eq SIScQaCV2/mZextwFoL6LI/sfDGEbShsfXvyk5k9JobijGKautWj6pcpzxQILqDjgBht xCb3m+UG8RpoK1tH7g3ePckzvOared4NR+U1AtM9p5x0gguVn1A0LxRCSBsB+Tv1JcXw N3OA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1769550803; x=1770155603; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=JhBeqlh+7XFSVtKGkqCNSyVPQct07oOIo+OIdBvLxjs=; b=D5eMwnB9ZjULBZxQtlDTjzgG2YKSH9rY2MI0fMXV2J14dquHGQZgquGHuUPuMUHnY3 nMAcvXECXSsVHE5isn/o8nvshTEXTLAT8ALRHzjf+ErC9lrrAXjPVCOyuKoqg/YE2aiB XS4ikrrMT4IC4E86gzi0VYbCX3NPVw87RObQgiKSeTGhz8GYw9bOsAmMrSHkmvUrDum8 KDjJqc4JpVtHD899IfoZBdO5oYMepp2+JU2aey6PlIqbEWqWN4oxk2ZiWwLOp51de1d7 reSVn8mV78RelNuWlGVP/WNyBkO53g2dNDYRbTiQL+BXLHJSjs2NxDvSCKumBHZ79CN9 GK3Q== X-Gm-Message-State: AOJu0YzKNU5JD8Ff+bcrmL6CBZj0kxOO7p3FO7KfBpqPFBYLJ7RDttkU rvhK2VvfkbkGaJJsS9SC3otA9pPLc4NwLNEME4+GH+U/nT8fme1NT/YtHM4b6uk8zaVM56ZvMt3 tF7eYKgFkGEYBrgHbmp/9K+7UQFEbozpQ3QOjJfp/4DzXuFl+/ps6Kf6L4JgdVNba X-Gm-Gg: AZuq6aKR0I8PU2wYS0zvAn5qCnpCV7bH5/KZce9lWQ1+RyO5Ff6KhLmCZvF42QtryFX BOirumnrVbq4pq+wyM7dGOvqGQ3kZRcd6iLe1TmXwbhGUBvZsMqG2PjE4EDfizHXR7hlOEFBHso 0oNxOn+ltB3XYCA7xumzrAIFV27TMS8/1oIZAZhNkL6za3F6H6Q9a37h229sckDWMPNSl7FmGfZ 3RQbntBD84HRcK0Lcc8srYQTRqO/+dd1i8rceWKE+/WIoypbcDjtSkvZubGEPu1E2PisUibqa2+ BAbq7tO8C1cxR0hiHwgr95t6mfVYFzjlesHOJcvN5OLSfmm+8CsL8UffyrpiMVEL/A1M7e0Xd/q 8oL1EG/VCKdVUroOYvA1xlMtjppIhLHkxrqPYzVu9ETVqPPKaOZ7gNVEnO0ziVdIOlrrq8bApy1 mGnA== X-Received: by 2002:a05:7022:488:b0:123:2d38:929a with SMTP id a92af1059eb24-124a00cf0b9mr2095068c88.38.1769550803046; Tue, 27 Jan 2026 13:53:23 -0800 (PST) X-Received: by 2002:a05:7022:488:b0:123:2d38:929a with SMTP id a92af1059eb24-124a00cf0b9mr2095051c88.38.1769550802549; Tue, 27 Jan 2026 13:53:22 -0800 (PST) Received: from lola.lan ([187.183.40.109]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-124a9cdcbcfsm31627c88.0.2026.01.27.13.53.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Jan 2026 13:53:22 -0800 (PST) From: Daiane Angolini To: bitbake-devel@lists.openembedded.org Cc: docs@lists.yoctoproject.org, Daiane Angolini Subject: [docs][PATCH v2 3/4] docs: Fix leading text for bitbake-setup init Date: Tue, 27 Jan 2026 18:53:02 -0300 Message-Id: <20260127215303.512936-4-daiane.angolini@foundries.io> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260127215303.512936-1-daiane.angolini@foundries.io> References: <20260127215303.512936-1-daiane.angolini@foundries.io> MIME-Version: 1.0 X-Authority-Analysis: v=2.4 cv=YNWSCBGx c=1 sm=1 tr=0 ts=697933d3 cx=c_pps a=kVLUcbK0zfr7ocalXnG1qA==:117 a=PIITv4rVe324bgT4salBLw==:17 a=IkcTkHD0fZMA:10 a=vUbySO9Y5rIA:10 a=9UA2AVYIz8kA:10 a=VkNPw1HP01LnGYTKEx00:22 a=EGU_KJDdnLjsBuGhkGQA:9 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=vr4QvYf-bLy2KjpDp97w:22 X-Proofpoint-ORIG-GUID: wJqHJshgZIN8Zq-2JZ3e92ZNx7_8I0pS X-Proofpoint-GUID: wJqHJshgZIN8Zq-2JZ3e92ZNx7_8I0pS X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwMTI3MDE3OCBTYWx0ZWRfX6KR6FkDmsz3K K6pYTcOxMeNgsWTR+BuFP5+YmY0aXb4SRsG9x8UP9PGk5D66c8DdoqmsahCOivSiC/eDUz67i4w R0hcO4GUTuz261Pxua/HtV5NWufBFtZ8KIdCdNjaehM53EyJJSWop6BfEd6Am5SHr0Kdbcukont mDae7txKQhNZuqtYRxk2jZpZSqhU5JbkejmMfF59iK9rWTqFPOJefLyIFfp6YkC6IU2RUOXdv5w UYhwqO1v5t20tNIaspaasvkCcgs70I2VsYkSfjBVJSv8ZX0iQZuSel8fWlYZXcYvrsIqOWsnXk1 FXA4tl7rKwb1mZqv8lihSbkSBqelKY9Dfaao2Xgvl5yeeF9Fv01S0n1G4dXTTslIGAOCo775I88 BVo7FmDAQAzYV0lep4njJz4rZIktJ9hlfCWOgKBJdhS0rMQUhAMmVrb76oOmadq0LZtcA3gcjlI wxiuACowCf5vGUrGobw== X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1121,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-01-27_04,2026-01-27_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 phishscore=0 suspectscore=0 lowpriorityscore=0 adultscore=0 priorityscore=1501 spamscore=0 impostorscore=0 malwarescore=0 clxscore=1015 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2601150000 definitions=main-2601270178 X-MIME-Autoconverted: from 8bit to quoted-printable by mx0a-0031df01.pphosted.com id 60RJ0gDV2436401 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 ; Tue, 27 Jan 2026 21:53:30 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8753 If we use the default of bitbake-setut init we may not create anything (as the first default for an empty directory is N). If user does not chose a number, the script asks again for a number. Signed-off-by: Daiane Angolini --- .../bitbake-user-manual-environment-setup.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index 6d76e3db4..8d86659bf 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -50,8 +50,7 @@ Quick Start See the :ref:`ref-bbsetup-section-config-reference` section to learn more about ``bitbake-setup`` input configuration files. -#. With the default choices, the ``bitbake-setup init`` command creates the - following files and directories:: +#. Here is an example of files and directories structure created by ``bitbake-setup init``:: ./bitbake-builds/ ├── site.conf From patchwork Tue Jan 27 21:53:03 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daiane Angolini X-Patchwork-Id: 79895 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 16BD4D2FEF9 for ; Tue, 27 Jan 2026 21:53:31 +0000 (UTC) Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.1239.1769550807705974638 for ; Tue, 27 Jan 2026 13:53:28 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@foundries.io header.s=google header.b=kGK327RV; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: foundries.io, ip: 205.220.180.131, mailfrom: daiane.angolini@foundries.io) Received: from pps.filterd (m0279868.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 60RFwwug1714603 for ; Tue, 27 Jan 2026 21:53:26 GMT Received: from mail-dl1-f71.google.com (mail-dl1-f71.google.com [74.125.82.71]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4by0g095ju-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Tue, 27 Jan 2026 21:53:26 +0000 (GMT) Received: by mail-dl1-f71.google.com with SMTP id a92af1059eb24-1233b81a92dso334407c88.0 for ; Tue, 27 Jan 2026 13:53:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=foundries.io; s=google; t=1769550805; x=1770155605; darn=lists.yoctoproject.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=wz0uqWgQ1hdqBdE8i4ul6Oa/CAVX7Z5/wVEh6XPOWlc=; b=kGK327RV6PnbGPlhAbQT5GJCfrudn4ZtLDVdS7MVw7LNk168sW0Z32sKoZTKPRhKtb Fjl8enKcrVmZFK6BIMCXXs9Gqw/Id/qIP7PHRYen8O/emDbazKpEPWN/gdVTOAGEAUdo MgxXtEgycvx1NcFWcY1Atuz2EhHVJJsPkK9XZiG9Bs40i4RbRQ+NMMwodlzVvIP5EljU qFNE/3V0zmamCqqu80wI9/fIf62DmXjaiTTvVq4MUbOjce9VWXiSsmKUuG0k4u/XvWsk rR4dpnx0Fnv35LeJ0SWeb8YuAea6EPYfKu1aLOIt0bLqxgMLHp1m/USlWlDoh3tcU+dS 54eg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1769550805; x=1770155605; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=wz0uqWgQ1hdqBdE8i4ul6Oa/CAVX7Z5/wVEh6XPOWlc=; b=ob2C/AP8DjFOc4oKIzIQvxQphLFb9sRiFGo4Yq/MCmMmUA/VQV2EUcd4xlA6S+J1ka NSkaGr0sXG5qRMQ7Tf4oDWmC1Cq/9kaUQi/WPUBV4aPCL0eThNeacx6UHX5qMeweVbPo +CsUuY76YHbJkXWd/B/Z52Gb1KoccXapuu8tUeIHT356kS9E35Dr8mLHYnLJdrjjkA+V ipEwzeK9lY4osixOWe5Dj7bokVZUk59UbrxYOff/evmGfn8WztKh+zX4mnjnCaNyFmRT btxV0NZ5D2L1ciSmyWI0gW/dKQjhUcOBewG0PU3rWNpaEV/mbQYlL8S0VwbBf3+xdWyb wk3w== X-Gm-Message-State: AOJu0Yy7IryxDurynr+dTo1SgK7pG15aecC6kgj4U7vX0qfF1tJyNra9 rEYJwp5qHIuGLNTBM9TUPIkgcBR+ZZQmMJ2DA9uvL8oKP7WULijM4py/eWj/76gYpu7d2fobxLS oNBgN1iKtgaNh6OGHWjxNhGM2FkOvqOLy+l6Y0KWFNqhY5kHIekdZH4Zc2OlQ724X X-Gm-Gg: AZuq6aLFL518RBH2Vpk2p+lbPnx4tE9DwGmGR0nini2fCJjwiyhBac2UPmlTH8RbVvu udeJ604saRXWFlrytOMZG4RFZ74ROjy1jJ5Toe/SpOr5ywCzBg0sW3syfgfFuNPyaxId4Gn/XCv VNb+ifbkmOdjjaML/KAsoWAmb7tkBwTI3y88/XsfzJiC6uz9SZhWtKj5lBf2pQueXAxiQ0e5i3/ 2d4EGcgwVcYFDMcc2r/5/dOILZvUa5Wl+u3GfQOsFzGFf8obL34tsZhGbJa4AweL4ow1wBn8/33 EJev4Rd96Z6Ww9Hx8ILUP/hSDzgRIc7Zd4KAhRTJiWlH/zvYyU7knYgFm1H5lJkeROpAJCS1a2j 8ctv1XSdiBIRcMUh9lCKrks/lfvTEPNCyW850TV/BWuW++h0rSfCJczjnB9OQlCYVb/pCimS0P+ nXWg== X-Received: by 2002:a05:7022:90e:b0:11b:f271:835a with SMTP id a92af1059eb24-124a05796c7mr1775790c88.3.1769550805249; Tue, 27 Jan 2026 13:53:25 -0800 (PST) X-Received: by 2002:a05:7022:90e:b0:11b:f271:835a with SMTP id a92af1059eb24-124a05796c7mr1775771c88.3.1769550804792; Tue, 27 Jan 2026 13:53:24 -0800 (PST) Received: from lola.lan ([187.183.40.109]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-124a9cdcbcfsm31627c88.0.2026.01.27.13.53.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Jan 2026 13:53:24 -0800 (PST) From: Daiane Angolini To: bitbake-devel@lists.openembedded.org Cc: docs@lists.yoctoproject.org, Daiane Angolini Subject: [docs][PATCH v2 4/4] docs: Fix sources as required Date: Tue, 27 Jan 2026 18:53:03 -0300 Message-Id: <20260127215303.512936-5-daiane.angolini@foundries.io> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260127215303.512936-1-daiane.angolini@foundries.io> References: <20260127215303.512936-1-daiane.angolini@foundries.io> MIME-Version: 1.0 X-Proofpoint-ORIG-GUID: LJjQ5Ksj7UXCENOcFMRjXfCognAW2LrA X-Proofpoint-GUID: LJjQ5Ksj7UXCENOcFMRjXfCognAW2LrA X-Authority-Analysis: v=2.4 cv=UPXQ3Sfy c=1 sm=1 tr=0 ts=697933d6 cx=c_pps a=JYo30EpNSr/tUYqK9jHPoA==:117 a=PIITv4rVe324bgT4salBLw==:17 a=vUbySO9Y5rIA:10 a=9UA2AVYIz8kA:10 a=VkNPw1HP01LnGYTKEx00:22 a=1OdKnqY07euSGrlipCwA:9 a=Fk4IpSoW4aLDllm1B1p-:22 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwMTI3MDE3OCBTYWx0ZWRfX5cvmI6RTUKhB Ruxaj+iK8XX55vIYn9azlqb+Vbz3eMeaB0CaEHLhqGqtVnksRCP91Tu7Fi+xuVn/IbzIFFzSw9Y bO3+Wr0OjXZDpoA9/pG8ja/FC4UYa/u7TxesbDN/G5h+Qkz9lH4WbcWjMheYcpoZabysecC++dB C8yvmYDxfTkP2P8VKXjzWX//8E+W8kMEvS3d+Qb4guz4E18DCJV0931UcFqzscM3TBOzYm/UnO5 4QDEjuf6rHKrbw44/c9kld1gNojMzvrbm7bwH1pLHGQzsMRenC84vNrqayccVag3z0ObkseeSSC +0S8EH7B8rtY8jnBPM7pvapej7lGYfK/le6UNjNkLHTN6pVQ0cIAqbr8wU6cgrv5QOMXwTDzZVu ELubt9m72siKC3Rhv5O2NzOudbmjrk1Cv+p3WjuE4Xc7A/Nwhn/wbVXJcupAaJSTx8qHE2AORCo wLxu3mbjO8DkVyn86cQ== X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1121,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-01-27_04,2026-01-27_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 phishscore=0 lowpriorityscore=0 clxscore=1015 priorityscore=1501 suspectscore=0 spamscore=0 adultscore=0 impostorscore=0 bulkscore=0 malwarescore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2601150000 definitions=main-2601270178 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 ; Tue, 27 Jan 2026 21:53:31 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/8754 If sources is empty, nothing happens. So let's just not say it's optional, and let's say the minimum is bitbake source code. Signed-off-by: Daiane Angolini --- .../bitbake-user-manual-environment-setup.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index 8d86659bf..fdfefac0e 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -660,8 +660,10 @@ They contain the following sections: "description": "OpenEmbedded - 'nodistro' basic configuration" } -- ``sources`` (*optional*): sources, such as git repositories that should be provided - under ``layers/`` directory of a :term:`Setup`. +- ``sources`` (**required**): sources, such as git repositories that should + be provided under ``layers/`` directory of a :term:`Setup`. Although the + list of sources can be very flexible, at least BitBake should be cloned + to generate a :term:`Setup`. Example: