1 files changed, 40 insertions, 20 deletions

diff --git a/doc/Makefile b/doc/Makefile
index 7fd9b52..59d25d5 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -20,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
 
 
 
@@ -38,11 +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-eclipse-open-source
-# COMPONENTS += book-enea-linux-target-guide
-
+#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)
@@ -65,24 +66,23 @@ 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 all needed s_* below'
+        @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 'make pullbuild                 #git pull in s_docbuild'
-        @echo 'make pulltargets               #git pull in s_targets'
+        @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 ''
         @echo 'Optional parameters for make doc:'
@@ -105,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'
@@ -124,7 +124,8 @@ ifeq ($(DOCBOOK_TOOLS_VERSIONS),yes)
         $(VERB)$(MAKE) -f $(DOCBOOKMAKE)/tools_book_standalone.mk book_tools_versions
 endif
 
-init: initbuild inittargets initpardoc
+# 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
@@ -150,7 +151,7 @@ FORMAT=html pdf eclipse
 endif
 
 
-books: initbuild inittargets initpardoc
+books: init
 # BOOKPACKAGES is defined in all book-*/swcomp.mk
         $(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>.*//'` ; \
@@ -169,8 +170,8 @@ ifeq ($(DOCBOOK_CLEANTMP),yes)
 endif
 endif
 
-# cleaninit cleans ALL tmpcommon and all s_*
-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 \
@@ -214,12 +215,12 @@ $(TMPCLONEROOT_TARGETS):
 
 # ****************************************************************************
 # ******************** 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
-.PHONY: initpardoc
 
 initpardoc:   s_docsrc_common
 
@@ -233,14 +234,33 @@ $(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`; echo "FIRSTTARGET is $$FIRSTTARGET" ; \
+        $(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/".*"/"'"$$DISTRO_VERSION_MAJOR$$DISTRO_VERSION_MINOR"'"/' >$(TMPPARDOC) ; \
+             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
+
+# ****************************************************************************