From 13da278fea34982e5eb398af09e9bd82c050a71c Mon Sep 17 00:00:00 2001
From: Miruna Paun <Miruna.Paun@enea.com>
Date: Mon, 10 Apr 2017 12:38:48 +0200
Subject: Updating El6-Network Relnotes

LXCR-7377 Tweaking the last of needed info, build files

Signed-off-by: Miruna Paun <Miruna.Paun@enea.com>
---
 .../doc/about_release.xml                          | 187 +++++----------------
 1 file changed, 41 insertions(+), 146 deletions(-)

(limited to 'doc/book-enea-linux-release-info/doc/about_release.xml')

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 6907507..01679f8 100644
--- a/doc/book-enea-linux-release-info/doc/about_release.xml
+++ b/doc/book-enea-linux-release-info/doc/about_release.xml
@@ -4,16 +4,23 @@
 <chapter id="relinfo-about-release">
   <title>About This Release</title>
 
-  <para>This release of Enea Linux <xi:include
-  href="../../s_docsrc_common/pardoc-distro.xml"
+  <para>This release of Enea Linux <xi:include href="eltf_params_updated.xml"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xpointer="element(EneaLinux_REL_VER/1)" /> provides a publicly available
   Enea Linux distribution for a selected set of targets. This release is
-  generated from the yocto distribution using the branch <xi:include
-  href="../../s_docsrc_common/pardoc-distro.xml"
+  generated from the yocto <xi:include href="eltf_params_updated.xml"
   xmlns:xi="http://www.w3.org/2001/XInclude"
-  xpointer="element(Yocto_NAME/1)" />.<remark>INFO Yocto distro autopicked
-  from poky.ent as DISTRO_NAME_NO_CAP</remark></para>
+  xpointer="element(Yocto_VER/1)" /> distribution using the branch <xi:include
+  href="eltf_params_updated.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
+  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>
 
   <section id="relinfo-provided-contents">
     <title>Provided Contents</title>
@@ -43,8 +50,16 @@
           </row>
 
           <row>
-            <entry>Pre-built packages (RPM)</entry>
+            <entry>Pre-built packages (RPM). See links for each
+            target.<remark>INFO Below is an Eclipse row from
+            eltf_params_updated.xml. MANUALLY if eclipse is not included, set
+            condition hidden on the row element BOTH in template.xml and in
+            updated.xml.</remark></entry>
           </row>
+
+          <xi:include href="eltf_params_updated.xml"
+                      xmlns:xi="http://www.w3.org/2001/XInclude"
+                      xpointer="element(eltf-eclipse-version-row)" />
         </tbody>
       </tgroup>
     </informaltable>
@@ -96,76 +111,21 @@
 
     <itemizedlist>
       <listitem>
-        <para>Ubuntu 14.04 LTS, 64-bit<remark>was
-        EneaLinux_HOST_VER</remark></para>
+        <para>Ubuntu 14.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>
       </listitem>
     </itemizedlist>
   </section>
 
-  <section id="relinfo-supported-versions">
-    <title>Supported Versions</title>
-
-    <informaltable>
-      <tgroup cols="2">
-        <thead valign="bottom">
-          <row>
-            <entry>Item</entry>
-
-            <entry>Version</entry>
-          </row>
-        </thead>
-
-        <tbody>
-          <row>
-            <entry><para>Yocto</para></entry>
-
-            <entry><xi:include href="../../s_docsrc_common/pardoc-distro.xml"
-            xmlns:xi="http://www.w3.org/2001/XInclude"
-            xpointer="element(Yocto_VER/1)" /> (<xi:include
-            href="../../s_docsrc_common/pardoc-distro.xml"
-            xmlns:xi="http://www.w3.org/2001/XInclude"
-            xpointer="element(Yocto_NAME/1)" />)<remark>INFO: Auto-fetched
-            from poky.ent via pardoc-distro.xml</remark></entry>
-          </row>
-
-          <row>
-            <entry>Poky</entry>
-
-            <entry><para>Git commit id:</para>
-            <para>75ca53211488a3e268037a44ee2a7ac5c7181bd2</para><remark>Problem:
-            Unfortunately the poky version in poky.ent is not correct unless
-            the EL release would be based on a Yocto release, so we can not
-            use that here. This is a problem because we don't want to manually
-            edit the git commit ID in this file? The poky version in poky.ent
-            is just now <xi:include
-            href="../../s_docsrc_common/pardoc-distro.xml"
-            xmlns:xi="http://www.w3.org/2001/XInclude"
-            xpointer="element(Poky_VER/1)" /></remark></entry>
-          </row>
-
-          <row>
-            <entry>GCC</entry>
-
-            <entry>5.3<remark>was EneaLinux_GCC_VER Not in poky.ent
-            </remark></entry>
-          </row>
-
-          <row>
-            <entry>Linux kernel<remark>was EneaLinux_KERNEL_VER Not in
-            poky.ent</remark></entry>
-
-            <entry><para>3.12</para></entry>
-          </row>
-
-          <row>
-            <entry>Packages</entry>
-
-            <entry>See <xref linkend="relinfo-packages" /></entry>
-          </row>
-        </tbody>
-      </tgroup>
-    </informaltable>
-  </section>
+  <xi:include href="eltf_params_updated.xml"
+              xmlns:xi="http://www.w3.org/2001/XInclude"
+              xpointer="element(eltf-target-tables-section)" />
 
   <section id="relinfo-packages">
     <title>Provided Packages</title>
@@ -194,6 +154,7 @@
               class="registered">Enea</trademark> Linux Open Source
               Report</olink></para></entry>
             </row>
+
           </tbody>
         </tgroup>
       </informaltable></para>
@@ -211,76 +172,6 @@
     toolchain.</para>
   </section>
 
-  <section id="relinfo-provided-drivers">
-    <title>Supported Drivers</title>
-
-    <informaltable>
-      <tgroup cols="2">
-        <colspec align="left" colwidth="3*" />
-
-        <colspec align="center" colwidth="2*" />
-
-        <thead>
-          <row>
-            <entry>Driver</entry>
-
-            <entry>P2041RDB</entry>
-          </row>
-        </thead>
-
-        <tbody>
-          <row>
-            <entry>Ethernet</entry>
-
-            <entry>X</entry>
-          </row>
-
-          <row>
-            <entry>I2C</entry>
-
-            <entry>X</entry>
-          </row>
-
-          <row>
-            <entry>SPI</entry>
-
-            <entry>X</entry>
-          </row>
-
-          <row>
-            <entry>PCI Express</entry>
-
-            <entry>X</entry>
-          </row>
-
-          <row>
-            <entry>USB</entry>
-
-            <entry>X</entry>
-          </row>
-
-          <row>
-            <entry>Flash</entry>
-
-            <entry>X</entry>
-          </row>
-
-          <row>
-            <entry>SD/SDHC/SDXC</entry>
-
-            <entry>X</entry>
-          </row>
-
-          <row>
-            <entry>RTC</entry>
-
-            <entry>X</entry>
-          </row>
-        </tbody>
-      </tgroup>
-    </informaltable>
-  </section>
-
   <section id="relinfo-documentation">
     <title>Provided Documentation</title>
 
@@ -326,7 +217,7 @@
       </listitem>
 
       <listitem>
-        <para><trademark class="registered">Enea</trademark> Linux 6 Test
+        <para><trademark class="registered">Enea</trademark> Linux Test
         Report</para>
       </listitem>
 
@@ -343,7 +234,9 @@
 
     <para>The functionality in a distribution depends on included packages in
     the default image. In addition to the supported features, the following
-    functionality is also available, among other:</para>
+    functionality is also available, among other:<remark>INFO: This section
+    might be hidden by setting condition hidden on the section, MANUALLY in
+    this file.</remark></para>
 
     <itemizedlist spacing="compact">
       <listitem>
@@ -381,7 +274,9 @@
     <title>Intentional Limitations</title>
 
     <para>The following functionality supported in other Enea Linux releases
-    has been excluded in this release:<itemizedlist spacing="compact">
+    has been excluded in this release:<remark>INFO: This section might be
+    hidden by setting condition hidden on the section, MANUALLY in this
+    file.</remark><itemizedlist spacing="compact">
         <listitem>
           <para>Networking features: DPDK vSwitch, DPDK</para>
         </listitem>
-- 
cgit v1.2.3-54-g00ecf