From 38e33dedee046a40eec0bdf3b74151f860cc89cc Mon Sep 17 00:00:00 2001 From: Trevor Woerner Date: Tue, 13 May 2025 12:58:38 -0400 Subject: ref-manual/variables.rst: document WIC_CREATE_EXTRA_ARGS Fixes [YOCTO #15509] Reviewed-by: Quentin Schulz (From yocto-docs rev: 8e893cc8cabba4b4f21556561d1ca9656ca1ff9f) Signed-off-by: Trevor Woerner Signed-off-by: Antonin Godard (cherry picked from commit f1cdecb6da91dbfac59359c83038cb4a4c36ad0a) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman --- documentation/ref-manual/variables.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 51c8a856c0..83fda05fc6 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -9579,6 +9579,20 @@ system and gives an overview of their function and contents. can control with this variable, see the ":ref:`ref-classes-insane`" section. + :term:`WIC_CREATE_EXTRA_ARGS` + If the :term:`IMAGE_FSTYPES` variable contains "wic", the build + will generate a + :ref:`Wic image ` + automatically when BitBake builds an image recipe. As part of + this process BitBake will invoke the "`wic create`" command. The + :term:`WIC_CREATE_EXTRA_ARGS` variable is placed at the end of this + command which allows the user to supply additional arguments. + + One such useful purpose for this mechanism is to add the ``-D`` (or + ``--debug``) argument to the "`wic create`" command. This increases the + amount of debugging information written out to the Wic log during the + Wic creation process. + :term:`WKS_FILE` Specifies the location of the Wic kickstart file that is used by the OpenEmbedded build system to create a partitioned image -- cgit v1.2.3-54-g00ecf