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>

11 files changed, 378 insertions, 115 deletions

diff --git a/doc/Makefile b/doc/Makefile
index 306bd4d..59d25d5 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,6 +1,11 @@
 #Path to this subsystem's root directory
 SUBSYSROOT := $(shell pwd)
 
+MANIFEST_DIR = $(dir $(SUBSYSROOT))
+MANIFEST_NAME = $(lastword $(subst /, ,$(MANIFEST_DIR)))
+MANIFEST_TAIL = $(word 2,$(subst -, ,$(MANIFEST_NAME)))
+
+# Generic docbuild.git auto-clone + s_docbuild symlink. Includes TMPCLONEROOT
 include init.mk
 
 # ****************** SUPPORT FOR TARGETS ***************************
@@ -15,8 +20,10 @@ TARGETDEFAULTXMLS    := $(shell cd $(REPODIR); ls -1 */default.xml)
 # URL and HASH of this manifest repository to be used by the repo tool
 CURRENTHASH := $(shell git log -1 --pretty=format:%H 2>/dev/null)
 CURRENTURL := $(shell git remote show origin | sed -n '/Fetch URL: /s/^.*URL: //p' 2>/dev/null)
-.PHONY: inittargets
-# ******************************************************************
+
+# ******************* AutoGenerated chapter from template and target READMEs *******
+BUILDBOOT_XML      := book-enea-linux-release-info/doc/build_boot_generated.xml
+BUILDBOOT_TEMPLATE := book-enea-linux-release-info/doc/build_boot_template.xml
 
 
 
@@ -33,27 +40,10 @@ DOCBOOK_FO_USEFOP ?= yes
 DOCBOOK_TO_BOOKDIR ?= yes
 DOCBOOK_CLEANTMP ?= yes
 
-#Components in this subsystem
-COMPONENTS := book-enea-linux-release-info book-enea-linux-open-source
-# COMPONENTS += book-enea-linux-target-guide
-# -----------------------------------------------------
-#Release version, used in labels and text
-REL_VER_EXT := $(shell perl -e \
-'while(<>) {\
-  if (/<!ENTITY ENEA_LINUX_REL_VER "([\d\.-\w]+)">/) { print $$1 ; exit; }\
-}' \
-< $(SUBSYSROOT)/docsrc_common/pardoc-distro.xml 2>/dev/null)
-#$(info REL_VER_EXT = $(REL_VER_EXT))
-
-ifneq ($(REL_VER_EXT),)
-REL_VER ?= $(REL_VER_EXT)
-else
-REL_VER ?= undefined
-endif
-$(info REL_VER = $(REL_VER))
-
-# -----------------------------------------------------
-
+#Components (books) in this subsystem
+#  COMPONENTS := book-enea-linux-release-info book-enea-linux-open-source
+#  COMPONENTS += book-enea-linux-eclipse-open-source
+COMPONENTS := $(shell ls -d book-enea* )
 
 # --------------------------------------------------------------
 ifeq ($(VERBOSE),yes)
@@ -76,34 +66,31 @@ VALIDATE = no
 # Export all parameters including those on the command line
 export
 
-.PHONY: doc books docusage
+.PHONY: doc books docusage init initbuild inittargets initpardoc initbuildboot
 
 
 docusage:
         @echo 'make docusage                #Shows this help text'
         @echo '  DOCBOOK_TOOLS_VERSIONS=yes #Displays DocBook tools versions in this machine'
         @echo 'make doc                    #Builds the userdoc, does autoinit if needed'
-        @echo 'make init                      #Init both below'
-        @echo 'make initbuild                 #Init s_docbuild'
-        @echo 'make inittargets               #Init s_targets using repo tool'
+        @echo 'make init                      #Init all needed init* below'
+        @echo 'make initbuild                 #Init s_docbuild Docbook build system and central files'
+        @echo 'make inittargets               #Init s_targets using repo tool Targets in this distro with poky'
+        @echo 'make initpardoc                #Init s_docsrc_common using info from poky/'
+        @echo 'make initbuildboot             #Init build_boot chapter from READMEs and template in release info'
         @echo ' DOCBOOK_CLEANTMP=no           #Option to keep temp files in doc/ and tmp/'
         @echo ' BOOK_GLOBALCLONEROOT=yes      #Option for all init above to clone all outside the doc directory'
         @echo ' BOOK_GLOBALCLONEROOT=otherpath #Option for all init above to clone all'
-        @echo              #Force rebuilding (ignore dependency on file times or BL_LABEL)'
-        @echo '                            #   Dependency only works if common doc directory is kept'
-        @echo '  BOOKCONDITION'make pullbuild                 #git pull in s_docbuild'
-        @echo 'make pulltargets               #git pull in s_targets'
+        @echo 'make pullbuild                 #git pull in s_docbuild'
+        @echo 'make pulltargets               #git pull in s_targets. You need also initpardoc initbuildboot'
         @echo 'make clean                     #Clean. Also clean s_* but not any external clones'
-        @echo 'The following directories are cloned via the init commands (s_* are symlinks to clones):'
-        @echo '  s_docbuild                #Docbook build system and central files'
-        @echo '  s_targets                 #targets in this distro with poky, for picking some parameters'
         @echo ''
         @echo 'Optional parameters for make doc:'
         @echo '  COMP=<book-directory>     #Component (book) to build. Book component names are book-*'
         @echo '                            #Default component/s:'
         @echo '    $(COMPONENTS)'
         @echo '  FORMAT=<format>           #One of: pdf, html, or eclipse (Default all are built)'
-        @echo '  BL_LABEL=<baseline>       #Becomes footer in book (default: date + time)'
+        @echo '  BL_LABEL=<baseline>       #Becomes footer in book (default: from poky enea.conf MAJORMINOR)'
         @echo '  DOCBOOK_TO_BOOKDIR=no     #(default yes) Avoid moving result to book directory'
         @echo '                            #   and avoid erasing common doc and tmp directories'
         @echo '  BOOKFORCE=yes             #Force rebuilding (ignore dependency on file times or BL_LABEL)'
@@ -118,7 +105,7 @@ docusage:
         @echo '  DOCBOOK_OLINK_TARGETDB=only  #Build a target db for this book (for links into it)'
         @echo '  DOCBOOK_OLINK_TARGETDB=yes   #Build a target db AND build the book'
         @echo '                               #Master olinkdb defined in this Makefile, one per generated format, is:'
-        @echo '                                $(DOCBOOKOLINKDB_BASE)_*.db'
+        @echo '   $(DOCBOOKOLINKDB_BASE)_*.db'
         @echo '  Typical examples:'
         @echo '     make doc                          Creates all books, all formats'
         @echo '     make doc COMP=book-xxxx FORMAT=html'
@@ -137,7 +124,8 @@ ifeq ($(DOCBOOK_TOOLS_VERSIONS),yes)
         $(VERB)$(MAKE) -f $(DOCBOOKMAKE)/tools_book_standalone.mk book_tools_versions
 endif
 
-init: initbuild inittargets
+# We rely on make doing these in order left to right
+init: initbuild inittargets initpardoc initbuildboot
 pullall: pullbuild pulltargets
 
 # If no COMP, iterate over books-* in COMPONENTS with make doc
@@ -163,24 +151,27 @@ FORMAT=html pdf eclipse
 endif
 
 
-books: initbuild inittargets
+books: init
 # BOOKPACKAGES is defined in all book-*/swcomp.mk
-        $(VERB)for book in $(BOOKPACKAGES); do \
+        $(VERB)DISTRO_VERSION_MAJOR=`egrep '"EneaLinux_DISTRO_VERSION_MAJOR"' s_docsrc_common/pardoc-distro.xml | sed 's/.*<phrase>//;s/<\/phrase>.*//'` ; \
+               DISTRO_VERSION_MINOR=`egrep '"EneaLinux_DISTRO_VERSION_MINOR"' s_docsrc_common/pardoc-distro.xml | sed 's/.*<phrase>//;s/<\/phrase>.*//'` ; \
+               BOOKVER="Profile $(MANIFEST_TAIL)-$$DISTRO_VERSION_MAJOR$$DISTRO_VERSION_MINOR" ; \
+         for book in $(BOOKPACKAGES); do \
           for format in $(FORMAT); do \
-            $(MAKE) -f $(DOCBOOKMAKE)/make_docbook_standalone.mk BOOK=$$book FORMAT=$$format books || exit 10; \
+            $(MAKE) -f $(DOCBOOKMAKE)/make_docbook_standalone.mk BOOK=$$book FORMAT=$$format BOOK_VER="$$BOOKVER" books || exit 10; \
           done ; \
-        done
+         done
 ifeq ($(DOCBOOK_TO_BOOKDIR),yes)
-        $(VERB)rm -rf doc tmp
+         $(VERB)rm -rf doc tmp
 else
 ifeq ($(DOCBOOK_CLEANTMP),yes)
-#       keep only doc/pdf/book-*.pdf doc/eclipse/plugins/com.enea.doc.book-* but delete doc/eclipse/plugins/com.enea.doc.book-*/done*
-        $(VERB)rm -rf tmp 2>/dev/null ; rm -rf doc/pdf/book-*/ ; rm -rf doc/eclipse/plugins/com.enea.doc.book-*/done* 2>/dev/null
+#        keep only doc/pdf/book-*.pdf doc/eclipse/plugins/com.enea.doc.book-* but delete doc/eclipse/plugins/com.enea.doc.book-*/done*
+         $(VERB)rm -rf tmp 2>/dev/null ; rm -rf doc/pdf/book-*/ ; rm -rf doc/eclipse/plugins/com.enea.doc.book-*/done* 2>/dev/null
 endif
 endif
 
-
-clean:  cleaninit
+# cleaninit cleans ALL tmpcommon and all s_* and generated build_boot chapter xml
+clean:  cleaninit cleanbuildboot
         $(VERB)rm -rf doc tmp 2>/dev/null
 ifneq ($(filter book-%, $(COMPONENTS)),)
         $(VERB)for comp in $(filter book-%, $(COMPONENTS)); do \
@@ -221,4 +212,55 @@ $(TMPCLONEROOT_TARGETS):
                               repo init -u $(CURRENTURL) -b $(CURRENTHASH) -m $$target_default_xml ; repo sync ; \
             ) ; \
           done
-# ******************************************************************
+
+# ****************************************************************************
+# ******************** SUPPORT FOR dynamic pardoc with added parameters ******
+# pardoc-distro can contain MAJOR.MINOR-xxxxx keeping -xxxx when replacing MINOR.MINOR from enea.conf
+
+PATH_DOCSRC_COMMON    = $(SUBSYSROOT)/s_docsrc_common
+NAME_DOCSRC_COMMON    = docsrc_common
+TMPCLONEROOT_DOCSRC_COMMON := $(TMPCLONEROOT)/$(NAME_DOCSRC_COMMON)
+TMPPARDOC                  := $(TMPCLONEROOT_DOCSRC_COMMON)/pardoc-distro.xml
+
+initpardoc:   s_docsrc_common
+
+cleanpardoc:
+        $(VERB)rm -rf $(TMPCLONEROOT_DOCSRC_COMMON) ; rm s_docsrc_common
+
+s_docsrc_common:  $(TMPCLONEROOT_DOCSRC_COMMON)
+        $(VERB)rm s_docsrc_common 2>/dev/null; ln -s $(TMPCLONEROOT_DOCSRC_COMMON) s_docsrc_common
+
+$(TMPCLONEROOT_DOCSRC_COMMON): s_targets
+        $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi
+        $(VERB)if [ ! -d $(TMPCLONEROOT_DOCSRC_COMMON) ]; then mkdir -p $(TMPCLONEROOT_DOCSRC_COMMON) ; fi
+        @echo "Copy and patch docsrc_common/ files to $(TMPCLONEROOT_DOCSRC_COMMON)"
+        $(VERB)FIRSTTARGET=`ls -1 s_targets/ | head -1`; \
+          ENEACONF=s_targets/$$FIRSTTARGET/poky/meta-el-common/conf/distro/enea.conf ; \
+          DISTRO_VERSION_MAJOR=`egrep '^DISTRO_VERSION_MAJOR' $$ENEACONF | sed 's/^[^"]*"//;s/".*//'` ; \
+          DISTRO_VERSION_MINOR=`egrep '^DISTRO_VERSION_MINOR' $$ENEACONF | sed 's/^[^"]*"//;s/".*//'` ; \
+          cat docsrc_common/pardoc-distro.xml | sed '/<\/section>/d' | \
+             sed '/<!ENTITY ENEA_LINUX_REL_VER/s/MAJOR.MINOR/'"$$DISTRO_VERSION_MAJOR$$DISTRO_VERSION_MINOR"'/' | \
+             sed '/<!ENTITY . common_poky_entities SYSTEM/s/s_targets\/[^\/]*\/poky/s_targets\/'"$$FIRSTTARGET"'\/poky/' >$(TMPPARDOC) ; \
+          echo "<para id=\"EneaLinux_DISTRO_VERSION_MAJOR\"><phrase>$$DISTRO_VERSION_MAJOR</phrase></para>" >>$(TMPPARDOC) ; \
+          echo "<para id=\"EneaLinux_DISTRO_VERSION_MINOR\"><phrase>$$DISTRO_VERSION_MINOR</phrase></para>" >>$(TMPPARDOC) ; \
+          echo "</section>" >>$(TMPPARDOC)
+
+# ****************************************************************************
+# ***** Create XML chapter with build/boot commands from all README files in s_targets
+
+initbuildboot: $(BUILDBOOT_XML)
+
+cleanbuildboot:
+        $(VERB)rm -f $(BUILDBOOT_XML) 2>/dev/null
+
+
+$(BUILDBOOT_XML): s_targets $(BUILDBOOT_TEMPLATE)
+        @echo "Creating $(BUILDBOOT_XML) from READMEs"
+        $(VERB)INITBB_CMD=initbuildboot.sh ; \
+          if [ -f "$$INITBB_CMD" ]; then \
+             sh "$$INITBB_CMD" -xml $(BUILDBOOT_XML) -template $(BUILDBOOT_TEMPLATE) ; \
+          else \
+             echo "ERROR: Missing $$INITBB_CMD, can not create $(BUILDBOOT_XML)"; exit 10; \
+          fi
+
+# ****************************************************************************
diff --git a/doc/book-enea-linux-open-source/doc/about.xml b/doc/book-enea-linux-open-source/doc/about.xml
index 30f00e9..a3d62f8 100644
--- a/doc/book-enea-linux-open-source/doc/about.xml
+++ b/doc/book-enea-linux-open-source/doc/about.xml
@@ -6,7 +6,7 @@
 
   <para>This document contains the open source and license information
   pertaining to the Eclipse package provided with 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)" />.</para>
 </chapter>
\ No newline at end of file
diff --git a/doc/book-enea-linux-open-source/doc/book.xml b/doc/book-enea-linux-open-source/doc/book.xml
index dcc1189..d5da88e 100644
--- a/doc/book-enea-linux-open-source/doc/book.xml
+++ b/doc/book-enea-linux-open-source/doc/book.xml
@@ -6,7 +6,7 @@
 <book id="book_enea_linux_open_source">
   <title><trademark class="registered">Enea</trademark> Linux Open Source Report</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.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
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>
diff --git a/doc/docsrc_common/pardoc-distro.xml b/doc/docsrc_common/pardoc-distro.xml
index 129d7a5..9c9edd6 100644
--- a/doc/docsrc_common/pardoc-distro.xml
+++ b/doc/docsrc_common/pardoc-distro.xml
@@ -5,7 +5,7 @@
 ==============================
 -->
 <!-- Distribution and release -->
-<!ENTITY ENEA_LINUX_REL_VER "6-Networking">  <!-- used also in Makefile -->
+<!ENTITY ENEA_LINUX_REL_VER "MAJOR.MINOR-Networking">  <!-- TEMPLATE LINE, IS PATCHED by Makefile with values from enea.conf in poky/ -->
 <!ENTITY % common_poky_entities SYSTEM "../s_targets/qemuarm/poky/documentation/poky.ent">
 %common_poky_entities;
 ]>
@@ -24,8 +24,6 @@
 
   <para>**** The phrase elements below can be used as variables in several
              places in XML files ****</para>
-  <para>**** In addition: Makefile parses variable REL_VER from entity ENEA_LINUX_REL_VER,
-             after which swcomp.mk extracts BOOK_VER from variable REL_VER ****</para>
 
   <para>You can add more elements using ENTITY lines in poky.ent, e.g. like Poky_VER below</para>
 
@@ -34,5 +32,6 @@
 <para id="ULINK_ENEA_LINUX_URL"><ulink url='https://linux.enea.com/&ENEA_LINUX_REL_VER;'>https://linux.enea.com/&ENEA_LINUX_REL_VER;</ulink></para>
 <para id="Poky_VER"><phrase>&POKYVERSION;</phrase></para>
 <para id="Yocto_VER"><phrase>&DISTRO;</phrase></para>
+<para id="Yocto_NAME"><phrase>&DISTRO_NAME_NO_CAP;</phrase></para>
 <para id="ULINK_YOCTO_RELEASE_NOTES"><ulink url='&YOCTO_RELEASE_NOTES;'>&YOCTO_RELEASE_NOTES;</ulink></para>
 </section>
diff --git a/doc/initbuildboot.sh b/doc/initbuildboot.sh
new file mode 100644
index 0000000..72606a6
--- /dev/null
+++ b/doc/initbuildboot.sh
@@ -0,0 +1,111 @@
+#!/bin/sh
+VER="R0.06"
+
+BBTEMPLATE=
+BBXML=
+
+USAGE="`basename $0` -xml buildbootxml-to-create  -template templatexml-file ($VER)
+    Currently only supports sequence types Build-command: and Boot-command:
+    Both files should have path book-*release-info/doc/
+    Creates the XML file from the template, inserting build/boot commands
+    from the various s_targets/XXXtargetXXX/README files
+    at the place in template with >SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE<
+    ignoring rest of template
+    The code tries to fold too long lines, but this is not perfect. Best would
+    be if the command lines already in README are short enough, e.g. by
+    using short variables, which work both on shell and uboot command lines"
+
+while echo "x$1" | egrep '^x-' >/dev/null 2>&1
+do
+  OPT="$1" ; shift
+  if [ "$OPT" = "--help" -o "$OPT" = "-h" -o "$OPT" = "-help" ] ; then echo "$USAGE" ; exit ; fi
+  if [ "$OPT" = "-xml" ] ; then BBXML="$1" ; shift; fi
+  if [ "$OPT" = "-template" ] ; then BBTEMPLATE="$1" ; shift; fi
+done
+if [ "$BBTEMPLATE" = "" ]; then echo "ERROR: Missing option -template templatefile"; exit ; fi
+if [ "$BBXML" = ""      ]; then echo "ERROR: Missing option -xml buildbootxml-to-create"; exit ; fi
+if [ ! -f "$BBTEMPLATE" ]; then echo "ERROR: Missing templatefile '$BBTEMPLATE'"; exit; fi
+if [ ! -d "`dirname \"$BBXML\"`" ]; then echo "ERROR: Missing parent directory for '$BBXML'"; exit ; fi
+
+echo "`basename $0` Creating $BBXML from"
+TARGETREADMES=`cd s_targets ; ls -d */README | tr '\n' ' '`
+echo "     $TARGETREADMES"
+
+# README file formats:
+# a) Sequence starts: ___ XXXX:yyyy or ___ XXXX:yyyy conffile
+#    where XXXX is a type, yyyy is text to be in title
+# b) Inside sequence: ___ END ends the sequence  (ignore rest of line)
+# c) Inside sequence: # Documentation line
+# d) Inside sequence: Anything else is command or config lines
+#    Conv.to XML: ">" "<" "&" and put all inside <programlisting>
+# *) Anywhere ____xxxx Leading 4 underlines or more, always ignored
+#    unless one of the recognized XXXX
+# *) Anywhere outside sequence, ignore all
+# *) There can be multiple of each type of sequence in each README file
+#    with different yyyy
+
+
+cat $BBTEMPLATE | awk '
+   />SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</ {exit 0; }
+   { print $0; }
+' >$BBXML
+
+
+# Long command lines: The awk code below breaks too long lines, but this is not perfect.
+extractcmds_filter() {
+   echo "        <programlisting>" | tr -d '\n'
+   sed '/^___/d;s/\&/\&amp;/g' | sed 's/</\&lt;/g;s/>/\&gt;/g;/^$/d' | \
+    awk 'BEGIN               { MAX=90; }
+         ( length($0) > MAX ) {
+            LINE=$0;
+            while (length(LINE) > MAX) {
+              if (index(LINE," ") == 0 ) {
+                print "ERROR: PROBLEM: No space in too long line:" LINE  > "/dev/stderr";
+                print $LINE;
+                next;
+              }
+              i=MAX; while ( substr(LINE,i,1) != " " ) { i=i-1; if (i==0) {break;} }
+              print substr(LINE,0,i) "\\";
+              REST=substr(LINE,i+1);
+              if ( length(REST) == 0 ) { next ; }
+              LINE="           " REST;
+            }
+            if ( length(LINE) > 0 ) { print LINE; next ; }
+         }
+         { print;}'
+   echo "</programlisting>"
+}
+
+extractcmds_for_type() { # target/README BOOTorBUILD
+  README=s_targets/"$1"
+  CMDTYPE="$2"
+  COMMANDSFOR=`egrep "___$CMDTYPE:" $README`
+  for CMDS in $COMMANDSFOR
+  do
+     cmdsfor=`echo "$CMDS" | sed 's/[^:]*://'`
+     echo "         <para>$CMDTYPE for $cmdsfor</para>"
+     cat "$README" | sed -n "/$COMMANDSFOR/,/___END/p" | extractcmds_filter
+  done
+}
+
+for targetreadme in $TARGETREADMES
+do
+   TARGET=`dirname $targetreadme`
+   echo "" >>$BBXML
+   echo "  <section id=\"target_$TARGET\">" >>$BBXML
+   echo "    <title>Target $TARGET - Build and Boot Instructions</title>" >>$BBXML
+   echo "     <remark>NOTE: DO NOT EDIT THIS GENERATED FILE! Only edit the template file.</remark>" >>$BBXML
+   echo "    <section>" >>$BBXML
+   echo "        <title>Build Instructions</title>" >>$BBXML
+   extractcmds_for_type $targetreadme Build-command >>$BBXML
+   echo "    </section>" >>$BBXML
+   echo "" >>$BBXML
+   echo "    <section>" >>$BBXML
+   echo "       <title>Boot Instructions</title>" >>$BBXML
+   extractcmds_for_type $targetreadme Boot-command >>$BBXML
+   echo "    </section>" >>$BBXML
+   echo "  </section>" >>$BBXML
+done
+
+echo "</chapter>" >>$BBXML
+echo "Ready created $BBXML"