diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml index 69b742244f..566fa5a9cf 100644 --- a/documentation/ref-manual/introduction.xml +++ b/documentation/ref-manual/introduction.xml @@ -290,6 +290,78 @@ + +
+ Required Git, tar, and Python Versions + + + In order to use the build system, your host development system + must meet the following version requirements for Git, tar, and + Python: + + Git 1.7.5 or greater + tar 1.24 or greater + Python 2.7.3 or greater + + + + + If your host development system does not meet all these requirements, + you can resolve this by either downloading a pre-built tarball + containing these tools, or building such a tarball on another + system. + Regardless of the method, once you have the tarball you simply + install it somewhere on you system, such as a directory in your + home directory, and then source the envirnoment script provided, + which adds the tools into PATH. + Doing so gives you working versions of Git, tar, Python and + chrpath. + + + + If downloading a pre-built tarball, locate the + *.sh at [NEED A PATH HERE from Beth]. + + + + If building your own tarball, do so using this command: + + $ bitbake buildtools-tarball + + + The SDKMACHINE + variable determines whether you build tools for a 32-bit + or 64-bit system. + + Once the build completes, you can find the file that installs the + the tools in tmp/deploy/sdk of the + Build Directory. + The file used to install the tarball has the string "buildtools" + in the name. + + + + After you have either built the tarball or downloaded it, you need + to install it. + Install the tools by executing the *.sh file. + During execution, a prompt appears that allows you to choose the + installation directory. + For example, you could choose the following: + + /home/your-username/sdk + + + + + The final step before you can actually use the tools is to source + the tools environment with a command like the following: + + $ source /home/your-username/sdk/environment-setup-i586-poky-linux + + Of course, you need to supply your installation directory and be + sure to use the right file (i.e. i585 or x86-64). + +