6 files changed, 174 insertions, 63 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 3cdea52..017f7b2 100644
--- a/doc/book-enea-linux-release-info/doc/about_release.xml
+++ b/doc/book-enea-linux-release-info/doc/about_release.xml
@@ -4,15 +4,16 @@
 <chapter id="relinfo-about-release">
   <title>About This Release</title>
 
-  <para>This release of Enea Linux 6 provides a publicly available Enea Linux
-  distribution for a selected set of targets. This release is generated from
-  branch dizzy-enea<remark>EneaLinux_BRANCH FIXME Is this correct branch, try
-  to ONLY HAVE THIS INFO in one place, here</remark> of applicable git
-  repositories.<remark>MAYBE WE COULD EXTRACT Enea Linux major and minor
-  version from meta-el-common/conf/distro/enea.conf ? This would be via shell
-  code in Makefile, the names clashes with those used in poky.ent. Suggest
-  using the docbuild feature BOOK_PARAM_n (n=1-5) to define parameters in
-  Makefile that can be used in XML files</remark></para>
+  <para>This release of Enea Linux <xi:include
+  href="../../s_docsrc_common/pardoc-distro.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 <xi:include
+  href="../../s_docsrc_common/pardoc-distro.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>
 
   <para>Provided contents:<itemizedlist spacing="compact">
       <listitem>
@@ -36,47 +37,38 @@
       </listitem>
 
       <listitem>
-        <para>Eclipse executable plus application development tools (ADT) for
-        command line and Eclipse</para>
+        <para>Eclipse executable plus development tools for command line and
+        Eclipse</para>
       </listitem>
     </itemizedlist></para>
 
-  <!-- At least one target must be listed otherwise PDF build fails -->
+  <para>Supported targets:</para>
 
-  <para>Supported targets:<itemizedlist spacing="compact">
-      <listitem>
-        <para>Freescale P2041RDB<remark> FIXME Why are these listed three
-        times?</remark></para>
-      </listitem>
+  <para><remark>FIXME should autocreate a list of targets, hopefully from the
+  generated README file, by using MAKEFILE to update pardoc-distro AND/OR also
+  auto-create an XML file to includ here with description text for each target
+  etc..</remark></para>
 
+  <para><itemizedlist spacing="compact">
       <listitem>
-        <para>Freescale P3041DS<remark> FIXME Why are these listed three
-        times?</remark></para>
+        <para>Freescale P2041RDB, Power architecture, No DSPs, Quad-core QorIQ
+        P2041 processor, e500mc cores.</para>
       </listitem>
 
-      <listitem>
-        <para>Freescale T4240RDB<remark> FIXME Why are these listed three
-        times?</remark></para>
-      </listitem>
 
-      <listitem>
-        <para>QEMU PPC</para>
-      </listitem>
     </itemizedlist></para>
 
   <para>Kernel configuration:</para>
 
   <itemizedlist>
     <listitem>
-      <para>P2041RDB: One kernel flavor (release)</para>
+      <para>P2041RDB: One kernel flavor (release)<remark>FIXME Why are these
+      listed three times? Why only "one kernel"??</remark></para>
     </listitem>
 
     <listitem>
-      <para>P3041DS: One kernel flavor (release)</para>
-    </listitem>
-
-    <listitem>
-      <para>T4240RDB: Two kernel flavors (release &amp; debug)</para>
+      <para>P3041DS: One kernel flavor (release)<remark>FIXME Why are these
+      listed three times?</remark></para>
     </listitem>
 
     <listitem>
@@ -94,32 +86,33 @@
   <para>Supported versions:<itemizedlist spacing="compact">
       <listitem>
         <para>Yocto version <xi:include
-        href="../../docsrc_common/pardoc-distro.xml"
+        href="../../s_docsrc_common/pardoc-distro.xml"
         xmlns:xi="http://www.w3.org/2001/XInclude"
-        xpointer="element(Yocto_VER/1)" /><remark>INFO: This is fetched from
+        xpointer="element(Yocto_VER/1)" /><remark>INFO: Auto-fetched from
         poky.ent via pardoc-distro.xml</remark></para>
       </listitem>
 
       <listitem>
         <para>poky source version <xi:include
-        href="../../docsrc_common/pardoc-distro.xml"
+        href="../../s_docsrc_common/pardoc-distro.xml"
         xmlns:xi="http://www.w3.org/2001/XInclude"
-        xpointer="element(Poky_VER/1)" /><remark>INFO: This is fetched from
+        xpointer="element(Poky_VER/1)" /><remark>INFO: Auto-fetched from
         poky.ent via pardoc-distro.xml</remark></para>
       </listitem>
 
       <listitem>
-        <para>gcc version: 4.9<remark>was EneaLinux_GCC_VER</remark></para>
+        <para>gcc version: 4.9<remark>was EneaLinux_GCC_VER Not in
+        poky.en</remark></para>
       </listitem>
 
       <listitem>
         <para>Linux kernel version for all targets: 3.12<remark>was
-        EneaLinux_KERNEL_VER</remark></para>
+        EneaLinux_KERNEL_VER Not in poky.ent</remark></para>
       </listitem>
 
       <listitem>
-        <para>Eclipse version 4.3 Kepler<remark>was Eclipse_VER and was
-        Eclipse_NAME</remark></para>
+        <para>Eclipse version 4.5 Mars<remark>was Eclipse_VER and was
+        Eclipse_NAME Not in poky.ent</remark></para>
       </listitem>
 
       <listitem>
@@ -130,10 +123,10 @@
   <para>Distribution channel:<itemizedlist spacing="compact">
       <listitem>
         <para>All deliverables can be downloaded from <xi:include
-        href="../../docsrc_common/pardoc-distro.xml"
+        href="../../s_docsrc_common/pardoc-distro.xml"
         xmlns:xi="http://www.w3.org/2001/XInclude"
-        xpointer="element(ULINK_ENEA_LINUX_URL/1)" /> <remark>This is still in
-        pardoc-distro.xml</remark></para>
+        xpointer="element(ULINK_ENEA_LINUX_URL/1)" /> <remark>QUEST REMOVE????
+        This is still in pardoc-distro.xml</remark></para>
       </listitem>
     </itemizedlist></para>
 
@@ -188,7 +181,7 @@
               <entry>Packages provided by Yocto</entry>
 
               <entry><para>See the Yocto "Release Notes" <xi:include
-              href="../../docsrc_common/pardoc-distro.xml"
+              href="../../s_docsrc_common/pardoc-distro.xml"
               xmlns:xi="http://www.w3.org/2001/XInclude"
               xpointer="element(ULINK_YOCTO_RELEASE_NOTES/1)" /></para></entry>
             </row>
@@ -221,19 +214,17 @@
   <section id="relinfo-documentation">
     <title>Provided Documentation</title>
 
-    <para>The following Enea Linux manuals are available for <xi:include
-    href="../../docsrc_common/pardoc-distro.xml"
-    xmlns:xi="http://www.w3.org/2001/XInclude"
-    xpointer="element(EneaLinux_REL_VER/1)" />:</para>
+    <para>The following Enea Linux manuals are available:</para>
 
     <itemizedlist spacing="compact">
       <listitem>
-        <para>README.htm - top page of the documentation</para>
+        <para>README.htm - top page of the documentation<remark>FIXME Needs to
+        be fixed to easily find also online doc</remark></para>
       </listitem>
 
       <listitem>
-        <para>README.release - text file describing the release contents,
-        installation, and quick getting started</para>
+        <para>README - text files describing various details like build- and
+        boot-commands</para>
       </listitem>
 
       <listitem>
@@ -242,12 +233,6 @@
       </listitem>
 
       <listitem>
-        <para><olink targetdoc="book_enea_linux_users_guide"
-        targetptr="book_enea_linux_users_guide"><trademark
-        class="registered">Enea</trademark> Linux User's Guide</olink></para>
-      </listitem>
-
-      <listitem>
         <para><olink targetdoc="book_enea_linux_open_source"
         targetptr="book_enea_linux_open_source"><trademark
         class="registered">Enea</trademark> Linux Open Source
@@ -262,6 +247,29 @@
       </listitem>
     </itemizedlist>
 
+    <para>User's Guides are available online, not inside the
+    distribution.</para>
+
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para><ulink
+        url="https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-application-dev-guide.pdf">Enea
+        Linux Application User's Guide</ulink>
+        (https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-applications-dev-guide.pdf)</para>
+      </listitem>
+
+      <listitem>
+        <para><ulink
+        url="https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-platforms-dev-guide.pdf">Enea
+        Linux Platforms User's Guide</ulink>
+        (https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-platforms-dev-guide.pdf)</para>
+      </listitem>
+    </itemizedlist>
+
+    <para>How to use Eclipse is described inside the Enea Linux user's guides.
+    Eclipse's own documentation is available in directory
+    <filename>eclipse/readme</filename>.</para>
+
     <para>The Enea Linux Eclipse tarball and Eclipse Open Source Report is
     inherited from Enea Linux 4.0. How to use Eclipse is described inside the
     <olink targetdoc="book_enea_linux_users_guide"
diff --git a/doc/book-enea-linux-release-info/doc/book.xml b/doc/book-enea-linux-release-info/doc/book.xml
index 3212850..2be87b0 100644
--- a/doc/book-enea-linux-release-info/doc/book.xml
+++ b/doc/book-enea-linux-release-info/doc/book.xml
@@ -5,10 +5,12 @@
 <book id="book_enea_linux_release_info">
   <title><trademark class="registered">Enea</trademark> Linux Release Information</title>
   <subtitle>Release Version
-         <xi:include href="../../docsrc_common/pardoc-distro.xml" xpointer="element(EneaLinux_REL_VER/1)"
+         <xi:include href="../../s_docsrc_common/pardoc-distro.xml" xpointer="element(EneaLinux_REL_VER/1)"
          xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle>
   <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="about_release.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="prerequisites.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="build_boot_generated.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="main_changes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="known_bugs_and_limitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="extracted_info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
diff --git a/doc/book-enea-linux-release-info/doc/build_boot_template.xml b/doc/book-enea-linux-release-info/doc/build_boot_template.xml
new file mode 100644
index 0000000..709e624
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/build_boot_template.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<chapter id="target_build_boot">
+  <title>Target Specific Build and Boot Instructions</title>
+
+  <para>For each target, a README file contains the build and boot
+  instructions. To make it easier for the reader, the contents of these
+  build/boot instruction have been extracted below into this release
+  information document.</para>
+
+  <para>The README files are parts of the distribution and can be seen after
+  the distribution is fetched.<remark>NOTE: Only EDIT THE TEMPLATE FILE! A new
+  build_boot.xml file is created from the template and sections are added
+  below automatically from the README files for each target when building the
+  book! Only in the template file you see a line below with SCRIPT_...._HERE
+  and the text telling that this is a template file.</remark></para>
+
+  <para>SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</para>
+
+  <para><emphasis role="bold">This is a template file which you can edit. When
+  the book is built, a new XML chapter file is created where the above part of
+  this file is copied to the new XML file and all from the line above is
+  replaced automatically by build and boot sections from the README
+  files!</emphasis></para>
+</chapter>
\ No newline at end of file
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 88ae1ef..2e6555b 100644
--- a/doc/book-enea-linux-release-info/doc/main_changes.xml
+++ b/doc/book-enea-linux-release-info/doc/main_changes.xml
@@ -5,7 +5,7 @@
   <title>Main Changes</title>
 
   <para>This chapter describes the major changes and additions in the Enea
-  Linux <xi:include href="../../docsrc_common/pardoc-distro.xml"
+  Linux <xi:include href="../../s_docsrc_common/pardoc-distro.xml"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xpointer="element(EneaLinux_REL_VER/1)" /> release compared to the previous
   general Enea Linux release (4.0-140919).</para>
@@ -44,17 +44,17 @@
     <itemizedlist spacing="compact">
       <listitem>
         <para>Enea Linux <xi:include
-        href="../../docsrc_common/pardoc-distro.xml"
+        href="../../s_docsrc_common/pardoc-distro.xml"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         xpointer="element(EneaLinux_REL_VER/1)" /> is based on Yocto
-        <xi:include href="../../docsrc_common/pardoc-distro.xml"
+        <xi:include href="../../s_docsrc_common/pardoc-distro.xml"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         xpointer="element(Yocto_VER/1)" /> (was 1.6)</para>
       </listitem>
 
       <listitem>
         <para>The poky source version is <xi:include
-        href="../../docsrc_common/pardoc-distro.xml"
+        href="../../s_docsrc_common/pardoc-distro.xml"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         xpointer="element(Poky_VER/1)" /> (was daisy-11.0)</para>
       </listitem>
diff --git a/doc/book-enea-linux-release-info/doc/prerequisites.xml b/doc/book-enea-linux-release-info/doc/prerequisites.xml
new file mode 100644
index 0000000..7241ed1
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/prerequisites.xml
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<chapter id="prerequisites">
+  <title>Prerequisites and Getting Enea Linux</title>
+
+  <section id="inst-host-packages">
+    <title>Install Host Packages</title>
+
+    <para>Building Enea Linux or compiling applications requires some packages
+    to be installed on your Linux development host. See the list of Required
+    Packages for Host Development System, found in the Yocto 2.1 document:
+    <ulink
+    url="https://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#required-packages-for-the-host-development-system">https://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#required-packages-for-the-host-development-system</ulink>.
+    If needed, replace 2.1 with the actual Yocto version in your Enea Linux
+    distribution.<remark>Sorry by the list in the Yocto document do not seem
+    to be enough at all at least for platform building! Therefore we need to
+    add a complete list here, and we actually have a bigger list than we
+    needed, but it's better to have more and not be needed than to lack
+    information.</remark></para>
+
+    <para>Install Host Packages</para>
+
+    <note>
+      <para>The list below is generic and might contain packages that are not
+      necessary. Additional packages might be required to build for some
+      targets. See the Enea Linux Release Information if more packages are
+      needed and which hosts have been tested by Enea for this Enea Linux
+      release.<remark>QUEST: Are the lists below ok? The lists below try to
+      cover ALL normal use cases for both ApplGuide and PlatfGuide, incl.
+      Eclipse, instead of limiting to some use case. Easier to keep
+      updated.</remark></para>
+    </note>
+
+    <section id="inst-host-packages-ubuntu-debian">
+      <title>Ubuntu or Debian</title>
+
+      <para>Ensure the system is up-to-date:</para>
+
+      <programlisting>$ sudo apt-get update</programlisting>
+
+      <para>For a supported <emphasis role="bold">Ubuntu</emphasis><indexterm>
+          <primary>Ubuntu</primary>
+        </indexterm> and <emphasis role="bold">Debian</emphasis><indexterm>
+          <primary>Debian</primary>
+        </indexterm> distributions you need the following packages:</para>
+
+      <programlisting># sudo apt-get install sed wget subversion git-core
+coreutils unzip texi2html texinfo libsdl1.2-dev docbook-utils fop gawk
+python-pysqlite2 diffstat make gcc build-essential xsltproc g++
+desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev autoconf automake
+groff libtool xterm libxml-parser-perl</programlisting>
+    </section>
+  </section>
+
+  <section id="get-el">
+    <title>Getting Enea Linux</title>
+
+    <para>For platform developers, an Enea Linux release is available for
+    cloning from git.enea.com. Releases are available in distribution-specific
+    repositories on git.enea.com, for cloning using the repo tool in the local
+    workstation. For more information on this topic, see the <olink
+    targetdoc="book_enea_linux_platforms_dev_guide"
+    targetptr="book_enea_linux_platforms_dev_guide">Enea Linux Platforms
+    Development Guide</olink> on <ulink
+    url="http://portal.enea.com">http://portal.enea.com</ulink>.</para>
+
+    <para>Application developers will download pre-complied images from the
+    Enea Portal or will receive prebuilt images from the platform developers.
+    For further information on this see <olink
+    targetdoc="book_enea_linux_app_dev_guide"
+    targetptr="book_enea_linux_app_dev_guide">Enea Linux Application
+    Development Guide</olink>.</para>
+  </section>
+</chapter>
\ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/supported_features.xml b/doc/book-enea-linux-release-info/doc/supported_features.xml
index 11e49b1..ebc4b59 100644
--- a/doc/book-enea-linux-release-info/doc/supported_features.xml
+++ b/doc/book-enea-linux-release-info/doc/supported_features.xml
@@ -6,7 +6,7 @@
 
   <para>The basic features provided by Yocto are listed on the "Features" tab
     on the <xi:include
-        href="../../docsrc_common/pardoc-distro.xml"
+        href="../../s_docsrc_common/pardoc-distro.xml"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         xpointer="element(ULINK_YOCTO_RELEASE_NOTES/1)" /><remark>???? FIXME THIS WAS "ULINK_YOCTO_DOWN_MINOR_URL"    in previous pardoc-distro file - I don't know what is shall be
       now. Perhaps it is Yocto release notes which I have changed this to, as found in poky.ent</remark>.</para>