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 41b9410e47..af2400f53c 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
@@ -8,8 +8,8 @@
Welcome to the BitBake User Manual.
This manual provides information on the BitBake tool.
The information attempts to be as independent as possible regarding
- systems that use BitBake, such as the Yocto Project and
- OpenEmbedded.
+ systems that use BitBake, such as OpenEmbedded and the
+ Yocto Project.
In some cases, scenarios or examples within the context of
a build system are used in the manual to help with understanding.
For these cases, the manual clearly states the context.
@@ -44,7 +44,7 @@
BitBake includes a fetcher library for obtaining source
- code from various places such as source control
+ code from various places such as local files, source control
systems, websites, or local files.
@@ -89,7 +89,7 @@
an aspiring embedded Linux distribution.
All of the build systems used by traditional desktop Linux
distributions lacked important functionality, and none of the
- ad-hoc Buildroot-based systems, prevalent in the
+ ad hoc Buildroot-based systems, prevalent in the
embedded space, were scalable or maintainable.
@@ -209,12 +209,14 @@
The version of the recipe
Existing dependencies (both build
and runtime dependencies)
- Where the source code resides
- Whether the source code requires any patches
+ Where the source code resides and
+ how to fetch it
+ Whether the source code requires
+ any patches
How to configure and compile the
source code
Where on the target machine to install the
- package being compiled
+ package or packages being compiled
@@ -261,7 +263,7 @@
called base.bbclass.
You can find this file in the
classes directory.
- The base.bbclass is special since it
+ The base.bbclass class files is special since it
is always included automatically for all recipes
and classes.
This class contains definitions for standard basic tasks such
@@ -309,8 +311,8 @@
Append files, which are files that have the
- .bbappend file extension, add or
- extend build information to an existing
+ .bbappend file extension, extend or
+ override information in an existing recipe file.
recipe file.
@@ -578,14 +580,14 @@
when one wants to manage multiple .bb
files.
Clearly there needs to be a way to tell BitBake what
- files are available, and of those, which you
+ files are available and, of those, which you
want to execute.
There also needs to be a way for each recipe
to express its dependencies, both for build-time and
runtime.
There must be a way for you to express recipe preferences
when multiple recipes provide the same functionality, or when
- there are multiple versions of a recipe.
+ there are multiple versions of a recipe.