summaryrefslogtreecommitdiffstats
path: root/bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-04-14 13:05:48 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-04-21 23:03:19 +0100
commit8f4b4e6f318edf50b65c22d10f5499c020f469a0 (patch)
tree91fbe354e59de757664ae9830f898b44cfa9770d /bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml
parent1313bacfbea00763ad0b4df357bcc36f83b83f93 (diff)
downloadpoky-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/doc/bitbake-user-manual/bitbake-user-manual-hello.xml')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml80
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 &amp;&amp; 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