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 7:17 PM, Yoann Congal wrote:
> 
> 
> Le 06/02/2025 à 17:08, Quentin Schulz a écrit :
>> 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>

Since this is your v1, I believe you're not allowed to provide 
Reviewed-by/Acked-by/Tested-by/etc... given privately. Guillaume should 
give their Reviewed-by on the mailing list before you can add it.

[...]
>>> +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?
> 
> OEQA_REPRODUCIBLE_TEST_TARGET is the list of all recipes to build twice
> (once with sstate globally enabled, once with sstate globally disabled)
> 
> Before the second build, the OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS set
> of recipes will be built using sstate so that the second build (without
> sstate) does not have to build them from scratch.
> 

This is actually documented at the end of 
https://docs.yoctoproject.org/test-manual/reproducible-builds.html#can-we-prove-the-project-is-reproducible. 
I feel like a reminder wouldn't be too bad of an idea in this section 
even though it follows the one it's explained in, but not a requirement 
per-se, up to you.

> We usually want OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS to be a subset of
> the dependencies of OEQA_REPRODUCIBLE_TEST_TARGET but it not enforced by
> the test.
> 

If my understand is correct, OEQA_REPRODUCIBLE_TEST_TARGET could be a 
recipe A and OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS could be dependencies 
of that recipe A, so it's not necessarily a subset? But they should 
relate otherwise they are noop?

Thanks for the explanation!

Cheers,
Quentin