diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-04-14 13:05:48 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-04-21 23:03:19 +0100 |
commit | 8f4b4e6f318edf50b65c22d10f5499c020f469a0 (patch) | |
tree | 91fbe354e59de757664ae9830f898b44cfa9770d /bitbake | |
parent | 1313bacfbea00763ad0b4df357bcc36f83b83f93 (diff) | |
download | poky-8f4b4e6f318edf50b65c22d10f5499c020f469a0.tar.gz |
bitbake: user-manual-hello.xml: General edits
I worked through the chapter and made some minor edits based
on my user experience. Part of what I did was to update
the console output for the examples.
(Bitbake rev: 13bf6cf71ff49572c3413435a33d87e5b6a8df0d)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml | 80 |
1 files changed, 39 insertions, 41 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml index 1873f968a5..d9ebaee0ca 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml | |||
@@ -10,7 +10,7 @@ | |||
10 | <para> | 10 | <para> |
11 | The simplest example commonly used to demonstrate any new | 11 | The simplest example commonly used to demonstrate any new |
12 | programming language or tool is the | 12 | programming language or tool is the |
13 | <ulink url="http://en.wikipedia.org/wiki/Hello_world_program">Hello World</ulink> | 13 | "<ulink url="http://en.wikipedia.org/wiki/Hello_world_program">Hello World</ulink>" |
14 | example. | 14 | example. |
15 | This appendix demonstrates, in tutorial form, Hello | 15 | This appendix demonstrates, in tutorial form, Hello |
16 | World within the context of BitBake. | 16 | World within the context of BitBake. |
@@ -75,8 +75,7 @@ | |||
75 | From the BitBake source code directory, issue the following command: | 75 | From the BitBake source code directory, issue the following command: |
76 | <literallayout class='monospaced'> | 76 | <literallayout class='monospaced'> |
77 | $ ./bin/bitbake --version | 77 | $ ./bin/bitbake --version |
78 | BitBake Build Tool Core version 1.19.0, bitbake version | 78 | BitBake Build Tool Core version 1.23.0, bitbake version 1.23.0 |
79 | 1.19.0 | ||
80 | </literallayout> | 79 | </literallayout> |
81 | You are now ready to use BitBake. | 80 | You are now ready to use BitBake. |
82 | </para> | 81 | </para> |
@@ -138,8 +137,8 @@ | |||
138 | The overall goal of this exercise is to build a | 137 | The overall goal of this exercise is to build a |
139 | complete "Hello World" example utilizing task and layer | 138 | complete "Hello World" example utilizing task and layer |
140 | concepts. | 139 | concepts. |
141 | This is how modern projects such as OpenEmbedded and | 140 | Because this is how modern projects such as OpenEmbedded and |
142 | the Yocto Project utilize BitBake, therefore it | 141 | the Yocto Project utilize BitBake, the example |
143 | provides an excellent starting point for understanding | 142 | provides an excellent starting point for understanding |
144 | BitBake. | 143 | BitBake. |
145 | </para> | 144 | </para> |
@@ -186,30 +185,34 @@ | |||
186 | First, set up a directory for the "Hello World" project. | 185 | First, set up a directory for the "Hello World" project. |
187 | Here is how you can do so in your home directory: | 186 | Here is how you can do so in your home directory: |
188 | <literallayout class='monospaced'> | 187 | <literallayout class='monospaced'> |
189 | $ mkdir ~/dev/hello && cd ~/dev/hello | 188 | $ mkdir ~/dev |
189 | $ mkdir ~/dev/hello | ||
190 | $ cd ~/dev/hello | ||
190 | </literallayout> | 191 | </literallayout> |
191 | Within this new, empty directory, run BitBake with | 192 | Within this new, empty directory, run BitBake with |
192 | debugging output and see what happens: | 193 | debugging output and see what happens: |
193 | <literallayout class='monospaced'> | 194 | <literallayout class='monospaced'> |
194 | $ bitbake -DDD | 195 | $ bitbake -DDD |
195 | The BBPATH variable is not set | 196 | The BBPATH variable is not set and bitbake did not find |
197 | a conf/bblayers.conf file in the expected location. | ||
198 | Maybe you accidentally invoked bitbake from the wrong | ||
199 | directory? | ||
196 | DEBUG: Removed the following variables from the environment: | 200 | DEBUG: Removed the following variables from the environment: |
197 | GNOME_DESKTOP_SESSION_ID, LESSOPEN, WINDOWID, | 201 | GNOME_DESKTOP_SESSION_ID, XDG_CURRENT_DESKTOP, |
198 | GNOME_KEYRING_CONTROL, DISPLAY, SSH_AGENT_PID, LANG, | 202 | GNOME_KEYRING_CONTROL, DISPLAY, SSH_AGENT_PID, LANG, |
199 | XDG_SESSION_PATH, XAUTHORITY, LANGUAGE, SESSION_MANAGER, | 203 | no_proxy, XDG_SESSION_PATH, XAUTHORITY, SESSION_MANAGER, |
200 | SHLVL, MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, TEXTDOMAIN, | 204 | SHLVL, MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, WINDOWID, |
201 | GPG_AGENT_INFO, SSH_AUTH_SOCK, XDG_RUNTIME_DIR, | 205 | EDITOR, GPG_AGENT_INFO, SSH_AUTH_SOCK, GDMSESSION, |
202 | COMPIZ_BIN_PATH, GDMSESSION, DEFAULTS_PATH, TEXTDOMAINDIR, | 206 | DEFAULTS_PATH, XDG_SEAT_PATH, XDG_CONFIG_DIRS, LESSOPEN, |
203 | XDG_SEAT_PATH, XDG_CONFIG_DIRS, XDG_CURRENT_DESKTOP, | ||
204 | DBUS_SESSION_BUS_ADDRESS, _, XDG_SESSION_COOKIE, | 207 | DBUS_SESSION_BUS_ADDRESS, _, XDG_SESSION_COOKIE, |
205 | DESKTOP_SESSION, LESSCLOSE, GNOME_KEYRING_PID, | 208 | DESKTOP_SESSION, LESSCLOSE, GNOME_KEYRING_PID, |
206 | UBUNTU_MENUPROXY, OLDPWD, GTK_MODULES, XDG_DATA_DIRS, | 209 | UBUNTU_MENUPROXY, OLDPWD, XDG_DATA_DIRS, COLORTERM, |
207 | COLORTERM, LS_COLORS | 210 | LS_COLORS |
208 | </literallayout> | 211 | </literallayout> |
209 | The majority of this output is specific to environment variables | 212 | The majority of this output is specific to environment variables |
210 | that are not directly relevant to BitBake. | 213 | that are not directly relevant to BitBake. |
211 | However, the very first message | 214 | However, the very first message regarding the |
212 | "<filename>The BBPATH variable is not set</filename>" | 215 | <filename>BBPATH</filename> variable |
213 | is relevant and you need to rectify it by setting | 216 | is relevant and you need to rectify it by setting |
214 | <link linkend='var-BBPATH'><filename>BBPATH</filename></link>. | 217 | <link linkend='var-BBPATH'><filename>BBPATH</filename></link>. |
215 | </para> | 218 | </para> |
@@ -258,7 +261,7 @@ | |||
258 | |-- classes | 261 | |-- classes |
259 | | +-- base.bbclass | 262 | | +-- base.bbclass |
260 | +-- conf | 263 | +-- conf |
261 | +-- bitbake.conf | 264 | +-- bitbake.conf |
262 | </literallayout> | 265 | </literallayout> |
263 | </para> | 266 | </para> |
264 | 267 | ||
@@ -295,33 +298,28 @@ | |||
295 | again and see what happens: | 298 | again and see what happens: |
296 | <literallayout class='monospaced'> | 299 | <literallayout class='monospaced'> |
297 | $ bitbake -DDD | 300 | $ bitbake -DDD |
298 | Nothing to do. Use 'bitbake world' to build everything, or run | 301 | Nothing to do. Use 'bitbake world' to build everything, or |
299 | 'bitbake --help' for usage information. | 302 | run 'bitbake --help' for usage information. |
300 | DEBUG: Removed the following variables from the environment: | 303 | DEBUG: Removed the following variables from the environment: |
301 | GNOME_DESKTOP_SESSION_ID, LESSOPEN, WINDOWID, | 304 | GNOME_DESKTOP_SESSION_ID, XDG_CURRENT_DESKTOP, |
302 | GNOME_KEYRING_CONTROL, DISPLAY, SSH_AGENT_PID, LANG, | 305 | GNOME_KEYRING_CONTROL, DISPLAY, SSH_AGENT_PID, LANG, no_proxy, |
303 | XDG_SESSION_PATH, XAUTHORITY, LANGUAGE, SESSION_MANAGER, | 306 | XDG_SESSION_PATH, XAUTHORITY, SESSION_MANAGER, SHLVL, |
304 | SHLVL, MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, TEXTDOMAIN, | 307 | MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, WINDOWID, EDITOR, |
305 | GPG_AGENT_INFO, SSH_AUTH_SOCK, XDG_RUNTIME_DIR, | 308 | GPG_AGENT_INFO, SSH_AUTH_SOCK, GDMSESSION, DEFAULTS_PATH, |
306 | COMPIZ_BIN_PATH, GDMSESSION, DEFAULTS_PATH, TEXTDOMAINDIR, | 309 | XDG_SEAT_PATH, XDG_CONFIG_DIRS, LESSOPEN, |
307 | XDG_SEAT_PATH, XDG_CONFIG_DIRS, XDG_CURRENT_DESKTOP, | ||
308 | DBUS_SESSION_BUS_ADDRESS, _, XDG_SESSION_COOKIE, | 310 | DBUS_SESSION_BUS_ADDRESS, _, XDG_SESSION_COOKIE, |
309 | DESKTOP_SESSION, LESSCLOSE, GNOME_KEYRING_PID, UBUNTU_MENUPROXY, | 311 | DESKTOP_SESSION, LESSCLOSE, GNOME_KEYRING_PID, UBUNTU_MENUPROXY, |
310 | OLDPWD, GTK_MODULES, XDG_DATA_DIRS, COLORTERM, LS_COLORS | 312 | OLDPWD, XDG_DATA_DIRS, COLORTERM, LS_COLORS |
311 | DEBUG: Found bblayers.conf (/home/wmat/dev/hello/conf/ | 313 | DEBUG: Found bblayers.conf (/home/scott-lenovo/dev/hello/conf/bblayers.conf) |
312 | bblayers.conf) | 314 | DEBUG: LOAD /home/scott-lenovo/dev/hello/conf/bblayers.conf |
313 | DEBUG: LOAD /home/wmat/dev/hello/conf/bblayers.conf | 315 | DEBUG: LOAD /home/scott-lenovo/dev/hello/conf/bitbake.conf |
314 | DEBUG: LOAD /home/wmat/dev/hello/conf/bitbake.conf | 316 | DEBUG: BB configuration INHERITs:0: inheriting /home/scott-lenovo/dev/hello/classes/base.bbclass |
315 | DEBUG: BB configuration INHERITs:0: inheriting /home/wmat/dev/ | 317 | DEBUG: BB /home/scott-lenovo/dev/hello/classes/base.bbclass: handle(data, include) |
316 | hello/classes/base.bbclass | 318 | DEBUG: LOAD /home/scott-lenovo/dev/hello/classes/base.bbclass |
317 | DEBUG: BB /home/wmat/dev/hello/classes/base.bbclass: handle | ||
318 | (data, include) | ||
319 | DEBUG: LOAD /home/wmat/dev/hello/classes/base.bbclass | ||
320 | DEBUG: Clearing SRCREV cache due to cache policy of: clear | 319 | DEBUG: Clearing SRCREV cache due to cache policy of: clear |
321 | DEBUG: Using cache in '/home/wmat/dev/hello/tmp/cache/ | 320 | DEBUG: Using cache in '/home/scott-lenovo/dev/hello/tmp/cache/local_file_checksum_cache.dat' |
322 | local_file_checksum_cache.dat' | 321 | DEBUG: Using cache in '/home/scott-lenovo/dev/hello/tmp/cache/bb_codeparser.dat' |
323 | DEBUG: Using cache in '/home/wmat/dev/hello/tmp/cache/ | 322 | DEBUG: Features set [3] (was [3]) |
324 | bb_codeparser.dat' | ||
325 | </literallayout> | 323 | </literallayout> |
326 | <note> | 324 | <note> |
327 | From this point forward in the example, the environment | 325 | From this point forward in the example, the environment |