summaryrefslogtreecommitdiffstats
path: root/documentation/yocto-project-qs
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-10 15:21:40 +0100
commit6915004b1873edaef0d679c02a42ad8b420a886d (patch)
treecc86bee84f28086a72c3c54abefbf98b7501dad8 /documentation/yocto-project-qs
parent90d45f4264c7dabdcf90a1310c9bf98644637fab (diff)
downloadpoky-6915004b1873edaef0d679c02a42ad8b420a886d.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/yocto-project-qs')
-rw-r--r--documentation/yocto-project-qs/yocto-project-qs.xml97
1 files changed, 40 insertions, 57 deletions
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index bfb5d4ee16..a025895843 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -211,94 +211,77 @@
211 <title>The Packages</title> 211 <title>The Packages</title>
212 212
213 <para> 213 <para>
214 Packages and package installation vary depending on your development system. 214 Packages and package installation vary depending on your development system
215 In general, you need to have root access and then install the required packages. 215 and on your intent.
216 The next few sections show you how to get set up with the right packages for 216 For example, if you want to build an image that can run
217 Ubuntu, Fedora, openSUSE, and CentOS. 217 on QEMU in graphical mode (a minimal, basic build
218 requirement), then the number of packages is different than if you want to
219 build an image for a headless system or build out the Yocto Project
220 documentation set.
221 Collectively, the number of required packages is large
222 if you want to be able to cover all cases.
223 <note>In general, you need to have root access and then install the
224 required packages.</note>
218 </para> 225 </para>
219 226
227 <para>
228 The next few sections list, by supported Linux Distributions, the required
229 packages needed to build an image that runs on QEMU in graphical mode
230 (e.g. essential plus graphics support).
231 </para>
232
233 <para>
234 For lists of required packages for other scenarios, see the
235 "<ulink url='&YOCTO_DOCS_REF_URL;#required-packages-for-the-host-development-system'>Required Packages for the Host Development System</ulink>"
236 section in the Yocto Project Reference Manual.
237 </para>
238
220 <section id='ubuntu'> 239 <section id='ubuntu'>
221 <title>Ubuntu</title> 240 <title>Ubuntu</title>
222 241
223 <para> 242 <para>
224 The packages you need for a supported Ubuntu distribution are shown in the following command: 243 The essential packages you need for a supported Ubuntu distribution
225 </para> 244 are shown in the following command:
226
227 <literallayout class='monospaced'> 245 <literallayout class='monospaced'>
228 $ sudo apt-get install sed wget subversion git-core coreutils \ 246 $ sudo apt-get install &UBUNTU_HOST_PACKAGES_ESSENTIAL; libsdl1.2-dev xterm
229 unzip texi2html texinfo libsdl1.2-dev docbook-utils fop gawk \
230 python-pysqlite2 diffstat make gcc build-essential xsltproc \
231 g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev \
232 autoconf automake groff libtool xterm libxml-parser-perl dblatex
233 </literallayout> 247 </literallayout>
248 </para>
234 </section> 249 </section>
235 250
236 <section id='fedora'> 251 <section id='fedora'>
237 <title>Fedora</title> 252 <title>Fedora</title>
238 253
239 <para> 254 <para>
240 The packages you need for a supported Fedora distribution are shown in the following 255 The essential packages you need for a supported Fedora distribution
241 commands: 256 are shown in the following commands:
242 </para>
243
244 <literallayout class='monospaced'> 257 <literallayout class='monospaced'>
245 $ sudo yum groupinstall "development tools" 258 $ sudo yum install &FEDORA_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm
246 $ sudo yum install python m4 make wget curl ftp tar bzip2 gzip \
247 unzip perl texinfo texi2html diffstat openjade \
248 docbook-style-dsssl sed docbook-style-xsl docbook-dtds fop libxslt \
249 docbook-utils sed bc eglibc-devel ccache pcre pcre-devel quilt \
250 groff linuxdoc-tools patch cmake \
251 perl-ExtUtils-MakeMaker tcl-devel gettext chrpath ncurses apr \
252 SDL-devel mesa-libGL-devel mesa-libGLU-devel gnome-doc-utils \
253 autoconf automake libtool xterm dblatex glib-gettextize
254 </literallayout> 259 </literallayout>
255 260 </para>
256 </section> 261 </section>
257 262
258 <section id='opensuse'> 263 <section id='opensuse'>
259 <title>openSUSE</title> 264 <title>openSUSE</title>
260 265
261 <para> 266 <para>
262 The packages you need for a supported openSUSE distribution are shown in the following 267 The essential packages you need for a supported openSUSE
263 command: 268 distribution are shown in the following command:
264 </para>
265
266 <literallayout class='monospaced'> 269 <literallayout class='monospaced'>
267 $ sudo zypper install python gcc gcc-c++ libtool fop \ 270 $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL; libSDL-devel xterm
268 subversion git chrpath automake make wget xsltproc \
269 diffstat texinfo freeglut-devel libSDL-devel dblatex \
270 python-curses
271 </literallayout> 271 </literallayout>
272 </para>
272 </section> 273 </section>
273 274
274 <section id='centos'> 275 <section id='centos'>
275 <title>CentOS</title> 276 <title>CentOS</title>
276 277
277 <para> 278 <para>
278 The packages you need for a supported CentOS distribution are shown in the following 279 The essential packages you need for a supported CentOS
279 commands: 280 distribution are shown in the following commands:
280 </para>
281
282 <literallayout class='monospaced'> 281 <literallayout class='monospaced'>
283 $ sudo yum -y groupinstall "development tools" 282 $ sudo yum -y install &CENTOS_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm
284 $ sudo yum -y install tetex gawk sqlite-devel vim-common redhat-lsb xz \
285 m4 make wget curl ftp tar bzip2 gzip python-devel \
286 unzip perl texinfo texi2html diffstat openjade zlib-devel \
287 docbook-style-dsssl sed docbook-style-xsl docbook-dtds \
288 docbook-utils bc glibc-devel pcre pcre-devel \
289 groff linuxdoc-tools patch cmake \
290 tcl-devel gettext ncurses apr \
291 SDL-devel mesa-libGL-devel mesa-libGLU-devel gnome-doc-utils \
292 autoconf automake libtool xterm dblatex
293 </literallayout> 283 </literallayout>
294 <note><para> 284 </para>
295 Depending on the CentOS version you are using, other requirements and dependencies
296 might exist.
297 For details, you should look at the CentOS sections on the
298 <ulink url='&YOCTO_WIKI_URL;/wiki/Poky/GettingStarted/Dependencies'>Poky/GettingStarted/Dependencies</ulink>
299 wiki page.
300 </para></note>
301
302 </section> 285 </section>
303 </section> 286 </section>
304 287