Poky Project Discussions
 help / color / mirror / Atom feed
* [PATCH 0/6] [DOCS] Quick STart updates
@ 2011-03-18 17:31 scott.m.rifenbark
  2011-03-18 17:31 ` [PATCH 1/6] [BUGID# 857] - documentation/yocto-project-qs/yocto-project-qs.xml: added groff package scott.m.rifenbark
                   ` (5 more replies)
  0 siblings, 6 replies; 7+ messages in thread
From: scott.m.rifenbark @ 2011-03-18 17:31 UTC (permalink / raw)
  To: poky

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

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,
     <scott.m.rifenbark@intel.com>
---


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(-)



^ permalink raw reply	[flat|nested] 7+ messages in thread

* [PATCH 1/6] [BUGID# 857] - documentation/yocto-project-qs/yocto-project-qs.xml: added groff package
  2011-03-18 17:31 [PATCH 0/6] [DOCS] Quick STart updates scott.m.rifenbark
@ 2011-03-18 17:31 ` scott.m.rifenbark
  2011-03-18 17:31 ` [PATCH 2/6] documentation/yocto-project-qs/style.css: Updated styles scott.m.rifenbark
                   ` (4 subsequent siblings)
  5 siblings, 0 replies; 7+ messages in thread
From: scott.m.rifenbark @ 2011-03-18 17:31 UTC (permalink / raw)
  To: poky

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

[BUGID# 857] In the packages section for the list of Debian-based system package
requirements I added 'groff'.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 .../yocto-project-qs/yocto-project-qs.xml          |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index 14c3f90..c2e019a 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -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>
-- 
1.7.1



^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH 2/6] documentation/yocto-project-qs/style.css: Updated styles
  2011-03-18 17:31 [PATCH 0/6] [DOCS] Quick STart updates scott.m.rifenbark
  2011-03-18 17:31 ` [PATCH 1/6] [BUGID# 857] - documentation/yocto-project-qs/yocto-project-qs.xml: added groff package scott.m.rifenbark
@ 2011-03-18 17:31 ` scott.m.rifenbark
  2011-03-18 17:31 ` [PATCH 3/6] documentation/yocto-project-qs/style.css: Updated note text color scott.m.rifenbark
                   ` (3 subsequent siblings)
  5 siblings, 0 replies; 7+ messages in thread
From: scott.m.rifenbark @ 2011-03-18 17:31 UTC (permalink / raw)
  To: poky

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

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.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 documentation/yocto-project-qs/style.css |   22 ++++++++++++++--------
 1 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/documentation/yocto-project-qs/style.css b/documentation/yocto-project-qs/style.css
index 2abfa7b..8b0c034 100644
--- a/documentation/yocto-project-qs/style.css
+++ b/documentation/yocto-project-qs/style.css
@@ -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;
-- 
1.7.1



^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH 3/6] documentation/yocto-project-qs/style.css: Updated note text color
  2011-03-18 17:31 [PATCH 0/6] [DOCS] Quick STart updates scott.m.rifenbark
  2011-03-18 17:31 ` [PATCH 1/6] [BUGID# 857] - documentation/yocto-project-qs/yocto-project-qs.xml: added groff package scott.m.rifenbark
  2011-03-18 17:31 ` [PATCH 2/6] documentation/yocto-project-qs/style.css: Updated styles scott.m.rifenbark
@ 2011-03-18 17:31 ` scott.m.rifenbark
  2011-03-18 17:31 ` [PATCH 4/6] documentation/yocto-project-qs/yocto-project-qs.xml: 1.0 edits applied to examples scott.m.rifenbark
                   ` (2 subsequent siblings)
  5 siblings, 0 replies; 7+ messages in thread
From: scott.m.rifenbark @ 2011-03-18 17:31 UTC (permalink / raw)
  To: poky

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

Had to update the note and tip text color to white to match other
books.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 documentation/yocto-project-qs/style.css |    1 -
 1 files changed, 0 insertions(+), 1 deletions(-)

diff --git a/documentation/yocto-project-qs/style.css b/documentation/yocto-project-qs/style.css
index 8b0c034..21caf85 100644
--- a/documentation/yocto-project-qs/style.css
+++ b/documentation/yocto-project-qs/style.css
@@ -247,7 +247,6 @@ div.legalnotice p.legalnotice-title {
 p {
   line-height: 1.5em;
   margin-top: 0em;
-  color: black; font-size: 100%;
   
 }
 
-- 
1.7.1



^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH 4/6] documentation/yocto-project-qs/yocto-project-qs.xml: 1.0 edits applied to examples
  2011-03-18 17:31 [PATCH 0/6] [DOCS] Quick STart updates scott.m.rifenbark
                   ` (2 preceding siblings ...)
  2011-03-18 17:31 ` [PATCH 3/6] documentation/yocto-project-qs/style.css: Updated note text color scott.m.rifenbark
@ 2011-03-18 17:31 ` scott.m.rifenbark
  2011-03-18 17:32 ` [PATCH 5/6] documentation/yocto-project-qs/yocto-project-qs.xml: Added references to FAQs scott.m.rifenbark
  2011-03-18 17:32 ` [PATCH 6/6] documentation/yocto-project-qs/yocto-project-qs.xml: Note added about proxy scott.m.rifenbark
  5 siblings, 0 replies; 7+ messages in thread
From: scott.m.rifenbark @ 2011-03-18 17:31 UTC (permalink / raw)
  To: poky

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

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.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 .../yocto-project-qs/yocto-project-qs.xml          |   42 ++++++++++----------
 1 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index c2e019a..c481d5f 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -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>
-- 
1.7.1



^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH 5/6] documentation/yocto-project-qs/yocto-project-qs.xml: Added references to FAQs
  2011-03-18 17:31 [PATCH 0/6] [DOCS] Quick STart updates scott.m.rifenbark
                   ` (3 preceding siblings ...)
  2011-03-18 17:31 ` [PATCH 4/6] documentation/yocto-project-qs/yocto-project-qs.xml: 1.0 edits applied to examples scott.m.rifenbark
@ 2011-03-18 17:32 ` scott.m.rifenbark
  2011-03-18 17:32 ` [PATCH 6/6] documentation/yocto-project-qs/yocto-project-qs.xml: Note added about proxy scott.m.rifenbark
  5 siblings, 0 replies; 7+ messages in thread
From: scott.m.rifenbark @ 2011-03-18 17:32 UTC (permalink / raw)
  To: poky

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

In the beginning of the manual I added references to the FAQs we
support.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 .../yocto-project-qs/yocto-project-qs.xml          |    9 ++++++++-
 1 files changed, 8 insertions(+), 1 deletions(-)

diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index c481d5f..62e9e6b 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -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'>
-- 
1.7.1



^ permalink raw reply related	[flat|nested] 7+ messages in thread

* [PATCH 6/6] documentation/yocto-project-qs/yocto-project-qs.xml: Note added about proxy
  2011-03-18 17:31 [PATCH 0/6] [DOCS] Quick STart updates scott.m.rifenbark
                   ` (4 preceding siblings ...)
  2011-03-18 17:32 ` [PATCH 5/6] documentation/yocto-project-qs/yocto-project-qs.xml: Added references to FAQs scott.m.rifenbark
@ 2011-03-18 17:32 ` scott.m.rifenbark
  5 siblings, 0 replies; 7+ messages in thread
From: scott.m.rifenbark @ 2011-03-18 17:32 UTC (permalink / raw)
  To: poky

From: Scott Rifenbark <scott.m.rifenbark@intel.com>

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.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
---
 .../yocto-project-qs/yocto-project-qs.xml          |   10 ++++++++++
 1 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index 62e9e6b..4cb50a5 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -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
-- 
1.7.1



^ permalink raw reply related	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2011-03-18 17:31 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-03-18 17:31 [PATCH 0/6] [DOCS] Quick STart updates scott.m.rifenbark
2011-03-18 17:31 ` [PATCH 1/6] [BUGID# 857] - documentation/yocto-project-qs/yocto-project-qs.xml: added groff package scott.m.rifenbark
2011-03-18 17:31 ` [PATCH 2/6] documentation/yocto-project-qs/style.css: Updated styles scott.m.rifenbark
2011-03-18 17:31 ` [PATCH 3/6] documentation/yocto-project-qs/style.css: Updated note text color scott.m.rifenbark
2011-03-18 17:31 ` [PATCH 4/6] documentation/yocto-project-qs/yocto-project-qs.xml: 1.0 edits applied to examples scott.m.rifenbark
2011-03-18 17:32 ` [PATCH 5/6] documentation/yocto-project-qs/yocto-project-qs.xml: Added references to FAQs scott.m.rifenbark
2011-03-18 17:32 ` [PATCH 6/6] documentation/yocto-project-qs/yocto-project-qs.xml: Note added about proxy scott.m.rifenbark

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox