diff --git a/bitbake/doc/user-manual/user-manual-intro.xml b/bitbake/doc/user-manual/user-manual-intro.xml
index 4050e432dc..f013ee6f45 100644
--- a/bitbake/doc/user-manual/user-manual-intro.xml
+++ b/bitbake/doc/user-manual/user-manual-intro.xml
@@ -8,21 +8,46 @@
Introduction
- BitBake is a tool for executing tasks commonly performed by software
- developers when building systems on a daily basis.
- BitBake can build Systems consisting of numerous individual pieces
- of software, or can be used to build a single application.
- Example tasks that BitBake can execute are fetching source code,
- applying patches to source code, configuring, compiling, and
- packaging applications into a complete system, and managing metadata.
- BitBake abstracts the information for completing individual tasks
- into files known as recipes.
- Recipes contain all of the relevant information required by BitBake
- to complete a given task including dependencies, source file
- locations, etc.
- BitBake is similar to
- GNU Make
- and other build tools.
+ fundamentally, BitBake is a generic task execution
+ engine that allows shell and Python tasks to be run
+ efficiently and in parallel while working within
+ complex inter-task dependency constraints.
+ One of BitBake's main users, OpenEmbedded, takes this core
+ and builds embedded Linux software stacks using
+ a task-oriented approach.
+
+
+
+ Conceptually, BitBake is similar to GNU Make in
+ some regards but has significant differences:
+
+
+ BitBake executes tasks according to provided
+ metadata that builds up the tasks.
+ Metadata is stored in recipe (.bb),
+ configuration (.conf), and class
+ (.bbclass) files and provides
+ BitBake with instructions on what tasks to run and
+ the dependencies between those tasks.
+
+
+ BitBake includes a fetcher library for obtaining source
+ code from various places such as source control
+ systems or websites.
+
+
+ The instructions for each unit to be built (e.g. a piece
+ of software) are known as recipe files and
+ contain all the information about the unit
+ (dependencies, source file locations, checksums, description
+ and so on).
+
+
+ BitBake includes a client/server abstraction and can
+ be used from a command line or used as a service over XMLRPC and
+ has several different user interfaces.
+
+