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

[Robert P. J. Day]

On Wed, 18 Jun 2014, Paul Eggleton wrote:

> 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.

  i see your point, but i still think the reader should at least be
aware that, under normal(?) circumstances, they might not need to go
hunting around for bitbake as they might already have it. i'm totally
open to anyone wanting to reword that.

rday

-- 

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

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