From 35e026504e5ab757623c63d8e9a85343eb981868 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Thu, 13 Mar 2014 14:52:34 -0600 Subject: yocto-project-qs: Added recommendation for cloning YP bits. I re-cast the section where we describe getting a copy of of the Yocto Project such that we recommend cloning poky now. Aside from this change, I found some other minor tweaks that needing fixing. (From yocto-docs rev: f10fc4afabddce8bd6296e83c4fecbbbd4683140) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../yocto-project-qs/yocto-project-qs.xml | 87 +++++++++++++--------- 1 file changed, 51 insertions(+), 36 deletions(-) diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index 8752aedcd5..77292d676b 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml @@ -159,7 +159,8 @@ What You Need and How You Get It - You need these things to develop in the Yocto Project environment: + You need these things to develop projects in the Yocto Project + environment: @@ -210,8 +211,8 @@ Python 2.7.3 or greater excluding Python 3.x, which is not supported. - Earlier releases of Python are known to not work and the system - does not support Python 3 at this time. + Earlier releases of Python are known to not work and the + system does not support Python 3 at this time. If your system does not meet any of these three listed version requirements, you can take steps to prepare the system so that you can still use the build @@ -331,26 +332,30 @@ Yocto Project Release - You can download the latest Yocto Project release by going to the - Yocto Project website - clicking "Downloads" in the navigation pane to the left to view all - available Yocto Project releases. - Current and archived releases are available for download to the - right. - Nightly and developmental builds are also maintained at - . - However, for this document a released version of Yocto Project is used. - - - - You can also get the Yocto Project files you need by setting up (cloning in Git terms) - a local copy of the poky Git repository on your host development + It is recommended that you get the latest Yocto Project files + by setting up (cloning in + Git terms) a local + copy of the + poky Git repository on your host development system. Doing so allows you to contribute back to the Yocto Project project. For information on how to get set up using this method, see the "Yocto Project Release" item in the Yocto Project Development Manual. + + + You can also get the Yocto Project Files by downloading + Yocto Project releases from the + Yocto Project website. + From the website, you just click "Downloads" in the navigation pane + to the left to display all Yocto Project downloads. + Current and archived releases are available for download. + Nightly and developmental builds are also maintained at + . + However, for this document a released version of Yocto Project is used. + + @@ -364,10 +369,14 @@ - Build an image and run it in the QEMU emulator + + Build an image and run it in the QEMU emulator. + - Use a pre-built image and run it in the QEMU emulator + + Use a pre-built image and run it in the QEMU emulator. + @@ -400,13 +409,16 @@ recommend having at least 100GB of free disk space. - - By default, the build process searches for source code using a pre-determined order - through a set of locations. - If you encounter problems with the build process finding and downloading source code, see the - "How does the OpenEmbedded build system obtain source code and will it work behind my - firewall or proxy server?" in the Yocto Project Reference Manual. - + + + By default, the build process searches for source code using + a pre-determined order through a set of locations. + If you encounter problems with the build process finding and + downloading source code, see the + "How does the OpenEmbedded build system obtain source code and will it work behind my firewall or proxy server?" + entry in the Yocto Project Reference Manual FAQ. + + @@ -417,16 +429,19 @@ - - To help conserve disk space during builds, you can add the following statement - to your project's configuration file, which for this example - is &YOCTO_POKY;/build/conf/local.conf. - Adding this statement deletes the work directory used for building a package - once the package is built. - + + + To help conserve disk space during builds, you can add the + following statement to your project's configuration file, + which for this example is + poky/build/conf/local.conf. + Adding this statement deletes the work directory used for + building a package once the package is built. + INHERIT += "rm_work" - - + + + In the previous example, the first command uses @@ -495,7 +510,7 @@ You can control this configuration by using the PACKAGE_CLASSES variable. For additional package manager selection information, see the - "Packaging - package*.bbclass" + "package*.bbclass" section in the Yocto Project Reference Manual. -- cgit v1.2.3-54-g00ecf