| Message ID | 20230619160614.909233-1-michael.opdenacker@bootlin.com |
|---|---|
| State | New, archived |
| Headers | show |
| Series | bitbake-user-manual: explicit variables taking a colon separated list | expand |
Hi Mike, On Mon, 19 Jun 2023 18:06:14 +0200 "Michael Opdenacker via lists.openembedded.org" <michael.opdenacker=bootlin.com@lists.openembedded.org> wrote: > From: Michael Opdenacker <michael.opdenacker@bootlin.com> > > [YOCTO #15128] > > Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> > --- > .../bitbake-user-manual-ref-variables.rst | 16 ++++++++-------- > 1 file changed, 8 insertions(+), 8 deletions(-) > > diff --git a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst > index 01d4f8d1..ee5d7ba8 100644 > --- a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst > +++ b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst > @@ -920,9 +920,9 @@ overview of their function and contents. > section. > > :term:`BBPATH` > - Used by BitBake to locate class (``.bbclass``) and configuration > - (``.conf``) files. This variable is analogous to the ``PATH`` > - variable. > + A colon-separated list used by BitBake to locate class (``.bbclass``) > + and configuration (``.conf``) files. This variable is analogous to the > + ``PATH`` variable. > > If you run BitBake from a directory outside of the build directory, > you must be sure to set :term:`BBPATH` to point to the build directory. > @@ -1165,8 +1165,8 @@ overview of their function and contents. > order. > > :term:`OVERRIDES` > - BitBake uses :term:`OVERRIDES` to control what variables are overridden > - after BitBake parses recipes and configuration files. > + A colon-separated list that BitBake uses to control what variables are > + overridden after BitBake parses recipes and configuration files. > > Following is a simple example that uses an overrides list based on > machine architectures: OVERRIDES = "arm:x86:mips:powerpc" You can > @@ -1225,9 +1225,9 @@ overview of their function and contents. > PREFERRED_PROVIDER_virtual/libgl ?= "mesa" > > :term:`PREFERRED_PROVIDERS` > - Determines which recipe should be given preference for cases where > - multiple recipes provide the same item. Functionally, > - :term:`PREFERRED_PROVIDERS` is identical to > + A colon-separated list to determine which recipe should be given > + preference for cases where multiple recipes provide the same item. > + Functionally, :term:`PREFERRED_PROVIDERS` is identical to > :term:`PREFERRED_PROVIDER`. However, the :term:`PREFERRED_PROVIDERS` variable > lets you define preferences for multiple situations using the following > form:: If I read the docs correctly, PREFERRED_PROVIDERS is not a colon-separated list but rather a space-separated list [of colon-separated pairs]. Otherwise looks good, and useful -- thanks! Luca
Hi Luca, Thanks a lot for the review! On 20.06.23 at 09:52, Luca Ceresoli wrote: > Hi Mike, > > On Mon, 19 Jun 2023 18:06:14 +0200 > "Michael Opdenacker via lists.openembedded.org" > <michael.opdenacker=bootlin.com@lists.openembedded.org> wrote: > >> From: Michael Opdenacker <michael.opdenacker@bootlin.com> >> >> [YOCTO #15128] >> >> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> >> --- >> .../bitbake-user-manual-ref-variables.rst | 16 ++++++++-------- >> 1 file changed, 8 insertions(+), 8 deletions(-) >> >> diff --git a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst >> index 01d4f8d1..ee5d7ba8 100644 >> --- a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst >> +++ b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst >> @@ -920,9 +920,9 @@ overview of their function and contents. >> section. >> >> :term:`BBPATH` >> - Used by BitBake to locate class (``.bbclass``) and configuration >> - (``.conf``) files. This variable is analogous to the ``PATH`` >> - variable. >> + A colon-separated list used by BitBake to locate class (``.bbclass``) >> + and configuration (``.conf``) files. This variable is analogous to the >> + ``PATH`` variable. >> >> If you run BitBake from a directory outside of the build directory, >> you must be sure to set :term:`BBPATH` to point to the build directory. >> @@ -1165,8 +1165,8 @@ overview of their function and contents. >> order. >> >> :term:`OVERRIDES` >> - BitBake uses :term:`OVERRIDES` to control what variables are overridden >> - after BitBake parses recipes and configuration files. >> + A colon-separated list that BitBake uses to control what variables are >> + overridden after BitBake parses recipes and configuration files. >> >> Following is a simple example that uses an overrides list based on >> machine architectures: OVERRIDES = "arm:x86:mips:powerpc" You can >> @@ -1225,9 +1225,9 @@ overview of their function and contents. >> PREFERRED_PROVIDER_virtual/libgl ?= "mesa" >> >> :term:`PREFERRED_PROVIDERS` >> - Determines which recipe should be given preference for cases where >> - multiple recipes provide the same item. Functionally, >> - :term:`PREFERRED_PROVIDERS` is identical to >> + A colon-separated list to determine which recipe should be given >> + preference for cases where multiple recipes provide the same item. >> + Functionally, :term:`PREFERRED_PROVIDERS` is identical to >> :term:`PREFERRED_PROVIDER`. However, the :term:`PREFERRED_PROVIDERS` variable >> lets you define preferences for multiple situations using the following >> form:: > If I read the docs correctly, PREFERRED_PROVIDERS is not a > colon-separated list but rather a space-separated list [of > colon-separated pairs]. Oops, you're right. bitbake/lib/bb/cooker.py confirms this. I'm sending an update. Thanks again Mike.
diff --git a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst index 01d4f8d1..ee5d7ba8 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.rst @@ -920,9 +920,9 @@ overview of their function and contents. section. :term:`BBPATH` - Used by BitBake to locate class (``.bbclass``) and configuration - (``.conf``) files. This variable is analogous to the ``PATH`` - variable. + A colon-separated list used by BitBake to locate class (``.bbclass``) + and configuration (``.conf``) files. This variable is analogous to the + ``PATH`` variable. If you run BitBake from a directory outside of the build directory, you must be sure to set :term:`BBPATH` to point to the build directory. @@ -1165,8 +1165,8 @@ overview of their function and contents. order. :term:`OVERRIDES` - BitBake uses :term:`OVERRIDES` to control what variables are overridden - after BitBake parses recipes and configuration files. + A colon-separated list that BitBake uses to control what variables are + overridden after BitBake parses recipes and configuration files. Following is a simple example that uses an overrides list based on machine architectures: OVERRIDES = "arm:x86:mips:powerpc" You can @@ -1225,9 +1225,9 @@ overview of their function and contents. PREFERRED_PROVIDER_virtual/libgl ?= "mesa" :term:`PREFERRED_PROVIDERS` - Determines which recipe should be given preference for cases where - multiple recipes provide the same item. Functionally, - :term:`PREFERRED_PROVIDERS` is identical to + A colon-separated list to determine which recipe should be given + preference for cases where multiple recipes provide the same item. + Functionally, :term:`PREFERRED_PROVIDERS` is identical to :term:`PREFERRED_PROVIDER`. However, the :term:`PREFERRED_PROVIDERS` variable lets you define preferences for multiple situations using the following form::