diff options
Diffstat (limited to 'documentation/poky-ref-manual/ref-structure.xml')
-rw-r--r-- | documentation/poky-ref-manual/ref-structure.xml | 61 |
1 files changed, 35 insertions, 26 deletions
diff --git a/documentation/poky-ref-manual/ref-structure.xml b/documentation/poky-ref-manual/ref-structure.xml index a5bfe5e876..c950671cb0 100644 --- a/documentation/poky-ref-manual/ref-structure.xml +++ b/documentation/poky-ref-manual/ref-structure.xml @@ -9,12 +9,12 @@ <para> The Yocto Project consists of several components. Understanding them and knowing where they are located is key to using the Yocto Project well. - This appendix describes the Yocto Project file's directory structure and gives information about the various - files and directories. + This appendix describes the <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink> + and gives information about the various files and directories. </para> <para> - For information on how to establish the Yocto Project files on your local development system, see the + For information on how to establish a local source directory on your development system, see the "<ulink url='&YOCTO_DOCS_DEV_URL;#getting-setup'>Getting Set Up</ulink>" section in the Yocto Project Development Manual. </para> @@ -49,18 +49,20 @@ <para> This directory contains user configuration files and the output - generated by the Yocto Project in its standard configuration where the source tree is - combined with the output. - The build directory is created initially when you <filename>source</filename> + generated by the OpenEmbedded build system in its standard configuration where + the source tree is combined with the output. + The <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink> + is created initially when you <filename>source</filename> the Yocto Project environment setup script <filename>oe-init-build-env</filename>. </para> <para> It is also possible to place output and configuration - files in a directory separate from the Yocto Project files + files in a directory separate from the + <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink> by providing a directory name when you <filename>source</filename> the setup script. - For information on separating output from the Yocto Project files, see <link + For information on separating output from your local source directory files, see <link linkend='structure-core-script'>oe-init-build-env</link>. </para> </section> @@ -147,9 +149,11 @@ By default, running this script without a build directory argument creates the <filename>build</filename> directory. If you provide a build directory argument when you <filename>source</filename> - the script, you direct the Yocto Project to create a build directory of your choice. + the script, you direct OpenEmbedded build system to create a + <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink> of your choice. For example, the following command creates a build directory named - <filename>mybuilds</filename> that is outside of the Yocto Project files: + <filename>mybuilds</filename> that is outside of the + <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>sourc directory</ulink>: <literallayout class='monospaced'> $ source oe-init-build-env ~/mybuilds </literallayout> @@ -181,12 +185,12 @@ <title><filename>build/conf/local.conf</filename></title> <para> - This file contains all the local user configuration of the Yocto Project. + This file contains all the local user configuration for your build environment. If there is no <filename>local.conf</filename> present, it is created from <filename>local.conf.sample</filename>. The <filename>local.conf</filename> file contains documentation on the various configuration options. - Any variable set here overrides any variable set elsewhere within the Yocto Project unless - that variable is hard-coded within the Yocto Project (e.g. by using '=' instead of '?='). + Any variable set here overrides any variable set elsewhere within the environment unless + that variable is hard-coded within a file (e.g. by using '=' instead of '?='). Some variables are hard-coded for various reasons but these variables are relatively rare. </para> @@ -244,10 +248,11 @@ <title><filename>build/tmp/</filename></title> <para> - This directory receives all the Yocto Project output. + This directory receives all the OpenEmbedded build system's output. BitBake creates this directory if it does not exist. - As a last resort, to clean the Yocto Project and start a build from scratch (other than downloads), - you can remove everything in this directory or get rid of the directory completely. + As a last resort, to clean up a build and start it from scratch (other than the downloads), + you can remove everything in the <filename>tmp</filename> directory or get rid of the + directory completely. If you do, you should also completely remove the <filename>build/sstate-cache</filename> directory as well. </para> @@ -275,7 +280,7 @@ <title><filename>build/tmp/deploy/</filename></title> <para> - This directory contains any 'end result' output from the Yocto Project build process. + This directory contains any 'end result' output from the OpenEmbedded build process. </para> </section> @@ -283,7 +288,8 @@ <title><filename>build/tmp/deploy/deb/</filename></title> <para> - This directory receives any <filename>.deb</filename> packages produced by the Yocto Project. + This directory receives any <filename>.deb</filename> packages produced by + the build process. The packages are sorted into feeds for different architecture types. </para> </section> @@ -292,7 +298,8 @@ <title><filename>build/tmp/deploy/rpm/</filename></title> <para> - This directory receives any <filename>.rpm</filename> packages produced by the Yocto Project. + This directory receives any <filename>.rpm</filename> packages produced by + the build process. The packages are sorted into feeds for different architecture types. </para> </section> @@ -319,7 +326,9 @@ <section id='structure-build-tmp-deploy-ipk'> <title><filename>build/tmp/deploy/ipk/</filename></title> - <para>This directory receives <filename>.ipk</filename> packages produced by the Yocto Project.</para> + <para> + This directory receives <filename>.ipk</filename> packages produced by + the build process.</para> </section> <section id='structure-build-tmp-sysroots'> @@ -380,7 +389,8 @@ <para> It is worth considering the structure of a typical work directory. - As an example, consider the linux-yocto kernel 3.0 on the machine <filename>qemux86</filename> + As an example, consider the <filename>linux-yocto-kernel-3.0</filename> + on the machine <filename>qemux86</filename> built within the Yocto Project. For this package, a work directory of <filename>tmp/work/qemux86-poky-linux/linux-yocto-3.0+git1+<.....></filename>, @@ -455,7 +465,7 @@ <para> This directory contains all the machine configuration files. If you set <filename>MACHINE="qemux86"</filename>, - Yocto Project looks for a <filename>qemux86.conf</filename> file in this + the OpenEmbedded build system looks for a <filename>qemux86.conf</filename> file in this directory. The <filename>include</filename> directory contains various data common to multiple machines. If you want to add support for a new machine to the Yocto Project, look in this directory. @@ -467,12 +477,11 @@ <para> Any distribution-specific configuration is controlled from this directory. - The Yocto Project only contains the Yocto Project distribution so - <filename>defaultsetup.conf</filename> is the main file here. + For the Yocto Project, the <filename>defaultsetup.conf</filename> is the main file here. This directory includes the versions and the <filename>SRCDATE</filename> definitions for applications that are configured here. - An example of an alternative configuration is <filename>poky-bleeding.conf</filename> - although this file mainly inherits its configuration from the Yocto Project itself. + An example of an alternative configuration might be <filename>poky-bleeding.conf</filename>. + Although this file mainly inherits its configuration from Poky. </para> </section> |