Skip to contentSkip to conversation

Quick STart updates

PATCH New [email protected] 1 participant 7 messages Mar 18, 2011

lore
Share & tools
lore
#0 lore raw

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(-)
#1 lore raw

PATCH 1/6 - documentation/yocto-project-qs/yocto-project-qs.xml: added groff package

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
index 14c3f90..c2e019a 100644
@@ -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
#2 lore raw

PATCH 2/6 documentation/yocto-project-qs/style.css: Updated styles

In reply to [email protected]

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
index 2abfa7b..8b0c034 100644
@@ -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
#3 lore raw

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
index 8b0c034..21caf85 100644
@@ -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
#4 lore raw

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
index c2e019a..c481d5f 100644
@@ -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:
          &lt;<emphasis>host_system</emphasis>&gt; is a string representing your development system: 
-                i586 or x86_64.
+                i686 or x86_64.
        
          &lt;<emphasis>arch</emphasis>&gt; is a string representing the target architecture: 
-                i585, x86_64, powerpc, mips, or arm.
+                i686, x86_64, powerpc, mips, or arm.
        
          &lt;<emphasis>release</emphasis>&gt; 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:
          &lt;<emphasis>arch</emphasis>&gt; is a string representing the target architecture: 
-                i586, x86_64, ppc603e, mips, or armv5te.
+                i686, x86_64, ppc603e, mips, or armv5te.
 
          &lt;<emphasis>if</emphasis>&gt; 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 &lt;<emphasis>qemuarch</emphasis>&gt; &lt;<emphasis>kernel</emphasis>&gt; &lt;<emphasis>image</emphasis>&gt; &lt;<emphasis>fstype</emphasis>&gt;
+     $ poky-qemu &lt;<emphasis>qemuarch</emphasis>&gt; &lt;<emphasis>kernel</emphasis>&gt; &lt;<emphasis>filesystem_image</emphasis>&gt;
 
      Where:
          &lt;<emphasis>qemuarch</emphasis>&gt; is a string representing the target architecture: qemux86, qemux86-64, 
                     qemuppc, qemumips, or qemuarm.
 
-         &lt;<emphasis>kernel</emphasis>&gt;    is the architecture-specific kernel.
+         &lt;<emphasis>kernel</emphasis>&gt; is the architecture-specific kernel.
 
-         &lt;<emphasis>image</emphasis>&gt;     is the .ext3 filesystem image.
+         &lt;<emphasis>filesystem_image</emphasis>&gt; is the .ext3 filesystem image.
 
-         &lt;<emphasis>fstype</emphasis>&gt;    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
#5 lore raw

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
index c481d5f..62e9e6b 100644
@@ -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
#6 lore raw

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
index 62e9e6b..4cb50a5 100644
@@ -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