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

[Rifenbark, Scott M]

Hey Robert, 

Great questions... we are revising the BitBake manual as part of the YP 1.4 release.  And, we are currently discussing exactly how to position it.  So the answers to your questions are in the works.  

Scott

>-----Original Message-----
>From: yocto-bounces at yoctoproject.org [mailto:yocto-
>bounces at yoctoproject.org] On Behalf Of Robert P. J. Day
>Sent: Thursday, December 13, 2012 6:09 AM
>To: Yocto discussion list
>Subject: [yocto] bitbake user manual vs mega manual, and more info on
>local file fetcher?
>
>
>  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
>========================================================================
>_______________________________________________
>yocto mailing list
>yocto at yoctoproject.org
>https://lists.yoctoproject.org/listinfo/yocto