Re: [docs][PATCH 4/5] doc: Add the term Variant

["Antonin Godard" <antonin.godard@bootlin.com>]

Hi,

On Mon Jan 26, 2026 at 11:27 PM CET, Daiane Angolini via lists.yoctoproject.org wrote:
> It also add a description for the term based on the concept that a
> variant is a fragment or a set of fragments.
>
> Signed-off-by: Daiane Angolini <daiane.angolini@foundries.io>
> ---
>  .../bitbake-user-manual-environment-setup.rst          | 10 ++++++++++
>  1 file changed, 10 insertions(+)
>
> 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 e316ead56..700e02216 100644
> --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst
> +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst
> @@ -212,6 +212,16 @@ The following components are involved to create the content of these directories
>        It is also a Git repository, that contains a history of the setup instance
>        and updates made to it via :ref:`ref-bbsetup-command-update`.
>  
> +   :term:`Variant`
> +      A Variant is a fragment or a set of fragments grouped under a name that

I think multiple variants could contains different set of layers too
(bb-layers). So it's not limited to fragments?
Also bb-env-passthrough-additions, etc.

> +      makes sense for a project. It is a nested configuration within a
> +      :term:`BitBake Setup Template`.
> +
> +      A :term:`BitBake Setup Template` can contain multiple variants. Users
> +      select among them during the :ref:`ref-bbsetup-command-init` command to
> +      customize the :term:`Setup`. Variants enable scaling configurations by
> +      sharing common parameters in a parent while differing in specific settings.
> +
>     :term:`Registry`
>        A configuration registry is a place where one or more :term:`BitBake
>        Setup Templates <BitBake Setup Template>` are stored.


Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com