Re: [docs] [PATCH] bsp-guide: simplify example of structure of BSP layer

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

Hi,

On Thu May 21, 2026 at 1:50 PM CEST, Robert P. J. Day wrote:
>
> Rather than introduce a generic example of a BSP layer and follow that
> with a link to meta-yocto-bsp, eliminate the middleman and just show a
> clear hierarchical view of the meta-yocto-bsp layer where readers can
> immediately see the point being made.
>
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
> ---
>
> diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst
> index a3b57d29f..1ae9d3353 100644
> --- a/documentation/bsp-guide/bsp.rst
> +++ b/documentation/bsp-guide/bsp.rst
> @@ -1222,22 +1222,28 @@ Project Development Tasks Manual.
>  BSP Machine Configuration Example
>  ---------------------------------
>
> -As mentioned earlier in this section, the existence of a machine
> +As mentioned earlier in this section, the existence of at least one machine
>  configuration file is what makes a layer a BSP layer as compared to a
>  general or kernel layer.
>
> -There are one or more machine configuration files in the
> -``bsp_layer/conf/machine/`` directory of the layer::
> -
> -   bsp_layer/conf/machine/machine1\.conf
> -   bsp_layer/conf/machine/machine2\.conf
> -   bsp_layer/conf/machine/machine3\.conf
> -   ... more ...
> -
> -For example, the machine configuration file for the `BeagleBone and
> -BeagleBone Black development boards <https://beagleboard.org/bone>`__ is
> -located in :yocto_git:`/meta-yocto/tree/meta-yocto-bsp/conf/machine/beaglebone-yocto.conf
> -</meta-yocto/tree/meta-yocto-bsp/conf/machine/beaglebone-yocto.conf>`.
> +As an actual example, consider the relevant content from the
> +:yocto_git:`/meta-yocto/tree/meta-yocto-bsp/conf/
> +</meta-yocto/tree/meta-yocto-bsp/conf/>` directory of the
> +``meta-yocto-bsp`` BSP layer::
> +

You could use '.. code-block:: console' here (without the :: above).

> +   $ tree -F conf
> +   conf/
> +   ├── layer.conf
> +   └── machine/
> +       ├── beaglebone-yocto.conf
> +       ├── genericarm64.conf
> +       ├── genericx86-64.conf
> +       ├── genericx86.conf
> +       └── include/
> +           └── genericx86-common.inc
> +
> +showing four machine configuration files along with a lower-level
> +tuning configuration file.
>
>  The variables used to configure the machine define machine-specific properties; for
>  example, machine-dependent packages, machine tunings, the type of kernel


Antonin