From e7cc30709756bf8100ea911d1976a89b936a4454 Mon Sep 17 00:00:00 2001
From: Tom Zanussi <tom.zanussi@intel.com>
Date: Mon, 26 Mar 2012 10:08:39 -0600
Subject: documentation/bsp-guide/bsp.xml: Removal of certain layers

Wording changed to remove example BSP layers that really weren't
layers (e.g. meta-intel).  One of three patches from Tom.

Reported-by Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 84677e0ef26f48af9b45585224d6c4dee0406f5e)

Signed-off-by: Tom Zanussi <tom.zanussi>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/bsp-guide/bsp.xml | 41 ++++++++++++++---------------------------
 1 file changed, 14 insertions(+), 27 deletions(-)

(limited to 'documentation/bsp-guide')

diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index f088f30a07..64ca5a4ea6 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -75,36 +75,11 @@
                 "bsp_name" is a placeholder for the machine or platform name.
             </para>
 
-            <para>
-                The Yocto Project organizes BSP Layers within the Yocto Metadata Layers area 
-                of the Yocto Project Source Repositories at 
-                <ulink url='&YOCTO_GIT_URL;/cgit.cgi'></ulink>.
-                If you examine the source repositories, you will find many BSP Layers.
-                Here are a few:
-                <literallayout class='monospaced'>
-     meta-baryon
-     meta-fsl-ppc
-     meta-intel
-     meta-selinux
-     meta-ti
-                </literallayout>
-                It is worth noting that the <filename>meta-intel</filename> BSP Layer contains 
-                within itself several other BSP Layers, which makes it sort of a "super" BSP layer.
-                Following is a sampling of the BSP Layers that the <filename>meta-intel</filename> 
-                BSP Layer contains:
-                <literallayout class='monospaced'>
-     meta-cedartrail
-     meta-crownbay
-     meta-emenlow
-     meta-fishriver
-     meta-fri2
-                </literallayout>
-            </para>
-
             <para>
                 The layer's base directory (<filename>meta-&lt;bsp_name&gt;</filename>) is the root 
                 of the BSP Layer.
-                This root is what you add to the <filename>BBLAYERS</filename>
+                This root is what you add to the 
+                <ulink url='&YOCTO_DOCS_REF_URL;#var-BBLAYERS'><filename>BBLAYERS</filename></ulink>
                 variable in the <filename>conf/bblayers.conf</filename> file found in the 
                 <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-build-directory'>Yocto Project Build Directory</ulink>.
                 Adding the root allows the Yocto Project build system to recognize the BSP 
@@ -119,6 +94,18 @@
                 </literallayout>
             </para>
 
+            <para>
+                Some BSPs require additional layers on
+                top of the BSP's root layer in order to be functional.
+                For these cases, you also need to add those layers to the
+                <filename>BBLAYERS</filename> variable in order to build the BSP.  
+                You must also specify in the "Dependiencies" section of the BSP's 
+                <filename>README</filename> file any requirements for additional 
+                layers and, preferably, any
+                build instructions that might be contained elsewhere
+                in the <filename>README</filename> file.
+            </para>
+
             <para>
                 For more detailed information on layers, see the 
                 "<ulink url='&YOCTO_DOCS_DEV_URL;#understanding-and-creating-layers'>Understanding and Creating Layers</ulink>" 
-- 
cgit v1.2.3-54-g00ecf