[gnome-continuous-yocto/gnomeostree-3.28-rocko: 5411/8267] ref-manual, yocto-project-qs, poky.ent: Fixed CentOS essentials

[Emmanuele Bassi <ebassi src gnome org>]

commit af4ef8adbce550888fbfa5de005768c0ff229250
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Mar 27 10:47:58 2017 -0700

    ref-manual, yocto-project-qs, poky.ent: Fixed CentOS essentials
    
    Fixes [YOCTO #10854]
    
    I added extra "yum" commands and a make command to deal with
    some essential packages needed for CentOS distribution.  These
    packages were missing.
    
    (From yocto-docs rev: 38ac6cf0165f7dd7bbfd583e218b6948dafae29c)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/poky.ent                             |    4 ++-
 documentation/ref-manual/introduction.xml          |   24 +++++++++++++-
 .../yocto-project-qs/yocto-project-qs.xml          |   34 +++++++++++++++----
 3 files changed, 52 insertions(+), 10 deletions(-)
---
diff --git a/documentation/poky.ent b/documentation/poky.ent
index 846df23..df0c009 100644
--- a/documentation/poky.ent
+++ b/documentation/poky.ent
@@ -70,7 +70,9 @@
 <!ENTITY OPENSUSE_HOST_PACKAGES_ESSENTIAL "python gcc gcc-c++ git chrpath make wget python-xml \
      diffstat makeinfo python-curses patch socat python3 python3-curses tar python3-pip \
      python3-expect xz which">
-<!ENTITY CENTOS_HOST_PACKAGES_ESSENTIAL "gawk make wget tar bzip2 gzip python unzip perl patch \
+<!ENTITY CENTOS_HOST_PACKAGES_ESSENTIAL "-y epel-release
+     $ sudo yum makecache
+     $ sudo yum install gawk make wget tar bzip2 gzip python unzip perl patch \
      diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath socat \
      perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python3-pip python3-expect xz \
      which">
diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml
index ddf6a86..cec23b6 100644
--- a/documentation/ref-manual/introduction.xml
+++ b/documentation/ref-manual/introduction.xml
@@ -368,8 +368,28 @@
                         Packages needed to build an image for a headless
                         system:
                         <literallayout class='monospaced'>
-     $ sudo yum install &CENTOS_HOST_PACKAGES_ESSENTIAL;
-                        </literallayout></para></listitem>
+     $ sudo yum install &CENTOS_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm
+                        </literallayout>
+                        <note><title>Notes</title>
+                            <itemizedlist>
+                                <listitem><para>
+                                    Extra Packages for Enterprise Linux
+                                    (i.e. <filename>epel-release</filename>)
+                                    is a collection of packages from Fedora
+                                    built on RHEL/CentOS for easy installation
+                                    of packages not included in enterprise
+                                    Linux by default.
+                                    You need to install these packages
+                                    separately.
+                                    </para></listitem>
+                                <listitem><para>
+                                    The <filename>makecache</filename> command
+                                    consumes additional Metadata from
+                                    <filename>epel-release</filename>.
+                                    </para></listitem>
+                            </itemizedlist>
+                        </note>
+                        </para></listitem>
                     <listitem><para><emphasis>Graphical and Eclipse Plug-In Extras:</emphasis>
                         Packages recommended if the host system has graphics
                         support or if you are going to use the Eclipse
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml 
b/documentation/yocto-project-qs/yocto-project-qs.xml
index b64e622..5100149 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -339,13 +339,33 @@
                         <literallayout class='monospaced'>
      $ sudo yum install &CENTOS_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm
                         </literallayout>
-                        <note>
-                            CentOS 6.x users need to ensure that the required
-                            versions of Git, tar and Python are available.
-                            For details, See the
-                            "<ulink url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required 
Git, tar, and Python Versions</ulink>"
-                            section in the Yocto Project Reference Manual for
-                            information.
+                        <note><title>Notes</title>
+                            <itemizedlist>
+                                <listitem><para>
+                                    CentOS 6.x users need to ensure that the
+                                    required versions of Git, tar and Python
+                                    are available.
+                                    For details, See the
+                                    "<ulink 
url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required Git, tar, and Python 
Versions</ulink>"
+                                    section in the Yocto Project Reference
+                                    Manual for information.
+                                    </para></listitem>
+                                <listitem><para>
+                                    Extra Packages for Enterprise Linux
+                                    (i.e. <filename>epel-release</filename>)
+                                    is a collection of packages from Fedora
+                                    built on RHEL/CentOS for easy installation
+                                    of packages not included in enterprise
+                                    Linux by default.
+                                    You need to install these packages
+                                    separately.
+                                    </para></listitem>
+                                <listitem><para>
+                                    The <filename>makecache</filename> command
+                                    consumes additional Metadata from
+                                    <filename>epel-release</filename>.
+                                    </para></listitem>
+                            </itemizedlist>
                         </note>
                         </para></listitem>
                 </itemizedlist>