1 files changed, 168 insertions, 1 deletions
diff --git a/documentation/poky-ref-manual/introduction.xml b/documentation/poky-ref-manual/introduction.xml
index 71717e3d77..5f3fa962b9 100644
--- a/documentation/poky-ref-manual/introduction.xml
+++ b/documentation/poky-ref-manual/introduction.xml
@@ -87,10 +87,177 @@
 <section id='intro-requirements'>
 <title>System Requirements</title>
    <para>
-        For Yocto Project system requirements, see the
+        For general Yocto Project system requirements, see the
        <ulink url='&YOCTO_DOCS_QS_URL;#yp-resources'>
        What You Need and How You Get It</ulink> section in the Yocto Project Quick Start.
+        The remainder of this section provides details on system requirements
+        not covered in the Yocto Project Quick Start.
    </para>
+    <section id='detailed-supported-distros'>
+    <title>Supported Linux Distributions</title>
+        <para>
+            TBD - a list of very specific distros and versions. 
+            The list will be kept up-to-date via a script provided that can 
+            be run prior to a release. 
+            The scripts output will yield the list and it can be copied 
+            into this section.
+        </para>
+    </section>
+    <section id='required-packages-for-the-host-development-system'>
+    <title>Required Packages for the Host Development System</title>
+        <para>
+            The list of packages you need on the host development system can 
+            be large when covering all build scenarios using the Yocto Project. 
+            This section provides required packages by Linux distribution and 
+            further categorized by function.
+        </para>
+        <section id='ubuntu-packages'>
+            <title>Ubuntu</title>
+            <para>
+                The following list shows the required packages by function
+                given a supported Ubuntu Linux distribution:
+                <itemizedlist>
+                    <listitem><para><emphasis>Essentials:</emphasis>
+                        Packages needed to build an image for 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:
+                        <literallayout class='monospaced'>
+     $ sudo apt-get install libsdl1.2-dev xterm
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Documentation:</emphasis>
+                        Packages needed if you are going to build out the 
+                        Yocto Project documentation manuals:
+                        <literallayout class='monospaced'>
+     $ sudo apt-get install make xsltproc docbook-utils fop
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Application Development Extras:</emphasis>
+                        Packages needed if you are going to be developing 
+                        user-space applications:
+                        <literallayout class='monospaced'>
+     $ sudo apt-get install autoconf automake libtool libglib2.0-dev
+                        </literallayout></para></listitem>
+                </itemizedlist>
+            </para>
+        </section>
+        <section id='fedora-packages'>
+            <title>Fedora Packages</title>
+            <para>
+                The following list shows the required packages by function
+                given a supported Fedora Linux distribution:
+                <itemizedlist>
+                    <listitem><para><emphasis>Essentials:</emphasis>
+                        Packages needed to build an image for a headless 
+                        system:
+                        <literallayout class='monospaced'>
+     $ 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:
+                        <literallayout class='monospaced'>
+     $ sudo yum install SDL-devel xterm
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Documentation:</emphasis>
+                        Packages needed if you are going to build out the 
+                        Yocto Project documentation manuals:
+                        <literallayout class='monospaced'>
+     $ sudo yum install make docbook-style-dsssl docbook-style-xsl \
+     docbook-dtds docbook-utils fop libxslt
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Application Development Extras:</emphasis>
+                        Packages needed if you are going to be developing 
+                        user-space applications:
+                        <literallayout class='monospaced'>
+     $ sudo yum install autoconf automake libtool glib2-devel
+                        </literallayout></para></listitem>
+                </itemizedlist>
+            </para>
+        </section>
+        <section id='opensuse-packages'>
+            <title>OpenSUSE Packages</title>
+            <para>
+                The following list shows the required packages by function
+                given a supported OpenSUSE Linux distribution:
+                <itemizedlist>
+                    <listitem><para><emphasis>Essentials:</emphasis>
+                        Packages needed to build an image for a headless 
+                        system:
+                        <literallayout class='monospaced'>
+     $ 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:
+                        <literallayout class='monospaced'>
+     $ sudo zypper install libSDL-devel xterm
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Documentation:</emphasis>
+                        Packages needed if you are going to build out the 
+                        Yocto Project documentation manuals:
+                        <literallayout class='monospaced'>
+     $ sudo zypper install make fop xsltproc
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Application Development Extras:</emphasis>
+                        Packages needed if you are going to be developing 
+                        user-space applications:
+                        <literallayout class='monospaced'>
+     $ sudo zypper install autoconf automake libtool glib2-devel
+                        </literallayout></para></listitem>
+                </itemizedlist>
+            </para>
+        </section>
+        <section id='centos-packages'>
+            <title>CentOS Packages</title>
+            <para>
+                The following list shows the required packages by function
+                given a supported CentOS Linux distribution:
+                <itemizedlist>
+                    <listitem><para><emphasis>Essentials:</emphasis>
+                        Packages needed to build an image for a headless 
+                        system:
+                        <literallayout class='monospaced'>
+     $ 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:
+                        <literallayout class='monospaced'>
+     $ sudo yum -y install SDL-devel xterm
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Documentation:</emphasis>
+                        Packages needed if you are going to build out the 
+                        Yocto Project documentation manuals:
+                        <literallayout class='monospaced'>
+     $ sudo yum -y install make docbook-style-dsssl docbook-style-xsl \
+     docbook-dtds docbook-utils fop libxslt
+                        </literallayout></para></listitem>
+                    <listitem><para><emphasis>Application Development Extras:</emphasis>
+                        Packages needed if you are going to be developing 
+                        user-space applications:
+                        <literallayout class='monospaced'>
+     $ sudo yum -y install autoconf automake libtool glib2-devel
+                        </literallayout></para></listitem>
+                </itemizedlist>
+            </para>
+        </section>
+    </section>
 </section>
 <section id='intro-getit'>

diff --git a/documentation/poky-ref-manual/introduction.xml b/documentation/poky-ref-manual/introduction.xml index 71717e3d77..5f3fa962b9 100644 --- a/documentation/poky-ref-manual/introduction.xml +++ b/documentation/poky-ref-manual/introduction.xml
@@ -87,10 +87,177 @@
87	<section id='intro-requirements'>	87	<section id='intro-requirements'>
88	<title>System Requirements</title>	88	<title>System Requirements</title>
89	<para>	89	<para>
90	For Yocto Project system requirements, see the	90	For general Yocto Project system requirements, see the
91	<ulink url='&YOCTO_DOCS_QS_URL;#yp-resources'>	91	<ulink url='&YOCTO_DOCS_QS_URL;#yp-resources'>
92	What You Need and How You Get It</ulink> section in the Yocto Project Quick Start.	92	What You Need and How You Get It</ulink> section in the Yocto Project Quick Start.
		93	The remainder of this section provides details on system requirements
		94	not covered in the Yocto Project Quick Start.
93	</para>	95	</para>
		96
		97	<section id='detailed-supported-distros'>
		98	<title>Supported Linux Distributions</title>
		99
		100	<para>
		101	TBD - a list of very specific distros and versions.
		102	The list will be kept up-to-date via a script provided that can
		103	be run prior to a release.
		104	The scripts output will yield the list and it can be copied
		105	into this section.
		106	</para>
		107	</section>
		108
		109	<section id='required-packages-for-the-host-development-system'>
		110	<title>Required Packages for the Host Development System</title>
		111
		112	<para>
		113	The list of packages you need on the host development system can
		114	be large when covering all build scenarios using the Yocto Project.
		115	This section provides required packages by Linux distribution and
		116	further categorized by function.
		117	</para>
		118
		119	<section id='ubuntu-packages'>
		120	<title>Ubuntu</title>
		121
		122	<para>
		123	The following list shows the required packages by function
		124	given a supported Ubuntu Linux distribution:
		125	<itemizedlist>
		126	<listitem><para><emphasis>Essentials:</emphasis>
		127	Packages needed to build an image for a headless
		128	system:
		129	<literallayout class='monospaced'>
		130	$ sudo apt-get install &UBUNTU_HOST_PACKAGES_ESSENTIAL;
		131	</literallayout></para></listitem>
		132	<listitem><para><emphasis>Graphical Extras:</emphasis>
		133	Packages needed if you are going to have graphics
		134	support when you run the image:
		135	<literallayout class='monospaced'>
		136	$ sudo apt-get install libsdl1.2-dev xterm
		137	</literallayout></para></listitem>
		138	<listitem><para><emphasis>Documentation:</emphasis>
		139	Packages needed if you are going to build out the
		140	Yocto Project documentation manuals:
		141	<literallayout class='monospaced'>
		142	$ sudo apt-get install make xsltproc docbook-utils fop
		143	</literallayout></para></listitem>
		144	<listitem><para><emphasis>Application Development Extras:</emphasis>
		145	Packages needed if you are going to be developing
		146	user-space applications:
		147	<literallayout class='monospaced'>
		148	$ sudo apt-get install autoconf automake libtool libglib2.0-dev
		149	</literallayout></para></listitem>
		150	</itemizedlist>
		151	</para>
		152	</section>
		153
		154	<section id='fedora-packages'>
		155	<title>Fedora Packages</title>
		156
		157	<para>
		158	The following list shows the required packages by function
		159	given a supported Fedora Linux distribution:
		160	<itemizedlist>
		161	<listitem><para><emphasis>Essentials:</emphasis>
		162	Packages needed to build an image for a headless
		163	system:
		164	<literallayout class='monospaced'>
		165	$ sudo yum install &FEDORA_HOST_PACKAGES_ESSENTIAL;
		166	</literallayout></para></listitem>
		167	<listitem><para><emphasis>Graphical Extras:</emphasis>
		168	Packages needed if you are going to have graphics
		169	support when you run the image:
		170	<literallayout class='monospaced'>
		171	$ sudo yum install SDL-devel xterm
		172	</literallayout></para></listitem>
		173	<listitem><para><emphasis>Documentation:</emphasis>
		174	Packages needed if you are going to build out the
		175	Yocto Project documentation manuals:
		176	<literallayout class='monospaced'>
		177	$ sudo yum install make docbook-style-dsssl docbook-style-xsl \
		178	docbook-dtds docbook-utils fop libxslt
		179	</literallayout></para></listitem>
		180	<listitem><para><emphasis>Application Development Extras:</emphasis>
		181	Packages needed if you are going to be developing
		182	user-space applications:
		183	<literallayout class='monospaced'>
		184	$ sudo yum install autoconf automake libtool glib2-devel
		185	</literallayout></para></listitem>
		186	</itemizedlist>
		187	</para>
		188	</section>
		189
		190	<section id='opensuse-packages'>
		191	<title>OpenSUSE Packages</title>
		192
		193	<para>
		194	The following list shows the required packages by function
		195	given a supported OpenSUSE Linux distribution:
		196	<itemizedlist>
		197	<listitem><para><emphasis>Essentials:</emphasis>
		198	Packages needed to build an image for a headless
		199	system:
		200	<literallayout class='monospaced'>
		201	$ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL;
		202	</literallayout></para></listitem>
		203	<listitem><para><emphasis>Graphical Extras:</emphasis>
		204	Packages needed if you are going to have graphics
		205	support when you run the image:
		206	<literallayout class='monospaced'>
		207	$ sudo zypper install libSDL-devel xterm
		208	</literallayout></para></listitem>
		209	<listitem><para><emphasis>Documentation:</emphasis>
		210	Packages needed if you are going to build out the
		211	Yocto Project documentation manuals:
		212	<literallayout class='monospaced'>
		213	$ sudo zypper install make fop xsltproc
		214	</literallayout></para></listitem>
		215	<listitem><para><emphasis>Application Development Extras:</emphasis>
		216	Packages needed if you are going to be developing
		217	user-space applications:
		218	<literallayout class='monospaced'>
		219	$ sudo zypper install autoconf automake libtool glib2-devel
		220	</literallayout></para></listitem>
		221	</itemizedlist>
		222	</para>
		223	</section>
		224
		225	<section id='centos-packages'>
		226	<title>CentOS Packages</title>
		227
		228	<para>
		229	The following list shows the required packages by function
		230	given a supported CentOS Linux distribution:
		231	<itemizedlist>
		232	<listitem><para><emphasis>Essentials:</emphasis>
		233	Packages needed to build an image for a headless
		234	system:
		235	<literallayout class='monospaced'>
		236	$ sudo yum -y install &CENTOS_HOST_PACKAGES_ESSENTIAL;
		237	</literallayout></para></listitem>
		238	<listitem><para><emphasis>Graphical Extras:</emphasis>
		239	Packages needed if you are going to have graphics
		240	support when you run the image:
		241	<literallayout class='monospaced'>
		242	$ sudo yum -y install SDL-devel xterm
		243	</literallayout></para></listitem>
		244	<listitem><para><emphasis>Documentation:</emphasis>
		245	Packages needed if you are going to build out the
		246	Yocto Project documentation manuals:
		247	<literallayout class='monospaced'>
		248	$ sudo yum -y install make docbook-style-dsssl docbook-style-xsl \
		249	docbook-dtds docbook-utils fop libxslt
		250	</literallayout></para></listitem>
		251	<listitem><para><emphasis>Application Development Extras:</emphasis>
		252	Packages needed if you are going to be developing
		253	user-space applications:
		254	<literallayout class='monospaced'>
		255	$ sudo yum -y install autoconf automake libtool glib2-devel
		256	</literallayout></para></listitem>
		257	</itemizedlist>
		258	</para>
		259	</section>
		260	</section>
94	</section>	261	</section>
95		262
96	<section id='intro-getit'>	263	<section id='intro-getit'>