documentation/poky-ref-manual/development.xml: Garman's partial review comments

(From yocto-docs rev: 329401ac13e60381ca74a617ae398586cbd5dfed)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2011-08-18 12:25:11 -07:00 committed by Richard Purdie
parent ed4caadd13
commit 776834d63b
1 changed files with 12 additions and 11 deletions

View File

@ -19,21 +19,22 @@
<para> <para>
The Yocto Project provides toolchains that allow you to develop your application The Yocto Project provides toolchains that allow you to develop your application
outside of the Yocto Project build system for specific hardware. outside of the Yocto Project build system for specific hardware.
These toolchains (called meta-toolchains) contain cross-development tools like compilers, These toolchains (called meta-toolchains) contain cross-development tools such as compilers,
linkers, and debuggers that build your application for your target. linkers, and debuggers that build your application for your target device.
The Yocto Project also provides images that have toolchains set up for supported The Yocto Project also provides images that have toolchains for supported
architectures. architectures included within the image.
This allows you to compile, debug, or profile applications directly on the target device.
See See
<xref linkend='ref-images'>Reference: Images</xref> for a listing of the image <xref linkend='ref-images'>Reference: Images</xref> for a listing of the image
types that Yocto Project supports. types that Yocto Project supports.
</para> </para>
<para> <para>
Using the BitBake tool you can build a meta-toolchain or meta-toolchain-sdk target, Using the BitBake tool you can build a meta-toolchain or meta-toolchain-sdk target,
which is in the form of a tarball. which generates a tarball.
Unpacking this tarball into the <filename class="directory">/opt/poky</filename> directory Unpacking this tarball into the <filename class="directory">/opt/poky</filename> directory
on your host produces a setup script on your host produces a setup script
(e.g. <filename>/opt/poky/environment-setup-i586-poky-linux</filename>) that (e.g. <filename>/opt/poky/environment-setup-i586-poky-linux</filename>) that
you can source to initialize your build environment. you can <filename>source</filename> to initialize your build environment.
Sourcing this script adds the compiler, QEMU scripts, QEMU binary, a special version of Sourcing this script adds the compiler, QEMU scripts, QEMU binary, a special version of
<filename>pkgconfig</filename> and other <filename>pkgconfig</filename> and other
useful utilities to the <filename>PATH</filename> variable used by the Yocto Project useful utilities to the <filename>PATH</filename> variable used by the Yocto Project
@ -55,7 +56,7 @@
that builds your application that builds your application
specify to use the cross-compiler <filename>arm-poky-linux-gnueabi-gcc</filename> specify to use the cross-compiler <filename>arm-poky-linux-gnueabi-gcc</filename>
and linker <filename>arm-poky-linux-gnueabi-ld</filename>, which are part of the and linker <filename>arm-poky-linux-gnueabi-ld</filename>, which are part of the
meta-toolchain you have previously established: meta-toolchain you would have previously established:
<literallayout class='monospaced'> <literallayout class='monospaced'>
CC=arm-poky-linux-gnueabi-gcc; CC=arm-poky-linux-gnueabi-gcc;
LD=arm-poky-linux-gnueabi-ld; LD=arm-poky-linux-gnueabi-ld;
@ -69,13 +70,13 @@
The current release of the Yocto Project supports the Eclipse IDE plug-in The current release of the Yocto Project supports the Eclipse IDE plug-in
to make developing software easier for the application developer. to make developing software easier for the application developer.
The plug-in provides capability extensions to the graphical IDE to allow The plug-in provides capability extensions to the graphical IDE to allow
for cross compilation, deployment and execution of the output in a QEMU for cross compilation, deployment and execution of the application within a QEMU
emulation session. emulation session.
Support of the Eclipse plug-in also allows for cross debugging and Support of the Eclipse plug-in also allows for cross debugging and
profiling. profiling.
Additionally, the Eclipse plug-in provides a suite of tools Additionally, the Eclipse plug-in provides a suite of tools
that allows the developer to perform remote profiling, tracing, collection of that allows the developer to perform remote profiling, tracing, collection of
power data, collection of latency data and collection of performance data. power consumption data, collection of latency data and collection of performance data.
</para> </para>
<note> <note>
The current release of the Yocto Project no longer supports the Anjuta plug-in. The current release of the Yocto Project no longer supports the Anjuta plug-in.
@ -106,7 +107,7 @@
</para> </para>
<para> <para>
The QEMU images shipped with the Yocto Project contain complete toolchains The QEMU images shipped with the Yocto Project contain complete toolchains
native to specific target architectures. native to their target architectures.
This support allows you to develop applications within QEMU similar to the way This support allows you to develop applications within QEMU similar to the way
you would using a normal host development system. you would using a normal host development system.
</para> </para>
@ -135,7 +136,7 @@
</para> </para>
<para> <para>
Several mechanisms exist that let you connect into the system running on the Several mechanisms exist that let you connect to the system running on the
QEMU emulator: QEMU emulator:
<itemizedlist> <itemizedlist>
<listitem><para>QEMU provides a framebuffer interface that makes standard <listitem><para>QEMU provides a framebuffer interface that makes standard