From e53470656ed6fb2595c75d7f3b7a2fb72900a831 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 27 Oct 2010 08:57:26 -0700 Subject: Editing pass through the Introduction chapter. I did a complete edit pass through this chapter. The manual has not been fully edited from its original state. One critical technical correction was corrected where the green-3.3 release was referenced. I changed this to laverne 4.0. Signed-off-by: Scott Rifenbark --- documentation/poky-ref-manual/introduction.xml | 112 ++++++++++++++----------- 1 file changed, 63 insertions(+), 49 deletions(-) (limited to 'documentation') diff --git a/documentation/poky-ref-manual/introduction.xml b/documentation/poky-ref-manual/introduction.xml index 301086a824..afe1028b73 100644 --- a/documentation/poky-ref-manual/introduction.xml +++ b/documentation/poky-ref-manual/introduction.xml @@ -8,15 +8,17 @@ Welcome to Poky! - Poky is the the build tool in Yocto Project. - It is at the heart of Yocto Project. - You use Poky within Yocto Project to build the images (kernel software) for targeted hardware. + Poky is the build tool in Yocto Project. + Yocto Project uses Poky to build images (kernel, system, and application software) for + targeted hardware. - Before jumping into Poky you should have an understanding of Yokto Project. - Be sure you are familiar with the information in the Yocto Project Quick Start. - You can find this documentation on the public Yocto Project Website. + Before diving into Poky, it helps to have an understanding of the Yocto Project. + Especially useful for newcomers is the information in the Yocto Project Quick Start, which + you can find on the Yocto Project website. + Specifically, the guide is + at @@ -24,31 +26,34 @@ What is Poky? - Poky provides an open source Linux, X11, Matchbox, GTK+, Pimlico, Clutter, and other GNOME Mobile technologies based full platform build tool within Yocto Project. - It creates a focused, stable, subset of OpenEmbedded that can be easily and reliably built and developed upon. - Poky fully supports a wide range of x86 ARM, MIPS and PowerPC hardware and device virtulisation. + Within the Yocto Project, Poky provides an open source, full-platform build tool based on + Linux, X11, Matchbox, GTK+, Pimlico, Clutter, + and other GNOME Mobile technologies. + It provides a focused and stable subset of OpenEmbedded upon which you can easily and + reliably build and develop. + Poky fully supports a wide range of x86, ARM, MIPS and PowerPC hardware and device virtualization. - Poky is primarily a platform builder which generates filesystem images + Poky is primarily a platform builder that generates filesystem images based on open source software such as the Kdrive X server, the Matchbox - window manager, the GTK+ toolkit and the D-Bus message bus system. Images - for many kinds of devices can be generated, however the standard example - machines target QEMU full system emulation(x86, ARM, MIPS and PowerPC) and + window manager, the GTK+ toolkit and the D-Bus message bus system. While images + for many kinds of devices can be generated, the standard example + machines target QEMU full-system emulation (x86, ARM, MIPS and PowerPC) and real reference boards for each of these architectures. Poky's ability to boot inside a QEMU - emulator makes it particularly suitable as a test platform for development - of embedded software. + emulator makes it particularly suitable as a test platform for developing embedded software. - An important component integrated within Poky is Sato, a GNOME Mobile - based user interface environment. - It is designed to work well with screens at very high DPI and restricted - size, such as those often found on smartphones and PDAs. It is coded with - focus on efficiency and speed so that it works smoothly on hand-held and - other embedded hardware. It will sit neatly on top of any device - using the GNOME Mobile stack, providing a well defined user experience. + An important component integrated within Poky is Sato, a GNOME Mobile-based + user interface environment. + It is designed to work well with screens that use very high DPI and have restricted + sizes, such as those often found on smartphones and PDAs. + Because Sato is coded for speed and efficiency, it works smoothly on hand-held and + other embedded hardware. + It sits nicely on top of any device that uses the GNOME Mobile stack and it results in + a well-defined user experience. @@ -62,26 +67,30 @@ - - - Poky has a growing open source community and is also backed up by commercial organisations including Intel Corporation. - + Poky has a growing open source community and is also backed up by commercial organizations + including Intel Corporation.
Documentation Overview - The Poky User Guide is split into sections covering different aspects of Poky. - The 'Using Poky' section gives an overview of the components that make up Poky followed by information about using Poky and debugging images created in Yocto Project. - The 'Extending Poky' section gives information about how to extend and customise Poky along with advice on how to manage these changes. - The 'Platform Development with Poky' section gives information about interaction between Poky and target hardware for common platform development tasks such as software development, debugging and profiling. - The rest of the manual consists of several reference sections each giving details on a specific section of Poky functionality. + The sections in this reference manual describe different aspects of Poky. + The 'Using Poky' section provides an overview of the components + that make up Poky followed by information about using Poky and debugging images created in Yocto Project. + The 'Extending Poky' and + 'Board Support Packages' sections provide information + about how to extend and customize Poky along with advice on how to manage these changes. + The 'Platform Development with Poky' section provides information about + interaction between Poky and target hardware for common platform development tasks such as software + development, debugging and profiling. + The rest of the manual consists of several reference sections, each providing details on a specific + area of Poky functionality. - This manual applies to Poky Release 3.3 (Green). + This manual applies to Poky Release 4.0 (laverne).
@@ -89,14 +98,16 @@
System Requirements - We recommend Debian-based distributions, in particular a recent Ubuntu - release (10.04 or newer), as the host system for Poky. Nothing in Poky is - distribution specific and other distributions will most likely work as long - as the appropriate prerequisites are installed - we know of Poky being used + Although we recommend Debian-based distributions + (Ubuntu 10.04 or newer) as the host system for Poky, nothing in Poky is + distribution-specific. Consequently, other distributions should work as long + as the appropriate prerequisites are installed. For example, we know of Poky being used successfully on Redhat, SUSE, Gentoo and Slackware host systems. - For information on what you need to develop images using Yocto Project and Poky - you should see the Yocto Project Quick Start on the public - Yocto Project Website. + For information on what you need to develop images using Yocto Project and Poky, + you should see the Yocto Project Quick Start on the + Yocto Project website. + The direct link to the quick start is + .
@@ -106,9 +117,9 @@
Releases - Periodically, we make releases of Poky and these are available + Periodically, we make releases of Poky available at . - These are more stable and tested than the nightly development images. + These releases are more stable and more rigorously tested than the nightly development images.
@@ -117,13 +128,16 @@ We make nightly builds of Poky for testing purposes and to make the latest developments available. The output from these builds is available - at - where the numbers increase for each subsequent build and can be used to reference it. + at . + The numbers used in the builds increase for each subsequent build and can be used to + reference a specific build. - Automated builds are available for "standard" Poky and for Poky SDKs and toolchains as well - as any testing versions we might have such as poky-bleeding. The toolchains can + Automated builds are available for "standard" Poky and for Poky SDKs and toolchains. + Additionally, testing versions such as poky-bleeding can be made available as + 'experimental' builds. + The toolchains can be used either as external standalone toolchains or can be combined with Poky as a prebuilt toolchain to reduce build time. Using the external toolchains is simply a case of untarring the tarball into the root of your system (it only creates files in @@ -136,16 +150,16 @@ Development Checkouts - Poky is available from our GIT repository located at + Poky is available from our git repository located at git://git.pokylinux.org/poky.git; a web interface to the repository can be accessed at . The 'master' is where the deveopment work takes place and you should use this if you're - after to work with the latest cutting edge developments. It is possible trunk - can suffer temporary periods of instability while new features are developed and - if this is undesireable we recommend using one of the release branches. + interested in working with the latest cutting-edge developments. It is possible for the trunk + to suffer temporary periods of instability while new features are developed. + If these periods of instability are undesireable, we recommend using one of the release branches.
-- cgit v1.2.3-54-g00ecf