All of lore.kernel.org
 help / color / mirror / Atom feed
* [yocto-docs][PATCH 00/11] Misc documentation updates
@ 2012-10-01 18:05 Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 01/11] documentation/poky-ref-manual: the G in GPL is "General" Paul Eggleton
                   ` (10 more replies)
  0 siblings, 11 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

The following changes since commit a85840611650c9124b6194acca59c8bfe71f566c:

  documentation: dev-manual - trademark added and reference updated. (2012-10-01 09:27:42 -0700)

are available in the git repository at:

  git://git.yoctoproject.org/poky-contrib paule/doc-fixes-4
  http://git.yoctoproject.org/cgit.cgi/poky-contrib/log/?h=paule/doc-fixes-4

Paul Eggleton (11):
  documentation/poky-ref-manual: the G in GPL is "General"
  documentation/poky-ref-manual: add staticdev-pkgs
  documentation/poky-ref-manual: add SDKIMAGE_FEATURES
  documentation/poky-ref-manual: minor improvements
  documentation/poky-ref-manual: remove reference to Ubuntu Intrepid
  documentation: update for current netbase version
  documentation/dev-manual: clarify section on updating PR
  documentation/poky-ref-manual: update FAQ for adding a new board
  documentation/poky-ref-manual: update FAQ on stability
  documentation/poky-ref-manual: clarify FAQ on products using the
    system
  documentation/poky-ref-manual: update FAQ for Poky

 documentation/bsp-guide/bsp.xml                    |    2 +-
 .../dev-manual/dev-manual-common-tasks.xml         |    7 +-
 documentation/dev-manual/dev-manual-newbie.xml     |    2 +-
 documentation/poky-ref-manual/faq.xml              |   74 +++++++-------------
 documentation/poky-ref-manual/ref-features.xml     |    2 +
 documentation/poky-ref-manual/ref-images.xml       |    4 +-
 documentation/poky-ref-manual/ref-variables.xml    |   27 ++++---
 documentation/poky-ref-manual/usingpoky.xml        |    6 +-
 8 files changed, 57 insertions(+), 67 deletions(-)

-- 
1.7.9.5



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

* [yocto-docs][PATCH 01/11] documentation/poky-ref-manual: the G in GPL is "General"
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 02/11] documentation/poky-ref-manual: add staticdev-pkgs Paul Eggleton
                   ` (9 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/ref-images.xml |    4 ++--
 documentation/poky-ref-manual/usingpoky.xml  |    6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/documentation/poky-ref-manual/ref-images.xml b/documentation/poky-ref-manual/ref-images.xml
index 096f4b5..79f2409 100644
--- a/documentation/poky-ref-manual/ref-images.xml
+++ b/documentation/poky-ref-manual/ref-images.xml
@@ -12,8 +12,8 @@
     </para>
 
     <note>
-        Building an image without GNU Public License Version 3 (GPLv3) components is 
-        only supported for minimal and base images.
+        Building an image without GNU General Public License Version 3 (GPLv3) components
+        is only supported for minimal and base images.
         Furthermore, if you are going to build an image using non-GPLv3 components,
         you must make the following changes in the <filename>local.conf</filename> file
         before using the BitBake command to build the minimal or base image:
diff --git a/documentation/poky-ref-manual/usingpoky.xml b/documentation/poky-ref-manual/usingpoky.xml
index 817aa2f..18bd8b7 100644
--- a/documentation/poky-ref-manual/usingpoky.xml
+++ b/documentation/poky-ref-manual/usingpoky.xml
@@ -66,8 +66,8 @@
         </para>
 
         <note>
-            Building an image without GNU Public License Version 3 (GPLv3) components is 
-            only supported for minimal and base images.
+            Building an image without GNU General Public License Version 3 (GPLv3) components
+            is only supported for minimal and base images.
             See the "<link linkend='ref-images'>Images</link>" chapter for more information.
         </note>
     </section>
@@ -78,7 +78,7 @@
         <para>
             When building an image using GPL components, you need to maintain your original 
             settings and not switch back and forth applying different versions of the GNU
-            Public License.  
+            General Public License.  
             If you rebuild using different versions of GPL, dependency errors might occur
             due to some components not being rebuilt.
         </para>
-- 
1.7.9.5



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

* [yocto-docs][PATCH 02/11] documentation/poky-ref-manual: add staticdev-pkgs
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 01/11] documentation/poky-ref-manual: the G in GPL is "General" Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 03/11] documentation/poky-ref-manual: add SDKIMAGE_FEATURES Paul Eggleton
                   ` (8 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Document the new staticdev-pkgs IMAGE_FEATURES item.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/ref-features.xml |    2 ++
 1 file changed, 2 insertions(+)

diff --git a/documentation/poky-ref-manual/ref-features.xml b/documentation/poky-ref-manual/ref-features.xml
index 1540475..da54379 100644
--- a/documentation/poky-ref-manual/ref-features.xml
+++ b/documentation/poky-ref-manual/ref-features.xml
@@ -161,6 +161,8 @@
                 <listitem><para><emphasis>nfs-server:</emphasis> Installs an NFS server.</para></listitem>
                 <listitem><para><emphasis>dev-pkgs:</emphasis> Installs development packages (headers and 
                     extra library links) for all packages installed in a given image.</para></listitem>
+                <listitem><para><emphasis>staticdev-pkgs:</emphasis> Installs static development packages (static
+                    libraries i.e .a files) for all packages installed in a given image.</para></listitem>
                 <listitem><para><emphasis>dbg-pkgs:</emphasis> Installs debug symbol packages for all packages 
                     installed in a given image.</para></listitem>
                 <listitem><para><emphasis>doc-pkgs:</emphasis> Installs documentation packages for all packages 
-- 
1.7.9.5



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

* [yocto-docs][PATCH 03/11] documentation/poky-ref-manual: add SDKIMAGE_FEATURES
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 01/11] documentation/poky-ref-manual: the G in GPL is "General" Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 02/11] documentation/poky-ref-manual: add staticdev-pkgs Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 04/11] documentation/poky-ref-manual: minor improvements Paul Eggleton
                   ` (7 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Add new SDKIMAGE_FEATURES to variable reference.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/ref-variables.xml |   10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 2ea1122..49bed9c 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -1868,6 +1868,16 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-SDKIMAGE_FEATURES'><glossterm>SDKIMAGE_FEATURES</glossterm>
+            <glossdef>
+                <para>Equivalent to 
+                <filename><link linkend='var-IMAGE_FEATURES'>IMAGE_FEATURES</link></filename>
+                except it applies to the SDK generated from an image (using 
+                <filename>bitbake -c populate_sdk imagename</filename>).
+                </para>
+            </glossdef>
+        </glossentry>
+
         <glossentry id='var-SECTION'><glossterm>SECTION</glossterm>
             <glossdef>
                 <para>The section where package should be put.
-- 
1.7.9.5



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

* [yocto-docs][PATCH 04/11] documentation/poky-ref-manual: minor improvements
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (2 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 03/11] documentation/poky-ref-manual: add SDKIMAGE_FEATURES Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 05/11] documentation/poky-ref-manual: remove reference to Ubuntu Intrepid Paul Eggleton
                   ` (6 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Adjust a few sentences so that they make sense.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/ref-variables.xml |   17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 49bed9c..af1a194 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -797,12 +797,13 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \
 
         <glossentry id='var-IMAGE_FEATURES'><glossterm>IMAGE_FEATURES</glossterm>
             <glossdef>
-                <para>The list of features present in images.
-                Typically, you configure this variable in image recipes.
-                Note that you can add extra features to the image by using the
+                <para>The list of features to include in an images.
+                Typically, you configure this variable in an image recipe.
+                Note that you can also add extra features to the image by using the
                 <filename><link linkend='var-EXTRA_IMAGE_FEATURES'>EXTRA_IMAGE_FEATURES</link></filename> variable.
                 See the "<link linkend="ref-features-image">Images</link>" section for the 
-                list of features present in images built by the OpenEmbedded build system.</para>
+                full list of features which can be included in images built by the
+                OpenEmbedded build system.</para>
             </glossdef>
         </glossentry>
 
@@ -1880,8 +1881,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
         <glossentry id='var-SECTION'><glossterm>SECTION</glossterm>
             <glossdef>
-                <para>The section where package should be put.
-                    Package managers use this variable.</para>
+                <para>The section in which packages should be categorised.
+                    Package management utilities may make use of this variable.</para>
             </glossdef>
         </glossentry>
 
@@ -1918,7 +1919,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             <glossdef>
                 <para>
                     Specifies the endian byte order of the target system. 
-                    The variable is either "le" for little-endian or "be" for big-endian.
+                    The value should be either "le" for little-endian or "be" for big-endian.
                 </para>
             </glossdef>
         </glossentry>
@@ -1927,7 +1928,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             <glossdef>
                 <para>
                     Specifies the number of bits for the target system CPU.
-                    The variable is either "32" or "64".
+                    The value should be either "32" or "64".
                 </para>
             </glossdef>
         </glossentry>
-- 
1.7.9.5



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

* [yocto-docs][PATCH 05/11] documentation/poky-ref-manual: remove reference to Ubuntu Intrepid
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (3 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 04/11] documentation/poky-ref-manual: minor improvements Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 06/11] documentation: update for current netbase version Paul Eggleton
                   ` (5 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

We haven't supported Ubuntu Intrepid (8.04) for some time now.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/faq.xml |   22 ----------------------
 1 file changed, 22 deletions(-)

diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml
index 825ea8b..4a17313 100644
--- a/documentation/poky-ref-manual/faq.xml
+++ b/documentation/poky-ref-manual/faq.xml
@@ -310,28 +310,6 @@
     <qandaentry>
         <question>
             <para>
-                I'm using Ubuntu Intrepid and am seeing build failures. What’s wrong?
-            </para>
-        </question>
-        <answer>
-            <para>
-	            In Intrepid, Ubuntu turns on by default the normally optional compile-time security features 
-		        and warnings. 
-                There are more details at 
-                <ulink url='https://wiki.ubuntu.com/CompilerFlags'>https://wiki.ubuntu.com/CompilerFlags</ulink>.
-		        You can work around this problem by disabling those options by adding 
-                the following to the <filename>BUILD_CPPFLAGS</filename> variable in the
-                <filename>conf/bitbake.conf</filename> file.
-                <literallayout class='monospaced'>
-     " -Wno-format-security -U_FORTIFY_SOURCE" 
-                </literallayout>
-            </para>
-        </answer>
-    </qandaentry>
-
-    <qandaentry>
-        <question>
-            <para>
                 What’s the difference between <filename>foo</filename> and <filename>foo-native</filename>?
             </para>
         </question>
-- 
1.7.9.5



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

* [yocto-docs][PATCH 06/11] documentation: update for current netbase version
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (4 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 05/11] documentation/poky-ref-manual: remove reference to Ubuntu Intrepid Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 07/11] documentation/dev-manual: clarify section on updating PR Paul Eggleton
                   ` (4 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Update references to the netbase recipe to the current version (5.0).

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/bsp-guide/bsp.xml       |    2 +-
 documentation/poky-ref-manual/faq.xml |    2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index 5bfa9fb..91b1be0 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -871,7 +871,7 @@
            <para>
                To better understand this, consider an example that customizes a recipe by adding 
                a BSP-specific configuration file named <filename>interfaces</filename> to the 
-               <filename>netbase_4.47.bb</filename> recipe for machine "xyz".
+               <filename>netbase_5.0.bb</filename> recipe for machine "xyz".
                Do the following:
                <orderedlist>
                    <listitem><para>Edit the <filename>netbase_4.47.bbappend</filename> file so that it 
diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml
index 4a17313..54c4763 100644
--- a/documentation/poky-ref-manual/faq.xml
+++ b/documentation/poky-ref-manual/faq.xml
@@ -399,7 +399,7 @@
                 For example, add the following files to your layer:
                 <literallayout class='monospaced'>
      meta-MACHINE/recipes-bsp/netbase/netbase/MACHINE/interfaces
-     meta-MACHINE/recipes-bsp/netbase/netbase_4.44.bbappend
+     meta-MACHINE/recipes-bsp/netbase/netbase_5.0.bbappend
                 </literallayout>
             </para>
         </answer>
-- 
1.7.9.5



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

* [yocto-docs][PATCH 07/11] documentation/dev-manual: clarify section on updating PR
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (5 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 06/11] documentation: update for current netbase version Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 08/11] documentation/poky-ref-manual: update FAQ for adding a new board Paul Eggleton
                   ` (3 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Setting PR = "r0" isn't mandatory, but is recommended. Also, there isn't
really any restriction on its format.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 .../dev-manual/dev-manual-common-tasks.xml         |    7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 8d053b3..62e3e61 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1538,11 +1538,10 @@
             <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PR'>PR</ulink></filename> 
             variable needs to be increased 
             (or "bumped") as part of that commit. 
-            This means that for new recipes you must be sure to add the <filename>PR</filename>
+            For new recipes you should add the <filename>PR</filename>
             variable and set its initial value equal to "r0".  
-            Failing to define <filename>PR</filename> makes it easy to miss when you bump a package.
-            Note that you can only use integer values following the "r" in the 
-            <filename>PR</filename> variable.
+            This is the default value, however, adding it initially makes 
+            it harder to miss bumping it when you make changes in future.
         </para>
 
         <para>
-- 
1.7.9.5



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

* [yocto-docs][PATCH 08/11] documentation/poky-ref-manual: update FAQ for adding a new board
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (6 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 07/11] documentation/dev-manual: clarify section on updating PR Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 09/11] documentation/poky-ref-manual: update FAQ on stability Paul Eggleton
                   ` (2 subsequent siblings)
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Since we are using a layer-based approach, people do not need to rely
upon us to add support for new boards.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/faq.xml |   12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml
index 54c4763..d31691e 100644
--- a/documentation/poky-ref-manual/faq.xml
+++ b/documentation/poky-ref-manual/faq.xml
@@ -91,13 +91,11 @@
         </question>
         <answer>
             <para>
-                There are two main ways to get a board supported in the Yocto Project;
-                <itemizedlist>
-                    <listitem><para>Send the Yocto Project team information on the board
-                        and if the team does not have it yet they will consider adding it.</para></listitem>
-                    <listitem><para>Send the Yocto Project team the BitBake recipes if you have them.
-                        </para></listitem>
-                </itemizedlist>
+                Support for an additional board is added by creating a BSP layer for it.
+                For more information on how to create a BSP layer, please see the
+                <ulink url='&YOCTO_DOCS_BSP_URL;'>BSP Guide</ulink>.
+            </para>
+            <para>
                 Usually, if the board is not completely exotic, adding support in 
                 the Yocto Project is fairly straightforward.
             </para>
-- 
1.7.9.5



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

* [yocto-docs][PATCH 09/11] documentation/poky-ref-manual: update FAQ on stability
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (7 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 08/11] documentation/poky-ref-manual: update FAQ for adding a new board Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 10/11] documentation/poky-ref-manual: clarify FAQ on products using the system Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 11/11] documentation/poky-ref-manual: update FAQ for Poky Paul Eggleton
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

* Explain that we test with a set of reference hardware rather than only
  supporting hardware that we have (avoiding any implication that the
  build system can't support other devices).
* Adjust the language so that it is OE-Core friendly, with a link to
  the Development Manual for the definition of OE-Core.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/dev-manual/dev-manual-newbie.xml |    2 +-
 documentation/poky-ref-manual/faq.xml          |   14 ++++++++------
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 50ef624..ccd29e2 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -304,7 +304,7 @@
             <listitem><para id='metadata'><emphasis>Metadata:</emphasis> The files that BitBake parses when 
                 building an image. 
                 Metadata includes recipes, classes, and configuration files.</para></listitem>
-            <listitem><para><emphasis>OE-Core:</emphasis> A core set of metadata originating 
+            <listitem><para id='oe-core'><emphasis>OE-Core:</emphasis> A core set of metadata originating 
                 with OpenEmbedded (OE) that is shared between OE and the Yocto Project.
                 This metadata is found in the <filename>meta</filename> directory of the source
                 directory.</para></listitem>
diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml
index d31691e..5da820b 100644
--- a/documentation/poky-ref-manual/faq.xml
+++ b/documentation/poky-ref-manual/faq.xml
@@ -63,7 +63,7 @@
     <qandaentry>
         <question>
             <para>
-                How can you claim Poky is stable?
+                How can you claim Poky / OpenEmbedded-Core is stable?
             </para>
         </question>
         <answer>
@@ -71,11 +71,13 @@
                 There are three areas that help with stability;
                 <itemizedlist>
                     <listitem><para>The Yocto Project team keeps 
-                        <ulink url='&YOCTO_DOCS_DEV_URL;#poky'>Poky</ulink> small and focused.
-                        It contains around 650 packages as compared to over 5000 for full 
-                        OpenEmbedded.</para></listitem>
-                    <listitem><para>The Yocto Project only supports hardware that the 
-                        team has access to for testing.</para></listitem>
+                        <ulink url='&YOCTO_DOCS_DEV_URL;#oe-core'>OE-Core</ulink> small
+                        and focused, containing around 830 recipes as opposed to the thousands
+                        available in other OpenEmbedded community layers; this makes it easy to
+                        test and maintain.</para></listitem>
+                    <listitem><para>The Yocto Project team runs manual and automated tests 
+                        using a small, fixed set of reference hardware as well as emulated
+                        targets.</para></listitem>
                     <listitem><para>The Yocto Project uses an an autobuilder,
                         which provides continuous build and integration tests.</para></listitem>
                 </itemizedlist>
-- 
1.7.9.5



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

* [yocto-docs][PATCH 10/11] documentation/poky-ref-manual: clarify FAQ on products using the system
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (8 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 09/11] documentation/poky-ref-manual: update FAQ on stability Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  2012-10-01 18:05 ` [yocto-docs][PATCH 11/11] documentation/poky-ref-manual: update FAQ for Poky Paul Eggleton
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Adjust language slightly so that it reads correctly, and avoid
conflating the terms OpenEmbedded and Poky.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/faq.xml |    8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml
index 5da820b..ad8fc7a 100644
--- a/documentation/poky-ref-manual/faq.xml
+++ b/documentation/poky-ref-manual/faq.xml
@@ -107,15 +107,15 @@
     <qandaentry>
         <question>
             <para>
-                Are there any products using the OpenEmbedded build system (poky)?
+                Are there any products built using the OpenEmbedded build system?
             </para>
         </question>
         <answer>
             <para>
-                The <ulink url='http://vernier.com/labquest/'>Vernier LabQuest</ulink> is using 
-                the OpenEmbedded build system.  
+                The software running on the <ulink url='http://vernier.com/labquest/'>Vernier LabQuest</ulink>
+                is built using the OpenEmbedded build system.  
                 See the <ulink url='http://www.vernier.com/products/interfaces/labq/'>Vernier LabQuest</ulink>
-                for more information.
+                website for more information.
                 There are a number of pre-production devices using the OpenEmbedded build system 
                 and the Yocto Project team
                 announces them as soon as they are released.
-- 
1.7.9.5



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

* [yocto-docs][PATCH 11/11] documentation/poky-ref-manual: update FAQ for Poky
  2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
                   ` (9 preceding siblings ...)
  2012-10-01 18:05 ` [yocto-docs][PATCH 10/11] documentation/poky-ref-manual: clarify FAQ on products using the system Paul Eggleton
@ 2012-10-01 18:05 ` Paul Eggleton
  10 siblings, 0 replies; 12+ messages in thread
From: Paul Eggleton @ 2012-10-01 18:05 UTC (permalink / raw)
  To: Scott Rifenbark, yocto

Ensure that this section correctly and accurately describes how Poky and
OE relate to eachother currently.

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
---
 documentation/poky-ref-manual/faq.xml |   16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml
index ad8fc7a..ab36f42 100644
--- a/documentation/poky-ref-manual/faq.xml
+++ b/documentation/poky-ref-manual/faq.xml
@@ -13,14 +13,14 @@
         </question>
         <answer>
             <para>
-                The term "Poky" is sometimes used to refer to the build system that the 
-                Yocto Project uses.  
-                The build system used in the Yocto project is referred to as the 
-                OpenEmbedded build system because "Poky" was derived from <ulink 
-                url='&OE_HOME_URL;'>OpenEmbedded</ulink>.
-                Poky is a stable, smaller subset focused on the mobile environment. 
-                Development in the Yocto Project using Poky is closely tied to OpenEmbedded with 
-                features being merged regularly between the two for mutual benefit.
+                The term "Poky" refers to the specific reference build system that
+                the Yocto Project provides; Poky is based upon 
+                <ulink url='&YOCTO_DOCS_DEV_URL;#oe-core'>OE-Core</ulink>
+                and BitBake and thus the generic term used here for the build system is
+                the OpenEmbedded build system.
+                Development in the Yocto Project using Poky is closely tied to OpenEmbedded, with 
+                changes always being merged to OE-Core or BitBake first before being pulled back
+                into Poky, benefiting both projects immediately.
                 For a fuller description of the term "Poky", see the 
                 <ulink url='&YOCTO_DOCS_DEV_URL;#poky'>poky</ulink> term in the Yocto Project
                 Development Manual.
-- 
1.7.9.5



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

end of thread, other threads:[~2012-10-01 18:05 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2012-10-01 18:05 [yocto-docs][PATCH 00/11] Misc documentation updates Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 01/11] documentation/poky-ref-manual: the G in GPL is "General" Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 02/11] documentation/poky-ref-manual: add staticdev-pkgs Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 03/11] documentation/poky-ref-manual: add SDKIMAGE_FEATURES Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 04/11] documentation/poky-ref-manual: minor improvements Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 05/11] documentation/poky-ref-manual: remove reference to Ubuntu Intrepid Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 06/11] documentation: update for current netbase version Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 07/11] documentation/dev-manual: clarify section on updating PR Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 08/11] documentation/poky-ref-manual: update FAQ for adding a new board Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 09/11] documentation/poky-ref-manual: update FAQ on stability Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 10/11] documentation/poky-ref-manual: clarify FAQ on products using the system Paul Eggleton
2012-10-01 18:05 ` [yocto-docs][PATCH 11/11] documentation/poky-ref-manual: update FAQ for Poky Paul Eggleton

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.