[gnome-continuous-yocto/gnomeostree-3.28-rocko: 6994/8267] dev-manual: Added steps to set up native linux host

[Emmanuele Bassi <ebassi src gnome org>]

commit 38ee8ae87614f790cbdd79137451994c28b69b05
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Thu Jul 20 08:14:00 2017 -0700

    dev-manual: Added steps to set up native linux host
    
    Fixes [YOCTO #11630]
    
    Added content for steps to set up a native Linux host for using
    the Yocto Project.
    
    (From yocto-docs rev: d8a18d382c584dbdfa7f5f190a92cc7cde0f9601)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/dev-manual/dev-manual-start.xml |   77 +++++++++++++++---------
 1 files changed, 48 insertions(+), 29 deletions(-)
---
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index e70d79e..1332a26 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -20,30 +20,23 @@
     <para>
         This section provides procedures to set up your development host to
         use the Yocto Project.
-        For a Linux system to use the Yocto Project, you need to be sure
-        you are running a supported Linux distribution and have the proper
-        host packages installed.
-        If you are using
-        <ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>
-        that leverages
+        You can use the Yocto Project on a native Linux development host or
+        you can use
+        <ulink url='https://git.yoctoproject.org/cgit/cgit.cgi/crops/about/'>CROPS</ulink>,
+        which leverages
         <ulink url='https://www.docker.com/'>Docker Containers</ulink>,
-        host setup differs from that of a native Linux machine.
+        to prepare any Linux, Mac, or Windows development host.
     </para>
 
     <section id='setting-up-a-native-linux-host'>
         <title>Setting Up a Native Linux Host</title>
 
-        <para role='writernotes'>
-            Need text - Following is some basics for a Linux host system.
-            This information needs to be worked in.
-        </para>
-
         <para>
-            Setup consists of making sure you have a supported operating system,
-            installing host packages, and Here is what you need to use the Yocto Project:
-            <itemizedlist>
+            Follow these steps to prepare a native Linux machine as your
+            Yocto Project development host:
+            <orderedlist>
                 <listitem><para>
-                    <emphasis>Host System:</emphasis>
+                    <emphasis>Use a Supported Linux Distribution:</emphasis>
                     You should have a reasonably current Linux-based host
                     system.
                     You will have the best results with a recent release of
@@ -54,25 +47,51 @@
                     status, see the
                     "<ulink url='&YOCTO_DOCS_REF_URL;#detailed-supported-distros'>Supported Linux 
Distributions</ulink>" section
                     in the Yocto Project Reference Manual and the wiki page at
-                    <ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution 
Support</ulink>.</para>
-                    <para>
-                    You should also have about 50 Gbytes of free disk space
+                    <ulink url='&YOCTO_WIKI_URL;/wiki/Distribution_Support'>Distribution Support</ulink>.
+                    </para></listitem>
+                <listitem><para>
+                    <emphasis>Have Enough Free Memory:</emphasis>
+                    You should have at least 50 Gbytes of free disk space
                     for building images.
                     </para></listitem>
                 <listitem><para>
-                    <emphasis>Packages:</emphasis>
-                    The OpenEmbedded build system requires that certain
-                    packages exist on your development system
-                    (e.g. Python 2.7).
+                    <emphasis>Meet Minimal Version Requirements:</emphasis>
+                    The OpenEmbedded build system should be able to run on any
+                    modern distribution that has the following versions for
+                    Git, tar, and Python.
+                    <itemizedlist>
+                        <listitem><para>
+                            Git 1.8.3.1 or greater
+                            </para></listitem>
+                        <listitem><para>
+                            tar 1.27 or greater
+                            </para></listitem>
+                        <listitem><para>
+                            Python 3.4.0 or greater.
+                            </para></listitem>
+                    </itemizedlist>
+                    If your build host does not meet any of these three listed
+                    version requirements, you can take steps to prepare the
+                    system so that you can still use the Yocto Project.
                     See the
-                    "<ulink url='&YOCTO_DOCS_QS_URL;#packages'>Build Host Packages</ulink>"
-                    section in the Yocto Project Quick Start and the
+                    "<ulink url='&YOCTO_DOCS_REF_URL;#required-git-tar-and-python-versions'>Required Git, 
tar, and Python Versions</ulink>"
+                    section in the Yocto Project Reference Manual for
+                    information.
+                    </para></listitem>
+                <listitem><para>
+                    <emphasis>Install Development Host Packages:</emphasis>
+                    Required development host packages vary depending on your
+                    build machine and what you want to do with the Yocto
+                    Project.
+                    Collectively, the number of required packages is large
+                    if you want to be able to cover all cases.</para>
+
+                    <para>For lists of required packages for all scenarios,
+                    see the
                     "<ulink 
url='&YOCTO_DOCS_REF_URL;#required-packages-for-the-host-development-system'>Required Packages for the Host 
Development System</ulink>"
-                    section in the Yocto Project Reference Manual for the
-                    exact package requirements and the installation commands
-                    to install them for the supported distributions.
+                    section in the Yocto Project Reference Manual.
                     </para></listitem>
-            </itemizedlist>
+            </orderedlist>
         </para>
     </section>