From 514176c231f71886a1a4be48a7a7a4fb43433e74 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 22 Apr 2013 14:23:29 -0700 Subject: [PATCH] dev-manual, ref-manual: Minor edits suggested by Bill Traynor Applied some re-wordings as suggested by Bill Traynor. Reported-by: William M.A. Traynor (From yocto-docs rev: 2510d9795720afc0309a10b18605e5af4a83769b) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-intro.xml | 13 +++++++------ documentation/dev-manual/dev-manual-start.xml | 4 ++-- documentation/ref-manual/ref-bitbake.xml | 5 +++-- documentation/ref-manual/usingpoky.xml | 4 ++-- 4 files changed, 14 insertions(+), 12 deletions(-) diff --git a/documentation/dev-manual/dev-manual-intro.xml b/documentation/dev-manual/dev-manual-intro.xml index b0d6386fea..ed1ab07fb1 100644 --- a/documentation/dev-manual/dev-manual-intro.xml +++ b/documentation/dev-manual/dev-manual-intro.xml @@ -78,7 +78,7 @@ Step-by-step instructions if those instructions exist in other Yocto Project documentation. For example, the Yocto Project Application Developer's Guide contains detailed - instruction on how to run the + instructions on how to run the Installing the ADT and Toolchains, which is used to set up a cross-development environment. Reference material. @@ -96,8 +96,9 @@ Other Information - Because this manual presents overview information for many different topics, you will - need to supplement it with other information. + Because this manual presents overview information for many different + topics, supplemental information is recommended for full + comprehension. The following list presents other sources of information you might find helpful: Yocto Project Website: @@ -105,7 +106,7 @@ as well as links to software and documentation. Yocto Project Quick Start: This short document lets you get started - with the Yocto Project quickly and start building an image. + with the Yocto Project and quickly begin building an image. Yocto Project Reference Manual: This manual is a reference guide to the OpenEmbedded build system known as "Poky." @@ -169,7 +170,7 @@ OpenEmbedded build system (Poky). - for a mailing list to receive official Yocto Project announcements for developments and + for a mailing list to receive official Yocto Project announcements as well as Yocto Project milestones. for a listing of all public mailing lists on lists.yoctoproject.org. @@ -182,7 +183,7 @@ OpenEmbedded: The build system used by the Yocto Project. - This project is the upstream, generic, embedded distribution from which the Yocto + This project is the upstream, generic, embedded distribution that the Yocto Project derives its build system (Poky) from and to which it contributes. diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 719d0f3919..02f6bd0452 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -23,9 +23,9 @@ The Yocto Project is an open-source collaboration project focused on embedded Linux development. - The project currently provides a build system, which is + The project currently provides a build system that is referred to as the OpenEmbedded build system in the Yocto Project documentation. - The Yocto Project provides various ancillary tools suitable for the embedded developer + The Yocto Project provides various ancillary tools for the embedded developer and also features the Sato reference User Interface, which is optimized for stylus driven, low-resolution screens. diff --git a/documentation/ref-manual/ref-bitbake.xml b/documentation/ref-manual/ref-bitbake.xml index cc4c943506..717c58bd71 100644 --- a/documentation/ref-manual/ref-bitbake.xml +++ b/documentation/ref-manual/ref-bitbake.xml @@ -23,8 +23,9 @@ BitBake strives to be a generic "task" executor that is capable of handling complex dependency relationships. As such, it has no real knowledge of what the tasks being executed actually do. - BitBake just considers a list of tasks with dependencies and handles metadata - that consists of variables in a certain format that get passed to the tasks. + BitBake just considers a list of tasks with dependencies and handles + Metadata + consisting of variables in a certain format that get passed to the tasks.
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml index d27d6f7a5e..9a98b4560a 100644 --- a/documentation/ref-manual/usingpoky.xml +++ b/documentation/ref-manual/usingpoky.xml @@ -38,8 +38,8 @@ The build_dir is optional and specifies the directory the OpenEmbedded build system uses for the build - the Build Directory. - If you do not specify a Build Directory, it defaults to build - in your current working directory. + If you do not specify a Build Directory, it defaults to a directory + named build in your current working directory. A common practice is to use a different Build Directory for different targets. For example, ~/build/x86 for a qemux86 target, and ~/build/arm for a qemuarm target.