From 8f4b4e6f318edf50b65c22d10f5499c020f469a0 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 14 Apr 2014 13:05:48 -0700 Subject: 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 Signed-off-by: Richard Purdie --- .../bitbake-user-manual-hello.xml | 80 +++++++++++----------- 1 file changed, 39 insertions(+), 41 deletions(-) (limited to 'bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml') 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 @@ The simplest example commonly used to demonstrate any new programming language or tool is the - Hello World + "Hello World" example. This appendix demonstrates, in tutorial form, Hello World within the context of BitBake. @@ -75,8 +75,7 @@ From the BitBake source code directory, issue the following command: $ ./bin/bitbake --version - BitBake Build Tool Core version 1.19.0, bitbake version - 1.19.0 + BitBake Build Tool Core version 1.23.0, bitbake version 1.23.0 You are now ready to use BitBake. @@ -138,8 +137,8 @@ The overall goal of this exercise is to build a complete "Hello World" example utilizing task and layer concepts. - This is how modern projects such as OpenEmbedded and - the Yocto Project utilize BitBake, therefore it + Because this is how modern projects such as OpenEmbedded and + the Yocto Project utilize BitBake, the example provides an excellent starting point for understanding BitBake. @@ -186,30 +185,34 @@ First, set up a directory for the "Hello World" project. Here is how you can do so in your home directory: - $ mkdir ~/dev/hello && cd ~/dev/hello + $ mkdir ~/dev + $ mkdir ~/dev/hello + $ cd ~/dev/hello Within this new, empty directory, run BitBake with debugging output and see what happens: $ bitbake -DDD - The BBPATH variable is not set + The BBPATH variable is not set and bitbake did not find + a conf/bblayers.conf file in the expected location. + Maybe you accidentally invoked bitbake from the wrong + directory? DEBUG: Removed the following variables from the environment: - GNOME_DESKTOP_SESSION_ID, LESSOPEN, WINDOWID, + GNOME_DESKTOP_SESSION_ID, XDG_CURRENT_DESKTOP, GNOME_KEYRING_CONTROL, DISPLAY, SSH_AGENT_PID, LANG, - XDG_SESSION_PATH, XAUTHORITY, LANGUAGE, SESSION_MANAGER, - SHLVL, MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, TEXTDOMAIN, - GPG_AGENT_INFO, SSH_AUTH_SOCK, XDG_RUNTIME_DIR, - COMPIZ_BIN_PATH, GDMSESSION, DEFAULTS_PATH, TEXTDOMAINDIR, - XDG_SEAT_PATH, XDG_CONFIG_DIRS, XDG_CURRENT_DESKTOP, + no_proxy, XDG_SESSION_PATH, XAUTHORITY, SESSION_MANAGER, + SHLVL, MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, WINDOWID, + EDITOR, GPG_AGENT_INFO, SSH_AUTH_SOCK, GDMSESSION, + DEFAULTS_PATH, XDG_SEAT_PATH, XDG_CONFIG_DIRS, LESSOPEN, DBUS_SESSION_BUS_ADDRESS, _, XDG_SESSION_COOKIE, DESKTOP_SESSION, LESSCLOSE, GNOME_KEYRING_PID, - UBUNTU_MENUPROXY, OLDPWD, GTK_MODULES, XDG_DATA_DIRS, - COLORTERM, LS_COLORS + UBUNTU_MENUPROXY, OLDPWD, XDG_DATA_DIRS, COLORTERM, + LS_COLORS The majority of this output is specific to environment variables that are not directly relevant to BitBake. - However, the very first message - "The BBPATH variable is not set" + However, the very first message regarding the + BBPATH variable is relevant and you need to rectify it by setting BBPATH. @@ -258,7 +261,7 @@ |-- classes |   +-- base.bbclass +-- conf - +-- bitbake.conf + +-- bitbake.conf @@ -295,33 +298,28 @@ again and see what happens: $ bitbake -DDD - Nothing to do. Use 'bitbake world' to build everything, or run - 'bitbake --help' for usage information. + Nothing to do. Use 'bitbake world' to build everything, or + run 'bitbake --help' for usage information. DEBUG: Removed the following variables from the environment: - GNOME_DESKTOP_SESSION_ID, LESSOPEN, WINDOWID, - GNOME_KEYRING_CONTROL, DISPLAY, SSH_AGENT_PID, LANG, - XDG_SESSION_PATH, XAUTHORITY, LANGUAGE, SESSION_MANAGER, - SHLVL, MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, TEXTDOMAIN, - GPG_AGENT_INFO, SSH_AUTH_SOCK, XDG_RUNTIME_DIR, - COMPIZ_BIN_PATH, GDMSESSION, DEFAULTS_PATH, TEXTDOMAINDIR, - XDG_SEAT_PATH, XDG_CONFIG_DIRS, XDG_CURRENT_DESKTOP, + GNOME_DESKTOP_SESSION_ID, XDG_CURRENT_DESKTOP, + GNOME_KEYRING_CONTROL, DISPLAY, SSH_AGENT_PID, LANG, no_proxy, + XDG_SESSION_PATH, XAUTHORITY, SESSION_MANAGER, SHLVL, + MANDATORY_PATH, COMPIZ_CONFIG_PROFILE, WINDOWID, EDITOR, + GPG_AGENT_INFO, SSH_AUTH_SOCK, GDMSESSION, DEFAULTS_PATH, + XDG_SEAT_PATH, XDG_CONFIG_DIRS, LESSOPEN, DBUS_SESSION_BUS_ADDRESS, _, XDG_SESSION_COOKIE, DESKTOP_SESSION, LESSCLOSE, GNOME_KEYRING_PID, UBUNTU_MENUPROXY, - OLDPWD, GTK_MODULES, XDG_DATA_DIRS, COLORTERM, LS_COLORS - DEBUG: Found bblayers.conf (/home/wmat/dev/hello/conf/ - bblayers.conf) - DEBUG: LOAD /home/wmat/dev/hello/conf/bblayers.conf - DEBUG: LOAD /home/wmat/dev/hello/conf/bitbake.conf - DEBUG: BB configuration INHERITs:0: inheriting /home/wmat/dev/ - hello/classes/base.bbclass - DEBUG: BB /home/wmat/dev/hello/classes/base.bbclass: handle - (data, include) - DEBUG: LOAD /home/wmat/dev/hello/classes/base.bbclass + OLDPWD, XDG_DATA_DIRS, COLORTERM, LS_COLORS + DEBUG: Found bblayers.conf (/home/scott-lenovo/dev/hello/conf/bblayers.conf) + DEBUG: LOAD /home/scott-lenovo/dev/hello/conf/bblayers.conf + DEBUG: LOAD /home/scott-lenovo/dev/hello/conf/bitbake.conf + DEBUG: BB configuration INHERITs:0: inheriting /home/scott-lenovo/dev/hello/classes/base.bbclass + DEBUG: BB /home/scott-lenovo/dev/hello/classes/base.bbclass: handle(data, include) + DEBUG: LOAD /home/scott-lenovo/dev/hello/classes/base.bbclass DEBUG: Clearing SRCREV cache due to cache policy of: clear - DEBUG: Using cache in '/home/wmat/dev/hello/tmp/cache/ - local_file_checksum_cache.dat' - DEBUG: Using cache in '/home/wmat/dev/hello/tmp/cache/ - bb_codeparser.dat' + DEBUG: Using cache in '/home/scott-lenovo/dev/hello/tmp/cache/local_file_checksum_cache.dat' + DEBUG: Using cache in '/home/scott-lenovo/dev/hello/tmp/cache/bb_codeparser.dat' + DEBUG: Features set [3] (was [3]) From this point forward in the example, the environment -- cgit v1.2.3-54-g00ecf