summaryrefslogtreecommitdiffstats
path: root/documentation/poky-ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2012-10-02 12:20:51 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2012-10-04 14:08:16 +0100
commit1eb01b66614912aa8fad63349953c3a7da6da4cc (patch)
treef64f337d40c8469d10541368ea95107c98db8ec9 /documentation/poky-ref-manual
parent528b0fe3479b5e2592564e6cfb67c821f3700a23 (diff)
downloadpoky-1eb01b66614912aa8fad63349953c3a7da6da4cc.tar.gz
documentation: yocto-project-qs, yocto-project-ref - package re-org
Reorganization of the packages section in the YP Quick Start. These are now ordered still by distro but the listed packages have been culled down to just the needed ones to run an image on QEMU with graphical support. A corresponding section in the reference manual now provides the comprehensive list of packages for all supported distros. The section in the reference manual is broken down by distro and by function. Finally, four new variables were introduced to track the essential packages for each of the distros. The variables are defined in poky.ent and follow the form <distro>_HOST_PACKAGES_ESSENTIAL. This will make it so we don't have to maintain this list of essential packages in multiple places. Reported-by: Paul Eggleton <paul.eggleton@intel.com> (From yocto-docs rev: 839b441791980db82f4795454e976e606b486d25) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/poky-ref-manual')
-rw-r--r--documentation/poky-ref-manual/introduction.xml169
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 @@
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'>