Fix review comments

Change-Id: Ic41afdff1c4a0f1f8bb5ad0e967a3854229555fb
Signed-off-by: Adrian Mangeac <Adrian.Mangeac@enea.com>

8 files changed, 143 insertions, 177 deletions

diff --git a/doc/book-enea-linux-open-source/doc/licenses.xml b/doc/book-enea-linux-open-source/doc/licenses.xml
index adad25e..9764617 100644
--- a/doc/book-enea-linux-open-source/doc/licenses.xml
+++ b/doc/book-enea-linux-open-source/doc/licenses.xml
@@ -14,9 +14,9 @@ specific documentation.-->
 
   <informaltable>
     <tgroup cols="5">
-      <colspec colwidth="2*"/>
-      <colspec colwidth="1*"/>
-      <colspec colwidth="5*"/>
+      <colspec colwidth="1.5*"/>
+      <colspec colwidth="1.3*"/>
+      <colspec colwidth="6*"/>
       <colspec colwidth="2*"/>
       <colspec colwidth="1*"/>
 
@@ -8203,7 +8203,8 @@ terms specified in this license.
 </programlisting></para></section>
 
   </section> 
- <section id="proprietary_license">
- <title>Proprietary Licenses</title>
+  <section id="proprietary_license">
+    <title>Proprietary Licenses</title>
+      <para>This release does not offer any proprietary licences.</para>
   </section> 
 </chapter>
diff --git a/doc/book-enea-linux-release-info/doc/about_release.xml b/doc/book-enea-linux-release-info/doc/about_release.xml
index 966347c..2546be1 100644
--- a/doc/book-enea-linux-release-info/doc/about_release.xml
+++ b/doc/book-enea-linux-release-info/doc/about_release.xml
@@ -44,13 +44,13 @@
                 -- enea-image-standard-sdk
                    /* precompiled artifacts for the development process. The image
                       contains userspace tools and kernel configurations necessary
-                      for developing, debugging and profiling applications and \
+                      for developing, debugging and profiling applications and 
                       kernel modules */
                     -- various artifacts
              -- esdk
-                /* Extensible SDK related artifacts including SDK installer and  */
-                      /* manifest, self-extracting archive installing cross-compilation
-                      toolchain for the platform */
+                /* Extensible SDK related artifacts including SDK installer and  
+                   manifest, self-extracting archive installing cross-compilation
+                   toolchain for the platform */
                    -- x86_64-buildtools-nativesdk-standalone-8.1.sh
                       /* self-extracting archive installing additional tools
                          for the host machine */
@@ -65,13 +65,13 @@
                 -- enea-image-standard-sdk
                    /* precompiled artifacts for the development process. The image
                       contains userspace tools and kernel configurations necessary
-                      for developing, debugging and profiling applications and \
+                      for developing, debugging and profiling applications and 
                       kernel modules */
                     -- various artifacts
              -- esdk
-                /* Extensible SDK related artifacts including SDK installer and  */
-                      /* manifest, self-extracting archive installing cross-compilation
-                      toolchain for the platform */
+                /* Extensible SDK related artifacts including SDK installer and
+                   manifest, self-extracting archive installing cross-compilation
+                   toolchain for the platform */
                    -- x86_64-buildtools-nativesdk-standalone-8.1.sh
                       /* self-extracting archive installing additional tools
                          for the host machine */
diff --git a/doc/book-enea-linux-release-info/doc/main_changes.xml b/doc/book-enea-linux-release-info/doc/main_changes.xml
index 11caf67..beda2b4 100644
--- a/doc/book-enea-linux-release-info/doc/main_changes.xml
+++ b/doc/book-enea-linux-release-info/doc/main_changes.xml
@@ -44,7 +44,7 @@
     <title>Yocto updates</title>
 
     <para>The following links provide information on Yocto releases since the 
-    previous Enea Linux release.</para>
+    previous Enea Linux release:</para>
     <itemizedlist spacing="compact">
     <listitem>
         <para><ulink url="https://lists.yoctoproject.org/pipermail/yocto-announce/2018-November/000147.html">
diff --git a/doc/book-enea-linux-release-info/doc/pkgdiff_generated.xml b/doc/book-enea-linux-release-info/doc/pkgdiff_generated.xml
index 5e2c68b..22eb4ba 100755
--- a/doc/book-enea-linux-release-info/doc/pkgdiff_generated.xml
+++ b/doc/book-enea-linux-release-info/doc/pkgdiff_generated.xml
@@ -11,9 +11,9 @@
     <para>The following packages were added to this Enea Linux release:</para>
     <informaltable>
       <tgroup cols="4">
-        <colspec colwidth="2*"/>
-        <colspec colwidth="1*"/>
-        <colspec colwidth="5*"/>
+        <colspec colwidth="1.5*"/>
+        <colspec colwidth="1.3*"/>
+        <colspec colwidth="6*"/>
         <colspec colwidth="2*"/>
         <thead>
           <row>
@@ -363,9 +363,9 @@
     <para>The following packages were removed from this Enea Linux release:</para>
     <informaltable>
       <tgroup cols="4">
-        <colspec colwidth="2*"/>
-        <colspec colwidth="1*"/>
-        <colspec colwidth="5*"/>
+        <colspec colwidth="1.5*"/>
+        <colspec colwidth="1.5*"/>
+        <colspec colwidth="6*"/>
         <colspec colwidth="2*"/>
         <thead>
           <row>
diff --git a/doc/book-enea-linux-user-guide/doc/application_development.xml b/doc/book-enea-linux-user-guide/doc/application_development.xml
index a94c422..ac7a010 100644
--- a/doc/book-enea-linux-user-guide/doc/application_development.xml
+++ b/doc/book-enea-linux-user-guide/doc/application_development.xml
@@ -146,7 +146,7 @@ MODULE_LICENSE("GPL");</programlisting>
     environment. For this, see <xref linkend="install_el_sdk" />.</para>
 
     <para>The following section, <ulink
-    url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#sdk-use-devtool-to-add-an-application">Use
+    url="http://www.yoctoproject.org/docs/2.7/sdk-manual/sdk-manual.html#sdk-use-devtool-to-add-an-application">Use
     devtool add to Add an Application</ulink>, in Yocto Project Software
     Development Kit (SDK) Developer's Guide, explains how to use devtool to
     generate recipes from existing application code, edit and build recipes,
diff --git a/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml b/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml
index 0efa6af..b54f530 100644
--- a/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml
+++ b/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml
@@ -22,7 +22,7 @@
     <bridgehead>A programlisting, ID
     "eltf-prereq-apt-get-commands-host"</bridgehead>
 
-    <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 16.04.2 LTS 64bit
+    <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 18.04 LTS 64bit
 sudo apt-get -y update
 sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
    texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
@@ -42,17 +42,17 @@ export PATH=~/bin:$PATH</programlisting></para>
     correct also compared to the "previous" REL VER in pardoc-distro.xml
     "prev_baseline".</bridgehead>
 
-    <para id="EneaLinux_REL_VER"><phrase>8</phrase></para>
+    <para id="EneaLinux_REL_VER"><phrase>8.1</phrase></para>
 
-    <para id="Yocto_VER"><phrase>2.5</phrase></para>
+    <para id="Yocto_VER"><phrase>2.7</phrase></para>
 
-    <para id="Yocto_NAME"><phrase>sumo</phrase></para>
+    <para id="Yocto_NAME"><phrase>warrior</phrase></para>
 
     <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
-    url="http://www.yoctoproject.org/downloads/core/pyro23">http://www.yoctoproject.org/downloads</ulink></para>
+    url="http://downloads.yoctoproject.org/releases/yocto/yocto-2.7/poky-warrior-21.0.0.tar.bz2">http://www.yoctoproject.org/downloads</ulink></para>
 
     <para id="ULINK_ENEA_LINUX_URL"><ulink
-    url="http://linux.enea.com/EneaLinux8.0">http://linux.enea.com/EneaLinux8.0</ulink></para>
+    url="http://linux.enea.com/EneaLinux8.1">http://linux.enea.com/EneaLinux8.1</ulink></para>
 
     <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
     $MACHINE/default.xml as parameter, where MACHINE is one of the target
@@ -61,7 +61,7 @@ export PATH=~/bin:$PATH</programlisting></para>
     <para id="eltf-repo-cloning-enea-linux"><programlisting>mkdir enea-linux
 cd enea-linux
 repo init -u git@git.enea.com:linux/manifests/el_manifests-standard.git \
-    -b refs/tags/Enea_Linux_8.0 -m intel-corei7-64/default.xml
+    -b refs/tags/Enea_Linux_8.1 -m intel-corei7-64/default.xml
 repo sync</programlisting></para>
 
     <bridgehead>A table with ONE row, only the row with ID
@@ -163,147 +163,7 @@ repo sync</programlisting></para>
               target</entry>
 
               <entry><ulink
-              url="http://linux.enea.com/EneaLinux8.0/deb">http://linux.enea.com/EneaLinux8.0/deb</ulink></entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
-
-      <table>
-        <title>MACHINE Information Intel Atom C3000</title>
-
-        <tgroup cols="2">
-          <colspec align="center" />
-
-          <thead>
-            <row>
-              <entry align="center">Component</entry>
-
-              <entry align="center">Description</entry>
-            </row>
-          </thead>
-
-          <tbody>
-            <row>
-              <entry align="left">Target official name</entry>
-
-              <entry>Intel Atom C3000</entry>
-            </row>
-
-            <row>
-              <entry align="left">Architecture and Description</entry>
-
-              <entry>x86-64</entry>
-            </row>
-
-            <row>
-              <entry align="left">Link to target datasheet</entry>
-
-              <entry><ulink
-              url="https://www.intel.com/content/www/us/en/products/docs/processors/atom/c-series/c3000-family-datasheet.html">Intel
-              Atom datasheet</ulink></entry>
-            </row>
-
-            <row>
-              <entry align="left">Poky version</entry>
-
-              <entry>Git-commit-id: TBD</entry>
-            </row>
-
-            <row>
-              <entry align="left">GCC version</entry>
-
-              <entry>7.3</entry>
-            </row>
-
-            <row>
-              <entry align="left">Linux Kernel Version</entry>
-
-              <entry>4.14</entry>
-            </row>
-
-            <row condition="hidden">
-              <entry align="left">Supported Drivers</entry>
-
-              <entry>Ethernet, RTC, UART</entry>
-            </row>
-
-            <row>
-              <entry>Enea deb folder for downloading DEB packages for this
-              target</entry>
-
-              <entry><ulink
-              url="http://linux.enea.com/EneaLinux8.0/deb">http://linux.enea.com/EneaLinux8.0/deb</ulink></entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
-
-      <table>
-        <title>MACHINE Information Intel NUC Kaby Lake</title>
-
-        <tgroup cols="2">
-          <colspec align="center" />
-
-          <thead>
-            <row>
-              <entry align="center">Component</entry>
-
-              <entry align="center">Description</entry>
-            </row>
-          </thead>
-
-          <tbody>
-            <row>
-              <entry align="left">Target official name</entry>
-
-              <entry>Intel NUC Kaby Lake</entry>
-            </row>
-
-            <row>
-              <entry align="left">Architecture and Description</entry>
-
-              <entry>x86-64</entry>
-            </row>
-
-            <row>
-              <entry align="left">Link to target datasheet</entry>
-
-              <entry><ulink
-              url="https://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/nuc-kit-nuc7i5bnh-nuc7i5bnk-brief.pdf">Intel
-              NUC Kaby Lake datasheet</ulink></entry>
-            </row>
-
-            <row>
-              <entry align="left">Poky version</entry>
-
-              <entry>Git-commit-id: TBD</entry>
-            </row>
-
-            <row>
-              <entry align="left">GCC version</entry>
-
-              <entry>7.3</entry>
-            </row>
-
-            <row>
-              <entry align="left">Linux Kernel Version</entry>
-
-              <entry>4.14</entry>
-            </row>
-
-            <row condition="hidden">
-              <entry align="left">Supported Drivers</entry>
-
-              <entry>Ethernet, RTC, UART</entry>
-            </row>
-
-            <row>
-              <entry>Enea deb folder for downloading DEB packages for this
-              target</entry>
-
-              <entry><ulink
-              url="http://linux.enea.com/EneaLinux8.0/deb">http://linux.enea.com/EneaLinux8.0/deb</ulink></entry>
+              url="http://linux.enea.com/EneaLinux8.1/rpm">http://linux.enea.com/EneaLinux8.1/rpm</ulink></entry>
             </row>
           </tbody>
         </tgroup>
diff --git a/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml b/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml
index 2215ba8..688145f 100644
--- a/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml
+++ b/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml
@@ -63,7 +63,7 @@ $ git config --global user.email johndoe@example.com</programlisting>
       <para>Building Enea Linux requires a set of packages to be installed on
       your Linux development host. The list of required packages is described
       in the <ulink
-      url="https://www.yoctoproject.org/docs/2.5/ref-manual/ref-manual.html#required-packages-for-the-host-development-system">Yocto
+      url="https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#required-packages-for-the-host-development-system">Yocto
       Project reference manual</ulink>.</para>
     </section>
   </section>
diff --git a/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml
index a6a0ed6..fbd6d28 100644
--- a/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml
+++ b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml
@@ -27,7 +27,7 @@
           <programlisting>$ mkdir enea-linux
 $ cd enea-linux
 $ repo init -u git@git.enea.com:linux/manifests/el_manifests-standard.git \
-    -b refs/tags/Enea_Linux_8.0 -m $MACHINE/default.xml
+    -b refs/tags/Enea_Linux_8.1 -m $MACHINE/default.xml
 $ repo sync</programlisting>
         </step>
 
@@ -106,7 +106,7 @@ $ cd &lt;build_dir&gt;/tmp/deploy/images/&lt;target&gt;/  # Here are the build b
           <programlisting>$ mkdir enea-linux
 $ cd enea-linux
 $ repo init -u git@git.enea.com:linux/manifests/el_manifests-standard.git \
-    -b refs/tags/Enea_Linux_8.0 -m $MACHINE/default.xml
+    -b refs/tags/Enea_Linux_8.1 -m $MACHINE/default.xml
 $ repo sync</programlisting>
         </step>
 
@@ -274,7 +274,7 @@ label device01
           <para>Copy <filename>pxelinux.0</filename> and
           <filename>vesamenu.c32</filename> from the build directory, e.g.
           from
-          <filename>&lt;build_dir&gt;tmp/work/corei7-64-enea-linux/syslinux/6.03-r0/image/usr/share/syslinux/</filename>.</para>
+          <filename>&lt;build_dir&gt;tmp/work/corei7-64-enea-linux/syslinux/6.04-pre2-r0/image/usr/share/syslinux/</filename>.</para>
         </listitem>
 
         <listitem>
@@ -308,6 +308,111 @@ label device01
       during BIOS power up tests. Look up the manufacturer's documentation for
       your board model to find the appropriate key.</para>
     </section>
+
+    <section id="boot_from_ram">
+      <title>Boot from RAM</title>
+
+      <para>This example requires that a TFTP server is set up at IP address
+      <literal>&lt;tftp_server_ip&gt;</literal>, and that the server stores
+      the Enea Linux image files, kernel image, device tree blob and root
+      filesystem, in <literal>/tftpboot/&lt;download_directory&gt;.</literal>
+      Please refer to <xref linkend="prebuiltprereq" /> for more details on
+      how to install and configure the TFTP server.</para>
+
+      <para>Once you have that in place, run the following commands on the
+      target:</para>
+
+      <programlisting>## set tftp server IP
+U-Boot&gt; setenv serverip &lt;tftp_server_ip&gt;
+
+## tftp the image files on the target machine
+U-Boot&gt; tftpboot 0x01000000 Image  
+U-Boot&gt; tftpboot 0x02000000 Image-bcm2837-rpi-3-b.dtb 
+U-Boot&gt; tftpboot 0x03000000 enea-image-standard-raspberrypi3-64.ext2.gz.u-boot
+
+## add any other bootargs values if necessary 
+U-Boot&gt; setenv bootargs "8250.nr_uarts=1 root=/dev/ram rw ramdisk_size=500000 ip=dhcp \
+console=ttyS0,115200"
+
+## Start boot sequence
+U-Boot&gt; booti 0x01000000 0x03000000 0x02000000</programlisting>
+    </section>
+
+    <section id="boot_from_sd">
+      <title>Boot from SD card</title>
+
+      <para>Copy the
+      <filename>enea-image-standard-raspberrypi3-64.rpi-sdimg</filename> image
+      to the SD card using the Linux dd tool or Win32DiskImager in Windows,
+      and insert it into the RPi. The Raspberry Pi will not start without a
+      properly formatted SD Card, containing the bootloader, kernel image and
+      rootfs.</para>
+
+      <para>Below you can find two methods of how to format an SD Card:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><emphasis role="bold">Format and copy images to the SD card
+          using the Linux dd command line</emphasis></para>
+
+          <para>The <command>dd</command> command copies a file, converting
+          the format of the data in the process, according to the operands
+          specified:</para>
+
+          <programlisting>sudo dd bs=4M if=enea-image-standard-sdk-raspberrypi3-64.rpi-sdimg of=/dev/sdg</programlisting>
+
+          <note>
+            <para>Use <command>dd</command> cautiously - improper usage or
+            entering the wrong values could inadvertently wipe, destroy, or
+            overwrite the data on your hard drive.</para>
+          </note>
+        </listitem>
+
+        <listitem>
+          <para><emphasis role="bold">Format the SD card using the
+          Win32DiskImager program</emphasis></para>
+
+          <orderedlist>
+            <listitem>
+              <para>Download and unzip <ulink
+              url="https://sourceforge.net/projects/win32diskimager/">Win32DiskImager</ulink></para>
+            </listitem>
+
+            <listitem>
+              <para>Run <filename>Win32DiskImager.exe</filename></para>
+            </listitem>
+
+            <listitem>
+              <para>Select the drive of your SD card</para>
+            </listitem>
+
+            <listitem>
+              <para>Select the image
+              <filename><filename>enea-image-standard-raspberrypi3-64.rpi-sdimg</filename></filename></para>
+            </listitem>
+
+            <listitem>
+              <para>Click "Write" and wait for the write to complete</para>
+            </listitem>
+
+            <listitem>
+              <para>Exit the imager and eject the SD Card</para>
+            </listitem>
+
+            <listitem>
+              <para>Plug the card into your Raspberry Pi</para>
+            </listitem>
+          </orderedlist>
+
+          <note>
+            <para>Be careful to select the correct drive. If you choose the
+            wrong one you may destroy your HDD data. If you are using an SD
+            Card slot and can't see the drive in the Win32DiskImager window,
+            try using an affordable external adapter in a USB slot.</para>
+          </note>
+        </listitem>
+      </itemizedlist>
+    </section>
   </section>
 
   <section id="custom_enealinux">
@@ -412,8 +517,8 @@ BBLAYERS ?= " \
       <para>As a result, <filename>BBLAYERS</filename> shall be extended with
       the bsp-layer/s layer for your target and any other additional layer/s.
       For details on how to do this, see the <ulink
-      url="http://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#understanding-and-creating-layers">Yocto
-      2.5 Dev Manual, section "Understanding and Creating Layers".</ulink> If
+      url="http://www.yoctoproject.org/docs/2.7/dev-manual/dev-manual.html#understanding-and-creating-layers">Yocto
+      2.7 Dev Manual, section "Understanding and Creating Layers".</ulink> If
       needed replace the Yocto version.</para>
 
       <para>Layers can be added when you initialize the build environment. The
@@ -440,9 +545,9 @@ BBLAYERS ?= " \
       <title>Adding a Recipe</title>
 
       <para>Study the <ulink
-      url="https://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#new-recipe-single-c-file-package-hello-world">Hello
+      url="https://www.yoctoproject.org/docs/2.7/dev-manual/dev-manual.html#new-recipe-single-c-file-package-hello-world">Hello
       World recipe</ulink> in the Yocto Project Development Manual. If needed
-      replace the example version (2.5) with the Yocto version in your Enea
+      replace the example version (2.7) with the Yocto version in your Enea
       Linux distribution.</para>
     </section>