[bitbake-devel] [PATCH] bitbake-user-manual-intro.xml: Semantic cleanup, clarifications.

[Paul Eggleton]

On Wednesday 18 June 2014 08:38:04 Robert P. J. Day wrote:
> @@ -413,6 +414,18 @@
>                      you have a directory entitled
>                      <filename>bitbake-1.17.0</filename>.
>                      </para></listitem>
> +                <listitem><para><emphasis>Using the BitBake that comes with
> your build checkout:</emphasis> +                    A final possibility
> for getting a copy of BitBake is that it +                    already comes
> with your checkout of a larger Bitbake-based build system, +               
>     such as Poky or Yocto Project. Rather than manually checking out +     
>               individual layers and gluing them together yourself, you can
> check +                    out an entire build system such as Poky with
> something like: +                    <literallayout class='monospaced'>
> +     $ git clone git://git.yoctoproject.org/poky
> +                    </literallayout>
> +                    where that checkout will already include a version of
> BitBake which +                    has been thoroughly tested for
> compatibility with the other components. +                   
> </para></listitem>
>              </itemizedlist>
>          </para>
>      </section>

Ignoring the mangling that my email client has done, I'm hesitant about the 
latter change. I appreciate the intention and what you've added isn't 
incorrect per se, but the pointer to actually check out poky might be a bit 
too much - I'd rather see a pointer to a different document (perhaps the Yocto 
Project Quick Start guide?). Additionally poky doesn't completely free you 
from fetching and incorporating individual layers, just OE-Core / meta-yocto / 
meta-yocto-bsp.

Cheers,
Paul

-- 

Paul Eggleton
Intel Open Source Technology Centre