[yocto] bitbake user manual vs mega manual, and more info on local file fetcher?

[Robert P. J. Day]

  first question -- is the bitbake user manual that comes bundled with
the bitbake source considered part of the yocto doc collection?  as
in, if one wants detailed info on bitbake, does one read the bitbake
user manual (which is not mentioned on the yocto docs page), or is
bitbake user info assumed to now be scattered throughout the yocto
docs?  i think it's important to identify the canonical location for
that documentation.

  following on that, i'm asking since the bitbake user manual is
definitely a *little* deficient on info for the local file fetcher.
here's the sum total of its examples:

SRC_URI= "file://relativefile.patch"
SRC_URI= "file://relativefile.patch;this=ignored"
SRC_URI= "file:///Users/ich/very_important_software"

but there's no mention that (as i read it) that protocol accepts
wildcards:

meta-angstrom/recipes-angstrom/angstrom/angstrom-uboot-scripts.bb:SRC_URI = "file://*.cmd"

i had no idea that was even true until i stumbled over the above (if
that's indeed what it means).

  there's also no comprehensive coverage of how to define and use
patches in the yocto docs.  the only mention i see is in the ref
manual, in the variable glossary under SRC_URI, which isn't even
complete (no mention of apply= or patchdir=).

  so basic question -- is the bitbake user manual still under active
maintenance and is it considered part of the yocto docs collection?
since all that bitbake information should be *somewhere* but it's not
clear where.

rday


-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================