summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRobert P. J. Day <rpjday@crashcourse.ca>2020-02-07 05:51:11 -0500
committerRichard Purdie <richard.purdie@linuxfoundation.org>2020-02-08 17:41:17 +0000
commit34535f3e0ca6f6e37e6457fc800dfbfff64d9298 (patch)
tree4cd7febbb7e42d9993e10046b3f2f856b10a2999
parent94208e7bf4b700dd71b7d528f604af5944126c0d (diff)
downloadpoky-34535f3e0ca6f6e37e6457fc800dfbfff64d9298.tar.gz
bitbake: doc: minor tweaks to ch 1 of BB user manual
Tweaks include: - hyphenation - rewording for brevity or clarification - adding <firstterm> markup where appropriate (Bitbake rev: bc84ce7e6542dac1a150b9733411190cff591948) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml18
1 files changed, 10 insertions, 8 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
index c87eac5242..f5526c053e 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
@@ -127,7 +127,7 @@
127 (e.g. Cygwin, the BSDs, and so forth). 127 (e.g. Cygwin, the BSDs, and so forth).
128 </para></listitem> 128 </para></listitem>
129 <listitem><para> 129 <listitem><para>
130 Be self contained, rather than tightly 130 Be self-contained, rather than tightly
131 integrated into the build machine's root 131 integrated into the build machine's root
132 filesystem. 132 filesystem.
133 </para></listitem> 133 </para></listitem>
@@ -221,6 +221,8 @@
221 them</para></listitem> 221 them</para></listitem>
222 <listitem><para>How to configure and compile the 222 <listitem><para>How to configure and compile the
223 source code</para></listitem> 223 source code</para></listitem>
224 <listitem><para>How to assemble the generated artifacts into
225 one or more installable packages</para></listitem>
224 <listitem><para>Where on the target machine to install the 226 <listitem><para>Where on the target machine to install the
225 package or packages created</para></listitem> 227 package or packages created</para></listitem>
226 </itemizedlist> 228 </itemizedlist>
@@ -229,7 +231,7 @@
229 <para> 231 <para>
230 Within the context of BitBake, or any project utilizing BitBake 232 Within the context of BitBake, or any project utilizing BitBake
231 as its build system, files with the <filename>.bb</filename> 233 as its build system, files with the <filename>.bb</filename>
232 extension are referred to as recipes. 234 extension are referred to as <firstterm>recipes</firstterm>.
233 <note> 235 <note>
234 The term "package" is also commonly used to describe recipes. 236 The term "package" is also commonly used to describe recipes.
235 However, since the same word is used to describe packaged 237 However, since the same word is used to describe packaged
@@ -252,9 +254,9 @@
252 various configuration variables that govern the project's build 254 various configuration variables that govern the project's build
253 process. 255 process.
254 These files fall into several areas that define 256 These files fall into several areas that define
255 machine configuration options, distribution configuration 257 machine configuration, distribution configuration,
256 options, compiler tuning options, general common 258 possible compiler tuning, general common
257 configuration options, and user configuration options. 259 configuration, and user configuration.
258 The main configuration file is the sample 260 The main configuration file is the sample
259 <filename>bitbake.conf</filename> file, which is 261 <filename>bitbake.conf</filename> file, which is
260 located within the BitBake source tree 262 located within the BitBake source tree
@@ -292,7 +294,7 @@
292 Layers allow you to isolate different types of 294 Layers allow you to isolate different types of
293 customizations from each other. 295 customizations from each other.
294 While you might find it tempting to keep everything in one layer 296 While you might find it tempting to keep everything in one layer
295 when working on a single project, the more modular you organize 297 when working on a single project, the more modular
296 your metadata, the easier it is to cope with future changes. 298 your metadata, the easier it is to cope with future changes.
297 </para> 299 </para>
298 300
@@ -300,8 +302,8 @@
300 To illustrate how you can use layers to keep things modular, 302 To illustrate how you can use layers to keep things modular,
301 consider customizations you might make to support a specific target machine. 303 consider customizations you might make to support a specific target machine.
302 These types of customizations typically reside in a special layer, 304 These types of customizations typically reside in a special layer,
303 rather than a general layer, called a Board Support Package (BSP) 305 rather than a general layer, called a <firstterm>Board Support Package</firstterm> (BSP)
304 Layer. 306 layer.
305 Furthermore, the machine customizations should be isolated from 307 Furthermore, the machine customizations should be isolated from
306 recipes and metadata that support a new GUI environment, for 308 recipes and metadata that support a new GUI environment, for
307 example. 309 example.