Quick STart updates
cover Quick STart updates
From: Scott Rifenbark <[email protected]>
UPdtates to the QS inculding style sheet, example changes (these were guesses), FAQ reference for proxy issue.
Pull URL: git://git.pokylinux.org/poky-contrib.git
Branch: srifenbark/qs-work
Browse: http://git.pokylinux.org/cgit.cgi/poky-contrib/log/?h=srifenbark/qs-work
Thanks,
<[email protected]>
---
Scott Rifenbark (6):
[BUGID# 857] - documentation/yocto-project-qs/yocto-project-qs.xml:
added groff package
documentation/yocto-project-qs/style.css: Updated styles documentation/yocto-project-qs/style.css: Updated note text color documentation/yocto-project-qs/yocto-project-qs.xml: 1.0 edits
applied to examples
documentation/yocto-project-qs/yocto-project-qs.xml: Added references
to FAQs
documentation/yocto-project-qs/yocto-project-qs.xml: Note added about
proxy
documentation/yocto-project-qs/style.css | 23 ++++--- .../yocto-project-qs/yocto-project-qs.xml | 63 ++++++++++++------- 2 files changed, 54 insertions(+), 32 deletions(-)
PATCH 2/6 documentation/yocto-project-qs/style.css: Updated styles
From: Scott Rifenbark <[email protected]>
I updated the style sheet to use Yocto blue for the headings and got rid of the green tip and note stuff. This style matches the other style sheet now.
--- documentation/yocto-project-qs/style.css | 22 ++++++++++++++-------- 1 files changed, 14 insertions(+), 8 deletions(-)
documentation/yocto-project-qs/style.css +14 -8
@@ -50,9 +50,13 @@ body { color: #333; } +.reviewer { + color: red; +} + h1,h2,h3,h4,h5,h6,h7 { font-family: Arial, Sans; - color:#999999; + color: #00557D; clear: both; }
@@ -76,7 +80,7 @@ h2 { margin: 2em 0em 0.66em 0em; padding: 0.5em 0em 0em 0em; font-size: 1.5em; - font-weight: normal; + font-weight: bold; } h3.subtitle {
@@ -90,28 +94,28 @@ h3 { margin: 1em 0em 0.5em 0em; padding: 1em 0em 0em 0em; font-size: 140%; - font-weight: normal; + font-weight: bold; } h4 { margin: 1em 0em 0.5em 0em; padding: 1em 0em 0em 0em; font-size: 120%; - font-weight: normal; + font-weight: bold; } h5 { margin: 1em 0em 0.5em 0em; padding: 1em 0em 0em 0em; - font-size: 110.000%; - border-bottom: 1px solid black; + font-size: 110%; + font-weight: bold; } h6 { margin: 1em 0em 0em 0em; padding: 1em 0em 0em 0em; font-size: 80%; - font-weight: normal; + font-weight: bold; } .authorgroup {
@@ -132,6 +136,7 @@ h3.author { padding: 0em 0em 0em 0em; font-weight: normal; font-size: 100%; + color: #333; clear: both; }
@@ -154,6 +159,7 @@ h3.author { .list-of-examples, .list-of-figures { padding: 1.33em 0em 2.5em 0em; + color: #00557D; } .toc p,
@@ -941,7 +947,7 @@ table { .tip, .note { - background: #91ae35; + background: #666666; color: #fff; padding: 20px; margin: 20px;
Signature · 1 line
1.7.1
PATCH 3/6 documentation/yocto-project-qs/style.css: Updated note text color
In reply to [email protected]From: Scott Rifenbark <[email protected]>
Had to update the note and tip text color to white to match other books.
--- documentation/yocto-project-qs/style.css | 1 - 1 files changed, 0 insertions(+), 1 deletions(-)
documentation/yocto-project-qs/style.css +0 -1
@@ -247,7 +247,6 @@ div.legalnotice p.legalnotice-title { p { line-height: 1.5em; margin-top: 0em; - color: black; font-size: 100%; }
Signature · 1 line
1.7.1
PATCH 4/6 documentation/yocto-project-qs/yocto-project-qs.xml: 1.0 edits applied to examples
In reply to [email protected]From: Scott Rifenbark <[email protected]>
This is first guess at the correct example commands and directory names for the Bernard 5.0 release. I don't have any real directories available to look at and doc changes are supposed to be frozen before the actual build. So these are guesses and will need reviewed.
--- .../yocto-project-qs/yocto-project-qs.xml | 42 ++++++++++---------- 1 files changed, 21 insertions(+), 21 deletions(-)
documentation/yocto-project-qs/yocto-project-qs.xml +21 -21
@@ -176,7 +176,7 @@ <para> The latest release images for the Yocto Project are kept at - <ulink url="http://yoctoproject.org/downloads/yocto-0.9/"></ulink>. + <ulink url="http://yoctoproject.org/downloads/yocto-1.0/"></ulink>. Nightly and developmental builds are also maintained. However, for this document a released version of Yocto Project is used. </para>
@@ -230,9 +230,9 @@ <para> <literallayout class='monospaced'> - $ wget http://www.yoctoproject.org/downloads/poky/poky-laverne-4.0.tar.bz2 - $ tar xjf poky-laverne-4.0.tar.bz2 - $ source poky-laverne-4.0/poky-init-build-env poky-4.0-build + $ wget http://www.yoctoproject.org/downloads/poky/poky-bernard-5.0.tar.bz2 + $ tar xjf poky-bernard-5.0.tar.bz2 + $ source poky-bernard-5.0/poky-init-build-env poky-5.0-build </literallayout> </para>
@@ -250,8 +250,8 @@ <listitem><para>The first two commands extract the Yocto Project files from the release tarball and place them into a subdirectory of your current directory.</para></listitem> <listitem><para>The <command>source</command> command creates the - <filename>poky-4.0-build</filename> directory and executes the <command>cd</command> - command to make <filename>poky-4.0-build</filename> the working directory. + <filename>poky-5.0-build</filename> directory and executes the <command>cd</command> + command to make <filename>poky-5.0-build</filename> the working directory. The resulting build directory contains all the files created during the build. By default the target architecture is qemux86. To change this default, edit the value of the MACHINE variable in the
@@ -353,9 +353,10 @@ <title>Installing the Toolchain</title> <para> You can download the pre-built toolchain, which includes the poky-qemu script and - support files, from <ulink url='http://yoctoproject.org/downloads/yocto-0.9/toolchain/'></ulink>. + support files, from + <ulink url='http://yoctoproject.org/downloads/yocto-1.0/toolchain/'></ulink>. Toolchains are available for 32-bit and 64-bit development systems from the - <filename>i586</filename> and <filename>x86_64</filename> folders, respectively. + <filename>i686</filename> and <filename>x86_64</filename> folders, respectively. Each type of development system supports five target architectures. The tarball files are named such that a string representing the host system appears first in the filename and then is immediately followed by a string representing
@@ -367,10 +368,10 @@ Where: <<emphasis>host_system</emphasis>> is a string representing your development system: - i586 or x86_64. + i686 or x86_64. <<emphasis>arch</emphasis>> is a string representing the target architecture: - i585, x86_64, powerpc, mips, or arm. + i686, x86_64, powerpc, mips, or arm. <<emphasis>release</emphasis>> is the version of Yocto Project. </literallayout>
@@ -381,7 +382,7 @@ </para> <literallayout class='monospaced'> - yocto-eglibc-x86_64-i586-toolchain-sdk-0.9.tar.bz2 + yocto-eglibc-x86_64-i686-toolchain-sdk-1.0.tar.bz2 </literallayout> <para>
@@ -393,7 +394,7 @@ <para> <literallayout class='monospaced'> $ cd / - $ sudo tar -xvjf yocto-eglibc-x86_64-i586-toolchain-sdk-0.9.tar.bz2 + $ sudo tar -xvjf yocto-eglibc-x86_64-i686-toolchain-sdk-1.0.tar.bz2 </literallayout> </para> </section>
@@ -403,7 +404,7 @@ <para> You can download the pre-built Linux kernel and the filesystem image suitable for running in the emulator QEMU from - <ulink url='http://yoctoproject.org/downloads/yocto-0.9/qemu'></ulink>. + <ulink url='http://yoctoproject.org/downloads/yocto-1.0/machines/qemu'></ulink>. Be sure to use the kernel and filesystem image that matches the architecture you want to simulate. </para>
@@ -455,10 +456,10 @@ Where: <<emphasis>arch</emphasis>> is a string representing the target architecture: - i586, x86_64, ppc603e, mips, or armv5te. + i686, x86_64, ppc603e, mips, or armv5te. <<emphasis>if</emphasis>> is a string representing an embedded application binary interface. - Not all setup scripts include this string. + Not all setup scripts include this string. </literallayout> <para>
@@ -466,17 +467,16 @@ </para> <literallayout class='monospaced'> - $ poky-qemu <<emphasis>qemuarch</emphasis>> <<emphasis>kernel</emphasis>> <<emphasis>image</emphasis>> <<emphasis>fstype</emphasis>> + $ poky-qemu <<emphasis>qemuarch</emphasis>> <<emphasis>kernel</emphasis>> <<emphasis>filesystem_image</emphasis>> Where: <<emphasis>qemuarch</emphasis>> is a string representing the target architecture: qemux86, qemux86-64, qemuppc, qemumips, or qemuarm. - <<emphasis>kernel</emphasis>> is the architecture-specific kernel. + <<emphasis>kernel</emphasis>> is the architecture-specific kernel. - <<emphasis>image</emphasis>> is the .ext3 filesystem image. + <<emphasis>filesystem_image</emphasis>> is the .ext3 filesystem image. - <<emphasis>fstype</emphasis>> is the filesystem type. </literallayout> <para>
@@ -486,8 +486,8 @@ </para> <literallayout class='monospaced'> - $ source /opt/poky/environment-setup-i586-poky-linux - $ poky-qemu qemui586 zImage-2.6.34-qemux86-0.9 yocto-image-sdk-qemux86-0.9.rootfs.ext3 ext3 + $ 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 </literallayout> <para>
Signature · 1 line
1.7.1
PATCH 5/6 documentation/yocto-project-qs/yocto-project-qs.xml: Added references to FAQs
In reply to [email protected]From: Scott Rifenbark <[email protected]>
In the beginning of the manual I added references to the FAQs we support.
--- .../yocto-project-qs/yocto-project-qs.xml | 9 ++++++++- 1 files changed, 8 insertions(+), 1 deletions(-)
documentation/yocto-project-qs/yocto-project-qs.xml +8 -1
@@ -26,11 +26,18 @@ and run it using the QEMU emulator. </para> <para> - For complete information on the Yocto Project you should check out the + For complete information on the Yocto Project, you should check out the <ulink url='http://www.yoctoproject.org'>Yocto Project Website</ulink>. You can find the latest builds, breaking news, full development documentation, and a rich Yocto Project Development Community into which you can tap. </para> + <para> + Finally, you might find the Frequently Asked Questions (FAQ) for the Yocto Project + at <ulink url='https://wiki.yoctoproject.org/wiki/FAQ'>Yocto Project FAQ</ulink> and + the FAQ appendix located in the + <ulink url='http://www.yoctoproject.org/docs/poky-ref-manual/poky-ref-manual.html'> + Poky Reference Manual</ulink> helpful. + </para> </section> <section id='yp-intro'>
Signature · 1 line
1.7.1
PATCH 1/6 - documentation/yocto-project-qs/yocto-project-qs.xml: added groff package
In reply to [email protected]From: Scott Rifenbark <[email protected]>
[BUGID# 857] In the packages section for the list of Debian-based system package requirements I added 'groff'.
--- .../yocto-project-qs/yocto-project-qs.xml | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-)
documentation/yocto-project-qs/yocto-project-qs.xml +1 -1
@@ -142,7 +142,7 @@ unzip texi2html texinfo libsdl1.2-dev docbook-utils gawk \ python-pysqlite2 diffstat help2man make gcc build-essential \ g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev \ - mercurial autoconf automake + mercurial autoconf automake groff </literallayout> <para>
Signature · 1 line
1.7.1
PATCH 6/6 documentation/yocto-project-qs/yocto-project-qs.xml: Note added about proxy
In reply to [email protected]From: Scott Rifenbark <[email protected]>
I added a note to reference the FAQ entry in the Poky manual that describes how to get around proxy and firewall stuff hanging up getting the source code during a build.
--- .../yocto-project-qs/yocto-project-qs.xml | 10 ++++++++++ 1 files changed, 10 insertions(+), 0 deletions(-)
documentation/yocto-project-qs/yocto-project-qs.xml +10 -0
@@ -235,6 +235,16 @@ recommend having at least 100GB of free disk space. </para></note> + <note><para> + By default, Poky searches for source code using a pre-determined order + through a set of locations. + If you encounter problems with Poky finding and downloading source code, see + the FAQ entry "How does Poky obtain source code and will it work behind my + firewall or proxy server?" in the + <ulink url='http://www.yoctoproject.org/docs/poky-ref-manual/poky-ref-manual.html'> + Poky Reference Manual</ulink>. + </para></note> + <para> <literallayout class='monospaced'> $ wget http://www.yoctoproject.org/downloads/poky/poky-bernard-5.0.tar.bz2
Signature · 1 line
1.7.1