Re: [docs] [PATCH 3/3] reproducible-builds: add a "How to" section with OEQA* variables

[Quentin Schulz <quentin.schulz@cherry.de>]

Hi Yoann,

On 2/6/25 2:18 PM, Yoann Congal via lists.yoctoproject.org wrote:
> From: Yoann Congal <yoann.congal@smile.fr>
> 
> Shows an example of the new variable OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS
> and still mention OEQA_REPRODUCIBLE_TEST_TARGET/SSTATE_TARGETS that were
> shown earlier.
> 
> Signed-off-by: Yoann Congal <yoann.congal@smile.fr>
> Reviewed-by: Guillaume Swaenepoel <guillaume.swaenepoel@smile.fr>
> ---
>   .../test-manual/reproducible-builds.rst        | 18 ++++++++++++++++++
>   1 file changed, 18 insertions(+)
> 
> diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst
> index b9f671d68..909ac5216 100644
> --- a/documentation/test-manual/reproducible-builds.rst
> +++ b/documentation/test-manual/reproducible-builds.rst
> @@ -145,3 +145,21 @@ set of recipes before the test, meaning they are excluded from reproducibility
>   testing. As a practical example, you could set ``sstate_targets`` to
>   ``core-image-sato``, then setting ``targets`` to ``core-image-sato-sdk`` would
>   run reproducibility tests only on the targets belonging only to ``core-image-sato-sdk``.
> +
> +Using OEQA_REPRODUCIBLE_TEST_* variables

I think it'd make sense here to tick-quote OEQA_REPRODUCIBLE_TEST_*?

> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +If you want to test the reproducibility of a set of recipe, you can define

s/recipe/recipes/

> +:term:`OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS`, in your local.conf::
> +
> +    OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS = "my-recipe"
> +

We align by three whitespaces, and I think it's four here if my eyes 
don't fail me?

> +This will test the reproducibility of ``my-recipe`` but will use the
> +:ref:`Shared State <overview-manual/concepts:Shared State>` for most its
> +dependencies.
> +
> +You can have finer control on the test with:
> +
> +- :term:`OEQA_REPRODUCIBLE_TEST_TARGET`: lists recipes to be built,

Reading this I'm wondering if this includes the recipes that will be 
built using sstate-cache as well, i.e. all recipes that will be built?

Cheers,
Quentin