trying to summarize all the top-level yocto-related docs

Robert P. J. Day

in trying to resolve a minor issue this weekend regarding
PREMIRRORS, i tried to summarize the current set of yocto-related docs
and wound up just a bit confused so i'm hoping someone can clarify the
canonical set of documentation someone getting into yocto would want
to have.

as i read it, one can look at yocto in a series of intellectual
layers, simplest to most complex:

* bitbake
* OE-core
* poky
* yocto

first, is that a reasonable way to look at the software collection?
if so, how do the docs line up against this?

first, there's the bitbake user manual here:

it seems like that manual hasn't been updated for a while (or has
it?). is that the current state of the documentation for bitbake? it
seems incomplete, unless i'm unclear on how the software is broken up.

next, there's OE-core, for which the wiki page seems to be the most
current doc:

moving on to poky, the web site really doesn't
take care to distinguish between poky and yocto since the "About" link
immediately jumps one over to the yocto project "About" page, which
really blurs the line between poky and yocto, deliberately or

as for poky documentation, the Documentation tab over at yocto has a
link to the "Poky Reference Manual" but there is also a Poky Handbook
which is *not* linked from there and is not even clearly linked from
the poky site itself -- here's the handbook:

which is clearly back at the poky site but you would be hard-pressed
to find that handbook starting at the poky linux main page and
following links.

so ... what is the state of docs and support these days, for both
documentation and mailing lists? i was wondering about something
involving PREMIRRORS and i ended up unsure as to what to read or which
mailing list i could consult.




Robert P. J. Day Ottawa, Ontario, CANADA


Join { to automatically receive all group messages.