Doc Add autovariables from manifest, poky.ent, enea.conf

Add autovariable from manifest repository name,
    e.g. the profile name
Add autovariables from poky.ent, e.g. Yocto version etc..
    in pardoc-distro
Add autovariables from enea.conf e.g. release MAJOR MINOR
    via generated s_docsrc_common/pardoc-distro
    and also pick up MAJOR MINOR into the
    make system to create BOOK_VER => BL_LABEL on books
Add autocreate build_boot chapter in release info
    from the README files in all included targets
Adapt book XML files to the above
Currently this makes the Makefile and init scripts identical
in different el6-<profile>.git
All are now automatic: Just clone el6-xxxx.git and
   cd el6-xxx/doc ; make doc
and all are done until the books are built and ready.
It takes several minutes to autofetch all from git
using the repo command according to the target manifests
before the books start to build.
Rebuilding books are quick.

Signed-off-by: Lennart Johansson <lennart.johansson@enea.com>

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>