documentation: poky-ref-manual, yocto-project-qs - Updates to packages

A few edits to the respective sections that talk about required
packages.  Some wording changes for headless and graphics
supported systems.  Also, re-inserted the note about older
CentOS systems.

Reported-by Paul Eggleton <paul.eggleton>
(From yocto-docs rev: 112370758cf41104ff04c4996d4a432e6bd54be1)

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

2 files changed, 36 insertions, 15 deletions

diff --git a/documentation/poky-ref-manual/introduction.xml b/documentation/poky-ref-manual/introduction.xml
index 5f3fa962b9..1f3f4ec442 100644
--- a/documentation/poky-ref-manual/introduction.xml
+++ b/documentation/poky-ref-manual/introduction.xml
@@ -124,14 +124,13 @@
                 given a supported Ubuntu Linux distribution:
                 <itemizedlist>
                     <listitem><para><emphasis>Essentials:</emphasis>
-                        Packages needed to build an image for a headless 
+                        Packages needed to build an image on a headless 
                         system:
                         <literallayout class='monospaced'>
      $ sudo apt-get install &UBUNTU_HOST_PACKAGES_ESSENTIAL;
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Graphical Extras:</emphasis>
-                        Packages needed if you are going to have graphics 
-                        support when you run the image:
+                        Packages recommended if the host system has graphics support:
                         <literallayout class='monospaced'>
      $ sudo apt-get install libsdl1.2-dev xterm
                         </literallayout></para></listitem>
@@ -143,7 +142,10 @@
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Application Development Extras:</emphasis>
                         Packages needed if you are going to be developing 
-                        user-space applications:
+                        user-space applications. 
+                        In particular, you are using the 
+                        <ulink url='&YOCTO_DOCS_ADT_URL;#adt-intro-section'>Application Development Toolkit (ADT)</ulink>
+                        or the <ulink url='&YOCTO_DOCS_ADT_URL;#using-the-adt-installer'>ADT Installer</ulink>:
                         <literallayout class='monospaced'>
      $ sudo apt-get install autoconf automake libtool libglib2.0-dev
                         </literallayout></para></listitem>
@@ -165,8 +167,7 @@
      $ sudo yum install &FEDORA_HOST_PACKAGES_ESSENTIAL;
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Graphical Extras:</emphasis>
-                        Packages needed if you are going to have graphics 
-                        support when you run the image:
+                        Packages recommended if the host system has graphics support:
                         <literallayout class='monospaced'>
      $ sudo yum install SDL-devel xterm
                         </literallayout></para></listitem>
@@ -179,7 +180,10 @@
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Application Development Extras:</emphasis>
                         Packages needed if you are going to be developing 
-                        user-space applications:
+                        user-space applications. 
+                        In particular, you are using the 
+                        <ulink url='&YOCTO_DOCS_ADT_URL;#adt-intro-section'>Application Development Toolkit (ADT)</ulink>
+                        or the <ulink url='&YOCTO_DOCS_ADT_URL;#using-the-adt-installer'>ADT Installer</ulink>:
                         <literallayout class='monospaced'>
      $ sudo yum install autoconf automake libtool glib2-devel
                         </literallayout></para></listitem>
@@ -201,8 +205,7 @@
      $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL;
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Graphical Extras:</emphasis>
-                        Packages needed if you are going to have graphics 
-                        support when you run the image:
+                        Packages recommended if the host system has graphics support:
                         <literallayout class='monospaced'>
      $ sudo zypper install libSDL-devel xterm
                         </literallayout></para></listitem>
@@ -214,7 +217,10 @@
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Application Development Extras:</emphasis>
                         Packages needed if you are going to be developing 
-                        user-space applications:
+                        user-space applications. 
+                        In particular, you are using the 
+                        <ulink url='&YOCTO_DOCS_ADT_URL;#adt-intro-section'>Application Development Toolkit (ADT)</ulink>
+                        or the <ulink url='&YOCTO_DOCS_ADT_URL;#using-the-adt-installer'>ADT Installer</ulink>:
                         <literallayout class='monospaced'>
      $ sudo zypper install autoconf automake libtool glib2-devel
                         </literallayout></para></listitem>
@@ -236,8 +242,7 @@
      $ sudo yum -y install &CENTOS_HOST_PACKAGES_ESSENTIAL;
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Graphical Extras:</emphasis>
-                        Packages needed if you are going to have graphics 
-                        support when you run the image:
+                        Packages recommended if the host system has graphics support:
                         <literallayout class='monospaced'>
      $ sudo yum -y install SDL-devel xterm
                         </literallayout></para></listitem>
@@ -250,11 +255,19 @@
                         </literallayout></para></listitem>
                     <listitem><para><emphasis>Application Development Extras:</emphasis>
                         Packages needed if you are going to be developing 
-                        user-space applications:
+                        user-space applications. 
+                        In particular, you are using the 
+                        <ulink url='&YOCTO_DOCS_ADT_URL;#adt-intro-section'>Application Development Toolkit (ADT)</ulink>
+                        or the <ulink url='&YOCTO_DOCS_ADT_URL;#using-the-adt-installer'>ADT Installer</ulink>:
                         <literallayout class='monospaced'>
      $ 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>
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index a025895843..ca6f65bf00 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -216,12 +216,15 @@
             For example, if you want to build an image that can run
             on QEMU in graphical mode (a minimal, basic build
             requirement), then the number of packages is different than if you want to
-            build an image for a headless system or build out the Yocto Project
+            build an image on a headless system or build out the Yocto Project
             documentation set. 
             Collectively, the number of required packages is large
             if you want to be able to cover all cases.
             <note>In general, you need to have root access and then install the 
-                required packages.</note>
+                required packages.
+                Thus, the commands in the following section may or may not work 
+                depending on whether or not your Linux distribution has 
+                <filename>sudo</filename> installed.</note>
         </para>
 
         <para>
@@ -281,6 +284,11 @@
                 <literallayout class='monospaced'>
      $ sudo yum -y install &CENTOS_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm
                 </literallayout>
+                <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>