ref-manual: Added note about issues on supported distros

Fixes YOCTO #4519

I have added a note after the list of supported Linux distros
that states there might be problems on a given distro when
using YP.  I cited the CentOS 6.4 example for this 4519
bug.

(From yocto-docs rev: 30c413739aae99462ec2b4771041d4c115917aa9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 20 insertions, 9 deletions

diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml
index 2a8a75850b..69b742244f 100644
--- a/documentation/ref-manual/introduction.xml
+++ b/documentation/ref-manual/introduction.xml
@@ -101,7 +101,11 @@
         <title>Supported Linux Distributions</title>
 
         <para>
-            Currently, the Yocto Project is supported on the following distributions:
+            Currently, the Yocto Project is supported on the following
+            distributions.
+            For additional information on distributions that support the
+            Yocto Project, see the
+            <ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution Support</ulink> wiki page.
             <itemizedlist>
                 <listitem><para>Ubuntu 10.04</para></listitem>
                 <listitem><para>Ubuntu 11.10</para></listitem>
@@ -120,9 +124,15 @@
         </para>
 
         <note>
-            For additional information on distributions that support the
-            Yocto Project, see the
-            <ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution Support</ulink> wiki page.
+            While the Yocto Project Team attempts to ensure all Yocto Project
+            releases are one hundred percent compatible with each officially
+            supported Linux distribution, instances might exist where you
+            encounter a problem while using the Yocto Project on a specific
+            distribution.
+            For example, the CentOS 6.4 distribution does not include the
+            Gtk+ 2.20.0 and PyGtk 2.21.0 (or higher) packages, which are
+            required to run
+            <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink>.
         </note>
     </section>
 
@@ -245,6 +255,12 @@
             <para>
                 The following list shows the required packages by function
                 given a supported CentOS Linux distribution:
+                <note>Depending on the CentOS version you are using, other requirements
+                    and dependencies might exist.
+                    For details, you should look at the CentOS sections on the
+                    <ulink url='https://wiki.yoctoproject.org/wiki/Poky/GettingStarted/Dependencies'>Poky/GettingStarted/Dependencies</ulink>
+                    wiki page.
+                </note>
                 <itemizedlist>
                     <listitem><para><emphasis>Essentials:</emphasis>
                         Packages needed to build an image for a headless
@@ -271,11 +287,6 @@
      $ sudo yum -y install autoconf automake libtool glib2-devel
                         </literallayout></para></listitem>
                 </itemizedlist>
-                <note>Depending on the CentOS version you are using, other requirements
-                    and dependencies might exist.
-                    For details, you should look at the CentOS sections on the
-                    <ulink url='https://wiki.yoctoproject.org/wiki/Poky/GettingStarted/Dependencies'>Poky/GettingStarted/Dependencies</ulink>
-                    wiki page.</note>
             </para>
         </section>
     </section>