diff --git a/bitbake/doc/user-manual/user-manual-bitbakecommand.xml b/bitbake/doc/user-manual/user-manual-bitbakecommand.xml
index d3f4595d84..a97f45ac40 100644
--- a/bitbake/doc/user-manual/user-manual-bitbakecommand.xml
+++ b/bitbake/doc/user-manual/user-manual-bitbakecommand.xml
@@ -18,7 +18,8 @@
Usage and syntax
- $ bitbake --help
+
+$ bitbake --help
Usage: bitbake [options] [recipename/target ...]
Executes the specified task (default is 'build') for a given set of target recipes (.bb files).
@@ -88,7 +89,8 @@ Options:
-m, --kill-server Terminate the remote server.
--observe-only Connect to a server as an observing-only client.
--status-only Check the status of the remote bitbake server.
-
+
+
@@ -104,9 +106,15 @@ Options:
clean
task:
- $ bitbake -b blah_1.0.bb -c clean
+
+ $ bitbake -b foo.bb -c clean
+
+
build
task:
- $ bitbake -b blah_1.0.bb
+
+ $ bitbake -b foo_1.0.bb
+
+
@@ -137,13 +145,20 @@ Options:
anything else.
By default, a .bb generally PROVIDES its
packagename, packagename-version, and packagename-version-revision.
+
+ $ bitbake foo
+
+ $ bitbake foo-1.0
+
+ $ bitbake foo-1.0-r0
+
+ $ bitbake -c clean foo
+
+ $ bitbake virtual/whatever
+
+ $ bitbake -c clean virtual/whatever
+
- $ bitbake blah
- $ bitbake blah-1.0
- $ bitbake blah-1.0-r0
- $ bitbake -c clean blah
- $ bitbake virtual/whatever
- $ bitbake -c clean virtual/whatever
Generating dependency graphs
@@ -163,9 +178,12 @@ Options:
This way, DEPENDS from inherited classes
such as base.bbclass can be removed from the
graph.
+
+ $ bitbake -g foo
+
+ $ bitbake -g -I virtual/whatever -I bloom foo
+
- $ bitbake -g blah
- $ bitbake -g -I virtual/whatever -I bloom blah
@@ -198,7 +216,9 @@ Options:
Setting BBFILES
- BBFILES = "/path/to/bbfiles/*.bb"
+
+ BBFILES = "/path/to/bbfiles/*.bb"
+
With regard to dependencies, it expects the
@@ -215,13 +235,16 @@ Options:
Depending on another .bb
-a.bb:
-PN = "package-a"
-DEPENDS += "package-b"
-
-
-b.bb:
-PN = "package-b"
+
+ a.bb:
+
+ PN = "package-a"
+ DEPENDS += "package-b"
+
+ b.bb:
+
+ PN = "package-b"
+
@@ -230,20 +253,19 @@ b.bb:
This example shows the usage of the PROVIDES variable, which allows a given .bb to specify what functionality it provides.
-
-
-package1.bb:
-PROVIDES += "virtual/package"
-
-
-package2.bb:
-DEPENDS += "virtual/package"
-
-
-package3.bb:
-PROVIDES += "virtual/package"
-
-
+
+ package1.bb:
+
+ PROVIDES += "virtual/package"
+
+ package2.bb:
+
+ DEPENDS += "virtual/package"
+
+ package3.bb:
+
+ PROVIDES += "virtual/package"
+
As you can see, we have two different
.bb's that provide the same functionality
(virtual/package).
@@ -254,7 +276,9 @@ package3.bb:
The following would go into a .conf file, to select package1:
-PREFERRED_PROVIDER_virtual/package = "package1"
+
+ PREFERRED_PROVIDER_virtual/package = "package1"
+
@@ -289,7 +313,10 @@ The following would go into a .conf file, to select package1:
However, if we define the following variable in a
.conf that BitBake parses, we
can change that.
- PREFERRED_VERSION_a = "1.1"
+
+ PREFERRED_VERSION_a = "1.1"
+
+
@@ -305,13 +332,15 @@ The following would go into a .conf file, to select package1:
own local copy of an upstream repository, but with
custom modifications that one does not want upstream.
Usage:
-
- BBFILES = "/stuff/openembedded/*/*.bb /stuff/openembedded.modified/*/*.bb"
+
+ BBFILES = "/stuff/openembedded/*/*.bb /stuff/openembedded.modified/*/*.bb"
BBFILE_COLLECTIONS = "upstream local"
BBFILE_PATTERN_upstream = "^/stuff/openembedded/"
BBFILE_PATTERN_local = "^/stuff/openembedded.modified/"
BBFILE_PRIORITY_upstream = "5"
- BBFILE_PRIORITY_local = "10"
+ BBFILE_PRIORITY_local = "10"
+
+