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>

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
+
+# ****************************************************************************