From 2477c9c7b2af5856c72572f45b8433ea5cce8a0a Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 9 Apr 2013 14:12:07 -0700 Subject: dev-manual: Edits to "Yocto Project Terms" section. (From yocto-docs rev: d5742f17daccbaab752e9c82f12dbc9b166bb901) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-newbie.xml | 57 +++++++++++++------------- 1 file changed, 29 insertions(+), 28 deletions(-) (limited to 'documentation/dev-manual/dev-manual-newbie.xml') diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index 48d42d50b7..3193403e85 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml @@ -444,14 +444,14 @@ In summary, here is where you can get the project files needed for development: - Source Repositories: + :SSource Repositories: This area contains IDE Plugins, Matchbox, Poky, Poky Support, Tools, Yocto Linux Kernel, and Yocto Metadata Layers. You can create local copies of Git repositories for each of these areas. - Index of /releases: + :Index of /releases: This area contains index releases such as the Eclipse Yocto Plug-in, miscellaneous support, poky, pseudo, installers for cross-development toolchains, @@ -487,9 +487,10 @@ Append Files: Files that append build information to a recipe file. Append files are known as BitBake append files and .bbappend files. - The OpenEmbedded build system expects every append file to have a corresponding and - underlying recipe (.bb) file. - Furthermore, the append file and the underlying recipe must have the same root filename. + The OpenEmbedded build system expects every append file to have a corresponding + recipe (.bb) file. + Furthermore, the append file and corresponding recipe file + must use the same root filename. The filenames can differ only in the file type suffix used (e.g. formfactor_0.0.bb and formfactor_0.0.bbappend). @@ -508,7 +509,7 @@ This term refers to the area used by the OpenEmbedded build system for builds. The area is created when you source the setup environment script that is found in the Source Directory - (i.e. &OE_INIT_FILE;). + (i.e. &OE_INIT_FILE;). The TOPDIR variable points to the Build Directory. @@ -529,22 +530,21 @@ $ source &OE_INIT_PATH; $HOME/mybuilds/YP-&POKYVERSION; - Provide an existing directory to use as the Build Directory. - This example uses the existing mybuilds directory - as the Build Directory. + Provide an existing directory to use as the Build Directory + and use the default build name. $ source &OE_INIT_PATH; $HOME/mybuilds/ - Build System: In the context of the Yocto Project + Build System: In the context of the Yocto Project, this term refers to the OpenEmbedded build system used by the project. This build system is based on the project known as "Poky." For some historical information about Poky, see the - Poky term further along in this section. + Poky term. Classes: Files that provide for logic encapsulation - and inheritance allowing commonly used patterns to be defined once and easily used + and inheritance so that commonly used patterns can be defined once and then easily used in multiple recipes. Class files end with the .bbclass filename extension. @@ -554,7 +554,7 @@ Build Directory contains user-defined variables that affect each build. The meta-yocto/conf/distro/poky.conf configuration file - defines Yocto ‘distro’ configuration + defines Yocto "distro" configuration variables used only when building with this policy. Machine configuration files, which are located throughout the @@ -586,18 +586,18 @@ The initial compiler needed to bootstrap the toolchain that runs on the host and is used to build software for the target. - This tool is a 'native' package. + This tool is a "native" package. gcc-cross-intermediate: The second stage of the bootstrap process that runs on the host and builds software for the target. - This tool is a 'native' package. + This tool is a "native" package. gcc-cross: The the final stage of the bootstrap process that results in the cross compiler that runs on the host and builds software for the target. If you are replacing the cross compiler toolchain with a custom version, this is what you must replace. - This tool is a 'native' package. + This tool is a "native" package. gcc-runtime: Runtime libraries from the toolchain bootstrapping process. @@ -607,20 +607,20 @@ Stage 1 and 2 of the a cross compiler that runs on the host and builds for the SDK. Often the SDK is not the same target as the host. - This tool is a 'native' binary. + This tool is a "native" binary. gcc-crosssdk: The final stage of the SDK compiler. - This tool is a 'native' binary. + This tool is a "native" binary. The tool runs on the host and builds for the SDK. gcc-cross-canadian: The compiler that runs on the SDK machine and is included with the SDK that builds software for the target. - This tool is a 'nativesdk' package. + This tool is a "nativesdk" package. Image: An image is the result produced when - BitBake processes a given collection of recipes and related metadata. + BitBake processes a given collection of recipes and related Metadata. Images are the binary output that run on specific hardware or QEMU and for specific use cases. For a list of the supported image types that the Yocto Project provides, see the @@ -636,17 +636,17 @@ In general, Metadata includes recipes, classes, and configuration files. In the context of the kernel ("kernel Metadata"), - it refers to metadata in the meta + it refers to Metadata in the meta branches of the kernel source Git repositories. - OE-Core: A core set of metadata originating + OE-Core: A core set of Metadata originating with OpenEmbedded (OE) that is shared between OE and the Yocto Project. - This metadata is found in the meta directory of the source - directory. + This Metadata is found in the meta directory of the + Source Directory. Package: In the context of the Yocto Project, this term refers to the packaged output from a baked recipe. A package is generally the compiled binaries produced from the recipe's sources. - You ‘bake’ something by running it through BitBake. + You "bake" something by running it through BitBake. It is worth noting that the term "package" can, in general, have subtle meanings. For example, the packages referred to in the "The Packages" section are @@ -666,7 +666,8 @@ build system becoming a build system for embedded images. After Intel Corporation acquired OpenedHand, the project poky became the basis for the Yocto Project's build system. - Within the Yocto Project source repositories, poky exists as a separate Git repository + Within the Yocto Project source repositories, poky + exists as a separate Git repository that can be cloned to yield a local copy on the host system. Thus, "poky" can refer to the local copy of the Source Directory used to develop within the Yocto Project. @@ -690,7 +691,7 @@ Be sure that the Source Directory you use does not contain these types of names. - The Source Directory contains BitBake, Documentation, metadata and + The Source Directory contains BitBake, Documentation, Metadata and other files that all support the Yocto Project. Consequently, you must have the Source Directory in place on your development system in order to do any development using the Yocto Project. @@ -729,7 +730,7 @@ "Repositories, Tags, and Branches" section. Tasks: Arbitrary groups of software Recipes. - You simply use Tasks to hold recipes that, when built, usually accomplish a single task. + You use tasks to hold recipes that, when built, usually accomplish a single task. For example, a task could contain the recipes for a company’s proprietary or value-add software. Or, the task could contain the recipes that enable graphics. A task is really just another recipe. -- cgit v1.2.3-54-g00ecf