From 2038b85a46643ea3083ec37e3538d3d817790eb7 Mon Sep 17 00:00:00 2001 From: Richard Purdie Date: Fri, 17 Jan 2014 15:00:48 +0000 Subject: bitbake: user-manual-intro: Update/improve whitespace (Bitbake rev: fb74a1926c3a603a4c1ebe0325b27fb2c3aec3ee) Signed-off-by: Richard Purdie --- bitbake/doc/user-manual/user-manual-intro.xml | 128 +++++++++++++++++++------- 1 file changed, 95 insertions(+), 33 deletions(-) (limited to 'bitbake') diff --git a/bitbake/doc/user-manual/user-manual-intro.xml b/bitbake/doc/user-manual/user-manual-intro.xml index c76696f5d5..347b17a156 100644 --- a/bitbake/doc/user-manual/user-manual-intro.xml +++ b/bitbake/doc/user-manual/user-manual-intro.xml @@ -1,11 +1,13 @@ - + + BitBake User Manual
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 @@ -23,8 +25,10 @@ and other build tools.
-
- History and Goals + +
+ History and Goals + BitBake was originally a part of the OpenEmbedded project. It was inspired by the Portage package management system @@ -43,39 +47,97 @@ such as the Angstrom Distribution and the Yocto Project. - Prior to BitBake, no other build tool adequately met -the needs of an aspiring embedded Linux distribution. All of the -buildsystems used by traditional desktop Linux distributions lacked -important functionality, and none of the ad-hoc -buildroot systems, prevalent in the -embedded space, were scalable or maintainable. - Some important original goals for BitBake were: + + + Prior to BitBake, no other build tool adequately met the needs of + 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 systems, prevalent in the + embedded space, were scalable or maintainable. + + + + Some important original goals for BitBake were: - Handle crosscompilation. - Handle interpackage dependencies (build time on target architecture, build time on native architecture, and runtime). - Support running any number of tasks within a given package, including, but not limited to, fetching upstream sources, unpacking them, patching them, configuring them, etc. - Must be Linux distribution agnostic (both build and target). - Must be architecture agnostic - Must support multiple build and target operating systems (including Cygwin, the BSDs, etc). - Must be able to be self contained, rather than tightly integrated into the build machine's root filesystem. - There must be a way to handle conditional metadata (on target architecture, operating system, distribution, machine). - It must be easy for the person using the tools to supply their own local metadata and packages to operate against. - Must make it easy to collaborate -between multiple projects using BitBake for their -builds. - Should provide an inheritance mechanism to -share common metadata between many packages. + + Handle cross-compilation. + + + Handle inter-package dependencies (build time on + target architecture, build time on native + architecture, and runtime). + + + Support running any number of tasks within a given + package, including, but not limited to, fetching + upstream sources, unpacking them, patching them, + configuring them, etc. + + + Must be Linux distribution agnostic (both build and + target). + + + Must be architecture agnostic + + + Must support multiple build and target operating systems + (including Cygwin, the BSDs, etc). + + + Must be able to be self contained, rather than tightly + integrated into the build machine's root + filesystem. + + + There must be a way to handle conditional metadata + (on target architecture, operating system, + distribution, machine). + + + It must be easy for the person using the tools to + supply their own local metadata and packages + to operate against. + + + Must make it easy to collaborate between multiple + projects using BitBake for their builds. + + + Should provide an inheritance mechanism to share + common metadata between many packages. + - Over time it has become apparent that some further requirements were necessary: + + + Over time it has become apparent that some further requirements + were necessary: - Handle variants of a base recipe (native, sdk, multilib). - Able to split metadata into layers and allow layers to override each other. - Allow representation of a given set of input variables to a task as a checksum. Based on that checksum, allow acceleration of builds with prebuilt components. + + Handle variants of a base recipe (native, sdk, multilib). + + + Able to split metadata into layers and allow layers + to override each other. + + + Allow representation of a given set of input variables + to a task as a checksum. + Based on that checksum, allow acceleration of builds + with prebuilt components. + - BitBake satisfies all the original requirements and many more with extensions being made to the basic functionality to reflect the additional requirements. Flexibility and power have always been the priorities. It is highly extensible, supporting embedded Python code and execution of any arbitrary tasks. -
- - + + BitBake satisfies all the original requirements and many more + with extensions being made to the basic functionality to + reflect the additional requirements. + Flexibility and power have always been the priorities. + It is highly extensible, supporting embedded Python code and + execution of any arbitrary tasks. + +
+ -- cgit v1.2.3-54-g00ecf