From 890a794e38f2d11ec0dd6e39e5ab77a929cb51d9 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <scott.m.rifenbark@intel.com>
Date: Thu, 4 Nov 2010 13:01:19 -0700
Subject: [PATCH] Created a new folder to hold the BSP Guide

I created a new sub folder to hold the BSP Guide by itself so there are
three folders now for each of the Yocto manuals: BSP Guide, quick start
and poky ref manual.  The new folder for the BSP guide is 'bsp-guide'.
It contains the bsp.xml file, its own Makefile, a bsp-guide.xml file,
and its own 'Figures' directory.  The 'bsp-guide.xml' file that was
in the poky reference folder was deleted.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 documentation/bsp-guide/Makefile              |  35 +
 .../bsp-guide.xml                             |   9 +-
 documentation/bsp-guide/bsp.xml               | 459 +++++++++
 .../bsp-guide/figures/poky-ref-manual.png     | Bin 0 -> 17829 bytes
 documentation/bsp-guide/style.css             | 952 ++++++++++++++++++
 documentation/poky-ref-manual/Makefile        |   6 +-
 6 files changed, 1453 insertions(+), 8 deletions(-)
 create mode 100644 documentation/bsp-guide/Makefile
 rename documentation/{poky-ref-manual => bsp-guide}/bsp-guide.xml (90%)
 create mode 100644 documentation/bsp-guide/bsp.xml
 create mode 100644 documentation/bsp-guide/figures/poky-ref-manual.png
 create mode 100644 documentation/bsp-guide/style.css

diff --git a/documentation/bsp-guide/Makefile b/documentation/bsp-guide/Makefile
new file mode 100644
index 0000000000..7e8d216904
--- /dev/null
+++ b/documentation/bsp-guide/Makefile
@@ -0,0 +1,35 @@
+all: html pdf tarball
+
+pdf:
+	../tools/poky-docbook-to-pdf bsp-guide.xml ../template
+
+XSLTOPTS = --stringparam html.stylesheet style.css \
+           --stringparam  chapter.autolabel 1 \
+           --stringparam  section.autolabel 1 \
+           --stringparam  section.label.includes.component.label 1 \
+	   --xinclude
+
+##
+# These URI should be rewritten by your distribution's xml catalog to
+# match your localy installed XSL stylesheets.
+XSL_BASE_URI  = http://docbook.sourceforge.net/release/xsl/current
+XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl
+
+html:
+#       See http://www.sagehill.net/docbookxsl/HtmlOutput.html 
+	xsltproc $(XSLTOPTS) -o bsp-guide.html $(XSL_XHTML_URI) bsp-guide.xml
+
+tarball: html
+	tar -cvzf bsp-guide.tgz style.css bsp-guide.html figures/poky-ref-manual.png
+
+validate:
+	xmllint --postvalid --xinclude --noout bsp-guide.xml
+
+OUTPUTS = bsp-guide.pdf bsp-guide.html
+SOURCES = *.png *.xml *.css *.svg
+
+publish:
+	scp -r $(OUTPUTS) $(SOURCES) o-hand.com:/srv/www/pokylinux.org/doc/
+
+clean:
+	rm -f $(OUTPUTS)
diff --git a/documentation/poky-ref-manual/bsp-guide.xml b/documentation/bsp-guide/bsp-guide.xml
similarity index 90%
rename from documentation/poky-ref-manual/bsp-guide.xml
rename to documentation/bsp-guide/bsp-guide.xml
index c0f77cf04d..e90602cb00 100644
--- a/documentation/poky-ref-manual/bsp-guide.xml
+++ b/documentation/bsp-guide/bsp-guide.xml
@@ -29,9 +29,9 @@
 
         <revhistory>
             <revision>
-                <revnumber>0.4</revnumber>
-                <date>26 May 2010</date>
-                <revremark>Alpha Draft</revremark>
+                <revnumber>0.9</revnumber>
+                <date>27 October 2010</date>
+                <revremark>Beta Draft</revremark>
             </revision>
         </revhistory>
 
@@ -51,9 +51,10 @@
 
     <xi:include href="bsp.xml"/>
 
-    <index id='index'>
+<!--    <index id='index'>
       <title>Index</title>
     </index>
+-->
 
 </book>
 <!-- 
diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
new file mode 100644
index 0000000000..3b4b4818fa
--- /dev/null
+++ b/documentation/bsp-guide/bsp.xml
@@ -0,0 +1,459 @@
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+
+<chapter id='bsp'>
+
+        <title>Board Support Packages (BSP) - Developers Guide</title>
+
+        <para>
+            A Board Support Package (BSP) is a collection of information that
+            defines how to support a particular hardware device, set of devices, or 
+            hardware platform. 
+            The BSP includes information about the hardware features 
+            present on the device and kernel configuration information along with any 
+            additional hardware drivers required.
+            The BSP also lists any additional software 
+            components required in addition to a generic Linux software stack for both 
+            essential and optional platform features.
+        </para>
+
+        <para>
+            The intent of this document is to define a structure for these components
+            so that BSPs follow a commonly understood layout.
+            Providing a common form allows end-users to understand and become familiar 
+            with the layout.  
+            A common form also encourages standardization 
+            of software support of hardware.
+        </para>
+
+        <para>
+            The proposed format does have elements that are specific to the Poky and 
+            OpenEmbedded build systems. 
+            It is intended that this information can be 
+            used by other systems besides Poky and OpenEmbedded and thatspecified it will be simple
+            to extract information and convert it to other formats if required.
+            Poky, through its standard slyers mechanism, can directly accept The format 
+            described as a layer.
+            The BSP captures all 
+            the hardware specific details in one place in a standard format, which is 
+            useful for any person wishing to use the hardware platform regardless of 
+            the build system being used.
+        </para>
+
+        <para>
+            The BSP specification does not include a build system or other tools -
+            it is concerned with the hardware-specific components only. 
+            At the end 
+            distribution point you can shipt the BSP combined with a build system
+            and other tools. 
+            However, it is important to maintain the distinction that these
+            are separate components that happen to be combined in certain end products.
+        </para>
+
+        <section id="bsp-filelayout">
+            <title>Example Filesystem Layout</title>
+
+            <para>
+                The BSP consists of a file structure inside a base directory, meta-bsp in this example, 
+                where "bsp" is a placeholder for the machine or platform name. 
+                Examples of some files that it could contain are:
+            </para>
+            <para>
+                <literallayout class='monospaced'>
+     meta-bsp/                                
+     meta-bsp/binary/zImage
+     meta-bsp/binary/poky-image-minimal.directdisk
+     meta-bsp/conf/layer.conf 
+     meta-bsp/conf/machine/*.conf             
+     meta-bsp/conf/machine/include/tune-*.inc
+     meta-bsp/packages/bootloader/bootloader_0.1.bb
+     meta-bsp/packages/linux/linux-bsp-2.6.50/*.patch
+     meta-bsp/packages/linux/linux-bsp-2.6.50/defconfig-bsp
+     meta-bsp/packages/linux/linux-bsp_2.6.50.bb
+     meta-bsp/packages/modem/modem-driver_0.1.bb
+     meta-bsp/packages/modem/modem-daemon_0.1.bb
+     meta-bsp/packages/image-creator/image-creator-native_0.1.bb
+     meta-bsp/prebuilds/
+                </literallayout>
+            </para>
+
+            <para>
+                The following sections detail what these files and directories could contain.
+            </para>
+
+        </section>
+
+        <section id="bsp-filelayout-binary">
+            <title>Prebuilt User Binaries (meta-bsp/binary/*)</title>
+
+            <para>
+                This optional area contains useful prebuilt kernels and userspace filesystem 
+                images appropriate to the target system. 
+                Users could use these to get a system 
+                running and quickly get started on development tasks. 
+                The exact types of binaries
+                present will be highly hardware-dependent but a README file should be present 
+                explaining how to use them with the target hardware. 
+                If prebuilt binaries are 
+                present, source code to meet licensing requirements must also be provided in 
+                some form.
+            </para>
+       
+        </section>
+
+        <section id='bsp-filelayout-layer'>
+            <title>Layer Configuration (meta-bsp/conf/layer.conf)</title>
+
+            <para>
+                This file identifies the structure as a Poky layer by identifying the  
+                contents of the layer and containing information about how Poky should use 
+                it. 
+                Generally, a standard boilerplate file consisting of the following works.
+            </para>
+
+            <para>
+               <literallayout class='monospaced'>
+     # We have a conf directory, add to BBPATH
+     BBPATH := "${BBPATH}${LAYERDIR}"
+
+     # We have a recipes directory containing .bb and .bbappend files, add to BBFILES
+     BBFILES := "${BBFILES} ${LAYERDIR}/recipes/*/*.bb \ ${LAYERDIR}/recipes/*/*.bbappend"
+
+     BBFILE_COLLECTIONS += "bsp"
+     BBFILE_PATTERN_bsp := "^${LAYERDIR}/"
+     BBFILE_PRIORITY_bsp = "5"
+                </literallayout>
+            </para>
+
+            <para>
+                This file simply makes bitbake aware of the recipes and conf directories and is required 
+                for recognition of the BSP by Poky.
+            </para>
+
+        </section>
+
+        <section id="bsp-filelayout-machine">
+            <title>Hardware Configuration Options (meta-bsp/conf/machine/*.conf)</title>
+
+            <para>
+                The machine files bind together all the information contained elsewhere
+                in the BSP into a format that Poky/OpenEmbedded can understand. 
+                If the BSP supports multiple machines, multiple machine configuration files
+                can be present. 
+                These filenames correspond to the values to which users have set the MACHINE variable.
+            </para>
+
+            <para>
+                These files define things such as what kernel package to use
+                (PREFERRED_PROVIDER of virtual/kernel), what hardware drivers to
+                include in different types of images, any special software components
+                that are needed, any bootloader information, and also any special image
+                format requirements.
+            </para>
+
+            <para>
+                At least one machine file is required for a Poky BSP layer.
+                However, you can supply more than one file.
+            </para>
+
+        </section>
+
+        <section id="bsp-filelayout-tune">
+            <title>Hardware Optimization Options (meta-bsp/conf/machine/include/tune-*.inc)</title>
+
+            <para>
+                These are shared hardware "tuning" definitions and are commonly used to
+                pass specific optimization flags to the compiler. 
+                An example is tune-atom.inc:
+            </para>
+            <para>
+               <literallayout class='monospaced'>
+     BASE_PACKAGE_ARCH = "core2"
+     TARGET_CC_ARCH = "-m32 -march=core2 -msse3 -mtune=generic -mfpmath=sse"
+               </literallayout>
+            </para>
+            <para>
+                This example defines a new package architecture called "core2" and uses the
+                specified optimization flags, which are carefully chosen to give best
+                performance on atom processors.
+            </para>
+            <para>
+                The tune file would be included by the machine definition and can be
+                contained in the BSP or referenced from one of the standard core set of
+                files included with Poky itself.
+            </para>
+            <para>
+                Both the base package architecuture file and the tune file are optional for a Poky BSP layer.
+            </para>
+        </section>
+
+        <section id='bsp-filelayout-kernel'>
+            <title>Linux Kernel Configuration (meta-bsp/packages/linux/*)</title>
+
+            <para>
+                These files make up the definition of a kernel to use with this
+                hardware. 
+                In this case it is a complete self-contained kernel with its own
+                configuration and patches but kernels can be shared between many
+                machines as well.
+                Following is an example:
+               <literallayout class='monospaced'>
+     meta-bsp/packages/linux/linux-bsp_2.6.50.bb
+               </literallayout>
+                This example file is the core kernel recipe that details from where to get the kernel
+                source.
+                All standard source code locations are supported so this could 
+                be a release tarball, some git repository, or source included in
+                the directory within the BSP itself.
+            </para>
+            <para>
+                The file then contains information about what patches to apply and how to configure and build them.
+                It can reuse the main Poky kernel build class, so the definitions here can remain very simple.   
+            </para>
+            <para>
+               <literallayout class='monospaced'>
+     linux-bsp-2.6.50/*.patch
+               </literallayout>
+            </para>
+            <para>
+                The above example file contains patches you can apply against the base kernel, wherever
+                they may have been obtained from.
+            </para>
+            <para>
+               <literallayout class='monospaced'>
+     meta-bsp/packages/linux/linux-bsp-2.6.50/defconfig-bsp
+               </literallayout>
+            </para>
+            <para>
+                Finally, this last example file contains configuration information to use to configure the kernel.
+            </para>
+            <para>
+                Examples of kernel recipes are available in Poky itself. 
+                These files are optional since a kernel from Poky itself could be selected, although it
+                would be unusual not to have a kernel configuration.
+            </para>
+        </section>
+
+        <section id='bsp-filelayout-packages'>
+            <title>Other Software (meta-bsp/packages/*)</title>
+
+            <para>
+                This section describes other pieces of software that the hardware might need for best
+                operation. 
+                These are examples of the kinds of things that you could encounter.  
+                The examples used in this section are standard <filename>.bb</filename> file recipes in the 
+                usual Poky format.  
+                You can include the source directly by referring to it in the source control system or 
+                the released tarballs of external software projects.
+                You only need to provide these types of files if the platform requires them.
+            </para>
+            <para>
+                The following file is a bootloader recipe that can be used to generate a new
+                bootloader binary. 
+                Sometimes these files are included in the final image format and are needed to reflash hardware.
+            </para>
+            <para>
+               <literallayout class='monospaced'>
+     meta-bsp/packages/bootloader/bootloader_0.1.bb
+               </literallayout>
+            </para>
+            <para>
+                These next two files are examples of a hardware driver and a hardware daemon that might need
+                to be included in images to make the hardware useful. 
+                Although the example uses "modem" there may be other components needed, such as firmware.
+            </para>
+            <para>
+               <literallayout class='monospaced'>
+     meta-bsp/packages/modem/modem-driver_0.1.bb
+     meta-bsp/packages/modem/modem-daemon_0.1.bb
+               </literallayout>
+            </para>
+            <para>
+                Sometimes the device needs an image in a very specific format so that the update
+                mechanism can accept and reflash it. 
+                Recipes to build the tools needed to do this can be included with the BSP.
+                Following is an example.
+            </para>
+            <para>
+               <literallayout class='monospaced'>
+     meta-bsp/packages/image-creator/image-creator-native_0.1.bb
+               </literallayout>
+            </para>
+        </section>
+
+        <section id='bs-filelayout-bbappend'>
+            <title>Append BSP-Specific Information to Existing Recipes</title>
+            <para>
+                Suppose you have a recipe such as 'pointercal' that requires machine-specific information.
+                At the same time, you have your new BSP code nicely partitioned into a layer, which is where 
+                you would also like to specify any machine-specific information associated with your new machine. 
+                Before the <filename>.bbappend</filename> extension was introduced, you would have to copy the whole
+                pointercal recipe and files into your layer, and then add the single file for your machine.
+            </para>
+            <para>
+                With the <filename>.bbappend</filename> extension, however, your work becomes much easier.
+                It allows you to easily merge BSP-specific information with the original recipe.
+                Whenever bitbake finds any <filename>.bbappend</filename> files, they will be
+                included after bitbake loads the associated <filename>.bb</filename> but before any finalize 
+                or anonymous methods run.
+                This allows the BSP layer to do whatever it might want to do to customize the original recipe.
+            </para>
+            <para>
+                If your recipe needs to reference extra files it can use the FILESEXTRAPATH variable
+                to specify their location. 
+                The example below shows extra files contained in a folder called ${PN} (the package name).
+            </para>
+            <literallayout class='monospaced'>
+     FILESEXTRAPATHS := "${THISDIR}/${PN}"
+            </literallayout>
+            <para>
+            This technique allows the BSP to add machine-specific configuration files to the layer directory, 
+            which will be picked up by bitbake. 
+            For an example see <filename>meta-emenlow/packages/formfactor</filename>.
+            </para>
+        </section>
+
+        <section id="bsp-filelayout-prebuilds">
+            <title>Prebuild Data (meta-bsp/prebuilds/*)</title>
+            <para>
+                This location can contain precompiled representations of the source code 
+                contained elsewhere in the BSP layer. 
+                Assuming a compatible configuration is used, Poky can process and use these optional precompiled 
+                representations to provide much faster build times.
+            </para>
+        </section>
+
+        <section id='bsp-click-through-licensing'>
+            <title>BSP 'Click-Through' Licensing Procedure</title>
+
+            <note><para> This section is here as a description of how
+		click-through licensing is expected to work, and is
+		not yet not impemented.
+            </para></note>
+
+            <para>
+	      In some cases, a BSP may contain separately licensed IP
+	      (Intellectual Property) for a component, which imposes
+	      upon the user a requirement to accept the terms of a
+	      'click-through' license.  Once the license is accepted
+	      (in whatever form that may be, see details below) the
+	      Poky build system can then build and include the
+	      corresponding component in the final BSP image.  Some
+	      affected components may be essential to the normal
+	      functioning of the system and have no 'free' replacement
+	      i.e. the resulting system would be non-functional
+	      without them.  Other components may be simply
+	      'good-to-have' or purely elective, or if essential
+	      nonetheless have a 'free' (possibly less-capable)
+	      version which may substituted for in the BSP recipe.
+            </para>
+
+            <para>
+	      For the latter cases, where it is possible to do so from
+	      a functionality perspective, the Poky website will make
+	      available a 'de-featured' BSP completely free of
+	      encumbered IP, which can be used directly and without
+	      any further licensing requirements.  If present, this
+	      fully 'de-featured' BSP will be named meta-bsp (i.e. the
+	      normal default naming convention).  This is the simplest
+	      and therefore preferred option if available, assuming
+	      the resulting functionality meets requirements.
+            </para>
+
+            <para>
+	      If however, a non-encumbered version is unavailable or
+	      the 'free' version would provide unsuitable
+	      functionality or quality, an encumbered version can be
+	      used.  Encumbered versions of a BSP are given names of
+	      the form meta-bsp-nonfree.  There are several ways
+	      within the Poky build system to satisfy the licensing
+	      requirements for an encumbered BSP, in roughly the
+	      following order of preference:
+            </para>
+
+	    <itemizedlist>
+              <listitem>
+
+		<para>
+		  Get a license key (or keys) for the encumbered BSP
+		  by visiting 
+                  <ulink url='https://pokylinux.org/bsp-keys.html'>https://pokylinux.org/bsp-keys.html</ulink>
+		  and give the web form there the name of the BSP and your e-mail address.
+		</para>
+
+		<literallayout class='monospaced'>
+          [screenshot of dialog box]
+		</literallayout>
+
+		<para>
+		  After agreeing to any applicable license terms, the
+		  BSP key(s) will be immediately sent to the address
+		  given and can be used by specifying BSPKEY_&lt;keydomain&gt;
+		  environment variables when building the image:
+		</para>
+
+		<literallayout class='monospaced'>
+          $ BSPKEY_&lt;keydomain&gt;=&lt;key&gt; bitbake poky-image-sato
+		</literallayout>
+
+		<para>
+		  This will allow the encumbered image to be built
+		  with no change at all to the normal build process.
+		</para>
+
+		<para>
+		  Equivalently and probably more conveniently, a line
+		  for each key can instead be put into the user's
+		  local.conf file.
+		</para>
+
+		<para>
+		  The &lt;keydomain&gt; component of the
+		  BSPKEY_&lt;keydomain&gt; is required because there
+		  may be multiple licenses in effect for a give BSP; a
+		  given &lt;keydomain&gt; in such cases corresponds to
+		  a particular license.  In order for an encumbered
+		  BSP encompassing multiple key domains to be built
+		  successfully, a &lt;keydomain&gt; entry for each
+		  applicable license must be present in local.conf or
+		  supplied on the command-line.
+		</para>
+              </listitem>
+              <listitem>
+		<para>
+		  Do nothing - build as you normally would, and follow
+		  any license prompts that originate from the
+		  encumbered BSP (the build will cleanly stop at this
+		  point).  These usually take the form of instructions
+		  needed to manually fetch the encumbered package(s)
+		  and md5 sums into e.g. the poky/build/downloads
+		  directory.  Once the manual package fetch has been
+		  completed, restarting the build will continue where
+		  it left off, this time without the prompt since the
+		  license requirements will have been satisfied.
+		</para>
+              </listitem>
+              <listitem>
+		<para>
+		  Get a full-featured BSP recipe rather than a key, by
+		  visiting
+		  <ulink url='https://pokylinux.org/bsps.html'>https://pokylinux.org/bsps.html</ulink>.
+		  Accepting the license agreement(s) presented will
+		  subsequently allow you to download a tarball
+		  containing a full-featured BSP legally cleared for
+		  your use by the just-given license agreement(s).
+		  This method will also allow the encumbered image to
+		  be built with no change at all to the normal build
+		  process.
+		</para>
+              </listitem>
+	    </itemizedlist>
+	    <para>
+	      Note that method 3 is also the only option available
+	      when downloading pre-compiled images generated from
+	      non-free BSPs.  Those images are likewise available at
+	      <ulink url='https://pokylinux.org/bsps.html'>https://pokylinux.org/bsps.html</ulink>.
+            </para>
+        </section>
+
+</chapter>
diff --git a/documentation/bsp-guide/figures/poky-ref-manual.png b/documentation/bsp-guide/figures/poky-ref-manual.png
new file mode 100644
index 0000000000000000000000000000000000000000..333442e0d63e407f55f589c37cea07dfca99dbeb
GIT binary patch
literal 17829
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
b|JAQe&iR@5e*y3y76t}SS3j3^P6<r_MzKk(

literal 0
HcmV?d00001

diff --git a/documentation/bsp-guide/style.css b/documentation/bsp-guide/style.css
new file mode 100644
index 0000000000..3564affccb
--- /dev/null
+++ b/documentation/bsp-guide/style.css
@@ -0,0 +1,952 @@
+/* 
+   Generic XHTML / DocBook XHTML CSS Stylesheet.
+   
+   Browser wrangling and typographic design by
+      Oyvind Kolas / pippin@gimp.org
+
+   Customised for Poky by
+      Matthew Allum / mallum@o-hand.com
+
+   Thanks to:
+     Liam R. E. Quin
+     William Skaggs
+     Jakub Steiner
+
+   Structure
+   ---------
+
+   The stylesheet is divided into the following sections:
+
+       Positioning
+          Margins, paddings, width, font-size, clearing.
+       Decorations
+          Borders, style
+       Colors
+          Colors
+       Graphics
+          Graphical backgrounds
+       Nasty IE tweaks
+          Workarounds needed to make it work in internet explorer,
+          currently makes the stylesheet non validating, but up until
+          this point it is validating.
+       Mozilla extensions
+          Transparency for footer
+	  Rounded corners on boxes
+
+*/
+
+
+  /*************** /
+ /  Positioning   /
+/ ***************/
+
+body {
+  font-family: Verdana, Sans, sans-serif;
+ 
+  min-width: 640px;
+  width: 80%;
+  margin:  0em auto;
+  padding: 2em 5em 5em 5em;
+  color: #333;
+}
+
+h1,h2,h3,h4,h5,h6,h7 {
+  font-family: Arial, Sans;
+  color:#999999;
+  clear: both;
+}
+
+h1 {
+  font-size: 2em;
+  text-align: left;
+  padding: 0em 0em 0em 0em;
+  margin: 2em 0em 0em 0em;
+}
+
+h2.subtitle {
+  margin: 0.10em 0em 3.0em 0em;
+  padding: 0em 0em 0em 0em;
+  font-size: 1.8em;
+  padding-left: 20%;
+  font-weight: normal;
+  font-style: italic;
+}
+
+h2 {
+  margin: 2em 0em 0.66em 0em;
+  padding: 0.5em 0em 0em 0em;
+  font-size: 1.5em;
+  font-weight: normal;
+}
+
+h3.subtitle {
+  margin: 0em 0em 1em 0em;
+  padding: 0em 0em 0em 0em;
+  font-size: 142.14%;
+  text-align: right;
+}
+
+h3 {
+  margin: 1em 0em 0.5em 0em;
+  padding: 1em 0em 0em 0em;
+  font-size: 140%;
+  font-weight: normal;
+}
+
+h4 {
+  margin: 1em 0em 0.5em 0em;
+  padding: 1em 0em 0em 0em;
+  font-size: 120%;
+  font-weight: normal;
+}
+
+h5 {
+  margin: 1em 0em 0.5em 0em;
+  padding: 1em 0em 0em 0em;
+  font-size: 110.000%;
+  border-bottom: 1px solid black;
+}
+
+h6 {
+  margin: 1em 0em 0em 0em;
+  padding: 1em 0em 0em 0em;
+  font-size: 80%;
+  font-weight: normal;
+}
+
+.authorgroup {
+  background-color: transparent;
+  background-repeat: no-repeat;
+  padding-top: 256px;
+  background-image: url("figures/poky-ref-manual.png");
+  background-position: left top;
+  margin-top: -256px;
+  padding-right: 50px;
+  margin-left: 50px;
+  text-align: right;
+  width: 600px;
+}
+
+h3.author {
+  margin: 0em 0me 0em 0em;
+  padding: 0em 0em 0em 0em;
+  font-weight: normal;
+  font-size: 100%;
+  clear: both;
+}
+
+.author tt.email {
+  font-size: 66%;
+}
+
+.titlepage hr {
+  width: 0em;
+  clear: both;
+}
+
+.revhistory {
+  padding-top: 2em;
+  clear: both;
+}
+
+.toc,
+.list-of-tables,
+.list-of-examples,
+.list-of-figures {
+  padding: 1.33em 0em 2.5em 0em;
+}
+
+.toc p,
+.list-of-tables p,
+.list-of-figures p,
+.list-of-examples p {
+  padding: 0em 0em 0em 0em;
+  padding: 0em 0em 0.3em;
+  margin: 1.5em 0em 0em 0em;
+}
+
+.toc p b,
+.list-of-tables p b,
+.list-of-figures p b,
+.list-of-examples p b{
+  font-size: 100.0%;
+  font-weight: bold;
+}
+
+.toc dl,
+.list-of-tables dl,
+.list-of-figures dl,
+.list-of-examples dl {
+  margin: 0em 0em 0.5em 0em;
+  padding: 0em 0em 0em 0em;
+}
+
+.toc dt {
+  margin: 0em 0em 0em 0em;
+  padding: 0em 0em 0em 0em;
+}
+
+.toc dd {
+  margin: 0em 0em 0em 2.6em;
+  padding: 0em 0em 0em 0em;
+}
+
+div.glossary dl,
+div.variablelist dl {
+}
+
+.glossary dl dt,
+.variablelist dl dt,
+.variablelist dl dt span.term {
+  font-weight: normal;
+  width: 20em;
+  text-align: right;
+}
+
+.variablelist dl dt {
+  margin-top: 0.5em;
+}
+
+.glossary dl dd,
+.variablelist dl dd {
+  margin-top: -1em;
+  margin-left: 25.5em;
+}
+
+.glossary dd p,
+.variablelist dd p {
+  margin-top: 0em;
+  margin-bottom: 1em;
+}
+
+
+div.calloutlist table td {
+  padding: 0em 0em 0em 0em;
+  margin: 0em 0em 0em 0em;
+}
+
+div.calloutlist table td p {
+  margin-top: 0em;
+  margin-bottom: 1em;
+}
+
+div p.copyright {
+  text-align: left;
+}
+
+div.legalnotice p.legalnotice-title {
+  margin-bottom: 0em;
+}
+
+p {
+  line-height: 1.5em;
+  margin-top: 0em;
+  
+}
+
+dl {
+  padding-top: 0em;
+}
+
+hr {
+  border: solid 1px;
+}
+
+
+.mediaobject,
+.mediaobjectco {
+  text-align: center;
+}
+
+img {
+  border: none;
+}
+
+ul {
+  padding: 0em 0em 0em 1.5em;
+}
+
+ul li {
+  padding: 0em 0em 0em 0em;
+}
+
+ul li p {
+  text-align: left;
+}
+
+table {
+  width :100%;
+}
+
+th {
+  padding: 0.25em;
+  text-align: left;
+  font-weight: normal;
+  vertical-align: top;
+}
+
+td {
+  padding: 0.25em;
+  vertical-align: top;
+}
+
+p a[id] {
+  margin: 0px;
+  padding: 0px;
+  display: inline;
+  background-image: none;
+} 
+
+a {
+  text-decoration: underline;
+  color: #444;
+}
+
+pre {
+    overflow: auto;
+}
+
+a:hover {
+  text-decoration: underline;
+  /*font-weight: bold;*/
+}
+
+
+div.informalfigure,
+div.informalexample,
+div.informaltable,
+div.figure,
+div.table,
+div.example {
+  margin: 1em 0em;
+  padding: 1em;
+  page-break-inside: avoid;
+}
+
+
+div.informalfigure p.title b,
+div.informalexample p.title b,
+div.informaltable p.title b,
+div.figure p.title b,
+div.example p.title b,
+div.table p.title b{
+    padding-top: 0em;
+    margin-top: 0em;
+    font-size: 100%;
+    font-weight: normal;
+}
+
+.mediaobject .caption, 
+.mediaobject .caption p  {
+  text-align: center;
+  font-size: 80%;  
+  padding-top: 0.5em;
+  padding-bottom: 0.5em;
+}
+
+.epigraph {
+  padding-left: 55%;
+  margin-bottom: 1em;
+}
+
+.epigraph p {
+  text-align: left;
+}
+
+.epigraph .quote {
+  font-style: italic;
+}
+.epigraph .attribution {
+  font-style: normal;
+  text-align: right;
+}
+
+span.application {
+  font-style: italic;
+}
+
+.programlisting {
+  font-family: monospace;
+  font-size: 80%;
+  white-space: pre;
+  margin: 1.33em 0em;
+  padding: 1.33em;
+}
+
+.tip,
+.warning,
+.caution,
+.note {
+  margin-top: 1em;
+  margin-bottom: 1em;
+
+}
+
+/* force full width of table within div */
+.tip table,
+.warning table,
+.caution table,
+.note table {
+  border: none;
+  width: 100%;
+}
+
+
+.tip table th,
+.warning table th,
+.caution table th,
+.note table th {
+  padding: 0.8em 0.0em 0.0em 0.0em;
+  margin : 0em 0em 0em 0em;
+}
+
+.tip p,
+.warning p,
+.caution p,
+.note p {
+  margin-top: 0.5em;
+  margin-bottom: 0.5em;
+  padding-right: 1em;
+  text-align: left;
+}
+
+.acronym {
+  text-transform: uppercase;
+}
+
+b.keycap,
+.keycap {
+  padding: 0.09em 0.3em;
+  margin: 0em;
+}
+
+.itemizedlist li {
+  clear: none;
+}
+
+.filename {
+  font-size: medium;
+  font-family: Courier, monospace;
+}
+
+
+div.navheader, div.heading{
+  position: absolute;
+  left: 0em;
+  top: 0em;
+  width: 100%;
+  background-color: #cdf;
+  width: 100%;
+}
+
+div.navfooter, div.footing{
+  position: fixed;
+  left: 0em;
+  bottom: 0em;
+  background-color: #eee;
+  width: 100%;
+}
+
+
+div.navheader td,
+div.navfooter td {
+  font-size: 66%;
+}
+
+div.navheader table th {
+  /*font-family: Georgia, Times, serif;*/
+  /*font-size: x-large;*/
+  font-size: 80%;
+}
+
+div.navheader table {
+  border-left: 0em;
+  border-right: 0em;
+  border-top: 0em;
+  width: 100%;
+}
+
+div.navfooter table {
+  border-left: 0em;
+  border-right: 0em;
+  border-bottom: 0em;
+  width: 100%;
+}
+
+div.navheader table td a,
+div.navfooter table td a {
+  color: #777;
+  text-decoration: none;
+}
+
+/* normal text in the footer */
+div.navfooter table td {
+  color: black;
+}
+
+div.navheader table td a:visited,
+div.navfooter table td a:visited {
+  color: #444;
+}
+
+
+/* links in header and footer */
+div.navheader table td a:hover,
+div.navfooter table td a:hover {
+  text-decoration: underline;
+  background-color: transparent;
+  color: #33a;
+}
+
+div.navheader hr,
+div.navfooter hr {
+  display: none;
+}
+
+
+.qandaset tr.question td p {
+  margin: 0em 0em 1em 0em;
+  padding: 0em 0em 0em 0em;
+}
+
+.qandaset tr.answer td p {
+  margin: 0em 0em 1em 0em;
+  padding: 0em 0em 0em 0em;
+}
+.answer td {
+  padding-bottom: 1.5em;
+}
+
+.emphasis {
+  font-weight: bold;
+}
+
+
+  /************* /
+ / decorations  /
+/ *************/
+
+.titlepage {
+}
+
+.part .title {
+}
+
+.subtitle {
+    border: none;
+}
+
+/*
+h1 {
+  border: none;
+}
+
+h2 {
+  border-top: solid 0.2em;
+  border-bottom: solid 0.06em;
+}
+
+h3 {
+  border-top: 0em;
+  border-bottom: solid 0.06em;
+}
+
+h4 {
+  border: 0em;
+  border-bottom: solid 0.06em;
+}
+
+h5 {
+  border: 0em;
+}
+*/
+
+.programlisting {
+  border: solid 1px;
+}
+
+div.figure,
+div.table,
+div.informalfigure,
+div.informaltable,
+div.informalexample,
+div.example {
+  border: 1px solid;
+}
+
+
+
+.tip,
+.warning,
+.caution,
+.note {
+  border: 1px solid;
+}
+
+.tip table th,
+.warning table th,
+.caution table th,
+.note table th {
+  border-bottom: 1px solid;
+}
+
+.question td {
+  border-top: 1px solid black;
+}
+
+.answer {
+}
+
+
+b.keycap,
+.keycap {
+  border: 1px solid;
+}
+  
+
+div.navheader, div.heading{
+  border-bottom: 1px solid;
+}
+
+
+div.navfooter, div.footing{
+  border-top: 1px solid;
+}
+
+  /********* /
+ /  colors  /
+/ *********/
+
+body {
+  color: #333;
+  background: white;
+}
+
+a {
+  background: transparent;
+}
+
+a:hover {
+  background-color: #dedede;
+}
+
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+h7,
+h8 {
+  background-color: transparent;
+}
+
+hr {
+  border-color: #aaa;
+}
+
+
+.tip, .warning, .caution, .note {
+  border-color: #aaa;
+}
+
+
+.tip table th,
+.warning table th,
+.caution table th,
+.note table th {
+  border-bottom-color: #aaa;
+}
+
+
+.warning {
+  background-color: #fea;
+}
+
+.caution {
+  background-color: #fea;
+}
+
+.tip {
+  background-color: #eff;
+}
+
+.note {
+  background-color: #dfc;
+}
+
+.glossary dl dt, 
+.variablelist dl dt,
+.variablelist dl dt span.term {
+  color: #044;
+}
+
+div.figure,
+div.table,
+div.example,
+div.informalfigure,
+div.informaltable,
+div.informalexample {
+  border-color: #aaa;
+}
+
+pre.programlisting {
+  color: black;
+  background-color: #fff;
+  border-color: #aaa;
+  border-width: 2px;
+}
+
+.guimenu,
+.guilabel,
+.guimenuitem {
+  background-color: #eee;
+}
+
+
+b.keycap,
+.keycap {
+  background-color: #eee;
+  border-color: #999;
+}
+
+
+div.navheader {
+  border-color: black;
+}
+
+
+div.navfooter {
+  border-color: black;
+}
+
+
+  /*********** /
+ /  graphics  /
+/ ***********/
+
+/*
+body {
+  background-image: url("images/body_bg.jpg");
+  background-attachment: fixed;
+}
+
+.navheader,
+.note,
+.tip {
+  background-image: url("images/note_bg.jpg");
+  background-attachment: fixed;
+}
+
+.warning,
+.caution {
+  background-image: url("images/warning_bg.jpg");
+  background-attachment: fixed;
+}
+
+.figure,
+.informalfigure,
+.example,
+.informalexample,
+.table,
+.informaltable {
+  background-image: url("images/figure_bg.jpg");
+  background-attachment: fixed;
+}
+
+*/
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+h7{
+}
+
+div.preface .titlepage .title, 
+div.colophon .title, 
+div.chapter .titlepage .title {
+  background-image: url("images/title-bg.png");
+  background-position: bottom;
+  background-repeat: repeat-x;
+}
+
+div.section div.section .titlepage .title,
+div.sect2 .titlepage .title {
+    background: none;
+}
+
+
+h1.title {
+  background-color: transparent;
+  background-image: url("poky-ref-manual.png");
+  background-repeat: no-repeat;
+  height: 256px;
+  text-indent: -9000px;
+  overflow:hidden;
+}
+
+h2.subtitle {
+  background-color: transparent;
+  text-indent: -9000px;
+  overflow:hidden;
+  width: 0px;
+  display: none;
+}
+
+  /*************************************** /
+ /  pippin.gimp.org specific alterations  /
+/ ***************************************/
+
+/*
+div.heading, div.navheader {
+  color: #777;
+  font-size: 80%;
+  padding: 0;
+  margin: 0;
+  text-align: left;
+  position: absolute;
+  top: 0px;
+  left: 0px;
+  width: 100%;
+  height: 50px;
+  background: url('/gfx/heading_bg.png') transparent;
+  background-repeat: repeat-x;
+  background-attachment: fixed;
+  border: none;
+}
+
+div.heading a {
+  color: #444;
+}
+
+div.footing, div.navfooter {
+  border: none;
+  color: #ddd;
+  font-size: 80%;
+  text-align:right;
+
+  width: 100%;
+  padding-top: 10px;
+  position: absolute;
+  bottom: 0px;
+  left: 0px;
+
+  background: url('/gfx/footing_bg.png') transparent;
+}
+*/
+
+
+
+  /****************** /
+ /  nasty ie tweaks  /
+/ ******************/
+
+/*
+div.heading, div.navheader {
+  width:expression(document.body.clientWidth + "px");
+}
+
+div.footing, div.navfooter {
+  width:expression(document.body.clientWidth + "px");
+  margin-left:expression("-5em");
+}
+body {
+  padding:expression("4em 5em 0em 5em");
+}
+*/
+
+  /**************************************** /
+ / mozilla vendor specific css extensions  /
+/ ****************************************/
+/*
+div.navfooter, div.footing{
+  -moz-opacity: 0.8em;
+}
+
+div.figure,
+div.table,
+div.informalfigure,
+div.informaltable,
+div.informalexample,
+div.example,
+.tip,
+.warning,
+.caution,
+.note {
+  -moz-border-radius: 0.5em;
+}
+
+b.keycap,
+.keycap {
+  -moz-border-radius: 0.3em;
+}
+*/
+
+table tr td table tr td {
+  display: none;
+}
+
+
+hr {
+  display: none;
+}
+
+table {
+  border: 0em;
+}
+
+ .photo {
+  float: right;
+  margin-left:   1.5em;
+  margin-bottom: 1.5em;
+  margin-top: 0em;
+  max-width:      17em;
+  border:     1px solid gray;
+  padding:    3px;
+  background: white;
+}
+ .seperator {
+   padding-top: 2em;
+   clear: both;
+  }
+
+  #validators {
+      margin-top: 5em;
+      text-align: right;
+      color: #777;
+  }
+  @media print {
+      body {
+          font-size: 8pt;
+      }
+      .noprint {
+          display: none;
+      }
+  }
+
+
+.tip,
+.note {
+   background: #91ae35;
+   color: #fff;   
+   padding: 20px;
+   margin: 20px;
+}
+
+.tip h3,
+.note h3 {
+   padding: 0em;
+   margin: 0em;
+   font-size: 2em;
+   font-weight: bold;
+   color: #fff;   
+}
+
+.tip a,
+.note a {
+   color: #fff;   
+   text-decoration: underline;
+}
diff --git a/documentation/poky-ref-manual/Makefile b/documentation/poky-ref-manual/Makefile
index a5a331bd53..c906c7debd 100644
--- a/documentation/poky-ref-manual/Makefile
+++ b/documentation/poky-ref-manual/Makefile
@@ -2,7 +2,6 @@ all: html pdf tarball
 
 pdf:
 	../tools/poky-docbook-to-pdf poky-ref-manual.xml ../template
-	../tools/poky-docbook-to-pdf bsp-guide.xml ../template
 
 XSLTOPTS = --stringparam html.stylesheet style.css \
            --stringparam  chapter.autolabel 1 \
@@ -20,15 +19,14 @@ XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl
 html:
 #       See http://www.sagehill.net/docbookxsl/HtmlOutput.html 
 	xsltproc $(XSLTOPTS) -o poky-ref-manual.html $(XSL_XHTML_URI) poky-ref-manual.xml
-	xsltproc $(XSLTOPTS) -o bsp-guide.html $(XSL_XHTML_URI) bsp-guide.xml
 
 tarball: html
-	tar -cvzf poky-ref-manual.tgz poky-ref-manual.html style.css figures/yocto-project-transp.png figures/poky-ref-manual.png
+	tar -cvzf poky-ref-manual.tgz poky-ref-manual.html style.css figures/yocto-project-transp.png figures/poky-ref-manual.png screenshots/ss-sato.png
 
 validate:
 	xmllint --postvalid --xinclude --noout poky-ref-manual.xml
 
-OUTPUTS = poky-ref-manual.tgz poky-ref-manual.html poky-ref-manual.pdf bsp-guide.pdf bsp-guide.html
+OUTPUTS = poky-ref-manual.tgz poky-ref-manual.html poky-ref-manual.pdf 
 SOURCES = *.png *.xml *.css *.svg
 
 publish: