diff mbox series

[v3,15/16] ref-manual: document UBOOT_MAKE_OPTS

Message ID 20251027-release-note-5-3-second-hunk-v3-15-07d36e2380b8@bootlin.com
State Under Review
Headers show
Series Updates for 5.3 | expand

Commit Message

Antonin Godard Oct. 27, 2025, 12:43 p.m. UTC
This variable was added by commit 3338330e0c46 ("u-boot: Add specifying
make options as part the config looping") in OE-Core. Document how to
use the option in UBOOT_CONFIG.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/classes.rst   | 8 ++++++--
 documentation/ref-manual/variables.rst | 6 ++++++
 2 files changed, 12 insertions(+), 2 deletions(-)

Comments

Quentin Schulz Oct. 27, 2025, 1:13 p.m. UTC | #1
Hi Antonin,

On 10/27/25 1:43 PM, Antonin Godard via lists.yoctoproject.org wrote:
> This variable was added by commit 3338330e0c46 ("u-boot: Add specifying
> make options as part the config looping") in OE-Core. Document how to
> use the option in UBOOT_CONFIG.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/ref-manual/classes.rst   | 8 ++++++--
>   documentation/ref-manual/variables.rst | 6 ++++++
>   2 files changed, 12 insertions(+), 2 deletions(-)
> 
> diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
> index 2a69d2d59..9fd2fe375 100644
> --- a/documentation/ref-manual/classes.rst
> +++ b/documentation/ref-manual/classes.rst
> @@ -3241,8 +3241,8 @@ There are two ways to configure the recipe for your machine:
>   -  Using :term:`UBOOT_CONFIG` variable. For example::
>   
>         UBOOT_CONFIG ??= "foo bar"
> -      UBOOT_CONFIG[foo] = "config,images,binary"
> -      UBOOT_CONFIG[bar] = "config2,images2,binary2"
> +      UBOOT_CONFIG[foo] = "config,images,binary,makeopts"
> +      UBOOT_CONFIG[bar] = "config2,images2,binary2,makeopts2"
>   
>      In this example, all possible configurations are selected (``foo`` and
>      ``bar``), but it is also possible to build only ``foo`` or ``bar`` by
> @@ -3280,6 +3280,10 @@ There are two ways to configure the recipe for your machine:
>   
>         This option defaults to :term:`UBOOT_BINARY` if unset.
>   
> +   -  ``makeopts``: the additional options passed to ``make`` when configuring
> +      and compiling U-boot for this configuration entry. The options in this

s/U-boot/U-Boot/

> +      entry are added before the options in :term:`UBOOT_MAKE_OPTS`.
> +
>   -  Or, using the :term:`UBOOT_MACHINE` variable (and its companion variable
>      :term:`UBOOT_BINARY`). For example::
>   
> diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
> index e80c5a6e9..d879a49d4 100644
> --- a/documentation/ref-manual/variables.rst
> +++ b/documentation/ref-manual/variables.rst
> @@ -10906,6 +10906,12 @@ system and gives an overview of their function and contents.
>         Please see the "Selection of Processor Architecture and Board Type"
>         section in the U-Boot README for valid values for this variable.
>   
> +   :term:`UBOOT_MAKE_OPTS`
> +      The :term:`UBOOT_MAKE_OPTS` variable can be used to pass extra options to
> +      ``make`` when U-boot is configured and compiled.
> +

s/U-boot/U-Boot/

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>

Thanks!
Quentin
diff mbox series

Patch

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 2a69d2d59..9fd2fe375 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -3241,8 +3241,8 @@  There are two ways to configure the recipe for your machine:
 -  Using :term:`UBOOT_CONFIG` variable. For example::
 
       UBOOT_CONFIG ??= "foo bar"
-      UBOOT_CONFIG[foo] = "config,images,binary"
-      UBOOT_CONFIG[bar] = "config2,images2,binary2"
+      UBOOT_CONFIG[foo] = "config,images,binary,makeopts"
+      UBOOT_CONFIG[bar] = "config2,images2,binary2,makeopts2"
 
    In this example, all possible configurations are selected (``foo`` and
    ``bar``), but it is also possible to build only ``foo`` or ``bar`` by
@@ -3280,6 +3280,10 @@  There are two ways to configure the recipe for your machine:
 
       This option defaults to :term:`UBOOT_BINARY` if unset.
 
+   -  ``makeopts``: the additional options passed to ``make`` when configuring
+      and compiling U-boot for this configuration entry. The options in this
+      entry are added before the options in :term:`UBOOT_MAKE_OPTS`.
+
 -  Or, using the :term:`UBOOT_MACHINE` variable (and its companion variable
    :term:`UBOOT_BINARY`). For example::
 
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index e80c5a6e9..d879a49d4 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -10906,6 +10906,12 @@  system and gives an overview of their function and contents.
       Please see the "Selection of Processor Architecture and Board Type"
       section in the U-Boot README for valid values for this variable.
 
+   :term:`UBOOT_MAKE_OPTS`
+      The :term:`UBOOT_MAKE_OPTS` variable can be used to pass extra options to
+      ``make`` when U-boot is configured and compiled.
+
+      See the :ref:`ref-classes-uboot-config` class for more information.
+
    :term:`UBOOT_MAKE_TARGET`
       Specifies the target called in the ``Makefile``. The default target
       is "all".