From 1eb01b66614912aa8fad63349953c3a7da6da4cc Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 2 Oct 2012 12:20:51 -0700 Subject: [PATCH] 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 _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 (From yocto-docs rev: 839b441791980db82f4795454e976e606b486d25) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../poky-ref-manual/introduction.xml | 169 +++++++++++++++++- documentation/poky.ent | 7 + .../yocto-project-qs/yocto-project-qs.xml | 97 +++++----- 3 files changed, 215 insertions(+), 58 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 @@
System Requirements - For Yocto Project system requirements, see the + For general Yocto Project system requirements, see the What You Need and How You Get It 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. + +
+ Supported Linux Distributions + + + 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. + +
+ +
+ Required Packages for the Host Development System + + + 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. + + +
+ Ubuntu + + + The following list shows the required packages by function + given a supported Ubuntu Linux distribution: + + Essentials: + Packages needed to build an image for a headless + system: + + $ sudo apt-get install &UBUNTU_HOST_PACKAGES_ESSENTIAL; + + Graphical Extras: + Packages needed if you are going to have graphics + support when you run the image: + + $ sudo apt-get install libsdl1.2-dev xterm + + Documentation: + Packages needed if you are going to build out the + Yocto Project documentation manuals: + + $ sudo apt-get install make xsltproc docbook-utils fop + + Application Development Extras: + Packages needed if you are going to be developing + user-space applications: + + $ sudo apt-get install autoconf automake libtool libglib2.0-dev + + + +
+ +
+ Fedora Packages + + + The following list shows the required packages by function + given a supported Fedora Linux distribution: + + Essentials: + Packages needed to build an image for a headless + system: + + $ sudo yum install &FEDORA_HOST_PACKAGES_ESSENTIAL; + + Graphical Extras: + Packages needed if you are going to have graphics + support when you run the image: + + $ sudo yum install SDL-devel xterm + + Documentation: + Packages needed if you are going to build out the + Yocto Project documentation manuals: + + $ sudo yum install make docbook-style-dsssl docbook-style-xsl \ + docbook-dtds docbook-utils fop libxslt + + Application Development Extras: + Packages needed if you are going to be developing + user-space applications: + + $ sudo yum install autoconf automake libtool glib2-devel + + + +
+ +
+ OpenSUSE Packages + + + The following list shows the required packages by function + given a supported OpenSUSE Linux distribution: + + Essentials: + Packages needed to build an image for a headless + system: + + $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL; + + Graphical Extras: + Packages needed if you are going to have graphics + support when you run the image: + + $ sudo zypper install libSDL-devel xterm + + Documentation: + Packages needed if you are going to build out the + Yocto Project documentation manuals: + + $ sudo zypper install make fop xsltproc + + Application Development Extras: + Packages needed if you are going to be developing + user-space applications: + + $ sudo zypper install autoconf automake libtool glib2-devel + + + +
+ +
+ CentOS Packages + + + The following list shows the required packages by function + given a supported CentOS Linux distribution: + + Essentials: + Packages needed to build an image for a headless + system: + + $ sudo yum -y install &CENTOS_HOST_PACKAGES_ESSENTIAL; + + Graphical Extras: + Packages needed if you are going to have graphics + support when you run the image: + + $ sudo yum -y install SDL-devel xterm + + Documentation: + Packages needed if you are going to build out the + Yocto Project documentation manuals: + + $ sudo yum -y install make docbook-style-dsssl docbook-style-xsl \ + docbook-dtds docbook-utils fop libxslt + + Application Development Extras: + Packages needed if you are going to be developing + user-space applications: + + $ sudo yum -y install autoconf automake libtool glib2-devel + + + +
+
diff --git a/documentation/poky.ent b/documentation/poky.ent index 6eb9d9aacf..8e0af71fa2 100644 --- a/documentation/poky.ent +++ b/documentation/poky.ent @@ -48,3 +48,10 @@ + + + + + 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 @@ The Packages - Packages and package installation vary depending on your development system. - In general, you need to have root access and then install the required packages. - The next few sections show you how to get set up with the right packages for - Ubuntu, Fedora, openSUSE, and CentOS. + Packages and package installation vary depending on your development system + and on your intent. + 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 + documentation set. + Collectively, the number of required packages is large + if you want to be able to cover all cases. + In general, you need to have root access and then install the + required packages. - + + + The next few sections list, by supported Linux Distributions, the required + packages needed to build an image that runs on QEMU in graphical mode + (e.g. essential plus graphics support). + + + + For lists of required packages for other scenarios, see the + "Required Packages for the Host Development System" + section in the Yocto Project Reference Manual. + +
Ubuntu - The packages you need for a supported Ubuntu distribution are shown in the following command: - - + The essential packages you need for a supported Ubuntu distribution + are shown in the following command: - $ sudo apt-get install sed wget subversion git-core coreutils \ - unzip texi2html texinfo libsdl1.2-dev docbook-utils fop gawk \ - python-pysqlite2 diffstat make gcc build-essential xsltproc \ - g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev \ - autoconf automake groff libtool xterm libxml-parser-perl dblatex + $ sudo apt-get install &UBUNTU_HOST_PACKAGES_ESSENTIAL; libsdl1.2-dev xterm +
Fedora - The packages you need for a supported Fedora distribution are shown in the following - commands: - - + The essential packages you need for a supported Fedora distribution + are shown in the following commands: - $ sudo yum groupinstall "development tools" - $ sudo yum install python m4 make wget curl ftp tar bzip2 gzip \ - unzip perl texinfo texi2html diffstat openjade \ - docbook-style-dsssl sed docbook-style-xsl docbook-dtds fop libxslt \ - docbook-utils sed bc eglibc-devel ccache pcre pcre-devel quilt \ - groff linuxdoc-tools patch cmake \ - perl-ExtUtils-MakeMaker tcl-devel gettext chrpath ncurses apr \ - SDL-devel mesa-libGL-devel mesa-libGLU-devel gnome-doc-utils \ - autoconf automake libtool xterm dblatex glib-gettextize + $ sudo yum install &FEDORA_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm - +
openSUSE - The packages you need for a supported openSUSE distribution are shown in the following - command: - - + The essential packages you need for a supported openSUSE + distribution are shown in the following command: - $ sudo zypper install python gcc gcc-c++ libtool fop \ - subversion git chrpath automake make wget xsltproc \ - diffstat texinfo freeglut-devel libSDL-devel dblatex \ - python-curses + $ sudo zypper install &OPENSUSE_HOST_PACKAGES_ESSENTIAL; libSDL-devel xterm +
CentOS - The packages you need for a supported CentOS distribution are shown in the following - commands: - - + The essential packages you need for a supported CentOS + distribution are shown in the following commands: - $ sudo yum -y groupinstall "development tools" - $ sudo yum -y install tetex gawk sqlite-devel vim-common redhat-lsb xz \ - m4 make wget curl ftp tar bzip2 gzip python-devel \ - unzip perl texinfo texi2html diffstat openjade zlib-devel \ - docbook-style-dsssl sed docbook-style-xsl docbook-dtds \ - docbook-utils bc glibc-devel pcre pcre-devel \ - groff linuxdoc-tools patch cmake \ - tcl-devel gettext ncurses apr \ - SDL-devel mesa-libGL-devel mesa-libGLU-devel gnome-doc-utils \ - autoconf automake libtool xterm dblatex + $ sudo yum -y install &CENTOS_HOST_PACKAGES_ESSENTIAL; SDL-devel xterm - - 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 - Poky/GettingStarted/Dependencies - wiki page. - - +