Re: [docs] BB manual needs to refer to additional "classes-recipe" and "classes-global" dirs?

["Robert P. J. Day" <rpjday@crashcourse.ca>]

On Tue, 3 Jun 2025, Quentin Schulz wrote:

> Hi Robert,
>
> On 6/3/25 1:08 PM, Robert P. J. Day via lists.yoctoproject.org wrote:
> >
> > I note at least a couple places in the BB manual that refer to
> > searching for class files only in the "classes" subdirectory, but no
> > mention about the "classes-global" and "classes-recipe" directories --
> > should those also be mentioned in the BB manual?
> >
>
> I'm not too surprised, the BitBake documentation is typically not
> receiving the same level of interest compared to YP :) (also I'm not
> entirely sure people are aware it exists as I would imagine most
> people are familiar with docs.yoctoproject.org but not
> docs.yoctoproject.org/bitbake for example?
>
> That seems like a reasonable change to make in any case, so patches
> welcome :)

  going through all my outstanding docs questions, and this issue is
problematic in that, technically, the BB manual should stand alone and
not refer "upwards" to build systems like OE-Core, however, bitbake
itself, here, in BB function list_recipes():

https://github.com/openembedded/bitbake/blob/master/lib/bblayers/query.py#L124

clearly hard-codes references to extra class directories
classes-global and classes-recipe, which don't exist in bitbake
itself, so this is obviously(?) a case where bitbake *does* refer
upwards to oe-core.

  is this worth even clarifying in the BB manual? i suspect that the
simplest way to explain it is that, while BB defines only
classes/base.bbclass, its own layers code simply *supports* the
existence of those two additional class subdirectories, and leave it
at that.

  thoughts?

rday