diff options
Diffstat (limited to 'documentation')
| -rw-r--r-- | documentation/dev-manual/dev-manual-newbie.xml | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index c85667cdd1..3eef7460f9 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml | |||
| @@ -7,8 +7,8 @@ | |||
| 7 | 7 | ||
| 8 | <para> | 8 | <para> |
| 9 | This chapter helps you understand the Yocto Project as an open source development project. | 9 | This chapter helps you understand the Yocto Project as an open source development project. |
| 10 | In general, working in an open source environment is very different as compared to working in a | 10 | In general, working in an open source environment is very different from working in a |
| 11 | proprietary environment. | 11 | closed, proprietary environment. |
| 12 | Additionally, the Yocto Project uses specific tools and constructs as part of its development | 12 | Additionally, the Yocto Project uses specific tools and constructs as part of its development |
| 13 | environment. | 13 | environment. |
| 14 | The chapter specifically addresses open source philosophy, licensing issues, code repositories, | 14 | The chapter specifically addresses open source philosophy, licensing issues, code repositories, |
| @@ -20,10 +20,10 @@ | |||
| 20 | 20 | ||
| 21 | <para> | 21 | <para> |
| 22 | Open source philosophy is characterized by software development directed by peer production | 22 | Open source philosophy is characterized by software development directed by peer production |
| 23 | and collaboration through a concerned community of developers. | 23 | and collaboration through an active community of developers. |
| 24 | Contrast this to the more standard centralized development models used by commercial software | 24 | Contrast this to the more standard centralized development models used by commercial software |
| 25 | companies where a finite set of developers produce a product for sale using a defined set | 25 | companies where a finite set of developers produce a product for sale using a defined set |
| 26 | of procedures that ultimately result in an end-product whose architecture and source material | 26 | of procedures that ultimately result in an end product whose architecture and source material |
| 27 | are closed to the public. | 27 | are closed to the public. |
| 28 | </para> | 28 | </para> |
| 29 | 29 | ||
| @@ -33,7 +33,7 @@ | |||
| 33 | stake in the software project. | 33 | stake in the software project. |
| 34 | The open source environment contains new copyright, licensing, domain, and consumer issues | 34 | The open source environment contains new copyright, licensing, domain, and consumer issues |
| 35 | that differ from the more traditional development environment. | 35 | that differ from the more traditional development environment. |
| 36 | In an open source environment, the end-product, source material, and documentation are | 36 | In an open source environment, the end product, source material, and documentation are |
| 37 | all available to the public at no cost. | 37 | all available to the public at no cost. |
| 38 | </para> | 38 | </para> |
| 39 | 39 | ||
| @@ -101,7 +101,7 @@ | |||
| 101 | <para> | 101 | <para> |
| 102 | <imagedata fileref="figures/source-repos.png" align="center" width="6in" depth="4in" /> | 102 | <imagedata fileref="figures/source-repos.png" align="center" width="6in" depth="4in" /> |
| 103 | </para></listitem> | 103 | </para></listitem> |
| 104 | <listitem><para><anchor id='index-downloads' /><emphasis><ulink url='http://www.yoctoproject.org/downloads/'>Index of /downloads:</ulink></emphasis> | 104 | <listitem><para><anchor id='index-downloads' /><emphasis><ulink url='http://downloads.yoctoproject.org/releases/'>Index of /releases:</ulink></emphasis> |
| 105 | This area contains an index of downloads such as | 105 | This area contains an index of downloads such as |
| 106 | the <trademark class='trade'>Eclipse</trademark> | 106 | the <trademark class='trade'>Eclipse</trademark> |
| 107 | Yocto Plug-in, miscellaneous support, Poky, pseudo, cross-development toolchains, | 107 | Yocto Plug-in, miscellaneous support, Poky, pseudo, cross-development toolchains, |
| @@ -115,7 +115,7 @@ | |||
| 115 | This page on the Yocto Project website allows you to download any Yocto Project | 115 | This page on the Yocto Project website allows you to download any Yocto Project |
| 116 | release or Board Support Package (BSP) in tarball form. | 116 | release or Board Support Package (BSP) in tarball form. |
| 117 | The tarballs are similar to those found in the | 117 | The tarballs are similar to those found in the |
| 118 | <ulink url='http://www.yoctoproject.org/downloads/'>Index of /downloads:</ulink> area.</para> | 118 | <ulink url='http://downloads.yoctoproject.org/releases/'>Index of /releases:</ulink> area.</para> |
| 119 | <para> | 119 | <para> |
| 120 | <imagedata fileref="figures/yp-download.png" align="center" width="6in" depth="4in" /> | 120 | <imagedata fileref="figures/yp-download.png" align="center" width="6in" depth="4in" /> |
| 121 | </para></listitem> | 121 | </para></listitem> |
| @@ -133,7 +133,7 @@ | |||
| 133 | <itemizedlist> | 133 | <itemizedlist> |
| 134 | <listitem><para><emphasis>Append Files:</emphasis> Files that append build information to | 134 | <listitem><para><emphasis>Append Files:</emphasis> Files that append build information to |
| 135 | a recipe file. | 135 | a recipe file. |
| 136 | Information in append files override the information in the similarly-named recipe file. | 136 | Information in append files overrides the information in the similarly-named recipe file. |
| 137 | Append files use the <filename>.bbappend</filename> filename suffix.</para></listitem> | 137 | Append files use the <filename>.bbappend</filename> filename suffix.</para></listitem> |
| 138 | <listitem><para><emphasis>BitBake:</emphasis> The task executor and scheduler used by | 138 | <listitem><para><emphasis>BitBake:</emphasis> The task executor and scheduler used by |
| 139 | the Yocto Project to build images. | 139 | the Yocto Project to build images. |
| @@ -143,12 +143,12 @@ | |||
| 143 | and inheritance allowing commonly used patterns to be defined once and easily used | 143 | and inheritance allowing commonly used patterns to be defined once and easily used |
| 144 | in multiple recipes. | 144 | in multiple recipes. |
| 145 | Class files end with the <filename>.bbclass</filename> filename extension.</para></listitem> | 145 | Class files end with the <filename>.bbclass</filename> filename extension.</para></listitem> |
| 146 | <listitem><para><emphasis>Configuration File:</emphasis> Configuration information in the | 146 | <listitem><para><emphasis>Configuration File:</emphasis> Configuration information in various |
| 147 | <filename>.conf</filename> files provides global definitions of variables. | 147 | <filename>.conf</filename> files provides global definitions of variables. |
| 148 | The <filename>conf/local.conf</filename> configuration file in the Yocto Project | 148 | The <filename>conf/local.conf</filename> configuration file in the Yocto Project |
| 149 | build directory defines user-defined variables that affect each build. | 149 | build directory contains user-defined variables that affect each build. |
| 150 | The <filename>distro/poky.conf</filename> configuration file also in the | 150 | The <filename>meta-yocto/conf/distro/poky.conf</filename> configuration file |
| 151 | build directory defines Yocto ‘distro’ configuration | 151 | defines Yocto ‘distro’ configuration |
| 152 | variables used only when building with this policy. | 152 | variables used only when building with this policy. |
| 153 | Machine configuration files, which | 153 | Machine configuration files, which |
| 154 | are located throughout the Yocto Project file structure, define | 154 | are located throughout the Yocto Project file structure, define |
| @@ -159,7 +159,7 @@ | |||
| 159 | <listitem><para><emphasis>Cross-Development Toolchain:</emphasis> A collection of software development | 159 | <listitem><para><emphasis>Cross-Development Toolchain:</emphasis> A collection of software development |
| 160 | tools and utilities that allow you to develop software for targeted architectures. | 160 | tools and utilities that allow you to develop software for targeted architectures. |
| 161 | This toolchain contains cross-compilers, linkers, and debuggers that are specific to | 161 | This toolchain contains cross-compilers, linkers, and debuggers that are specific to |
| 162 | an architecure. | 162 | an architecture. |
| 163 | You can use the Yocto Project to build cross-development toolchains in tarball form that when | 163 | You can use the Yocto Project to build cross-development toolchains in tarball form that when |
| 164 | unpacked contain the development tools you need to cross-compile and test your software. | 164 | unpacked contain the development tools you need to cross-compile and test your software. |
| 165 | The Yocto Project ships with images that contain toolchains for supported architectures | 165 | The Yocto Project ships with images that contain toolchains for supported architectures |
