diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-07-15 08:30:15 +0300 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-08-13 13:18:40 +0100 |
commit | cb66b6e1a28ae20261ea2d02c638b0a8590ab8b2 (patch) | |
tree | bab3669f48a4f9d0df4218f567bd40732e64376e /documentation | |
parent | c7ac8851c8c1d21a3d49fb9aa58c531dfaf85fd6 (diff) | |
download | ast2050-yocto-poky-cb66b6e1a28ae20261ea2d02c638b0a8590ab8b2.zip ast2050-yocto-poky-cb66b6e1a28ae20261ea2d02c638b0a8590ab8b2.tar.gz |
ref-manual: Review comments added.
Fixes [YOCTO #2808]
Applied review comments from Paul Eggleton on the user configuration
and the layers section. Changes applied to the figure for the
user configuration section as well.
(From yocto-docs rev: b05af4b740f0daf3d6c59acf71c362decba2a176)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/figures/user-configuration.png | bin | 24982 -> 24734 bytes | |||
-rw-r--r-- | documentation/ref-manual/technical-details.xml | 48 |
2 files changed, 28 insertions, 20 deletions
diff --git a/documentation/ref-manual/figures/user-configuration.png b/documentation/ref-manual/figures/user-configuration.png Binary files differindex 5f49e2f..b9425a9 100644 --- a/documentation/ref-manual/figures/user-configuration.png +++ b/documentation/ref-manual/figures/user-configuration.png diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml index 77c1ba8..f35b296 100644 --- a/documentation/ref-manual/technical-details.xml +++ b/documentation/ref-manual/technical-details.xml @@ -184,13 +184,19 @@ <listitem><para><emphasis>Source Files:</emphasis> Upstream releases, local projects, and SCMs.</para></listitem> <listitem><para><emphasis>Build System:</emphasis> - Processes inside the BitBake "box". + Processes under the control of BitBake. This block expands on how BitBake fetches source, applies patches, completes compilation, analyzes output for package generation, creates and tests packages, generates images, and generates cross-development tools.</para></listitem> <listitem><para><emphasis>Package Feeds:</emphasis> - Package feeds into the BitBake process.</para></listitem> + Directories containing output packages (rpm, deb or ipk), + which are subsequently used in the construction of an image or + SDK, produced by the build system. + These feeds can also be copied and shared using a web server or + other means to facilitate extending or updating existing + images on devices at runtime if runtime package management is + enabled.</para></listitem> <listitem><para><emphasis>Images:</emphasis> Images produced by the development process. Where do they go? @@ -269,12 +275,11 @@ <para> Because the Poky repository is fundamentally an aggregation of existing repositories, some users might be familiar with running - the <filename>oe-init-build-env</filename> script in the context - of the OpenEmbedded development environment, which is outside - of the Yocto Project development environment. - This discussion assumes the script is executed from within a - cloned or unpacked version of Poky (i.e. within the Yocto Project - environment). + the <filename>oe-init-build-env</filename> script in the context of + separate OpenEmbedded-Core and BitBake repositories rather than a + single Poky repository. + This discussion assumes the script is executed from within a cloned + or unpacked version of Poky. </para> <para> @@ -514,16 +519,16 @@ This area holds configuration files for the layer (<filename>conf/layer.conf</filename>), the distribution - (<filename>conf/distro/<distro<.conf</filename>), + (<filename>conf/distro/<distro>.conf</filename>), and any distribution-wide include files. </para></listitem> <listitem><para><emphasis>recipes-*:</emphasis> Recipes and append files that affect common functionality across the distribution. - This area also can hold common distribution headers, - initialization files, and - <filename><recipe>/files/defconfig</filename> - files for the distribution.</para></listitem> + This area could include recipes and append files to + to add distribution-specific configuration, + initialization scripts, custom image recipes, + and so forth.</para></listitem> </itemizedlist> </para> </section> @@ -535,10 +540,13 @@ The BSP Layer provides machine configurations. Everything in this layer is specific to the machine for which you are building the image or the SDK. - BSP Layers have a structure that is followed if they are - considered to be compatible with the Yocto Project. - For information on the structure, see the + A common structure or form is defined for BSP layers. + You can learn more about this structure in the <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>. + <note> + In order for a BSP layer to be considered compliant with the + Yocto Project, it must meet some structural requirements. + </note> </para> <para> @@ -568,8 +576,8 @@ <title>Software Layer</title> <para> - The software layer provides the Metadata for your source - code used during the build. + The software layer provides the Metadata for your + software packages used during the build. This layer does not include Metadata that is specific to the distribution or the machine, which are found in their respective layers. @@ -578,8 +586,8 @@ <para> This layer contains any new recipes that your project needs in the form of recipe files. - Patch files are stored in the <filename>files</filename> - directory. + If the software layer contains any patch files, they can be + stored in a <filename>files</filename> directory. </para> </section> </section> |