| Message ID | 20250513135345.38651-1-twoerner@gmail.com |
|---|---|
| State | New |
| Headers | show |
| Series | [v2] ref-manual/variables.rst: document WIC_CREATE_EXTRA_ARGS | expand |
Hi Trevor, On 5/13/25 3:53 PM, Trevor Woerner via lists.yoctoproject.org wrote: > Fixes [YOCTO #15509] > > Signed-off-by: Trevor Woerner <twoerner@gmail.com> > --- > changes in v2: > - link the phrase "Wic image" to the dev manual's section on creating wic > images instead of providing a paragraph at the end to include the link > - remove any reference to a bbclass > - reduce the number of "`wic create`" phrases > --- > 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 d17f81036b7d..1ba687820131 100644 > --- a/documentation/ref-manual/variables.rst > +++ b/documentation/ref-manual/variables.rst > @@ -10942,6 +10942,20 @@ system and gives an overview of their function and contents. > Specifies the timeout in seconds used by the ``watchdog-config`` recipe > and also by ``systemd`` during reboot. The default is 60 seconds. > > + :term:`WIC_CREATE_EXTRA_ARGS` > + If the :term:`IMAGE_FSTYPES` variable contains "wic", the build > + will generate a > + :ref:`Wic image <dev-manual/wic:creating partitioned images using wic>` > + automatically when BitBake builds an image recipe. As part of this > + process BitBake will invoke the "`wic create`" command. > + The `WIC_CREATE_EXTRA_ARGS` variable is placed at the end of this :term:`WIC_CREATE_EXTRA_ARGS` > + 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 I would tickquote -D and --debug here. Looks good to me otherwise: Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de> Thanks! Quentin
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index d17f81036b7d..1ba687820131 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -10942,6 +10942,20 @@ system and gives an overview of their function and contents. Specifies the timeout in seconds used by the ``watchdog-config`` recipe and also by ``systemd`` during reboot. The default is 60 seconds. + :term:`WIC_CREATE_EXTRA_ARGS` + If the :term:`IMAGE_FSTYPES` variable contains "wic", the build + will generate a + :ref:`Wic image <dev-manual/wic:creating partitioned images using wic>` + automatically when BitBake builds an image recipe. As part of this + process BitBake will invoke the "`wic create`" command. + The `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:`WIC_SECTOR_SIZE` The variable :term:`WIC_SECTOR_SIZE` controls the sector size of Wic images. In the background, this controls the value of the
Fixes [YOCTO #15509] Signed-off-by: Trevor Woerner <twoerner@gmail.com> --- changes in v2: - link the phrase "Wic image" to the dev manual's section on creating wic images instead of providing a paragraph at the end to include the link - remove any reference to a bbclass - reduce the number of "`wic create`" phrases --- documentation/ref-manual/variables.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+)