Toaster: where are variable descriptions used?
Hello,
I'm checking for Bitbake variables which should be documented in meta/conf/documentation.conf, but before that, I'd like to check how such information is used.
In the "Bitbake variables" section, I can see help information about some variables, as in the attached screenshot.
However, if I add a new variable such as "NO_RECOMMENDATIONS", no help information is provided about it, even though it is described in meta/conf/documentation.conf.
It also turns out that the help information I get on this section comes from bitbake/lib/toaster/toastergui/templates/projectconf.html instead.
So, where are variable descriptions in meta/conf/documentation.conf actually used?
Thanks in advance
Cheers
Michael.
Signature · 3 lines
Michael Opdenacker, Bootlin Embedded Linux and Kernel engineering https://bootlin.com
Quoted 13 lines · Michael Opdenacker via lists.openembedded.org
Hello,
I'm checking for Bitbake variables which should be documented in
meta/conf/documentation.conf, but before that, I'd like to check how such information is used.In the "Bitbake variables" section, I can see help information about some variables, as in the attached screenshot.
However, if I add a new variable such as "
NO_RECOMMENDATIONS", no help information is provided about it, even though it is described inmeta/conf/documentation.conf.
Quoted 5 lines
It also turns out that the help information I get on this section comes from bitbake/lib/toaster/toastergui/templates/projectconf.html instead.
So, where are variable descriptions in
meta/conf/documentation.confactually used?
I have a suspicion that the html may be generated by a script from documentation.conf but I don't really remember. Adding David Reyna to cc in case he knows.
Cheers,
Richard
Quoted 18 lines · Richard Purdie
Quoted 16 lines · Michael Opdenacker via lists.openembedded.org
Hello,
I'm checking for Bitbake variables which should be documented in
meta/conf/documentation.conf, but before that, I'd like to check how such information is used.In the "Bitbake variables" section, I can see help information about some variables, as in the attached screenshot.
However, if I add a new variable such as "
NO_RECOMMENDATIONS", no help information is provided about it, even though it is described inmeta/conf/documentation.conf.It also turns out that the help information I get on this section comes from bitbake/lib/toaster/toastergui/templates/projectconf.html instead.
Quoted 8 lines
Quoted 2 lines
So, where are variable descriptions in
meta/conf/documentation.confactually used?I have a suspicion that the html may be generated by a script from documentation.conf but I don't really remember. Adding David Reyna to cc in case he knows.
The variables at the top of that screen capture have hard-coded "help" (tooltip) text.
I believe this was because some/most of the descriptions are Toaster specific.
The dynamically generated html for user defined config variables comes from
https://git.yoctoproject.org/poky/tree/bitbake/lib/toaster/toastergui/templates/projectconf.html#n445
Interestingly, build configuration variables do actually parse the "documentation.conf" (via "bitbake.conf") in
https://git.yoctoproject.org/poky/tree/bitbake/lib/toaster/toastergui/templates/configvars.html#n68
which pulls
data from
https://git.yoctoproject.org/poky/tree/bitbake/lib/toaster/toastergui/views.py#n906
which can be viewed at e.g.
http://localhost:8000/toastergui/build/1/configvars
Unfortunately, such a query is not defined in the projectconf view
https://git.yoctoproject.org/poky/tree/bitbake/lib/toaster/toastergui/views.py#n1795
It appears that the scope of variables was intentionally kept to a smaller set?
Cheers,
Quoted 14 lines
Richard
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group. View/Reply Online (#175320):
https://lists.openembedded.org/g/openembedded-core/message/175320
Mute This Topic: https://lists.openembedded.org/mt/96009476/924729
Group Owner: [email protected]
Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [ [email protected]]
-=-=-=-=-=-=-=-=-=-=-=-