From 3a9593d4099edf906d9074e0b44b9b0e6ba1db94 Mon Sep 17 00:00:00 2001
From: Bill Traynor <wmat@alphatroop.com>
Date: Mon, 13 Jan 2014 18:34:16 -0600
Subject: bitbake: user-manual-intro.xml: Re-write of BitBake introduction.

(Bitbake rev: afc998a73f09f3d1a0d7e22425badfa5b7001aa1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 bitbake/doc/user-manual/user-manual-intro.xml | 55 +++++++++++++++++++--------
 1 file changed, 40 insertions(+), 15 deletions(-)

(limited to 'bitbake/doc/user-manual/user-manual-intro.xml')

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 @@
         <title>Introduction</title>
 
         <para>
-            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
-            <ulink url='http://www.gnu.org/software/make/'>GNU Make</ulink>
-            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.
+        </para>
+
+        <para>
+            Conceptually, BitBake is similar to GNU Make in
+            some regards but has significant differences:
+            <itemizedlist>
+                <listitem><para>
+                    BitBake executes tasks according to provided
+                    metadata that builds up the tasks.
+                    Metadata is stored in recipe (<filename>.bb</filename>),
+                    configuration (<filename>.conf</filename>), and class
+                    (<filename>.bbclass</filename>) files and provides
+                    BitBake with instructions on what tasks to run and
+                    the dependencies between those tasks.
+                    </para></listitem>
+                <listitem><para>
+                    BitBake includes a fetcher library for obtaining source
+                    code from various places such as source control
+                    systems or websites.
+                    </para></listitem>
+                <listitem><para>
+                    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).
+                    </para></listitem>
+                <listitem><para>
+                    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.
+                    </para></listitem>
+            </itemizedlist>
         </para>
     </section>
 
-- 
cgit v1.2.3-54-g00ecf