Re: [docs] Description of BBPATH in BB user manual seems ... wrong

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

[-- Attachment #1: Type: text/plain, Size: 1536 bytes --]

On Mon, 15 Mar 2021, Quentin Schulz wrote:

> Hi Robert,
>
> On Mon, Mar 15, 2021 at 09:05:53AM -0400, Robert P. J. Day wrote:
> >
> >   Section 3.4.1 of BB manual:
> >
> > https://docs.yoctoproject.org/bitbake/bitbake-user-manual/bitbake-user-manual-metadata.html#locating-include-and-class-files
> >
> > "BitBake uses the BBPATH variable to locate needed include and class
> > files. Additionally, BitBake searches the current directory for
> > include and require directives.
> >
> > ... snip ..
> >
> > "In order for include and class files to be found by BitBake, they
> > need to be located in a “classes” subdirectory that can be found in
> > BBPATH."
> >
> >   first, is BBPATH not used for finding conf files as well? and the
>
> Yes it is.
>
> > wording of that second paragraph suggests that include files need to
> > be in a classes subdirectory to be found, which i'm pretty sure isn't
> > true.
> >
>
> I think what was meant by "include" files are conf files.... which
> (probably) technically are include files to Yocto PoV.

  i'll figure out how to reword this, but it's interesting that the
very intro of the BB manual distinguishes between configuration and
include files:

"BitBake executes tasks according to provided metadata that builds up
the tasks. Metadata is stored in recipe (.bb) and related recipe
“append” (.bbappend) files, configuration (.conf) and underlying
include (.inc) files, and in class (.bbclass) files."

  i'll figure something out.

rday