diff mbox series

[v6,1/4] ref-manual/variables: document OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS

Message ID 20250217220618.1999362-1-yoann.congal@smile.fr
State Accepted
Headers show
Series [v6,1/4] ref-manual/variables: document OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS | expand

Commit Message

Yoann Congal Feb. 17, 2025, 10:06 p.m. UTC 
From: Yoann Congal <yoann.congal@smile.fr>

This documents the variable used in the "automate testing a single
recipe's reproducibility" feature [YOCTO #15701]

Signed-off-by: Yoann Congal <yoann.congal@smile.fr>
Reviewed-by: Guillaume Swaenepoel <guillaume.swaenepoel@smile.fr>
Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
---
v5->v6:
Quentin's review:
* Proper highliting (:term:, :ref: and ``)
* s/varflags/varflag/
* Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de> (Thanks!)

v3->v4:
Quentin's Review
* make missing dependencies more explicit
Guillaume's Reviewed-By
v2->v3: Quentin's review:
* s/target/target(s)/
* Removed Guillaume Reviewed-by (given privately)
---
 documentation/ref-manual/variables.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

Comments

Antonin Godard March 3, 2025, 9:31 a.m. UTC | #1 
On Mon, 17 Feb 2025 23:06:15 +0100, Yoann Congal wrote:
> This documents the variable used in the "automate testing a single
> recipe's reproducibility" feature [YOCTO #15701]
> 
> 

Applied, thanks!

[1/4] ref-manual/variables: document OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS
      commit: 417b423ea3d2ba9903d21d930c1982ff2ac6f596
[2/4] reproducible-builds: change/add titles in the "How" section
      commit: 0ff459c273704a281419a44ae5670068ac47f1b9
[3/4] reproducible-builds: add a "How to" section with OEQA* variables
      commit: 78cf8b1ff1cdfbc863033f267da8fb60419b50fc
[4/4] release-notes-5.2: Add new variable OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS
      commit: eec44e4daf414be414e9fd0471b0381b980d6fab

Best regards,
diff mbox series

Patch

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index adbef69d8..e91568cb8 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -5807,6 +5807,15 @@  system and gives an overview of their function and contents.
       For additional information on how this variable is used, see the
       initialization script.
 
+   :term:`OEQA_REPRODUCIBLE_TEST_LEAF_TARGETS`
+      Set build target(s) for build reproducibility testing but activate
+      :ref:`shared state <overview-manual/concepts:shared state cache>` build
+      for most dependencies (i.e. the ones explicitly listed in
+      :term:`DEPENDS`, which may not be all dependencies, c.f. :ref:`[depends]
+      varflag <bitbake-user-manual/bitbake-user-manual-metadata:variable flags>`,
+      ``PACKAGE_DEPENDS`` and other implementations). See
+      :doc:`/test-manual/reproducible-builds`.
+
    :term:`OEQA_REPRODUCIBLE_TEST_PACKAGE`
       Set the package manager(s) for build reproducibility testing.
       See :yocto_git:`reproducible.py </poky/tree/meta/lib/oeqa/selftest/cases/reproducible.py>`