From 6c2a07b36ef96ad7ba0b62e57dab7c0e4c84b609 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 15 Jul 2011 15:57:51 -0700 Subject: [PATCH] documentation/yocto-project-qs/yocto-project-qs.xml: Various Robert P. J. Day fixes Three issues pointed out by Robert P. J. Day. 1) Missing text for "This optional GNOME mobile-based UI, which is intended for devices with resolution but restricted size screens ..." I re-wrote this so it makes sense. 2) Scrubbed document for incorrect usage of openSUSE. There were three occurences. 3) Made several changes to the example of using a pre-built image. The arguments to the poky-qemu command did not exist (they were old). I used existing arguments now and I also bolstered up the root filesystem explanation a bit. (From yocto-docs rev: 31b7a97dfd11ff50ee6c554bf8647591021fef72) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../yocto-project-qs/yocto-project-qs.xml | 30 +++++++++++-------- 1 file changed, 18 insertions(+), 12 deletions(-) diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index 07d752c4c1..e59a1a77cd 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml @@ -102,8 +102,8 @@ Another important Yocto Project feature is the Sato reference User Interface. This optional GNOME mobile-based UI, which is intended for devices with - resolution but restricted size screens, sits neatly on top of a device using the - GNOME Mobile Stack providing a well-defined user experience. + restricted screen sizes, sits neatly on top of a device using the + GNOME Mobile Stack and provides a well-defined user experience. Implemented in its own layer, it makes it clear to developers how they can implement their own UIs on top of Yocto Linux. @@ -119,7 +119,7 @@ A host system running a supported Linux distribution (i.e. recent releases of - Fedora, OpenSUSE, Debian, and Ubuntu). + Fedora, openSUSE, Debian, and Ubuntu). For notes about using the Yocto Project on development systems that use older Linux distributions see @@ -145,7 +145,7 @@ Ubuntu Fedora - OpenSuse + openSUSE @@ -196,7 +196,7 @@ - The packages you need for an RPM-based host like Fedora and OpenSUSE, + The packages you need for an RPM-based host like Fedora and openSUSE, respectively, are as follows: @@ -471,15 +471,19 @@ - Most kernel files have the following form: + Most kernel files have one of the following forms: - *zImage*qemu<arch>*.bin + *zImage-<kernel-rev>-qemu<arch>*.bin + vmlinux-<kernel-rev>-<arch>*.bin Where: <arch> is a string representing the target architecture: x86, x86-64, ppc, mips, or arm. + + <kernel-rev> is the base Linux kernel revision + (e.g. 2.6.37). @@ -493,7 +497,7 @@ - yocto-image-<profile>-qemu<arch>.rootfs.ext3 + yocto-image-<profile>-qemu<arch>.rootfs.ext3.bz2 yocto-image-<profile>-qemu<arch>.rootfs.tar.bz2 Where: @@ -542,13 +546,15 @@ Continuing with the example, the following two commands setup the emulation - environment and launch QEMU. - The kernel and filesystem are for a 32-bit target architecture. + environment and launch QEMU. + This example assumes the root filesystem tarball has been downloaded and expanded, and + that the kernel and filesystem are for a 32-bit target architecture. - $ source /opt/poky/environment-setup-i686-poky-linux - $ poky-qemu qemux86 zImage-2.6.34-qemux86-1.0.bin yocto-image-sdk-qemux86-1.0.rootfs.ext3 + $ source /opt/poky/1.0/environment-setup-i686-poky-linux + $ poky-qemu qemux86 bzImage-2.6.37-qemux86-1.0.bin \ + yocto-image-sato-qemux86-1.0.rootfs.ext3