diff options
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/introduction.xml | 318 |
1 files changed, 180 insertions, 138 deletions
diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml index 58ee073868..deaac033a3 100644 --- a/documentation/ref-manual/introduction.xml +++ b/documentation/ref-manual/introduction.xml | |||
@@ -43,110 +43,123 @@ | |||
43 | <title>Yocto Project Terms</title> | 43 | <title>Yocto Project Terms</title> |
44 | 44 | ||
45 | <para> | 45 | <para> |
46 | Following is a list of terms and definitions users new to the Yocto Project development | 46 | Following is a list of terms and definitions users new to the Yocto |
47 | environment might find helpful. | 47 | Project development environment might find helpful. |
48 | While some of these terms are universal, the list includes them just in case: | 48 | While some of these terms are universal, the list includes them |
49 | just in case: | ||
49 | <itemizedlist> | 50 | <itemizedlist> |
50 | <listitem><para><emphasis>Append Files:</emphasis> Files that append build information to | 51 | <listitem><para> |
51 | a recipe file. | 52 | <emphasis>Append Files:</emphasis> |
52 | Append files are known as BitBake append files and <filename>.bbappend</filename> files. | 53 | Files that append build information to a recipe file. |
53 | The OpenEmbedded build system expects every append file to have a corresponding | 54 | Append files are known as BitBake append files and |
54 | recipe (<filename>.bb</filename>) file. | 55 | <filename>.bbappend</filename> files. |
56 | The OpenEmbedded build system expects every append file to have | ||
57 | a corresponding recipe (<filename>.bb</filename>) file. | ||
55 | Furthermore, the append file and corresponding recipe file | 58 | Furthermore, the append file and corresponding recipe file |
56 | must use the same root filename. | 59 | must use the same root filename. |
57 | The filenames can differ only in the file type suffix used (e.g. | 60 | The filenames can differ only in the file type suffix used |
58 | <filename>formfactor_0.0.bb</filename> and <filename>formfactor_0.0.bbappend</filename>). | 61 | (e.g. |
59 | </para> | 62 | <filename>formfactor_0.0.bb</filename> and |
63 | <filename>formfactor_0.0.bbappend</filename>).</para> | ||
64 | |||
60 | <para>Information in append files extends or overrides the | 65 | <para>Information in append files extends or overrides the |
61 | information in the similarly-named recipe file. | 66 | information in the similarly-named recipe file. |
62 | For an example of an append file in use, see the | 67 | For an example of an append file in use, see the |
63 | "<ulink url='&YOCTO_DOCS_DEV_URL;#using-bbappend-files'>Using .bbappend Files</ulink>" | 68 | "<ulink url='&YOCTO_DOCS_DEV_URL;#using-bbappend-files'>Using .bbappend Files</ulink>" |
64 | section in the Yocto Project Development Manual. | 69 | section in the Yocto Project Development Manual. |
65 | <note> | 70 | <note> |
66 | Append files can also use wildcard patterns in their version numbers | 71 | Append files can also use wildcard patterns in their |
67 | so they can be applied to more than one version of the underlying recipe file. | 72 | version numbers so they can be applied to more than one |
73 | version of the underlying recipe file. | ||
68 | </note> | 74 | </note> |
69 | </para></listitem> | 75 | </para></listitem> |
70 | <listitem><para id='bitbake-term'><emphasis>BitBake:</emphasis> | 76 | <listitem><para id='bitbake-term'> |
77 | <emphasis>BitBake:</emphasis> | ||
71 | The task executor and scheduler used by the OpenEmbedded build | 78 | The task executor and scheduler used by the OpenEmbedded build |
72 | system to build images. | 79 | system to build images. |
73 | For more information on BitBake, see the | 80 | For more information on BitBake, see the |
74 | <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual</ulink>. | 81 | <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual</ulink>. |
75 | </para></listitem> | 82 | </para></listitem> |
76 | <listitem> | 83 | <listitem> |
77 | <para id='build-directory'><emphasis>Build Directory:</emphasis> | 84 | <para id='build-directory'> |
85 | <emphasis>Build Directory:</emphasis> | ||
78 | This term refers to the area used by the OpenEmbedded build | 86 | This term refers to the area used by the OpenEmbedded build |
79 | system for builds. | 87 | system for builds. |
80 | The area is created when you <filename>source</filename> the | 88 | The area is created when you <filename>source</filename> the |
81 | setup environment script that is found in the Source Directory | 89 | setup environment script that is found in the Source Directory |
82 | (i.e. <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink> | 90 | (i.e. <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link> |
83 | or | 91 | or |
84 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>). | 92 | <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>). |
85 | The <ulink url='&YOCTO_DOCS_REF_URL;#var-TOPDIR'><filename>TOPDIR</filename></ulink> | 93 | The |
94 | <link linkend='var-TOPDIR'><filename>TOPDIR</filename></link> | ||
86 | variable points to the Build Directory.</para> | 95 | variable points to the Build Directory.</para> |
87 | 96 | ||
88 | <para> | 97 | <para>You have a lot of flexibility when creating the Build |
89 | You have a lot of flexibility when creating the Build | 98 | Directory. |
90 | Directory. | 99 | Following are some examples that show how to create the |
91 | Following are some examples that show how to create the | 100 | directory. |
92 | directory. | 101 | The examples assume your |
93 | The examples assume your | 102 | <link linkend='source-directory'>Source Directory</link> is |
94 | <link linkend='source-directory'>Source Directory</link> is | 103 | named <filename>poky</filename>: |
95 | named <filename>poky</filename>: | 104 | <itemizedlist> |
96 | <itemizedlist> | 105 | <listitem><para>Create the Build Directory inside your |
97 | <listitem><para>Create the Build Directory inside your | 106 | Source Directory and let the name of the Build |
98 | Source Directory and let the name of the Build | 107 | Directory default to <filename>build</filename>: |
99 | Directory default to <filename>build</filename>: | 108 | <literallayout class='monospaced'> |
100 | <literallayout class='monospaced'> | ||
101 | $ cd $HOME/poky | 109 | $ cd $HOME/poky |
102 | $ source &OE_INIT_FILE; | 110 | $ source &OE_INIT_FILE; |
103 | </literallayout></para></listitem> | 111 | </literallayout> |
104 | <listitem><para>Create the Build Directory inside your | 112 | </para></listitem> |
105 | home directory and specifically name it | 113 | <listitem><para>Create the Build Directory inside your |
106 | <filename>test-builds</filename>: | 114 | home directory and specifically name it |
107 | <literallayout class='monospaced'> | 115 | <filename>test-builds</filename>: |
116 | <literallayout class='monospaced'> | ||
108 | $ cd $HOME | 117 | $ cd $HOME |
109 | $ source poky/&OE_INIT_FILE; test-builds | 118 | $ source poky/&OE_INIT_FILE; test-builds |
110 | </literallayout></para></listitem> | 119 | </literallayout> |
111 | <listitem><para> | 120 | </para></listitem> |
112 | Provide a directory path and | 121 | <listitem><para> |
113 | specifically name the Build Directory. | 122 | Provide a directory path and specifically name the |
114 | Any intermediate folders in the pathname must | 123 | Build Directory. |
115 | exist. | 124 | Any intermediate folders in the pathname must exist. |
116 | This next example creates a Build Directory named | 125 | This next example creates a Build Directory named |
117 | <filename>YP-&POKYVERSION;</filename> | 126 | <filename>YP-&POKYVERSION;</filename> |
118 | in your home directory within the existing | 127 | in your home directory within the existing |
119 | directory <filename>mybuilds</filename>: | 128 | directory <filename>mybuilds</filename>: |
120 | <literallayout class='monospaced'> | 129 | <literallayout class='monospaced'> |
121 | $cd $HOME | 130 | $cd $HOME |
122 | $ source $HOME/poky/&OE_INIT_FILE; $HOME/mybuilds/YP-&POKYVERSION; | 131 | $ source $HOME/poky/&OE_INIT_FILE; $HOME/mybuilds/YP-&POKYVERSION; |
123 | </literallayout></para></listitem> | 132 | </literallayout> |
124 | </itemizedlist> | 133 | </para></listitem> |
125 | <note> | 134 | </itemizedlist> |
126 | By default, the Build Directory contains | 135 | <note> |
127 | <ulink url='&YOCTO_DOCS_REF_URL;#var-TMPDIR'><filename>TMPDIR</filename></ulink>, | 136 | By default, the Build Directory contains |
128 | which is a temporary directory the build system uses for | 137 | <link linkend='var-TMPDIR'><filename>TMPDIR</filename></link>, |
129 | its work. | 138 | which is a temporary directory the build system uses for |
130 | <filename>TMPDIR</filename> cannot be under NFS. | 139 | its work. |
131 | Thus, by default, the Build Directory cannot be under NFS. | 140 | <filename>TMPDIR</filename> cannot be under NFS. |
132 | However, if you need the Build Directory to be under NFS, | 141 | Thus, by default, the Build Directory cannot be under NFS. |
133 | you can set this up by setting <filename>TMPDIR</filename> | 142 | However, if you need the Build Directory to be under NFS, |
134 | in your <filename>local.conf</filename> file | 143 | you can set this up by setting <filename>TMPDIR</filename> |
135 | to use a local drive. | 144 | in your <filename>local.conf</filename> file |
136 | Doing so effectively separates <filename>TMPDIR</filename> | 145 | to use a local drive. |
137 | from <filename>TOPDIR</filename>, which is the Build | 146 | Doing so effectively separates <filename>TMPDIR</filename> |
138 | Directory. | 147 | from <filename>TOPDIR</filename>, which is the Build |
139 | </note> | 148 | Directory. |
140 | </para></listitem> | 149 | </note> |
141 | <listitem><para><emphasis>Classes:</emphasis> Files that provide for logic encapsulation | 150 | </para></listitem> |
142 | and inheritance so that commonly used patterns can be defined once and then easily used | 151 | <listitem><para> |
143 | in multiple recipes. | 152 | <emphasis>Classes:</emphasis> |
153 | Files that provide for logic encapsulation and inheritance so | ||
154 | that commonly used patterns can be defined once and then | ||
155 | easily used in multiple recipes. | ||
144 | For reference information on the Yocto Project classes, see the | 156 | For reference information on the Yocto Project classes, see the |
145 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes'>Classes</ulink>" chapter of the | 157 | "<link linkend='ref-classes'>Classes</link>" chapter. |
146 | Yocto Project Reference Manual. | 158 | Class files end with the <filename>.bbclass</filename> |
147 | Class files end with the <filename>.bbclass</filename> filename extension. | 159 | filename extension. |
148 | </para></listitem> | 160 | </para></listitem> |
149 | <listitem><para><emphasis>Configuration File:</emphasis> | 161 | <listitem><para> |
162 | <emphasis>Configuration File:</emphasis> | ||
150 | Configuration information in various <filename>.conf</filename> | 163 | Configuration information in various <filename>.conf</filename> |
151 | files provides global definitions of variables. | 164 | files provides global definitions of variables. |
152 | The <filename>conf/local.conf</filename> configuration file in | 165 | The <filename>conf/local.conf</filename> configuration file in |
@@ -169,52 +182,58 @@ | |||
169 | </para></listitem> | 182 | </para></listitem> |
170 | <listitem><para id='cross-development-toolchain'> | 183 | <listitem><para id='cross-development-toolchain'> |
171 | <emphasis>Cross-Development Toolchain:</emphasis> | 184 | <emphasis>Cross-Development Toolchain:</emphasis> |
172 | In general, a cross-development toolchain is a collection of | 185 | In general, a cross-development toolchain is a collection of |
173 | software development tools and utilities that run on one | 186 | software development tools and utilities that run on one |
174 | architecture and allow you to develop software for a | 187 | architecture and allow you to develop software for a |
175 | different, or targeted, architecture. | 188 | different, or targeted, architecture. |
176 | These toolchains contain cross-compilers, linkers, and | 189 | These toolchains contain cross-compilers, linkers, and |
177 | debuggers that are specific to the target architecture. | 190 | debuggers that are specific to the target architecture.</para> |
178 | </para> | ||
179 | 191 | ||
180 | <para>The Yocto Project supports two different cross-development | 192 | <para>The Yocto Project supports two different cross-development |
181 | toolchains: | 193 | toolchains: |
182 | <itemizedlist> | 194 | <itemizedlist> |
183 | <listitem><para>A toolchain only used by and within | 195 | <listitem><para> |
184 | BitBake when building an image for a target | 196 | A toolchain only used by and within |
185 | architecture.</para></listitem> | 197 | BitBake when building an image for a target |
186 | <listitem><para>A relocatable toolchain used outside of | 198 | architecture. |
187 | BitBake by developers when developing applications | 199 | </para></listitem> |
188 | that will run on a targeted device. | 200 | <listitem><para>A relocatable toolchain used outside of |
189 | </para></listitem> | 201 | BitBake by developers when developing applications |
190 | </itemizedlist> | 202 | that will run on a targeted device. |
191 | </para> | 203 | </para></listitem> |
204 | </itemizedlist></para> | ||
192 | 205 | ||
193 | <para> | 206 | <para>Creation of these toolchains is simple and automated. |
194 | Creation of these toolchains is simple and automated. | 207 | For information on toolchain concepts as they apply to the |
195 | For information on toolchain concepts as they apply to the | 208 | Yocto Project, see the |
196 | Yocto Project, see the | 209 | "<link linkend='cross-development-toolchain-generation'>Cross-Development Toolchain Generation</link>" |
197 | "<ulink url='&YOCTO_DOCS_REF_URL;#cross-development-toolchain-generation'>Cross-Development Toolchain Generation</ulink>" | 210 | section. |
198 | section in the Yocto Project Reference Manual. | 211 | You can also find more information on using the |
199 | You can also find more information on using the | 212 | relocatable toolchain in the |
200 | relocatable toolchain in the | 213 | <ulink url='&YOCTO_DOCS_SDK_URL;'>Yocto Project Software Development Kit (SDK) Developer's Guide</ulink>. |
201 | <ulink url='&YOCTO_DOCS_SDK_URL;'>Yocto Project Software Development Kit (SDK) Developer's Guide</ulink>. | 214 | </para></listitem> |
202 | </para></listitem> | 215 | <listitem><para> |
203 | <listitem><para><emphasis>Image:</emphasis> | 216 | <emphasis>Image:</emphasis> |
204 | An image is an artifact of the BitBake build process given | 217 | An image is an artifact of the BitBake build process given |
205 | a collection of recipes and related Metadata. | 218 | a collection of recipes and related Metadata. |
206 | Images are the binary output that run on specific hardware or | 219 | Images are the binary output that run on specific hardware or |
207 | QEMU and are used for specific use-cases. | 220 | QEMU and are used for specific use-cases. |
208 | For a list of the supported image types that the Yocto Project provides, see the | 221 | For a list of the supported image types that the Yocto Project |
209 | "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" | 222 | provides, see the |
210 | chapter in the Yocto Project Reference Manual.</para></listitem> | 223 | "<link linkend='ref-images'>Images</link>" |
211 | <listitem><para id='layer'><emphasis>Layer:</emphasis> A collection of recipes representing the core, | 224 | chapter. |
225 | </para></listitem> | ||
226 | <listitem><para id='layer'> | ||
227 | <emphasis>Layer:</emphasis> | ||
228 | A collection of recipes representing the core, | ||
212 | a BSP, or an application stack. | 229 | a BSP, or an application stack. |
213 | For a discussion specifically on BSP Layers, see the | 230 | For a discussion specifically on BSP Layers, see the |
214 | "<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-layers'>BSP Layers</ulink>" | 231 | "<ulink url='&YOCTO_DOCS_BSP_URL;#bsp-layers'>BSP Layers</ulink>" |
215 | section in the Yocto Project Board Support Packages (BSP) | 232 | section in the Yocto Project Board Support Packages (BSP) |
216 | Developer's Guide.</para></listitem> | 233 | Developer's Guide. |
217 | <listitem><para id='metadata'><emphasis>Metadata:</emphasis> | 234 | </para></listitem> |
235 | <listitem><para id='metadata'> | ||
236 | <emphasis>Metadata:</emphasis> | ||
218 | The files that BitBake parses when building an image. | 237 | The files that BitBake parses when building an image. |
219 | In general, Metadata includes recipes, classes, and | 238 | In general, Metadata includes recipes, classes, and |
220 | configuration files. | 239 | configuration files. |
@@ -222,11 +241,16 @@ | |||
222 | it refers to Metadata in the <filename>meta</filename> | 241 | it refers to Metadata in the <filename>meta</filename> |
223 | branches of the kernel source Git repositories. | 242 | branches of the kernel source Git repositories. |
224 | </para></listitem> | 243 | </para></listitem> |
225 | <listitem><para id='oe-core'><emphasis>OE-Core:</emphasis> A core set of Metadata originating | 244 | <listitem><para id='oe-core'> |
226 | with OpenEmbedded (OE) that is shared between OE and the Yocto Project. | 245 | <emphasis>OE-Core:</emphasis> |
227 | This Metadata is found in the <filename>meta</filename> directory of the | 246 | A core set of Metadata originating with OpenEmbedded (OE) |
228 | <link linkend='source-directory'>Source Directory</link>.</para></listitem> | 247 | that is shared between OE and the Yocto Project. |
229 | <listitem><para id='build-system-term'><emphasis>OpenEmbedded Build System:</emphasis> | 248 | This Metadata is found in the <filename>meta</filename> |
249 | directory of the | ||
250 | <link linkend='source-directory'>Source Directory</link>. | ||
251 | </para></listitem> | ||
252 | <listitem><para id='build-system-term'> | ||
253 | <emphasis>OpenEmbedded Build System:</emphasis> | ||
230 | The build system specific to the Yocto Project. | 254 | The build system specific to the Yocto Project. |
231 | The OpenEmbedded build system is based on another project known | 255 | The OpenEmbedded build system is based on another project known |
232 | as "Poky", which uses | 256 | as "Poky", which uses |
@@ -243,26 +267,33 @@ | |||
243 | <link linkend='poky'>Poky</link> term. | 267 | <link linkend='poky'>Poky</link> term. |
244 | </note> | 268 | </note> |
245 | </para></listitem> | 269 | </para></listitem> |
246 | <listitem><para><emphasis>Package:</emphasis> | 270 | <listitem><para> |
271 | <emphasis>Package:</emphasis> | ||
247 | In the context of the Yocto Project, this term refers to a | 272 | In the context of the Yocto Project, this term refers to a |
248 | recipe's packaged output produced by BitBake (i.e. a | 273 | recipe's packaged output produced by BitBake (i.e. a |
249 | "baked recipe"). | 274 | "baked recipe"). |
250 | A package is generally the compiled binaries produced from the | 275 | A package is generally the compiled binaries produced from the |
251 | recipe's sources. | 276 | recipe's sources. |
252 | You "bake" something by running it through BitBake.</para> | 277 | You "bake" something by running it through BitBake.</para> |
253 | <para>It is worth noting that the term "package" can, in general, have subtle | 278 | |
254 | meanings. For example, the packages referred to in the | 279 | <para>It is worth noting that the term "package" can, |
255 | "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Build Host Packages</ulink>" section are | 280 | in general, have subtle meanings. |
256 | compiled binaries that, when installed, add functionality to your Linux | 281 | For example, the packages referred to in the |
282 | "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>The Build Host Packages</ulink>" | ||
283 | section in the Yocto Project Quick Start are compiled binaries | ||
284 | that, when installed, add functionality to your Linux | ||
257 | distribution.</para> | 285 | distribution.</para> |
258 | <para>Another point worth noting is that historically within the Yocto Project, | 286 | |
259 | recipes were referred to as packages - thus, the existence of several BitBake | 287 | <para>Another point worth noting is that historically within |
260 | variables that are seemingly mis-named, | 288 | the Yocto Project, recipes were referred to as packages - thus, |
261 | (e.g. <ulink url='&YOCTO_DOCS_REF_URL;#var-PR'><filename>PR</filename></ulink>, | 289 | the existence of several BitBake variables that are seemingly |
262 | <ulink url='&YOCTO_DOCS_REF_URL;#var-PV'><filename>PV</filename></ulink>, and | 290 | mis-named, |
263 | <ulink url='&YOCTO_DOCS_REF_URL;#var-PE'><filename>PE</filename></ulink>). | 291 | (e.g. <link linkend='var-PR'><filename>PR</filename></link>, |
264 | </para></listitem> | 292 | <link linkend='var-PV'><filename>PV</filename></link>, and |
265 | <listitem><para><emphasis>Package Groups:</emphasis> | 293 | <link linkend='var-PE'><filename>PE</filename></link>). |
294 | </para></listitem> | ||
295 | <listitem><para> | ||
296 | <emphasis>Package Groups:</emphasis> | ||
266 | Arbitrary groups of software Recipes. | 297 | Arbitrary groups of software Recipes. |
267 | You use package groups to hold recipes that, when built, | 298 | You use package groups to hold recipes that, when built, |
268 | usually accomplish a single task. | 299 | usually accomplish a single task. |
@@ -272,8 +303,10 @@ | |||
272 | graphics. | 303 | graphics. |
273 | A package group is really just another recipe. | 304 | A package group is really just another recipe. |
274 | Because package group files are recipes, they end with the | 305 | Because package group files are recipes, they end with the |
275 | <filename>.bb</filename> filename extension.</para></listitem> | 306 | <filename>.bb</filename> filename extension. |
276 | <listitem><para id='poky'><emphasis>Poky:</emphasis> | 307 | </para></listitem> |
308 | <listitem><para id='poky'> | ||
309 | <emphasis>Poky:</emphasis> | ||
277 | The term "poky" can mean several things. | 310 | The term "poky" can mean several things. |
278 | In its most general sense, it is an open-source | 311 | In its most general sense, it is an open-source |
279 | project that was initially developed by OpenedHand. | 312 | project that was initially developed by OpenedHand. |
@@ -283,6 +316,7 @@ | |||
283 | After Intel Corporation acquired OpenedHand, the | 316 | After Intel Corporation acquired OpenedHand, the |
284 | project poky became the basis for the Yocto Project's | 317 | project poky became the basis for the Yocto Project's |
285 | build system.</para> | 318 | build system.</para> |
319 | |||
286 | <para>Within the Yocto Project source repositories, | 320 | <para>Within the Yocto Project source repositories, |
287 | <filename>poky</filename> exists as a separate Git | 321 | <filename>poky</filename> exists as a separate Git |
288 | repository you can clone to yield a local copy on your | 322 | repository you can clone to yield a local copy on your |
@@ -290,13 +324,15 @@ | |||
290 | Thus, "poky" can refer to the local copy of the Source | 324 | Thus, "poky" can refer to the local copy of the Source |
291 | Directory used for development within the Yocto | 325 | Directory used for development within the Yocto |
292 | Project.</para> | 326 | Project.</para> |
327 | |||
293 | <para>Finally, "poky" can refer to the default | 328 | <para>Finally, "poky" can refer to the default |
294 | <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO'><filename>DISTRO</filename></ulink> | 329 | <link linkend='var-DISTRO'><filename>DISTRO</filename></link> |
295 | (i.e. distribution) created when you use the Yocto | 330 | (i.e. distribution) created when you use the Yocto |
296 | Project in conjunction with the | 331 | Project in conjunction with the |
297 | <filename>poky</filename> repository to build an image. | 332 | <filename>poky</filename> repository to build an image. |
298 | </para></listitem> | 333 | </para></listitem> |
299 | <listitem><para><emphasis>Recipe:</emphasis> | 334 | <listitem><para> |
335 | <emphasis>Recipe:</emphasis> | ||
300 | A set of instructions for building packages. | 336 | A set of instructions for building packages. |
301 | A recipe describes where you get source code, which patches | 337 | A recipe describes where you get source code, which patches |
302 | to apply, how to configure the source, how to compile it and so on. | 338 | to apply, how to configure the source, how to compile it and so on. |
@@ -307,7 +343,8 @@ | |||
307 | <filename>.bb</filename> file extension. | 343 | <filename>.bb</filename> file extension. |
308 | </para></listitem> | 344 | </para></listitem> |
309 | <listitem> | 345 | <listitem> |
310 | <para id='source-directory'><emphasis>Source Directory:</emphasis> | 346 | <para id='source-directory'> |
347 | <emphasis>Source Directory:</emphasis> | ||
311 | This term refers to the directory structure created as a result | 348 | This term refers to the directory structure created as a result |
312 | of creating a local copy of the <filename>poky</filename> Git | 349 | of creating a local copy of the <filename>poky</filename> Git |
313 | repository <filename>git://git.yoctoproject.org/poky</filename> | 350 | repository <filename>git://git.yoctoproject.org/poky</filename> |
@@ -373,16 +410,21 @@ | |||
373 | </para></listitem> | 410 | </para></listitem> |
374 | <listitem><para><emphasis>Task:</emphasis> | 411 | <listitem><para><emphasis>Task:</emphasis> |
375 | A unit of execution for BitBake (e.g. | 412 | A unit of execution for BitBake (e.g. |
376 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-compile'><filename>do_compile</filename></ulink>, | 413 | <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>, |
377 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-fetch'><filename>do_fetch</filename></ulink>, | 414 | <link linkend='ref-tasks-fetch'><filename>do_fetch</filename></link>, |
378 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-patch'><filename>do_patch</filename></ulink>, | 415 | <link linkend='ref-tasks-patch'><filename>do_patch</filename></link>, |
379 | and so forth). | 416 | and so forth). |
380 | </para></listitem> | 417 | </para></listitem> |
381 | <listitem><para><emphasis>Upstream:</emphasis> A reference to source code or repositories | 418 | <listitem><para> |
382 | that are not local to the development system but located in a master area that is controlled | 419 | <emphasis>Upstream:</emphasis> |
383 | by the maintainer of the source code. | 420 | A reference to source code or repositories |
384 | For example, in order for a developer to work on a particular piece of code, they need to | 421 | that are not local to the development system but located in a |
385 | first get a copy of it from an "upstream" source.</para></listitem> | 422 | master area that is controlled by the maintainer of the source |
423 | code. | ||
424 | For example, in order for a developer to work on a particular | ||
425 | piece of code, they need to first get a copy of it from an | ||
426 | "upstream" source. | ||
427 | </para></listitem> | ||
386 | </itemizedlist> | 428 | </itemizedlist> |
387 | </para> | 429 | </para> |
388 | </section> | 430 | </section> |