Updated the user's guide and rel notes with olinks and minor edits.

Signed-off-by: Miruna Paun <Miruna.Paun@enea.com>

6 files changed, 61 insertions, 59 deletions

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 5004f66..0ed0730 100644
--- a/doc/book-enea-linux-release-info/doc/about_release.xml
+++ b/doc/book-enea-linux-release-info/doc/about_release.xml
@@ -15,19 +15,21 @@
   xpointer="element(Yocto_NAME/1)" />.<remark>INFO <emphasis
   role="bold">eltf_params_updated.xml</emphasis> contains many parameters in
   the book, also in the open source books, and MUST be created FROM <emphasis
-  role="bold">eltf_params_template.xml</emphasis>. The parameters are
-  automatically used in the books, via xi:include statements, similar to how
-  parameters from pardoc-distro.xml are included in the book. Read the file
-  <emphasis role="bold">eltf_params_updated_template_how_to_use.txt</emphasis>
-  for important details about formats and how to do! The idea is that ELTF
-  will auto-create/update it.</remark></para>
+  role="bold">eltf_params_template.xml</emphasis>. </remark></para>
+
+  <para><remark>The parameters are automatically used in the books, via
+  xi:include statements, similar to how parameters from pardoc-distro.xml are
+  included in the book. Read the file <emphasis
+  role="bold">eltf_params_updated_template_how_to_use.txt</emphasis> for
+  important details about formats and how to do! The idea is that ELTF will
+  auto-create/update it.</remark></para>
 
   <section id="relinfo-provided-contents">
     <title>Provided Contents</title>
 
-    <para>The current release contains along with other items, documentation,
-    pre-built kernels and images, a bootloader and an SDK. The directories
-    structure is detailed below:</para>
+    <para>The current release contains documentation, prebuilt kernels and
+    images, a bootloader and an SDK. The directories structure is detailed
+    below:</para>
 
     <programlisting>-- Documentation/
    /* Enea Linux 7 documentation */
@@ -76,14 +78,16 @@
   <section id="relinfo-supported-host-environment">
     <title>Supported Host Environment</title>
 
-    <para>Ubuntu 16.04 LTS, 64-bit<remark>Hardcoded now in this XML file.
-    Might be moved to the parameter file later.</remark><remark>INFO Below is
-    a complete section with ID "eltf-target-tables-section" included from
-    elft_params_updated.xml. It contains a variable number of target tables
-    and the section title should be "Supported Targets with Parameters". It
-    has have a short sentence about what it is in the beginning. The subtitles
-    shall have the directory name of the target in the
-    manifest.</remark></para>
+    <para>The following environments have been validated as host environments
+    for this release of Enea Linux: <emphasis role="bold">Ubuntu 16.04 LTS,
+    64-bit</emphasis>.</para>
+
+    <para><remark>INFO Below is a complete section with ID
+    "eltf-target-tables-section" included from elft_params_updated.xml. It
+    contains a variable number of target tables and the section title should
+    be "Supported Targets with Parameters". It has have a short sentence about
+    what it is in the beginning. The subtitles shall have the directory name
+    of the target in the manifest.</remark></para>
   </section>
 
   <xi:include href="eltf_params_updated.xml"
@@ -126,9 +130,13 @@
     <title>Provided Toolchains (SDK)</title>
 
     <para>The SDK contains toolchains supporting cross-compilation of
-    applications for the targets on an aarch64 host. See the <trademark
-    class="registered">Enea</trademark> Linux User's Guide for information on
-    how to build and install a toolchain.</para>
+    applications for the targets on an aarch64 host. For information on how to
+    build and install a toolchain, see the chapter <olink
+    targetdoc="book_enea_linux_user_guide_standard"
+    targetptr="using_enealinux">Using Enea Linux, in the <xi:include
+    href="../../s_docbuild/olinkdb/pardoc-names.xml"
+    xmlns:xi="http://www.w3.org/2001/XInclude"
+    xpointer="element(book_enea_linux_user_guide_standard/1)" /></olink>.</para>
   </section>
 
   <section id="relinfo-documentation">
@@ -143,13 +151,13 @@
       </listitem>
 
       <listitem>
-        <para><trademark class="registered">Enea</trademark> Linux User's
-        Guide</para>
+        <para><olink targetdoc="book_enea_linux_user_guide_standard"
+        targetptr="book_enea_linux_user_guide_standard"><trademark
+        class="registered">Enea</trademark> Linux User's Guide</olink></para>
       </listitem>
 
       <listitem>
-        <para><olink security=""
-        targetdoc="book_enea_linux_open_source_standard"
+        <para><olink targetdoc="book_enea_linux_open_source_standard"
         targetptr="book_enea_linux_open_source_standard"><trademark
         class="registered">Enea</trademark> Linux Open Source
         Report</olink></para>
@@ -166,9 +174,8 @@
       </listitem>
 
       <listitem>
-        <para><trademark class="registered">Enea</trademark> Linux Real-Time
-        Guide can be read at <ulink
-        url="http://linuxrealtime.org">http://linuxrealtime.org</ulink>.</para>
+        <para><trademark class="registered">Enea</trademark><ulink
+        url="http://linuxrealtime.org"> Linux Real-Time Guide</ulink></para>
       </listitem>
     </itemizedlist>
   </section>
diff --git a/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml b/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml
index 35db2a3..0aa2e06 100644
--- a/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml
+++ b/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml
@@ -88,7 +88,7 @@ repo sync</programlisting></para>
   </section>
 
   <section id="eltf-target-tables-section">
-    <title>Supported Targets with Parameters</title>
+    <title>Supported Reference Boards with Parameters</title>
 
     <para>The section(s) below describe the target(s) supported in this Enea
     Linux release.</para>
diff --git a/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml b/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
index 5c0c594..6fafb8d 100644
--- a/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
+++ b/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
@@ -5,17 +5,17 @@
   <title>Known Problems in this Release</title>
 
   <para>Open source projects are continuously working on correcting reported
-  problems. Corrections to bugs detected by Enea are submitted upstream, and
-  the corrections are included in Enea Linux regardless of when they will be
-  included by the open source project. Remaining issues are listed
-  below.<remark>INFO: The <emphasis role="bold">Release-Specific
-  Problems</emphasis> section further down is generated from JIRA with
-  gen_known_issues.py, but that script is HARDCODED with affectedversion "Enea
-  Linux 6" and needs to be adapted when a release info for another EL version
-  changes.</remark></para>
+  problems. Fixes and workarounds to bugs detected by Enea are submitted
+  upstream, and included in Enea Linux regardless of when they will be
+  included by the open source project. Issues that still affect the current
+  release are listed below.<remark>INFO: The <emphasis
+  role="bold">Release-Specific Problems</emphasis> section further down is
+  generated from JIRA with gen_known_issues.py, but that script is HARDCODED
+  with affectedversion "Enea Linux 6" and needs to be adapted when a release
+  info for another EL version changes.</remark></para>
 
   <section id="bugs-limitations-yocto">
-    <title>Yocto Project </title>
+    <title>Yocto Project</title>
 
     <para>The Yocto Project community uses a <ulink
     url="https://bugzilla.yoctoproject.org">Bugzilla database</ulink> to track
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 c0e3006..9f036db 100644
--- a/doc/book-enea-linux-release-info/doc/main_changes.xml
+++ b/doc/book-enea-linux-release-info/doc/main_changes.xml
@@ -5,15 +5,14 @@
   <title>Main Changes</title>
 
   <para>This chapter describes the major changes and additions made to this
-  release of Enea Linux, as compared to the previous Enea Linux 6.<remark>INFO
-  Just now Hardcoded previous release string in this
-  paragraph.</remark><remark>The list of changed packages further down is
-  created from the open source book licenses.xml by the script gen_pkgdiff.py
-  by comparing with an older open source licenses.xml, depending on the
-  parameter "prev_baseline" in pardoc-distro.xml, e.g. a tag like "EL5". This
-  parameter needs to be changed to a new TAG when a release info for another
-  EL version is created. It must correspond to the release string
-  above.</remark></para>
+  release of Enea Linux.<remark>INFO Just now Hardcoded previous release
+  string in this paragraph.</remark><remark>The list of changed packages
+  further down is created from the open source book licenses.xml by the script
+  gen_pkgdiff.py by comparing with an older open source licenses.xml,
+  depending on the parameter "prev_baseline" in pardoc-distro.xml, e.g. a tag
+  like "EL5". This parameter needs to be changed to a new TAG when a release
+  info for another EL version is created. It must correspond to the release
+  string above.</remark></para>
 
   <section id="relinfo-changes-other">
     <title>New Functionality/Enhancements</title>
diff --git a/doc/book-enea-linux-user-guide/doc/preface.xml b/doc/book-enea-linux-user-guide/doc/preface.xml
index b1de43c..1752ff5 100644
--- a/doc/book-enea-linux-user-guide/doc/preface.xml
+++ b/doc/book-enea-linux-user-guide/doc/preface.xml
@@ -3,7 +3,7 @@
   <title>Preface</title>
 
   <section id="guide_purpose">
-    <title>The Purpose of This Guide</title>
+    <title>The Purpose of this Guide</title>
 
     <para>This guide is intended for all Enea Linux developers who want to
     configure and build customized Linux kernel images for embedded system
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 3997038..a0b7d2c 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
@@ -5,9 +5,9 @@
   <section id="build_enealinux">
     <title>Building Enea Linux</title>
 
-    <para>Enea Linux is made available as sources as well. This allows
-    building various Enea Linux artifacts and this is detailed in the
-    following sections:</para>
+    <para>Enea Linux is made available as sources, this allows for of building
+    various Enea Linux artifacts and is detailed in the following
+    sections:</para>
 
     <section id="build_images">
       <title>Building the images</title>
@@ -17,8 +17,7 @@
       <procedure>
         <step>
           <para>Clone Enea Linux sources using Repo tool. Please refer to
-          chapter 3.2 in the current documebt for more details on how to do
-          this.</para>
+          <xref linkend="getting_sources" /> for more details.</para>
 
           <programlisting>$ mkdir enea-linux
 $ cd enea-linux
@@ -35,13 +34,10 @@ $ repo sync</programlisting>
 $ TEMPLATECONF=meta-el-standard/conf/template.&lt;machine&gt; \
 . ./oe-init-build-env &lt;build_dir&gt;</programlisting>
 
-          <note>
-            <para>Sourcing the build environment is needed everytime a new
-            shell is used. However, sourcing using the
-            <literal>TEMPLATECONF</literal> is only needed the first time
-            around. Afterwards it is enough to source the build directory
-            created before.</para>
-          </note>
+          <para>Sourcing the build environment is needed everytime a new shell
+          is used. However, sourcing using the <literal>TEMPLATECONF</literal>
+          is only needed the first time around. After the first time, it is
+          enough to source the build directory created before.</para>
 
           <note>
             <para>The build directory may reside on an NFS mount, but the