summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLennart Johansson <lennart.johansson@enea.com>2017-03-28 13:42:06 +0200
committerLennart Johansson <lennart.johansson@enea.com>2017-03-28 13:42:06 +0200
commit9b5b099ac72c125a8dc75c6f02346f2a1c6a5d38 (patch)
treeebfaca93f8e60febb3cecf7fe83e1167d4200d39
parent6aff72624ec1c001e065f270f1140049db05fbb9 (diff)
downloadel_releases-standard-9b5b099ac72c125a8dc75c6f02346f2a1c6a5d38.tar.gz
Use new eltf_params_updates.xml for later ELTF autoupdate
LXCR-7377 Change to allow ELTF to autoupdate all parameters in the release info and the open-source books. All parameters, including also multiline commands and complete tables of all target machine parameters are stored in one file eltf_params_updates.xml Prepared for auto-updating by ELTF by using a template elft_params_template.xml with ELTF_* variables from which a new eltf_params_updates.xml can be created and pushed (if changed) This includes the -b option to the repo command, which is the branch or tag of the MANIFEST. This is what the user uses to get the source. In a final distribution this tag shall be same as the tag given in manifest_conf.mk Left is manifest_conf.mk but MANIFESTHASH can be overridden by an env.variable when building. MANIFESTHASH still defines which MANIFEST to clone when building the doc to get a list of valid MACHINE names and to get the valid build/boot commands from the MANIFEST. Left is also pardoc-distro.xml with three version variables used by gen_known_issues.py and gen_pkgdiff.py Signed-off-by: Lennart Johansson <lennart.johansson@enea.com>
Diffstat
-rw-r--r--doc/Makefile156
-rw-r--r--doc/book-enea-linux-eclipse-open-source/doc/book.xml2
-rw-r--r--doc/book-enea-linux-open-source/doc/about.xml2
-rw-r--r--doc/book-enea-linux-open-source/doc/book.xml2
-rw-r--r--doc/book-enea-linux-release-info/doc/about_release.xml349
-rw-r--r--doc/book-enea-linux-release-info/doc/book.xml2
-rw-r--r--doc/book-enea-linux-release-info/doc/build_boot_template.xml12
-rw-r--r--doc/book-enea-linux-release-info/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-linux-release-info/doc/eltf_params_updated.xml429
-rw-r--r--doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt320
-rw-r--r--doc/book-enea-linux-release-info/doc/extracted_info.xml18
-rw-r--r--doc/book-enea-linux-release-info/doc/extracted_info_template.xml10
-rw-r--r--doc/book-enea-linux-release-info/doc/getting_enea_linux.xml46
-rw-r--r--doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml30
-rw-r--r--doc/book-enea-linux-release-info/doc/main_changes.xml30
-rw-r--r--doc/book-enea-linux-release-info/doc/prerequisites.xml26
-rw-r--r--doc/book-enea-linux-release-info/doc/targetscontain.xml867
-rw-r--r--doc/book-enea-linux-release-info/doc/targetscontain_template.xml12
-rw-r--r--doc/docsrc_common/pardoc-distro.xml20
-rw-r--r--doc/initbuildboot.sh14
20 files changed, 1113 insertions, 1385 deletions
diff --git a/doc/Makefile b/doc/Makefile
index 7982e0c..8d76326 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,3 +1,5 @@
1#2017-03-27 Replaced poky autocloning for parameter extraction with XML file updated by the ELTF test system
2
1#Path to this subsystem's root directory 3#Path to this subsystem's root directory
2SUBSYSROOT := $(shell pwd) 4SUBSYSROOT := $(shell pwd)
3 5
@@ -7,21 +9,13 @@ include manifest_conf.mk
7MANIFESTDIR := $(shell echo "$(MANIFESTURL)" | sed 's/.*\///;s/\.git//') 9MANIFESTDIR := $(shell echo "$(MANIFESTURL)" | sed 's/.*\///;s/\.git//')
8 10
9# Further down we extract the list of target manifest file names from the manifest itself 11# Further down we extract the list of target manifest file names from the manifest itself
10# We need all to get all README, but only first in alphabetic list is used to extract info from poky/ 12
11 13
12 14
13# ***************** Generic docbuild.git auto-clone + s_docbuild symlink *** 15# ***************** Generic docbuild.git auto-clone + s_docbuild symlink ***
14# This also defines TMPCLONEROOT which optionally can be nondefault using BOOK_GLOBALCLONEROOT=yes or a path 16# This also defines TMPCLONEROOT which optionally can be nondefault using BOOK_GLOBALCLONEROOT=yes or a path
15include init.mk 17include init.mk
16 18
17# ****************** SUPPORT FOR TARGETS ***************************
18PATH_TARGETS = $(SUBSYSROOT)/s_targets
19#Git repositories to be cloned
20NAME_TARGETS := targets
21#Path to the directory under which repos shall be cloned.
22DOCBASEDIR=$(shell pwd)
23REPODIR=$(DOCBASEDIR)/..
24TMPCLONEROOT_TARGETS := $(TMPCLONEROOT)/$(NAME_TARGETS)
25TMPCLONEROOT_MANIFEST := $(TMPCLONEROOT)/manifest 19TMPCLONEROOT_MANIFEST := $(TMPCLONEROOT)/manifest
26 20
27 21
@@ -32,7 +26,11 @@ BUILDBOOT_TEMPLATE := book-enea-linux-release-info/doc/build_boot_template.xml
32PKGDIFF_GEN_XML := book-enea-linux-release-info/doc/pkgdiff_generated.xml 26PKGDIFF_GEN_XML := book-enea-linux-release-info/doc/pkgdiff_generated.xml
33JIRA_ISSUES_GEN_XML := book-enea-linux-release-info/doc/jiraissues_generated.xml 27JIRA_ISSUES_GEN_XML := book-enea-linux-release-info/doc/jiraissues_generated.xml
34 28
35MANIFESTFILES_XML := book-enea-linux-release-info/doc/manifestfiles_generated.xml 29MACHINE_LIST_XML := book-enea-linux-release-info/doc/machine_list_generated.xml
30
31ELTF_PARAMS_TEMPLATE := book-enea-linux-release-info/doc/eltf_params_template.xml
32ELTF_PARAMS_UPDATED := book-enea-linux-release-info/doc/eltf_params_updated.xml
33
36 34
37 35
38# ----------------------------------------------------- 36# -----------------------------------------------------
@@ -73,12 +71,12 @@ VALIDATE = no
73# Export all parameters including those on the command line 71# Export all parameters including those on the command line
74export 72export
75 73
76.PHONY: doc books docusage init initbuild initmanifest inittargets initpardoc initbuildboot dist 74.PHONY: doc books docusage init initbuild initmanifest initpardoc initbuildboot dist
77 75
78 76
79docusage: 77docusage:
80 @echo 'make docusage #Shows this help text' 78 @echo 'make docusage #Shows this help text'
81 @echo ' DOCBOOK_TOOLS_VERSIONS=yes #Displays DocBook tools versions in this machine' 79 @echo ' DOCBOOK_TOOLS_VERSIONS=yes #Displays./testeltfver.sh DocBook tools versions in this machine'
82 @echo 'make doc #Builds doc. ALSO automatically does all inits if needed' 80 @echo 'make doc #Builds doc. ALSO automatically does all inits if needed'
83 @echo 'make dist BOOK_DIST_DIR=xx/doc #Builds doc as above and copies results to BOOK_DIST_DIR' 81 @echo 'make dist BOOK_DIST_DIR=xx/doc #Builds doc as above and copies results to BOOK_DIST_DIR'
84 @echo ' # Does not work with DOCBOOK_TO_BOOKDIR or BOOK_BUILD_DIR' 82 @echo ' # Does not work with DOCBOOK_TO_BOOKDIR or BOOK_BUILD_DIR'
@@ -87,10 +85,10 @@ docusage:
87 @echo 'make init #Init all needed init* below' 85 @echo 'make init #Init all needed init* below'
88 @echo 'make initbuild #Init s_docbuild Docbook build system and central files' 86 @echo 'make initbuild #Init s_docbuild Docbook build system and central files'
89 @echo 'make initmanifest #Init s_manifest by cloning, to detect which targets are included' 87 @echo 'make initmanifest #Init s_manifest by cloning, to detect which targets are included'
90 @echo 'make inittargets #Init s_targets using repo tool. Targets in this distro with poky'
91 @echo 'make initpardoc #Init s_docsrc_common with extracted parameters/' 88 @echo 'make initpardoc #Init s_docsrc_common with extracted parameters/'
92 @echo 'make initbuildboot #Init build_boot chapter from READMEs and template in release info' 89 @echo 'make initbuildboot #Init build_boot chapter from READMEs and template in release info'
93 @echo 'make initissues #Init known issues section from Jira' 90 @echo 'make initissues #Init known issues section from Jira'
91 @echo 'make eltf #Test - displays all ELTF_xxx variables that ELTF shall replace'
94 @echo ' MANIFESTHASH=xxxxx #Option for all inits above to use nondefault manifest version' 92 @echo ' MANIFESTHASH=xxxxx #Option for all inits above to use nondefault manifest version'
95 @echo ' #It shall either be ref/tags/<tagvalue> or a hashvalue' 93 @echo ' #It shall either be ref/tags/<tagvalue> or a hashvalue'
96 @echo ' #Configured tag or hashvalue $(MANIFESTHASH)' 94 @echo ' #Configured tag or hashvalue $(MANIFESTHASH)'
@@ -99,7 +97,6 @@ docusage:
99 @echo ' DOCBOOK_CLEANTMP=no #Option to keep temp files in doc/ and tmp/' 97 @echo ' DOCBOOK_CLEANTMP=no #Option to keep temp files in doc/ and tmp/'
100 @echo ' BOOK_GLOBALCLONEROOT=yes #Option for all init above to clone all outside the doc directory' 98 @echo ' BOOK_GLOBALCLONEROOT=yes #Option for all init above to clone all outside the doc directory'
101 @echo ' BOOK_GLOBALCLONEROOT=otherpath #Option for all init above to clone all to given path' 99 @echo ' BOOK_GLOBALCLONEROOT=otherpath #Option for all init above to clone all to given path'
102 @echo 'make pullbuild #git pull in s_docbuild'
103 @echo 'make clean #Clean results and all s_*, but not any external clones' 100 @echo 'make clean #Clean results and all s_*, but not any external clones'
104 @echo '' 101 @echo ''
105 @echo 'Optional parameters for make doc:' 102 @echo 'Optional parameters for make doc:'
@@ -143,7 +140,7 @@ ifeq ($(DOCBOOK_TOOLS_VERSIONS),yes)
143endif 140endif
144 141
145# We rely on make doing these in order left to right 142# We rely on make doing these in order left to right
146init: initbuild initmanifest inittargets initpardoc initbuildboot initpkgdiff initissues 143init: initbuild initmanifest initpardoc initbuildboot initpkgdiff initissues
147pullall: pullbuild 144pullall: pullbuild
148 145
149# If no COMP, iterate over books-* in COMPONENTS with make doc 146# If no COMP, iterate over books-* in COMPONENTS with make doc
@@ -184,9 +181,8 @@ endif
184 181
185books: init 182books: init
186# BOOKPACKAGES is defined in all book-*/swcomp.mk 183# BOOKPACKAGES is defined in all book-*/swcomp.mk
187 $(VERB)DISTRO_VERSION_MAJOR=`egrep '"EneaLinux_DISTRO_VERSION_MAJOR"' s_docsrc_common/pardoc-distro.xml | sed 's/.*<phrase>//;s/<\/phrase>.*//'` ; \ 184 $(VERB)DISTRO_VERSION=`egrep '"EneaLinux_REL_VER"><phrase>' $(ELTF_PARAMS_UPDATED) | sed 's/.*<phrase>//;s/<\/phrase>.*//'` ; \
188 DISTRO_VERSION_MINOR=`egrep '"EneaLinux_DISTRO_VERSION_MINOR"' s_docsrc_common/pardoc-distro.xml | sed 's/.*<phrase>//;s/<\/phrase>.*//'` ; \ 185 BOOKVER="Profile $(PROFILE_NAME)-$$DISTRO_VERSION" ; \
189 BOOKVER="Profile $(PROFILE_NAME)-$$DISTRO_VERSION_MAJOR$$DISTRO_VERSION_MINOR" ; \
190 for book in $(BOOKPACKAGES); do \ 186 for book in $(BOOKPACKAGES); do \
191 for format in $(FORMAT); do \ 187 for format in $(FORMAT); do \
192 $(MAKE) -f $(DOCBOOKMAKE)/make_docbook_standalone.mk BOOK=$$book FORMAT=$$format BOOK_VER="$$BOOKVER" books || exit 10; \ 188 $(MAKE) -f $(DOCBOOKMAKE)/make_docbook_standalone.mk BOOK=$$book FORMAT=$$format BOOK_VER="$$BOOKVER" books || exit 10; \
@@ -216,7 +212,6 @@ endif
216# ****************************************************************** 212# ******************************************************************
217# ****************** SUPPORT FOR TARGETS *************************** 213# ****************** SUPPORT FOR TARGETS ***************************
218initmanifest: s_manifest 214initmanifest: s_manifest
219inittargets: s_targets
220 215
221 216
222# ----------------------------------------- 217# -----------------------------------------
@@ -229,8 +224,8 @@ s_manifest: $(TMPCLONEROOT_MANIFEST)
229 $(VERB)rm s_manifest 2>/dev/null; ln -s $(TMPCLONEROOT_MANIFEST) s_manifest 224 $(VERB)rm s_manifest 2>/dev/null; ln -s $(TMPCLONEROOT_MANIFEST) s_manifest
230 225
231cleanmanifest: 226cleanmanifest:
232 @echo "Cleaning generated manifestfilelist XML document file" 227 @echo "Cleaning generated manifest files"
233 $(VERB)rm -f $(MANIFESTFILES_XML) 2>/dev/null 228 $(VERB)rm -f $(MACHINE_LIST_XML) 2>/dev/null
234 $(VERB)rm -rf "$(TMPCLONEROOT_MANIFEST)" s_manifest 2>/dev/null 229 $(VERB)rm -rf "$(TMPCLONEROOT_MANIFEST)" s_manifest 2>/dev/null
235 230
236$(TMPCLONEROOT_MANIFEST): 231$(TMPCLONEROOT_MANIFEST):
@@ -241,41 +236,16 @@ $(TMPCLONEROOT_MANIFEST):
241 cd "$(TMPCLONEROOT_MANIFEST)"; git clone $(MANIFESTURL) ; cd $(MANIFESTDIR) ; git checkout $(MANIFESTHASH) 236 cd "$(TMPCLONEROOT_MANIFEST)"; git clone $(MANIFESTURL) ; cd $(MANIFESTDIR) ; git checkout $(MANIFESTHASH)
242 $(VERB)if [ ! -d "$(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR)" ]; then echo "ERROR: Missing $(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR)"; exit 10 ; fi ; \ 237 $(VERB)if [ ! -d "$(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR)" ]; then echo "ERROR: Missing $(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR)"; exit 10 ; fi ; \
243 TARGETDEFAULTXMLS=`cd $(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR); ls -1 */default.xml 2>/dev/null` ; \ 238 TARGETDEFAULTXMLS=`cd $(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR); ls -1 */default.xml 2>/dev/null` ; \
244 echo "$$TARGETDEFAULTXMLS" | tr '\n' ' ' >$(TMPCLONEROOT_MANIFEST)/targetdefaultxmls.txt ; \ 239 TARGET_LIST=`echo "$$TARGETDEFAULTXMLS" | sed 's/\/default.xml//;s/^/# export MACHINE=/'` ; \
245 echo "$$TARGETDEFAULTXMLS" | sed 's/\/.*//' | tr '\n' ' ' >$(TMPCLONEROOT_MANIFEST)/targetids.txt ; \ 240 echo "<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>" >$(MACHINE_LIST_XML) ; \
246 echo "<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>" >$(MANIFESTFILES_XML) ; \ 241 echo "<!DOCTYPE para PUBLIC \"-//OASIS//DTD DocBook XML V4.2//EN\"" >>$(MACHINE_LIST_XML) ; \
247 echo "<!DOCTYPE section PUBLIC \"-//OASIS//DTD DocBook XML V4.2//EN\"" >>$(MANIFESTFILES_XML) ; \ 242 echo "\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\">" >>$(MACHINE_LIST_XML) ; \
248 echo "\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\">" >>$(MANIFESTFILES_XML) ; \ 243 echo "<para id=\"machine-list\">" >>$(MACHINE_LIST_XML) ; \
249 echo "<section id=\"manifestfiles\">" >>$(MANIFESTFILES_XML) ; \ 244 echo "<programlisting># Set MACHINE to ONE of the targets in this release!" >>$(MACHINE_LIST_XML) ; \
250 echo "<programlisting>$$TARGETDEFAULTXMLS</programlisting>" >>$(MANIFESTFILES_XML) ; \ 245 echo "$$TARGET_LIST</programlisting>" >>$(MACHINE_LIST_XML) ; \
251 echo "</section>" >>$(MANIFESTFILES_XML) 246 echo "</para>" >>$(MACHINE_LIST_XML)
252
253
254# -----------------------------------------
255# Use repo to auto-clone each target separately - VERY LARGE if there are many targets (5 targets => about 1.3 Gbytes)
256
257s_targets: $(TMPCLONEROOT_TARGETS)
258 $(VERB)rm s_targets 2>/dev/null; ln -s $(TMPCLONEROOT_TARGETS) s_targets
259 247
260 248
261$(TMPCLONEROOT_TARGETS): s_manifest
262 $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi
263 $(VERB)if [ ! -d $(TMPCLONEROOT_TARGETS) ]; then mkdir -p $(TMPCLONEROOT_TARGETS) ; fi
264 @echo "**** Cloning all targets using repo tool into $(TMPCLONEROOT_TARGETS)"
265 $(VERB)if [ ! -f "$(TMPCLONEROOT_MANIFEST)/targetdefaultxmls.txt" ]; then echo "ERROR: Missing $(TMPCLONEROOT_MANIFEST)/targetdefaultxmls.txt"; exit 10; fi
266 $(VERB)TARGETDEFAULTXMLS=`cat "$(TMPCLONEROOT_MANIFEST)/targetdefaultxmls.txt" 2>/dev/null` ; \
267 echo "Info: TARGETDEFAULTXMLS is $$TARGETDEFAULTXMLS" ; \
268 for target_default_xml in $$TARGETDEFAULTXMLS; \
269 do \
270 TARGDIR=$(TMPCLONEROOT_TARGETS)/`dirname $$target_default_xml` ; \
271 echo "TARGDIR=<$$TARGDIR>" ; \
272 if [ ! -d $$TARGDIR ]; then mkdir -p $$TARGDIR ; fi ; \
273 ( cd $$TARGDIR ; \
274 echo "*** Doing repo init -u $(MANIFESTURL) -b $(MANIFESTHASH) -m $$target_default_xml ; repo sync"; \
275 repo init -u $(MANIFESTURL) -b $(MANIFESTHASH) -m $$target_default_xml ; repo sync ; \
276 ) ; \
277 done
278
279# **************************************************************************** 249# ****************************************************************************
280# ******************** SUPPORT FOR dynamic pardoc with added parameters ****** 250# ******************** SUPPORT FOR dynamic pardoc with added parameters ******
281# pardoc-distro can contain MAJOR.MINOR-xxxxx keeping -xxxx when replacing MINOR.MINOR from enea.conf 251# pardoc-distro can contain MAJOR.MINOR-xxxxx keeping -xxxx when replacing MINOR.MINOR from enea.conf
@@ -291,32 +261,18 @@ cleanpardoc:
291 @echo "Cleaning dynamic parameters" 261 @echo "Cleaning dynamic parameters"
292 $(VERB)rm -rf $(TMPCLONEROOT_DOCSRC_COMMON) ; rm s_docsrc_common 262 $(VERB)rm -rf $(TMPCLONEROOT_DOCSRC_COMMON) ; rm s_docsrc_common
293 263
264
294s_docsrc_common: $(TMPCLONEROOT_DOCSRC_COMMON) 265s_docsrc_common: $(TMPCLONEROOT_DOCSRC_COMMON)
295 $(VERB)rm s_docsrc_common 2>/dev/null; ln -s $(TMPCLONEROOT_DOCSRC_COMMON) s_docsrc_common 266 $(VERB)rm s_docsrc_common 2>/dev/null; ln -s $(TMPCLONEROOT_DOCSRC_COMMON) s_docsrc_common
296 267
297$(TMPCLONEROOT_DOCSRC_COMMON): s_targets 268$(TMPCLONEROOT_DOCSRC_COMMON):
298 $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi 269 $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi
299 $(VERB)if [ ! -d $(TMPCLONEROOT_DOCSRC_COMMON) ]; then mkdir -p $(TMPCLONEROOT_DOCSRC_COMMON) ; fi 270 $(VERB)if [ ! -d $(TMPCLONEROOT_DOCSRC_COMMON) ]; then mkdir -p $(TMPCLONEROOT_DOCSRC_COMMON) ; fi
300 @echo "**** Copy and patch docsrc_common/ files to $(TMPCLONEROOT_DOCSRC_COMMON)" 271 @echo "**** Copy docsrc_common/ files to $(TMPCLONEROOT_DOCSRC_COMMON)"
301 @echo "*** Add parameters from first target's enea.conf and add manifest parameters" 272 $(VERB)cat docsrc_common/pardoc-distro.xml >$(TMPPARDOC)
302 $(VERB)FIRSTTARGET=`ls -1 s_targets/ 2>/dev/null | head -1`; \
303 if [ "$$FIRSTTARGET" = "" ]; then echo "ERROR: No targets?" ; exit 10; fi ; \
304 ENEACONF=s_targets/$$FIRSTTARGET/poky/meta-el-common/conf/distro/enea.conf ; \
305 if [ ! -f "$$ENEACONF" ]; then echo "ERROR: No $$ENEACONF?" ; exit 10; fi ; \
306 DISTRO_VERSION_MAJOR=`egrep '^DISTRO_VERSION_MAJOR' $$ENEACONF | sed 's/^[^"]*"//;s/".*//'` ; \
307 DISTRO_VERSION_MINOR=`egrep '^DISTRO_VERSION_MINOR' $$ENEACONF | sed 's/^[^"]*"//;s/".*//'` ; \
308 cat docsrc_common/pardoc-distro.xml | sed '/<\/section>/d' | \
309 sed '/<!ENTITY ENEA_LINUX_REL_VER/s/MAJOR.MINOR/'"$$DISTRO_VERSION_MAJOR$$DISTRO_VERSION_MINOR"'/' | \
310 sed '/<!ENTITY . common_poky_entities SYSTEM/s/s_targets\/[^\/]*\/poky/s_targets\/'"$$FIRSTTARGET"'\/poky/' >$(TMPPARDOC) ; \
311 echo "<para id=\"EneaLinux_DISTRO_VERSION_MAJOR\"><phrase>$$DISTRO_VERSION_MAJOR</phrase></para>" >>$(TMPPARDOC) ; \
312 echo "<para id=\"EneaLinux_DISTRO_VERSION_MINOR\"><phrase>$$DISTRO_VERSION_MINOR</phrase></para>" >>$(TMPPARDOC) ; \
313 echo "<para id=\"EneaLinux_PROFILE_NAME\"><phrase>$(PROFILE_NAME)</phrase></para>" >>$(TMPPARDOC) ; \
314 echo "<para id=\"EneaLinux_MANIFESTURL\"><phrase>$(MANIFESTURL)</phrase></para>" >>$(TMPPARDOC) ; \
315 echo "<para id=\"EneaLinux_MANIFESTHASH\"><phrase>$(MANIFESTHASH)</phrase></para>" >>$(TMPPARDOC) ; \
316 echo "</section>" >>$(TMPPARDOC)
317 273
318# **************************************************************************** 274# ****************************************************************************
319# ***** Create XML chapter with build/boot commands from all README files in s_targets 275# ***** Create XML chapter with build/boot commands from all README files in manifest
320 276
321initbuildboot: $(BUILDBOOT_XML) 277initbuildboot: $(BUILDBOOT_XML)
322 278
@@ -325,11 +281,11 @@ cleanbuildboot:
325 $(VERB)rm -f $(BUILDBOOT_XML) 2>/dev/null 281 $(VERB)rm -f $(BUILDBOOT_XML) 2>/dev/null
326 282
327 283
328$(BUILDBOOT_XML): s_targets $(BUILDBOOT_TEMPLATE) 284$(BUILDBOOT_XML): $(BUILDBOOT_TEMPLATE)
329 @echo "**** Creating $(BUILDBOOT_XML) from READMEs" 285 @echo "**** Creating $(BUILDBOOT_XML) from READMEs"
330 $(VERB)INITBB_CMD=initbuildboot.sh ; \ 286 $(VERB)INITBB_CMD=initbuildboot.sh ; \
331 if [ -f "$$INITBB_CMD" ]; then \ 287 if [ -f "$$INITBB_CMD" ]; then \
332 sh "$$INITBB_CMD" -xml $(BUILDBOOT_XML) -template $(BUILDBOOT_TEMPLATE) ; \ 288 sh "$$INITBB_CMD" -xml $(BUILDBOOT_XML) -template $(BUILDBOOT_TEMPLATE) -readmebasedir s_manifest/$(MANIFESTDIR); \
333 else \ 289 else \
334 echo "ERROR: Missing $$INITBB_CMD, can not create $(BUILDBOOT_XML)"; exit 10; \ 290 echo "ERROR: Missing $$INITBB_CMD, can not create $(BUILDBOOT_XML)"; exit 10; \
335 fi 291 fi
@@ -357,6 +313,7 @@ $(PKGDIFF_GEN_XML):
357 313
358initissues: $(JIRA_ISSUES_GEN_XML) 314initissues: $(JIRA_ISSUES_GEN_XML)
359 315
316
360cleanissues: 317cleanissues:
361 @echo "Cleaning generated known issues document file" 318 @echo "Cleaning generated known issues document file"
362 $(VERB)rm -f $(JIRA_ISSUES_GEN_XML) 2>/dev/null 319 $(VERB)rm -f $(JIRA_ISSUES_GEN_XML) 2>/dev/null
@@ -366,3 +323,52 @@ $(JIRA_ISSUES_GEN_XML):
366 $(VERB)python gen_known_issues.py >$(JIRA_ISSUES_GEN_XML) 323 $(VERB)python gen_known_issues.py >$(JIRA_ISSUES_GEN_XML)
367 324
368# **************************************************************************** 325# ****************************************************************************
326
327#
328# All ELTF_ variables names only has upper case, underline and digits
329eltf:
330 @echo "# make eltf extracts and displays all ELTF_ variables found here"
331 @echo "# in $(SUBSYSROOT)/$(ELTF_PARAMS_TEMPLATE)"
332 @echo "# Replace all variables, creating a new eltf*updated.xml file from the eltf*template.xml"
333 @echo "#"
334 @echo "# Only replace + push the result file $(ELTF_PARAMS_UPDATED), IF IT WILL BE CHANGED."
335 @echo "#"
336 @echo "# IMPORTANT: See eltf_params_updated_template_how_to_use.txt for requirements and details!"
337 @echo "# Below is only a summary!"
338 @echo "#"
339 @echo "# ELTF_ variables must be UNIQUE, e.g. a variable must not be a part of another variable"
340 @echo "#"
341 @echo "# ELTF_PL_* and ELTF_T_PL_* shall have the format for programlisting and are often multiline - see below."
342 @echo "#"
343 @echo "# ELTF_*_URL and ELTF_*_TXTURL are the URL part and TXT part of ulink; those shall be exactly identical,"
344 @echo "# unless the URL is very very long."
345 @echo "#"
346 @echo "# ELTF_T_* are target (MACHINE) variables in one subsection, replace with machine specific strings."
347 @echo "#"
348 @echo "# Append more target subsections to *updated.xml, if more than one target is in a release!"
349 @echo "# Replace the line <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED --> with appended"
350 @echo "# complete target section elements copied before the variables are replaced."
351 @echo "# In each target section, replace the ELTF_T* variables with machine dependent strings"
352 @echo "# Append final lines seen after <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->"
353 @echo "# but that would often only be two final </section> </section> lines"
354 @echo "#"
355 @echo "# ELTF_ Variables: Replace each variable with a string, for ELTF_*PL* it can be multiline"
356 @echo "# DO NOT use any leading or trailing spaces and DO NOT use TABs"
357 @echo "#"
358 @echo "# ELTF_ Everywhere: Only 7-bit ASCII inside the string replacing a variable. Translate characters"
359 @echo "# like & < > to &amp; &lt; &gt; etc."
360 @echo "# unless real XML shall be inserted like when entire sections are appended."
361 @echo "#"
362 @echo "# ELTF_ programlisting, variables with PL in the name: Max line length < 80 char."
363 @echo "# Use backslash + indent-leading-spaces for continuation lines."
364 @echo "# Multiline. No trailing spaces on any line inside the programlisting."
365 @echo "#"
366 @echo "# The following variables shall be replaced with suitable contents (egrep from the template):"
367 @echo "# Again: See details in eltf_params_updated_template_how_to_use.txt"
368 @echo "# including also examples of contents of each variable!"
369 @echo "#"
370 $(VERB)( egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' $(ELTF_PARAMS_TEMPLATE) 2>/dev/null | sed 's/ELTF_/\nELTF_/g' | egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' | sed 's/\(ELTF_[A-Z_0-9][A-Z_0-9]*\).*/\1/' ) | sort
371 @echo "# The make eltf also here extracts any left-over ELTF variables from $(ELTF_PARAMS_UPDATED)"
372 @echo "# It should not be any left here:"
373 $(VERB)( egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' $(ELTF_PARAMS_UPDATED) 2>/dev/null | sed 's/ELTF_/\nELTF_/g' | egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' | sed 's/\(ELTF_[A-Z_0-9][A-Z_0-9]*\).*/\1/' ) | sort
374 @echo "# If you see any left-over above, something is wrong"
diff --git a/doc/book-enea-linux-eclipse-open-source/doc/book.xml b/doc/book-enea-linux-eclipse-open-source/doc/book.xml
index 679ecc1..e12b3c9 100644
--- a/doc/book-enea-linux-eclipse-open-source/doc/book.xml
+++ b/doc/book-enea-linux-eclipse-open-source/doc/book.xml
@@ -8,7 +8,7 @@
8 Source Report</title> 8 Source Report</title>
9 9
10 <subtitle>Release Version <xi:include 10 <subtitle>Release Version <xi:include
11 href="../../s_docsrc_common/pardoc-distro.xml" 11 href="../../book-enea-linux-release-info/doc/eltf_params_updated.xml"
12 xmlns:xi="http://www.w3.org/2001/XInclude" 12 xmlns:xi="http://www.w3.org/2001/XInclude"
13 xpointer="element(EneaLinux_REL_VER/1)" /></subtitle> 13 xpointer="element(EneaLinux_REL_VER/1)" /></subtitle>
14 14
diff --git a/doc/book-enea-linux-open-source/doc/about.xml b/doc/book-enea-linux-open-source/doc/about.xml
index f2f863f..d4b6437 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 @@
6 6
7 <para>This document contains the open source and license information 7 <para>This document contains the open source and license information
8 pertaining to packages provided with Enea Linux <xi:include 8 pertaining to packages provided with Enea Linux <xi:include
9 href="../../s_docsrc_common/pardoc-distro.xml" 9 href="../../book-enea-linux-release-info/doc/eltf_params_updated.xml"
10 xmlns:xi="http://www.w3.org/2001/XInclude" 10 xmlns:xi="http://www.w3.org/2001/XInclude"
11 xpointer="element(EneaLinux_REL_VER/1)" />.</para> 11 xpointer="element(EneaLinux_REL_VER/1)" />.</para>
12</chapter> \ No newline at end of file 12</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 d5da88e..1fd8217 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 @@
6<book id="book_enea_linux_open_source"> 6<book id="book_enea_linux_open_source">
7 <title><trademark class="registered">Enea</trademark> Linux Open Source Report</title> 7 <title><trademark class="registered">Enea</trademark> Linux Open Source Report</title>
8 <subtitle>Release Version 8 <subtitle>Release Version
9 <xi:include href="../../s_docsrc_common/pardoc-distro.xml" xpointer="element(EneaLinux_REL_VER/1)" 9 <xi:include href="../../book-enea-linux-release-info/doc/eltf_params_updated.xml" xpointer="element(EneaLinux_REL_VER/1)"
10 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle> 10 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle>
11 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 11 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
12 <xi:include href="about.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 12 <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 08a44a8..009cd56 100644
--- a/doc/book-enea-linux-release-info/doc/about_release.xml
+++ b/doc/book-enea-linux-release-info/doc/about_release.xml
@@ -4,16 +4,23 @@
4<chapter id="relinfo-about-release"> 4<chapter id="relinfo-about-release">
5 <title>About This Release</title> 5 <title>About This Release</title>
6 6
7 <para>This release of Enea Linux <xi:include 7 <para>This release of Enea Linux <xi:include href="eltf_params_updated.xml"
8 href="../../s_docsrc_common/pardoc-distro.xml"
9 xmlns:xi="http://www.w3.org/2001/XInclude" 8 xmlns:xi="http://www.w3.org/2001/XInclude"
10 xpointer="element(EneaLinux_REL_VER/1)" /> provides a publicly available 9 xpointer="element(EneaLinux_REL_VER/1)" /> provides a publicly available
11 Enea Linux distribution for a selected set of targets. This release is 10 Enea Linux distribution for a selected set of targets. This release is
12 generated from the yocto distribution using the branch <xi:include 11 generated from the yocto <xi:include href="eltf_params_updated.xml"
13 href="../../s_docsrc_common/pardoc-distro.xml"
14 xmlns:xi="http://www.w3.org/2001/XInclude" 12 xmlns:xi="http://www.w3.org/2001/XInclude"
15 xpointer="element(Yocto_NAME/1)" />.<remark>INFO Yocto distro autopicked 13 xpointer="element(Yocto_VER/1)" /> distribution using the branch <xi:include
16 from poky.ent as DISTRO_NAME_NO_CAP</remark></para> 14 href="eltf_params_updated.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
15 xpointer="element(Yocto_NAME/1)" />.<remark>INFO <emphasis
16 role="bold">eltf_params_updated.xml</emphasis> contains many parameters in
17 the book, also in the open source books, and MUST be created FROM <emphasis
18 role="bold">eltf_params_template.xml</emphasis>. The parameters are
19 automatically used in the books, via xi:include statements, similar to how
20 parameters from pardoc-distro.xml are included in the book. Read the file
21 <emphasis role="bold">eltf_params_updated_template_how_to_use.txt</emphasis>
22 for important details about formats and how to do! The idea is that ELTF
23 will auto-create/update it.</remark></para>
17 24
18 <section id="relinfo-provided-contents"> 25 <section id="relinfo-provided-contents">
19 <title>Provided Contents</title> 26 <title>Provided Contents</title>
@@ -43,88 +50,19 @@
43 </row> 50 </row>
44 51
45 <row> 52 <row>
46 <entry>Pre-built packages (RPM)</entry> 53 <entry>Pre-built packages (RPM). See links for each
54 target.<remark>INFO Below is an Eclipse row from
55 eltf_params_updated.xml. MANUALLY if eclipse is not included, set
56 condition hidden on the row element BOTH in template.xml and in
57 updated.xml.</remark></entry>
47 </row> 58 </row>
48 59
49 <row> 60 <xi:include href="eltf_params_updated.xml"
50 <entry>Eclipse executable plus development tools for command line 61 xmlns:xi="http://www.w3.org/2001/XInclude"
51 and Eclipse</entry> 62 xpointer="element(eltf-eclipse-version-row)" />
52 </row>
53 </tbody>
54 </tgroup>
55 </informaltable>
56 </section>
57
58 <section id="relinfo-supported-targets">
59 <title>Supported Targets</title>
60
61 <informaltable>
62 <tgroup cols="3">
63 <colspec align="left" colname="c1" colwidth="1*" />
64
65 <colspec align="left" colname="c2" colwidth="1*" />
66
67 <colspec align="left" colname="c3" colwidth="1*" />
68
69 <thead valign="bottom">
70 <row>
71 <entry>Target</entry>
72
73 <entry>Architecture</entry>
74
75 <entry>Specification</entry>
76 </row>
77 </thead>
78
79 <tbody>
80 <row>
81 <entry>P2041RDB</entry>
82
83 <entry><para>Power, e500mc</para></entry>
84
85 <entry>See <ulink
86 url="http://www.nxp.com/products/microcontrollers-and-processors/power-architecture-processors/qoriq-power-architecture-processors/p2041-qoriq-reference-design-board:RDP2041BOARD">link
87 to NXP's datasheet</ulink></entry>
88 </row>
89
90 <row>
91 <entry>LS1021a-IoT</entry>
92
93 <entry><para>ARM Cortex-A7</para></entry>
94
95 <entry>See<ulink
96 url="http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/qoriq-arm-processors/qoriq-ls1021a-iot-gateway-reference-design:LS1021A-IoT">link
97 to NXP's datasheet</ulink></entry>
98 </row>
99
100 <row>
101 <entry>QEMUARM</entry>
102
103 <entry><para>ARM</para></entry>
104
105 <entry morerows="2" valign="middle">See <ulink
106 url="http://wiki.qemu.org">http://wiki.qemu.org</ulink></entry>
107 </row>
108
109 <row>
110 <entry>QEMUPCC</entry>
111
112 <entry><para>PPC</para></entry>
113 </row>
114
115 <row>
116 <entry>QEMUX86</entry>
117
118 <entry><para>X86</para></entry>
119 </row>
120 </tbody> 63 </tbody>
121 </tgroup> 64 </tgroup>
122 </informaltable> 65 </informaltable>
123
124 <para><remark>FIXME should autocreate a list of targets, hopefully from
125 the generated README file, by using MAKEFILE to update pardoc-distro
126 AND/OR also auto-create an XML file to include here with description text
127 for each target etc..</remark></para>
128 </section> 66 </section>
129 67
130 <section id="relinfo-supported-host-environment"> 68 <section id="relinfo-supported-host-environment">
@@ -132,84 +70,21 @@
132 70
133 <itemizedlist> 71 <itemizedlist>
134 <listitem> 72 <listitem>
135 <para>Ubuntu 14.04 LTS, 64-bit<remark>was 73 <para>Ubuntu 14.04 LTS, 64-bit<remark>Hardcoded now in this XML file.
136 EneaLinux_HOST_VER</remark></para> 74 Might be moved to the parameter file later.</remark><remark>INFO Below
75 is a complete section with ID "eltf-target-tables-section" included
76 from elft_params_updated.xml. It contains a variable number of target
77 tables and the section title should be "Supported Targets with
78 Parameters". It has have a short sentence about what it is in the
79 beginning. The subtitles shall have the directory name of the target
80 in the manifest.</remark></para>
137 </listitem> 81 </listitem>
138 </itemizedlist> 82 </itemizedlist>
139 </section> 83 </section>
140 84
141 <section id="relinfo-supported-versions"> 85 <xi:include href="eltf_params_updated.xml"
142 <title>Supported Versions</title> 86 xmlns:xi="http://www.w3.org/2001/XInclude"
143 87 xpointer="element(eltf-target-tables-section)" />
144 <informaltable>
145 <tgroup cols="2">
146 <thead valign="bottom">
147 <row>
148 <entry>Item</entry>
149
150 <entry>Version</entry>
151 </row>
152 </thead>
153
154 <tbody>
155 <row>
156 <entry><para>Yocto</para></entry>
157
158 <entry><xi:include href="../../s_docsrc_common/pardoc-distro.xml"
159 xmlns:xi="http://www.w3.org/2001/XInclude"
160 xpointer="element(Yocto_VER/1)" /> (<xi:include
161 href="../../s_docsrc_common/pardoc-distro.xml"
162 xmlns:xi="http://www.w3.org/2001/XInclude"
163 xpointer="element(Yocto_NAME/1)" />)<remark>INFO: Auto-fetched
164 from poky.ent via pardoc-distro.xml</remark></entry>
165 </row>
166
167 <row>
168 <entry>Poky</entry>
169
170 <entry><para>Git commit id:</para>
171 <para>75ca53211488a3e268037a44ee2a7ac5c7181bd2</para><remark>Problem:
172 Unfortunately the poky version in poky.ent is not correct unless
173 the EL release would be based on a Yocto release, so we can not
174 use that here. This is a problem because we don't want to manually
175 edit the git commit ID in this file? The poky version in poky.ent
176 is just now <xi:include
177 href="../../s_docsrc_common/pardoc-distro.xml"
178 xmlns:xi="http://www.w3.org/2001/XInclude"
179 xpointer="element(Poky_VER/1)" /></remark></entry>
180 </row>
181
182 <row>
183 <entry>GCC</entry>
184
185 <entry>5.3<remark>was EneaLinux_GCC_VER Not in poky.ent
186 </remark></entry>
187 </row>
188
189 <row>
190 <entry>Linux kernel<remark>was EneaLinux_KERNEL_VER Not in
191 poky.ent</remark></entry>
192
193 <entry><para>3.12 (P2041RDB &amp; LS1021a-IoT)</para><para>4.4
194 (QEMU targets)</para></entry>
195 </row>
196
197 <row>
198 <entry>Eclipse</entry>
199
200 <entry>4.5 (Mars)<remark>was Eclipse_VER and was Eclipse_NAME Not
201 in poky.ent</remark></entry>
202 </row>
203
204 <row>
205 <entry>Packages</entry>
206
207 <entry>See <xref linkend="relinfo-packages" /></entry>
208 </row>
209 </tbody>
210 </tgroup>
211 </informaltable>
212 </section>
213 88
214 <section id="relinfo-packages"> 89 <section id="relinfo-packages">
215 <title>Provided Packages</title> 90 <title>Provided Packages</title>
@@ -266,156 +141,6 @@
266 toolchain.</para> 141 toolchain.</para>
267 </section> 142 </section>
268 143
269 <section id="relinfo-provided-drivers">
270 <title>Supported Drivers</title>
271
272 <informaltable>
273 <tgroup cols="6">
274 <colspec align="left" colwidth="3*" />
275
276 <colspec align="center" colwidth="2*" />
277
278 <colspec align="center" colwidth="2*" />
279
280 <colspec align="center" colwidth="2*" />
281
282 <colspec align="center" colwidth="2*" />
283
284 <colspec align="center" colwidth="2*" />
285
286 <thead>
287 <row>
288 <entry>Driver</entry>
289
290 <entry>P2041RDB</entry>
291
292 <entry>LS1021a-IoT</entry>
293
294 <entry>QEMUARM</entry>
295
296 <entry>QEMUPCC</entry>
297
298 <entry>QEMUX86</entry>
299 </row>
300 </thead>
301
302 <tbody>
303 <row>
304 <entry>Ethernet</entry>
305
306 <entry>X</entry>
307
308 <entry>X</entry>
309
310 <entry>X</entry>
311
312 <entry>X</entry>
313
314 <entry>X</entry>
315 </row>
316
317 <row>
318 <entry>I2C</entry>
319
320 <entry>X</entry>
321
322 <entry>X</entry>
323
324 <entry></entry>
325
326 <entry></entry>
327
328 <entry></entry>
329 </row>
330
331 <row>
332 <entry>SPI</entry>
333
334 <entry>X</entry>
335
336 <entry>X</entry>
337
338 <entry></entry>
339
340 <entry></entry>
341
342 <entry></entry>
343 </row>
344
345 <row>
346 <entry>PCI Express</entry>
347
348 <entry>X</entry>
349
350 <entry>X</entry>
351
352 <entry></entry>
353
354 <entry></entry>
355
356 <entry></entry>
357 </row>
358
359 <row>
360 <entry>USB</entry>
361
362 <entry>X</entry>
363
364 <entry>X</entry>
365
366 <entry></entry>
367
368 <entry></entry>
369
370 <entry></entry>
371 </row>
372
373 <row>
374 <entry>Flash</entry>
375
376 <entry>X</entry>
377
378 <entry></entry>
379
380 <entry></entry>
381
382 <entry></entry>
383
384 <entry></entry>
385 </row>
386
387 <row>
388 <entry>SD/SDHC/SDXC</entry>
389
390 <entry>X</entry>
391
392 <entry>X</entry>
393
394 <entry></entry>
395
396 <entry></entry>
397
398 <entry></entry>
399 </row>
400
401 <row>
402 <entry>RTC</entry>
403
404 <entry>X</entry>
405
406 <entry></entry>
407
408 <entry></entry>
409
410 <entry></entry>
411
412 <entry></entry>
413 </row>
414 </tbody>
415 </tgroup>
416 </informaltable>
417 </section>
418
419 <section id="relinfo-documentation"> 144 <section id="relinfo-documentation">
420 <title>Provided Documentation</title> 145 <title>Provided Documentation</title>
421 146
@@ -456,7 +181,7 @@
456 </listitem> 181 </listitem>
457 182
458 <listitem> 183 <listitem>
459 <para><trademark class="registered">Enea</trademark> Linux 6 Test 184 <para><trademark class="registered">Enea</trademark> Linux Test
460 Report</para> 185 Report</para>
461 </listitem> 186 </listitem>
462 187
@@ -473,7 +198,9 @@
473 198
474 <para>The functionality in a distribution depends on included packages in 199 <para>The functionality in a distribution depends on included packages in
475 the default image. In addition to the supported features, the following 200 the default image. In addition to the supported features, the following
476 functionality is also available, among other:</para> 201 functionality is also available, among other:<remark>INFO: This section
202 might be hidden by setting condition hidden on the section, MANUALLY in
203 this file.</remark></para>
477 204
478 <itemizedlist spacing="compact"> 205 <itemizedlist spacing="compact">
479 <listitem> 206 <listitem>
@@ -516,7 +243,9 @@
516 <title>Intentional Limitations</title> 243 <title>Intentional Limitations</title>
517 244
518 <para>The following functionality supported in other Enea Linux releases 245 <para>The following functionality supported in other Enea Linux releases
519 has been excluded in this release:<itemizedlist spacing="compact"> 246 has been excluded in this release:<remark>INFO: This section might be
247 hidden by setting condition hidden on the section, MANUALLY in this
248 file.</remark><itemizedlist spacing="compact">
520 <listitem> 249 <listitem>
521 <para>Eclipse plug-ins for image creation (HOB)</para> 250 <para>Eclipse plug-ins for image creation (HOB)</para>
522 </listitem> 251 </listitem>
diff --git a/doc/book-enea-linux-release-info/doc/book.xml b/doc/book-enea-linux-release-info/doc/book.xml
index d1226b9..91af443 100644
--- a/doc/book-enea-linux-release-info/doc/book.xml
+++ b/doc/book-enea-linux-release-info/doc/book.xml
@@ -5,7 +5,7 @@
5<book id="book_enea_linux_release_info"> 5<book id="book_enea_linux_release_info">
6 <title><trademark class="registered">Enea</trademark> Linux Release Information</title> 6 <title><trademark class="registered">Enea</trademark> Linux Release Information</title>
7 <subtitle>Release Version 7 <subtitle>Release Version
8 <xi:include href="../../s_docsrc_common/pardoc-distro.xml" xpointer="element(EneaLinux_REL_VER/1)" 8 <xi:include href="eltf_params_updated.xml" xpointer="element(EneaLinux_REL_VER/1)"
9 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle> 9 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle>
10 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 10 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
11 <xi:include href="about_release.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 11 <xi:include href="about_release.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
index 653f943..2200997 100644
--- a/doc/book-enea-linux-release-info/doc/build_boot_template.xml
+++ b/doc/book-enea-linux-release-info/doc/build_boot_template.xml
@@ -10,11 +10,13 @@
10 reader, the contents of these build/boot instruction have been extracted 10 reader, the contents of these build/boot instruction have been extracted
11 into the following sections.</para> 11 into the following sections.</para>
12 12
13 <para><remark>NOTE: Only EDIT THE TEMPLATE FILE! A new build_boot.xml file 13 <para><remark>NOTE: Only EDIT THE TEMPLATE build_boot_template.xml file here
14 is created from the template and sections are added below automatically from 14 and also only edit the manifest template ".README" (name starting by a dot)!
15 the README files for each target when building the book! Only in the 15 A new build_boot_generated.xml file is created from the template and
16 template file you see a line below with SCRIPT_...._HERE and the text 16 sections are added below automatically from the README files for each target
17 telling that this is a template file.</remark></para> 17 when building the book! Only in the template file you see a line below with
18 SCRIPT_...._HERE and the text telling that this is a template
19 file.</remark></para>
18 20
19 <para>SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</para> 21 <para>SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</para>
20 22
diff --git a/doc/book-enea-linux-release-info/doc/eltf_params_template.xml b/doc/book-enea-linux-release-info/doc/eltf_params_template.xml
new file mode 100644
index 0000000..278ad71
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/eltf_params_template.xml
@@ -0,0 +1,151 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting>ELTF_PL_HOST_PREREQ</programlisting></para>
26
27 <bridgehead>A programlisting, ID
28 "eltf-getting-repo-install-command"</bridgehead>
29
30 <para id="eltf-getting-repo-install-command"><programlisting>ELTF_PL_GET_REPO</programlisting></para>
31
32 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
33 correct also compared to the "previous" REL VER in pardoc-distro.xml
34 "prev_baseline".</bridgehead>
35
36 <para id="EneaLinux_REL_VER"><phrase>ELTF_EL_REL_VER</phrase></para>
37
38 <para id="Yocto_VER"><phrase>ELTF_YOCTO_VER</phrase></para>
39
40 <para id="Yocto_NAME"><phrase>ELTF_YOCTO_NAME</phrase></para>
41
42 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
43 url="ELTF_YOCTO_PROJ_DOWNLOAD_URL">ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL</ulink></para>
44
45 <para id="ULINK_ENEA_LINUX_URL"><ulink
46 url="ELTF_EL_DOWNLOAD_URL">ELTF_EL_DOWNLOAD_TXTURL</ulink></para>
47
48 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
49 $MACHINE/default.xml as parameter, where MACHINE is one of the target
50 directory names in the manifest.</bridgehead>
51
52 <para id="eltf-repo-cloning-enea-linux"><programlisting>ELTF_PL_CLONE_W_REPO</programlisting></para>
53
54 <bridgehead>A table with ONE row, only the row with ID
55 "eltf-eclipse-version-row" is included in the book. MANUALLY BOTH in the
56 template.xml and in the updated.xml, set condition hidden on the
57 &lt;row&gt;, if eclipse is not in the release.</bridgehead>
58
59 <informaltable>
60 <tgroup cols="1">
61 <tbody>
62 <row id="eltf-eclipse-version-row">
63 <entry>Eclipse version ELTF_ECLIPSE_VERSION plus command line
64 development tools are included in this Enea Linux release.</entry>
65 </row>
66 </tbody>
67 </tgroup>
68 </informaltable>
69
70 <bridgehead>Below is one big section with title "Supported Targets with
71 Parameters". The entire section is included completely in the book via ID
72 "eltf-target-tables-section" and shall be LAST in the template. The
73 template contains ONE target subsection. COPY/APPEND it, if multiple
74 targets exist in the release and optionally add rows with additional
75 target parameters in each target subsection table.</bridgehead>
76 </section>
77
78 <section id="eltf-target-tables-section">
79 <title>Supported Targets with Parameters</title>
80
81 <para>The tables below describes the target(s) supported in this Enea
82 Linux release.</para>
83
84 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
85 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
86
87 <para><informaltable>
88 <tgroup cols="2">
89 <colspec colwidth="6*" />
90
91 <colspec colwidth="9*" />
92
93 <tbody>
94 <row>
95 <entry>Target official name</entry>
96
97 <entry>ELTF_T_NAME</entry>
98 </row>
99
100 <row>
101 <entry>Architecture and Description</entry>
102
103 <entry>ELTF_T_ARC_DESC</entry>
104 </row>
105
106 <row>
107 <entry>Link to target datasheet</entry>
108
109 <entry>See <ulink
110 url="ELTF_T_DS_URL">ELTF_T_DS_TXTURL</ulink></entry>
111 </row>
112
113 <row>
114 <entry>Poky version</entry>
115
116 <entry>ELTF_T_POKY_VER</entry>
117 </row>
118
119 <row>
120 <entry>GCC version</entry>
121
122 <entry>ELTF_T_GCC_VER</entry>
123 </row>
124
125 <row>
126 <entry>Linux Kernel Version</entry>
127
128 <entry>ELTF_T_KERN_VER</entry>
129 </row>
130
131 <row>
132 <entry>Supported Drivers</entry>
133
134 <entry>ELTF_T_DRIVERS</entry>
135 </row>
136
137 <row>
138 <entry>Enea rpm folder for downloading RPM packages for this
139 target</entry>
140
141 <entry><ulink
142 url="ELTF_T_EL_RPM_URL">ELTF_T_EL_RPM_TXTURL</ulink></entry>
143 </row>
144 </tbody>
145 </tgroup>
146 </informaltable></para>
147 </section>
148
149 <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->
150 </section>
151</section> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml b/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml
new file mode 100644
index 0000000..e977e2a
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml
@@ -0,0 +1,429 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 14.04.5 LTS 64bit
26sudo apt-get -y update
27sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
28 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
29 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
30 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
31 libxml-parser-perl</programlisting></para>
32
33 <bridgehead>A programlisting, ID
34 "eltf-getting-repo-install-command"</bridgehead>
35
36 <para id="eltf-getting-repo-install-command"><programlisting>mkdir -p ~/bin
37curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo
38chmod a+x ~/bin/repo
39export PATH=~/bin:$PATH</programlisting></para>
40
41 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
42 correct also compared to the "previous" REL VER in pardoc-distro.xml
43 "prev_baseline".</bridgehead>
44
45 <para id="EneaLinux_REL_VER"><phrase>6</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.1</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>krogoth</phrase></para>
50
51 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
52 url="http://www.yoctoproject.org/downloads/core/krogoth/21">http://www.yoctoproject.org/downloads/core/krogoth/21</ulink></para>
53
54 <para id="ULINK_ENEA_LINUX_URL"><ulink
55 url="https://linux.enea.com/6">https://linux.enea.com/6</ulink></para>
56
57 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
58 $MACHINE/default.xml as parameter, where MACHINE is one of the target
59 directory names in the manifest.</bridgehead>
60
61 <para id="eltf-repo-cloning-enea-linux"><programlisting>mkdir enea-linux
62cd enea-linux
63repo init -u git://git.enea.com/linux/el_manifests-standard.git \
64 -b refs/tags/EL6 -m $MACHINE/default.xml
65repo sync</programlisting></para>
66
67 <bridgehead>A table with ONE row, only the row with ID
68 "eltf-eclipse-version-row" is included in the book. MANUALLY in book, set
69 condition hidden if eclipse is not in the release.</bridgehead>
70
71 <informaltable>
72 <tgroup cols="1">
73 <tbody>
74 <row id="eltf-eclipse-version-row">
75 <entry>Eclipse version 4.3 (Mars) plus command line development
76 tools are included in this Enea Linux release.</entry>
77 </row>
78 </tbody>
79 </tgroup>
80 </informaltable>
81
82 <bridgehead>Below is one big section with title "Supported Targets with
83 Parameters". The entire section is included completely in the book via ID
84 "eltf-target-tables-section" and shall be LAST in the template. The
85 template contains ONE target subsection. COPY/APPEND it, if multiple
86 targets exist in the release and optionally add rows with additional
87 target parameters in each target subsection table.</bridgehead>
88 </section>
89
90 <section id="eltf-target-tables-section">
91 <title>Supported Targets with Parameters</title>
92
93 <para>The tables below describes the target(s) supported in this Enea
94 Linux release.</para>
95
96 <section id="eltf-target-table-ls1021aiot">
97 <title>MACHINE ls1021aiot - Information</title>
98
99 <para><informaltable>
100 <tgroup cols="2">
101 <colspec colwidth="6*" />
102
103 <colspec colwidth="9*" />
104
105 <tbody>
106 <row>
107 <entry>Target official name</entry>
108
109 <entry>LS1021a-IoT</entry>
110 </row>
111
112 <row>
113 <entry>Architecture and Description</entry>
114
115 <entry>ARM Cortex-A7</entry>
116 </row>
117
118 <row>
119 <entry>Link to target datasheet</entry>
120
121 <entry>See <ulink
122 url="http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/qoriq-arm-processors/qoriq-ls1021a-iot-gateway-reference- design:LS1021A-IoT">link
123 to NXP's datasheet</ulink></entry>
124 </row>
125
126 <row>
127 <entry>Poky version</entry>
128
129 <entry>Git-commit-id:
130 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
131 </row>
132
133 <row>
134 <entry>GCC version</entry>
135
136 <entry>5.3</entry>
137 </row>
138
139 <row>
140 <entry>Linux Kernel Version</entry>
141
142 <entry>3.12</entry>
143 </row>
144
145 <row>
146 <entry>Supported Drivers</entry>
147
148 <entry>Ethernet, I2C, SPI, PCI, USB, SD/SDHC/SDXC</entry>
149 </row>
150
151 <row>
152 <entry>Enea rpm folder for downloading RPM packages for this
153 target</entry>
154
155 <entry><ulink
156 url="https://linux.enea.com/6/ls1021aiot/rpm">https://linux.enea.com/6/ls1021aiot/rpm</ulink></entry>
157 </row>
158 </tbody>
159 </tgroup>
160 </informaltable></para>
161 </section>
162
163 <section id="eltf-target-table-p2041rdb">
164 <title>MACHINE p2041rdb - Information</title>
165
166 <para><informaltable>
167 <tgroup cols="2">
168 <colspec colwidth="6*" />
169
170 <colspec colwidth="9*" />
171
172 <tbody>
173 <row>
174 <entry>Target official name</entry>
175
176 <entry>P2041RDB</entry>
177 </row>
178
179 <row>
180 <entry>Architecture and Description</entry>
181
182 <entry>Power, e500mc</entry>
183 </row>
184
185 <row>
186 <entry>Link to target datasheet</entry>
187
188 <entry>See <ulink
189 url="http://www.nxp.com/products/microcontrollers-and-processors/power-architecture-processors/qoriq-power-architecture-processors/p2041-qoriq-reference-design-board:RDP2041BOARD">link
190 to NXP's datasheet</ulink></entry>
191 </row>
192
193 <row>
194 <entry>Poky version</entry>
195
196 <entry>Git-commit-id:
197 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
198 </row>
199
200 <row>
201 <entry>GCC version</entry>
202
203 <entry>5.3</entry>
204 </row>
205
206 <row>
207 <entry>Linux Kernel Version</entry>
208
209 <entry>3.12</entry>
210 </row>
211
212 <row>
213 <entry>Supported Drivers</entry>
214
215 <entry>Ethernet, I2C, SPI, PCI, USB, Flash, SD/SDHC/SDXC,
216 RTC</entry>
217 </row>
218
219 <row>
220 <entry>Enea rpm folder for downloading RPM packages for this
221 target</entry>
222
223 <entry><ulink
224 url="https://linux.enea.com/6/p2041rgb/rpm">https://linux.enea.com/6/p2041rgb/rpm</ulink></entry>
225 </row>
226 </tbody>
227 </tgroup>
228 </informaltable></para>
229 </section>
230
231 <section id="eltf-target-table-qemuarm">
232 <title>MACHINE emuarm - Information</title>
233
234 <para><informaltable>
235 <tgroup cols="2">
236 <colspec colwidth="6*" />
237
238 <colspec colwidth="9*" />
239
240 <tbody>
241 <row>
242 <entry>Target official name</entry>
243
244 <entry>QEMUARM</entry>
245 </row>
246
247 <row>
248 <entry>Architecture and Description</entry>
249
250 <entry>ARM</entry>
251 </row>
252
253 <row>
254 <entry>Link to target datasheet</entry>
255
256 <entry>See <ulink
257 url="http://wiki.qemu.org">http://wiki.qemu.org</ulink></entry>
258 </row>
259
260 <row>
261 <entry>Poky version</entry>
262
263 <entry>Git-commit-id:
264 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
265 </row>
266
267 <row>
268 <entry>GCC version</entry>
269
270 <entry>5.3</entry>
271 </row>
272
273 <row>
274 <entry>Linux Kernel Version</entry>
275
276 <entry>4.4</entry>
277 </row>
278
279 <row>
280 <entry>Supported Drivers</entry>
281
282 <entry>Ethernet</entry>
283 </row>
284
285 <row>
286 <entry>Enea rpm folder for downloading RPM packages for this
287 target</entry>
288
289 <entry><ulink
290 url="https://linux.enea.com/6/qemuarm/rpm">https://linux.enea.com/6/qemuarm/rpm</ulink></entry>
291 </row>
292 </tbody>
293 </tgroup>
294 </informaltable></para>
295 </section>
296
297 <section id="eltf-target-table-qemuppc">
298 <title>MACHINE qemuppc - Information</title>
299
300 <para><informaltable>
301 <tgroup cols="2">
302 <colspec colwidth="6*" />
303
304 <colspec colwidth="9*" />
305
306 <tbody>
307 <row>
308 <entry>Target official name</entry>
309
310 <entry>QEMUPPC</entry>
311 </row>
312
313 <row>
314 <entry>Architecture and Description</entry>
315
316 <entry>PowerPC</entry>
317 </row>
318
319 <row>
320 <entry>Link to target datasheet</entry>
321
322 <entry>See <ulink
323 url="http://wiki.qemu.org">http://wiki.qemu.org</ulink></entry>
324 </row>
325
326 <row>
327 <entry>Poky version</entry>
328
329 <entry>Git-commit-id:
330 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
331 </row>
332
333 <row>
334 <entry>GCC version</entry>
335
336 <entry>5.3</entry>
337 </row>
338
339 <row>
340 <entry>Linux Kernel Version</entry>
341
342 <entry>4.4</entry>
343 </row>
344
345 <row>
346 <entry>Supported Drivers</entry>
347
348 <entry>Ethernet</entry>
349 </row>
350
351 <row>
352 <entry>Enea rpm folder for downloading RPM packages for this
353 target</entry>
354
355 <entry><ulink
356 url="https://linux.enea.com/6/qemuppc/rpm">https://linux.enea.com/6/qemuppc/rpm</ulink></entry>
357 </row>
358 </tbody>
359 </tgroup>
360 </informaltable></para>
361 </section>
362
363 <section id="eltf-target-table-qemux86">
364 <title>MACHINE qemux86 - Information</title>
365
366 <para><informaltable>
367 <tgroup cols="2">
368 <colspec colwidth="6*" />
369
370 <colspec colwidth="9*" />
371
372 <tbody>
373 <row>
374 <entry>Target official name</entry>
375
376 <entry>QEMUX86</entry>
377 </row>
378
379 <row>
380 <entry>Architecture and Description</entry>
381
382 <entry>X86</entry>
383 </row>
384
385 <row>
386 <entry>Link to target datasheet</entry>
387
388 <entry>See <ulink
389 url="http://wiki.qemu.org">http://wiki.qemu.org</ulink></entry>
390 </row>
391
392 <row>
393 <entry>Poky version</entry>
394
395 <entry>Git-commit-id:
396 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
397 </row>
398
399 <row>
400 <entry>GCC version</entry>
401
402 <entry>5.3</entry>
403 </row>
404
405 <row>
406 <entry>Linux Kernel Version</entry>
407
408 <entry>4.4</entry>
409 </row>
410
411 <row>
412 <entry>Supported Drivers</entry>
413
414 <entry>Ethernet</entry>
415 </row>
416
417 <row>
418 <entry>Enea rpm folder for downloading RPM packages for this
419 target</entry>
420
421 <entry><ulink
422 url="https://linux.enea.com/6/qemux86/rpm">https://linux.enea.com/6/qemux86/rpm</ulink></entry>
423 </row>
424 </tbody>
425 </tgroup>
426 </informaltable></para>
427 </section>
428 </section>
429</section> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt b/doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt
new file mode 100644
index 0000000..7f1d3cb
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt
@@ -0,0 +1,320 @@
1eltf_params_template_updated_howto_use.txt
2
3This is a way to collect all parameters for an Enea Linux release
4in one parameter file, easy to automatically update by ELTF regularly.
5
6NOTE: Both the release info AND the open source books use parameters from
7 here, but the XML file is inside the release info book directory.
8
9NOTE: The manifest_conf.mk, or overridden by the environment variable
10 MANIFESTHASH, contains the full tag (or hashvalue) for downloading
11 the manifest when the books are built. The list of target
12 directories are fetched from the manifest into the book.
13 The eltf_params_updates.xml can all the time contain
14 the final next complete tag e.g. refs/tags/EL6 or similar
15 in the ELTF_PL_CLONE_W_REPO parameter command lines.
16
17The ordinary book XML files use xi:include statements to include elements
18from this parameter file. The book XML files can thus be manually edited.
19Before editing, you must run "make init".
20Any other text in the template or updated.xml file, outside the parts that
21are included in the book, are not used but still all must be correct
22DocBook XML files.
23
24ELTF work:
25 template => ELTF replaces ALL ELTF_xxx variables => updated XML file
26 => push to git only if changed
27
28
29eltf_params_template.xml (in git)
30 File used by ELTF to autocreate/update the real parameter
31 file eltf_params_updated.xml.
32
33eltf_params_updated.xml (in git)
34 Real parameter file where ELTF has replaced all ELTF_xx variables with
35 strings, in several cases with multiline strings.
36 No spaces or linefeed allowed in beginning or end of the variable values!
37
38
39xi:include: Each parameter is xi:include'ed in various book files, using
40 the IDs existing in the parameter files.
41 In most cases the 1:st element inside an element with an ID is included
42 using a format like eltf-prereq-apt-get-commands-host/1.
43 In very few cases the element with the ID is included in the book, one
44 example is the target section which has an ID, but which contains
45 multiple subsections, one per target.
46 All IDs in a book must be unique.
47
48DocBook XML: All XML files must be correct DocBook XML files.
49
50Do NOT edit/save the real *updated.xml file with XMLmind to avoid changes
51 not done by ELTF. But it is OK to open the real file in XMLmind to
52 check that the format is correct.
53
54ELTF should autocreate a temporary "real" file but only replace
55 and push the eltf_params_updated.xml if it is changed.
56
57
58make eltf
59 This lists all ELTF_xxx variables and some rules how to treat them
60
61DocBook Format: All elements - rules:
62 Several strict generic XML rules apply for all strings:
63 1. No TABs allowed or any other control chr than "linefeed"
64 2. Only 7-bit ASCII
65 3. Any < > & must be converted to &lt; &gt; and &amp;
66 Similar for any other non-7-bit-ASCII but avoid those!
67 4. No leading spaces or linefeeds when replacing the ELTF_* variable
68 5. No trailing spaces or linefeeds when replacing the ELTF_* variable
69 6. Note: Keep existing spaces before/efter ELTF_* in a few cases.
70
71DocBook Format: <programlisting> - rules: ELTF*PL* variables
72 Several strict rules apply for the multiline string in programlisting
73 in addition to the general XML rules above:
74 7. Max line length < 80 char
75 8. Use backslash (\) to break longer lines
76 9. Use spaces (e.g. 4) to indent continuation lines in programlistings
77 10. No trailing spaces on any line
78 11. No spaces or linefeed immediately after leading <programlisting>
79 12. No spaces or linefeed before trailing </programlisting>
80
81DocBook Format: <ulink> - rules: ELTF_*URL* variables
82 13. ELTF_*URL and corresponding ELTF_*TXTURL shall be identical strings
83 14. Only if the URL is extremely long, the TXTURL can be a separate string
84
85Each target has one section with target parameters:
86 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
87 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
88 ..... with many ELTF_ variables ....
89 </section>
90
91 15. If there is only one target. ELTF just replaces ELTF parameters
92
93 16. It there are multiple targets. ELTF copies the section and appends the
94 section the required number of times.
95 Each section ID will become unique: eltf-target-table-ELTF_T_MANIFEST_DIR
96 Each section title will become unique
97
98Tables with target parameters in each target section:
99 17. It is possible for ELTF to append more rows with one parameter each
100 to these tables, because the entire tables are included in the book
101
102Special - NOT YET READY DEFINED how to handle the optionally included
103 Eclipse and its version, but this is a first suggestion:
104 18. Just now ELTF can define ELFT_ECLIPSE_VERSION as a full string
105 with both version number and name,
106 19. MANUALLY if Eclipse is NOT included in the release,
107 the release manager should manually set condition="hidden" on
108 the entire section in the book XML about Eclipse
109
110
111
112BELOW WE TRY TO EXPLAIN EACH ELTF_* variable, but always check with make eltf
113if there are more new variables, missing in this description file.
114
115_____________________________________________________________________________
116ELTF_PL_HOST_PREREQ Multiline list of host prerequisites, e.g. commands
117 like sudo apt-get install xxxx or similar.
118 First line = comment with the complete host name!
119 It is possible to include multiple hosts by just
120 adding an empty line, comment with host name, etc.
121 xi:include eltf-prereq-apt-get-commands-host/1
122 This is a <programlisting>...</programlisting>
123 Example:
124# Host Ubuntu 14.04.5 LTS 64bit
125sudo apt-get update
126sudo apt-get install sed wget subversion git-core coreutils unzip texi2html \
127 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
128 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
129 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
130 libxml-parser-perl
131
132_____________________________________________________________________________
133ELTF_PL_GET_REPO Multiline commands to download the repo tool
134 xi:include eltf-getting-repo-install-command/1
135 This is a <programlisting>...</programlisting>
136 Example:
137mkdir -p ~/bin
138curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
139chmod a+x ~/bin/repo
140export PATH=~/bin:$PATH
141
142_____________________________________________________________________________
143ELTF_EL_REL_VER General parameter string: The version of this Enea
144 Linux release. Major version and optional .Minor
145 Typically created from MAJOR and MINOR in enea.conf
146 MINOR in enea.conf is empty or contains a dot+minor
147 xi_include EneaLinux_REL_VER/1
148 This is a <phrase>X.x</phrase> used in many places.
149 Examples:
1506
151 or
1526.1
153
154_____________________________________________________________________________
155ELTF_YOCTO_VER General parameter string: Yocto version, created
156 from DISTRO in poky.ent
157 xi:include Yocto_VER/1
158 This is a <phrase>X.x</phrase> used in many places.
159 Example:
1602.1
161
162_____________________________________________________________________________
163ELTF_YOCTO_NAME General parameter string: Yocto name (branch), created
164 from DISTRO_NAME_NO_CAP in poky.ent
165 xi:include Yocto_NAME/1
166 This is a <phrase>X.x</phrase> used in many places.
167 Example:
168krogoth
169
170_____________________________________________________________________________
171ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL
172ELTF_YOCTO_PROJ_DOWNLOAD_URL strings with correct Yocto version string
173 at the end, typically without "dot".
174 xi:include ULINK_YOCTO_PROJECT_DOWNLOAD/1
175 This is an <ulink url="...">...</ulink>
176 Example:
177http://www.yoctoproject.org/downloads/core/krogoth/21
178
179_____________________________________________________________________________
180ELTF_EL_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL strings
181ELTF_EL_DOWNLOAD_URL and shall be the http:/..... address where
182 Enea Linux can be downloaded
183 Often containing same version as in ELTF_EL_REL_VER
184 xi:include ULINK_ENEA_LINUX_URL/1
185 This is an <ulink url="...">...</ulink>
186 Example:
187http://linux.enea.com/6
188
189_____________________________________________________________________________
190ELTF_PL_CLONE_W_REPO Multiline commands to run repo to clone everything.
191 Use the variable $MACHINE/default.xml (the text in
192 the book will list the avaiable values of MACHINE,
193 taken from the manifest repository)
194 xi:include eltf-repo-cloning-enea-linux/1
195 This is a <programlisting>...</programlisting>
196 Example:
197mkdir enea-linux
198cd enea-linux
199repo init -u git://git.enea.com/linux/el_manifests-standard.git \
200 -b refs/tags/EL6 -m $MACHINE/default.xml
201repo sync
202
203_____________________________________________________________________________
204ELTF_ECLIPSE_VERSION Optional general parameter string.
205 NOT YET READY DEFINED
206 Just now a release manage must manually set
207 condition="hidden" on the Eclipse section,
208 if Eclipse is not included in the release.
209 ELTF just replaces ELTF_ECLIPSE_VERSION with a full
210 string with "X.Y (name)"
211 It includes the ID and can only be ONCE in the book.
212 xi:include eltf-eclipse-version-row
213 Example.
2144.5 (Mars)
215
216
217_____________________________________________________________________________
218ELTF_T_* All these are in each target (MACHINE) and ELTF
219 must separately replace them with strings for
220 each target
221 NOTE: All (except the MANIFEST_DIR) are in rows
222 in a table and ELTF can select to append
223 more parameters by adding more rows
224
225_____________________________________________________________________________
226ELTF_T_MANIFEST_DIR This happens to be in two places. Must be exactly
227ELTF_T_MANIFEST_DIR the directory name in the manifest, e.g. same
228 as the MACHINE names in $MACHINE/default.xml.
229 In book: a) Part of section ID
230 b) Part of section title
231 Examples:
232p2041rgb
233 or
234ls1021aiot
235 or
236qemuarm
237
238_____________________________________________________________________________
239ELTF_T_NAME Target specific: "Target Official Name"
240 NOT same as the target directory name in most cases.
241 In book: An <entry> element in a row
242 Examples:
243P2041RGB
244 or
245LS1021a-IoT
246 or
247qemuarm
248
249_____________________________________________________________________________
250ELTF_T_ARC_DESC Target specific: "Architecture and Description"
251 It can be a short identification string or
252 it can be a longer descriptive sentence.
253 In book: An <entry> element in a row
254 Examples:
255Power, e500mc
256 or
257ARM Cortex-A7
258
259_____________________________________________________________________________
260ELTF_T_DS_TXTURL Target specific: "Link to target datasheet. These
261ELTF_T_DS_URL two usually are IDENTICAL strings with correct
262 hyperlink to the target's official datasheet.
263 In book: an <ulink url="...">...</ulink>
264 Only if the link is VERY LONG, the text part shall
265 instead be a descriptive string (see 2:nd example).
266 NOTE: Also here no spaces or line-feeds!
267 Examples:
268url="http://wiki.qemu.org">http://wiki.qemu.org
269or
270url="http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/qoriq-arm-processors/qoriq-ls1021a-iot-gateway-reference-design:LS1021A-IoT">link to NXP's datasheet
271
272_____________________________________________________________________________
273ELTF_T_POKY_VER Target specific: "Poky version" created either
274 from POKYVERSION in poky.ent
275 or using a hashvalue with a leading string, in
276 which case it may be different per target.
277 In book: An <entry> in a row
278 Examples:
27915.0.0
280or
281Git commit id: 75ca53211488a3e268037a44ee2a7ac5c7181bd2
282
283_____________________________________________________________________________
284ELTF_T_GCC_VER Target specific: "GCC Version". Should be in poky
285 but not easy to find among various parameters.
286 ELTF would extract it from build logs building SDK
287 and it is possibly different per target.
288 In book: An <entry> in a row
289 Example:
2905.3
291
292_____________________________________________________________________________
293ELTF_T_KERN_VER Target specific: "Linux Kernel Version". Often
294 different per target.
295 In book: An <entry> in a row
296 Example:
2973.12
298
299_____________________________________________________________________________
300ELTF_T_DRIVERS Target specific: "Supported Drivers". This is a
301 comma-separated list of driver names.
302 ELTF should create the list in same order for each
303 target, e.g. alphabetic migth be OK.
304 In book: An <entry> in a row
305 Example:
306Ethernet, I2C, SPI, PCI, USB, SD/SDHC/SDXC
307
308
309_____________________________________________________________________________
310ELTF_T_EL_RPM_TXTURL Target specific: "Enea rpm folder for downloading
311ELTF_T_EL_RPM_URL RPM packages for this target". These two are
312 INDENTICAL strings with hyperlink to the web site
313 at Enea where the customer can download RPMs
314 Note: Often the ELFT_EL_REL_VER value and
315 the ELTF_T_MANIFEST_DIR are used in the link.
316 In book: an <ulink url="...">...</ulink>
317 Example:
318url="https://linux.enea.com/6/ls1021aiot/rpm">https://linux.enea.com/6/ls1021aiot/rpm
319
320_____________________________________________________________________________
diff --git a/doc/book-enea-linux-release-info/doc/extracted_info.xml b/doc/book-enea-linux-release-info/doc/extracted_info.xml
deleted file mode 100644
index 7156817..0000000
--- a/doc/book-enea-linux-release-info/doc/extracted_info.xml
+++ /dev/null
@@ -1,18 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="extracted-info">
5 <title>TEST Extracted Info from git and from poky for Each Target</title>
6
7 <para>xxxx</para>
8
9
10<section id="someinfo">
11 <title>Some Info Extracted Using git Into the Manual</title>
12 <para>Current URL of the manifest git is: git@git.enea.se:linux/manifests/el6-standard.git</para>
13 <para>Current HASH of the manifest git is: 7d848c27c76b48442df23e5aeb174573f0aba6c5</para>
14 <para>Corresponding meta-el-X should be meta-el-standard translated from the URL</para>
15 <para>Tips: A few values can be added as BOOK_PARAM_X (X= 1,2,3,4,5) env.variables when the book it build instead</para>
16</section>
17 <xi:include href="targetscontain.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
18</chapter>
diff --git a/doc/book-enea-linux-release-info/doc/extracted_info_template.xml b/doc/book-enea-linux-release-info/doc/extracted_info_template.xml
deleted file mode 100644
index 5f8eda4..0000000
--- a/doc/book-enea-linux-release-info/doc/extracted_info_template.xml
+++ /dev/null
@@ -1,10 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="extracted-info">
5 <title>TEST Extracted Info from git and from poky for Each Target</title>
6
7 <para>xxxx</para>
8
9
10</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
index 93a5c59..055be15 100644
--- a/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
+++ b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
@@ -33,38 +33,34 @@
33 <orderedlist> 33 <orderedlist>
34 <listitem> 34 <listitem>
35 <para>Make sure that the repo tool is installed. If not, follow the 35 <para>Make sure that the repo tool is installed. If not, follow the
36 instructions below:</para> 36 instructions below. The instruction assumes a suitable place in your
37 PATH to use. You might change that.<remark>INFO: Below is include of
38 ID "eltf-getting-repo-install-command" from
39 eltf_params_updated.xml</remark></para>
37 40
38 <para><programlisting>$ curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo 41 <xi:include href="eltf_params_updated.xml"
39$ chmod a+x ~/bin/repo</programlisting>The instruction assumes that ~/bin 42 xmlns:xi="http://www.w3.org/2001/XInclude"
40 exists and is included in the PATH variable.</para> 43 xpointer="element(eltf-getting-repo-install-command/1)" />
41 </listitem> 44 </listitem>
42 45
43 <listitem> 46 <listitem>
44 <para>Use the repo tool to download the source:<remark>FIXME: At final 47 <para>Use the repo tool to download the source: Please define MACHINE
45 release the tag for the manifest must be set in mainfest_conf.mk as 48 to your target, uncomment and use one of the MACHINE lines listed
46 MANIFESTHASH, typically something like refs/tags/EL6. Before final 49 here,<remark>Below is the "machine_list" programlisting in
47 release, it is possible to set MANIFESTHASH on the make command line 50 machine_list_generated.xml created by the make system by extracting
48 to override the value, e.g. with a commit hash string for a release 51 from the manifest</remark></para>
49 candidate to be tested</remark></para>
50 52
51 <programlisting>$ mkdir enea-linux 53 <xi:include href="machine_list_generated.xml"
52$ cd enea-linux 54 xmlns:xi="http://www.w3.org/2001/XInclude"
53$ repo init -u <xi:include href="../../s_docsrc_common/pardoc-distro.xml" 55 xpointer="element(machine-list/1)" />
54 xmlns:xi="http://www.w3.org/2001/XInclude"
55 xpointer="element(EneaLinux_MANIFESTURL/1)" /> \
56 -b <xi:include href="../../s_docsrc_common/pardoc-distro.xml"
57 xmlns:xi="http://www.w3.org/2001/XInclude"
58 xpointer="element(EneaLinux_MANIFESTHASH/1)" /> \
59 -m &lt;manifest file&gt;
60$ repo sync</programlisting>
61 56
62 <para>The parameter &lt;manifest file&gt; depends on the target. Use 57 <para>and use the repo command below:<remark> Below is include of ID
63 the following:</para> 58 "eltf-repo-cloning-enea-linux" from eltf_params_updated.xml. Here the
59 $MACHINE shall be given!</remark></para>
64 60
65 <xi:include element="manifestfiles/1" 61 <xi:include href="eltf_params_updated.xml"
66 href="manifestfiles_generated.xml" 62 xmlns:xi="http://www.w3.org/2001/XInclude"
67 xmlns:xi="http://www.w3.org/2001/XInclude" /> 63 xpointer="element(eltf-repo-cloning-enea-linux/1)" />
68 </listitem> 64 </listitem>
69 </orderedlist> 65 </orderedlist>
70 66
diff --git a/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml b/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
index 0b86eed..8a1033d 100644
--- a/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
+++ b/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
@@ -6,16 +6,20 @@
6 6
7 <para>The open source projects are continuously working on correcting 7 <para>The open source projects are continuously working on correcting
8 reported problems. Corrections to bugs detected by Enea are submitted 8 reported problems. Corrections to bugs detected by Enea are submitted
9 upstream, and the corrections are included in Enea Linux regardless of 9 upstream, and the corrections are included in Enea Linux regardless of when
10 when they will be included by the open source project. Remaining issues are 10 they will be included by the open source project. Remaining issues are
11 listed below.</para> 11 listed below.<remark>INFO: The <emphasis role="bold">Release-Specific
12 Problems</emphasis> section further down is generated from JIRA with
13 gen_known_issues.py, but that script is HARDCODED with affectedversion "Enea
14 Linux 6" and needs to be adapted when a release info for another EL version
15 changes.</remark></para>
12 16
13 <section id="bugs-limitations-yocto"> 17 <section id="bugs-limitations-yocto">
14 <title>Yocto</title> 18 <title>Yocto</title>
15 19
16 <para>The Yocto Project community uses a Bugzilla database to track 20 <para>The Yocto Project community uses a Bugzilla database to track
17 information on reported bugs and other issues: 21 information on reported bugs and other issues: <ulink
18 <ulink url="https://bugzilla.yoctoproject.org"> 22 url="https://bugzilla.yoctoproject.org">
19 https://bugzilla.yoctoproject.org</ulink>.</para> 23 https://bugzilla.yoctoproject.org</ulink>.</para>
20 </section> 24 </section>
21 25
@@ -26,7 +30,9 @@
26 <listitem> 30 <listitem>
27 <para>Building the kernel might fail if GNU Make of version 3.82 has 31 <para>Building the kernel might fail if GNU Make of version 3.82 has
28 been installed on the host. The mandatory recovery action is to revert 32 been installed on the host. The mandatory recovery action is to revert
29 to version 3.81.</para> 33 to version 3.81.<remark>INFO It is possible to hide this entire
34 subsection by setting condition hidden on the section
35 element</remark></para>
30 </listitem> 36 </listitem>
31 37
32 <listitem> 38 <listitem>
@@ -43,7 +49,8 @@
43 <para>Installation of some packages might currently fail when installing 49 <para>Installation of some packages might currently fail when installing
44 using the Smart Package Manager. An example is the qemu package. Errors 50 using the Smart Package Manager. An example is the qemu package. Errors
45 can e.g. be reported by smart about conflicts with files from other 51 can e.g. be reported by smart about conflicts with files from other
46 packages.</para> 52 packages.<remark>INFO It is possible to hide this setting condition hidden
53 on the section element</remark></para>
47 54
48 <para>The recommended solution to this problem is to install the failing 55 <para>The recommended solution to this problem is to install the failing
49 package using rpm, already available in enea-image-base. In order to 56 package using rpm, already available in enea-image-base. In order to
@@ -63,7 +70,8 @@
63 <title>Example with Failing QEMU Package</title> 70 <title>Example with Failing QEMU Package</title>
64 71
65 <para>As an example, the qemu installation can show the following 72 <para>As an example, the qemu installation can show the following
66 error.</para> 73 error.<remark>INFO It is possible to hide this setting condition hidden
74 on the section element</remark></para>
67 75
68 <note> 76 <note>
69 <para>The example below is for ARM, including the RPM names. For 77 <para>The example below is for ARM, including the RPM names. For
@@ -116,7 +124,8 @@
116 Yocto Application Development Toolkit (ADT) and are maintained by 124 Yocto Application Development Toolkit (ADT) and are maintained by
117 different open source projects. The list below outlines current problems 125 different open source projects. The list below outlines current problems
118 with the plug-ins as such, as well as kernel limitations when using a tool 126 with the plug-ins as such, as well as kernel limitations when using a tool
119 towards the mentioned target:</para> 127 towards the mentioned target:<remark>INFO It is possible to hide this
128 setting condition hidden on the section element</remark></para>
120 129
121 <itemizedlist spacing="compact"> 130 <itemizedlist spacing="compact">
122 <listitem> 131 <listitem>
@@ -257,7 +266,8 @@
257 266
258 <para>The target-side tools can be run stand-alone on target or from 267 <para>The target-side tools can be run stand-alone on target or from
259 Eclipse on host. The issues below are only observed when running the tools 268 Eclipse on host. The issues below are only observed when running the tools
260 directly on target:</para> 269 directly on target:<remark>INFO It is possible to hide this setting
270 condition hidden on the section element</remark></para>
261 271
262 <itemizedlist spacing="compact"> 272 <itemizedlist spacing="compact">
263 <listitem> 273 <listitem>
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 223aa42..38fec86 100644
--- a/doc/book-enea-linux-release-info/doc/main_changes.xml
+++ b/doc/book-enea-linux-release-info/doc/main_changes.xml
@@ -5,21 +5,29 @@
5 <title>Main Changes</title> 5 <title>Main Changes</title>
6 6
7 <para>This chapter describes the major changes and additions in the Enea 7 <para>This chapter describes the major changes and additions in the Enea
8 Linux release compared to the previous release (Enea Linux 5.0-ppc).</para> 8 Linux release compared to the previous release (Enea Linux
9 5.0-ppc).<remark>INFO Just now Hardcoded previous release string in this
10 paragraph.</remark><remark>The list of changed packages further down is
11 created from the open source book licenses.xml by the script gen_pkgdiff.py
12 by comparing with an older open source licenses.xml, depending on the
13 parameter "prev_baseline" in pardoc-distro.xml, e.g. a tag like "EL5". This
14 parameter needs to be changed to a new TAG when a release info for another
15 EL version is created. It must correspond to the release string
16 above.</remark></para>
9 17
10 <section id="relinfo-changes-other"> 18 <section id="relinfo-changes-other">
11 <title>New Functionality/Enhancements</title> 19 <title>New Functionality/Enhancements</title>
12 20
13 <remark>Based in the Jira query: 'project = CPDX and fixVersion = "Enea
14 Linux 6"'</remark>
15
16 <itemizedlist spacing="compact"> 21 <itemizedlist spacing="compact">
17 <listitem> 22 <listitem>
18 <para>New Yocto version (<xi:include 23 <para>New Yocto version (<xi:include href="eltf_params_updated.xml"
19 href="../../s_docsrc_common/pardoc-distro.xml" 24 xmlns:xi="http://www.w3.org/2001/XInclude"
25 xpointer="element(Yocto_VER/1)" />). See <xi:include
26 href="eltf_params_updated.xml"
20 xmlns:xi="http://www.w3.org/2001/XInclude" 27 xmlns:xi="http://www.w3.org/2001/XInclude"
21 xpointer="element(Yocto_VER/1)" />). See <ulink 28 xpointer="element(ULINK_YOCTO_PROJECT_DOWNLOAD/1)" />).<remark>INFO
22 url="https://www.yoctoproject.org/downloads/core/krogoth21">https://www.yoctoproject.org/downloads/core/krogoth21</ulink>.</para> 29 Yocto_VER and ULINK_YOCTO_PROJECT_DOWNLOAD in
30 eltf_params_updated.xml</remark></para>
23 </listitem> 31 </listitem>
24 32
25 <listitem> 33 <listitem>
@@ -36,13 +44,15 @@
36 <section condition="hidden" id="relinfo-fixed"> 44 <section condition="hidden" id="relinfo-fixed">
37 <title>Problems Fixed in this Release</title> 45 <title>Problems Fixed in this Release</title>
38 46
39 <para>TBD <remark>FIXME or set condition hidden</remark></para> 47 <para>TBD <remark>FIXME or set condition hidden on the section
48 element</remark></para>
40 </section> 49 </section>
41 50
42 <section condition="hidden" id="relinfo-added-drivers"> 51 <section condition="hidden" id="relinfo-added-drivers">
43 <title>Added Drivers</title> 52 <title>Added Drivers</title>
44 53
45 <para>TBD <remark>FIXME or set condition hidden</remark></para> 54 <para>TBD <remark>FIXME or set condition hidden on the section
55 element</remark></para>
46 </section> 56 </section>
47 57
48 <xi:include href="pkgdiff_generated.xml" 58 <xi:include href="pkgdiff_generated.xml"
diff --git a/doc/book-enea-linux-release-info/doc/prerequisites.xml b/doc/book-enea-linux-release-info/doc/prerequisites.xml
index 71f7d7e..c8d19ab 100644
--- a/doc/book-enea-linux-release-info/doc/prerequisites.xml
+++ b/doc/book-enea-linux-release-info/doc/prerequisites.xml
@@ -7,21 +7,15 @@
7 <para>Building Enea Linux or compiling applications requires some packages 7 <para>Building Enea Linux or compiling applications requires some packages
8 to be installed on your Linux development host.</para> 8 to be installed on your Linux development host.</para>
9 9
10 <section id="inst-host-packages-ubuntu-debian"> 10 <para>First ensure the system is up-to-date, then for the supported
11 <title>Ubuntu 14.04 LTS, 64-bit</title> 11 distribution(s) you need the following packages:<remark>INFO: The
12 programlisting below is a parameters in eltf_params_updated.xml with ID:
13 "eltf-prereq-apt-get-command-host". If multiple hosts are supported, store
14 the commands for each host in the same programlisting with empty lines
15 between each - the comment with the FULL HOST name and version is
16 essential.</remark></para>
12 17
13 <para>Ensure the system is up-to-date:</para> 18 <xi:include href="eltf_params_updated.xml"
14 19 xmlns:xi="http://www.w3.org/2001/XInclude"
15 <programlisting>$ sudo apt-get update</programlisting> 20 xpointer="element(eltf-prereq-apt-get-commands-host/1)" />
16
17 <para>For a supported <emphasis role="bold">Ubuntu</emphasis><indexterm>
18 <primary>Ubuntu</primary>
19 </indexterm> distribution you need the following packages:</para>
20
21 <programlisting>$ sudo apt-get install sed wget subversion git-core
22 coreutils unzip texi2html texinfo libsdl1.2-dev docbook-utils fop gawk
23 python-pysqlite2 diffstat make gcc build-essential xsltproc g++
24 desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev autoconf automake
25 groff libtool xterm libxml-parser-perl</programlisting>
26 </section>
27</chapter> \ No newline at end of file 21</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/targetscontain.xml b/doc/book-enea-linux-release-info/doc/targetscontain.xml
deleted file mode 100644
index 42522ae..0000000
--- a/doc/book-enea-linux-release-info/doc/targetscontain.xml
+++ /dev/null
@@ -1,867 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="targetscontain">
5 <title>DEMO-Autogenerated chapter - Poky Components in this
6 Distribution</title>
7
8 <note>
9 <para>JUST A DEMO, Examples what could be autoextracted from poky if we
10 want to</para>
11 </note>
12
13 <section>
14 <title>Various Config Files extracted from ls1021atwr/poky</title>
15 <para>poky contains</para>
16 <programlisting>
17bitbake/
18documentation/
19LICENSE
20meta/
21meta-el-common/
22meta-el-standard/
23meta-enea-base-arm/
24meta-enea-bsp-arm/
25meta-enea-bsp-common/
26meta-fsl-arm/
27meta-openembedded/
28meta-poky/
29meta-selftest/
30meta-skeleton/
31meta-yocto/
32meta-yocto-bsp/
33oe-init-build-env*
34oe-init-build-env-memres*
35README
36README.hardware
37scripts/
38</programlisting>
39 <para>Main version information in enea.conf is</para>
40 <programlisting>
41DISTRO_VERSION_MAJOR = "6.0"
42DISTRO_VERSION_MINOR ??= ""
43</programlisting>
44 <para>meta-el-* is meta-el-standard</para>
45 <para>Configuration files in template.p2041rdb</para>
46 <para>
47<programlisting>_____ template.p2041rdb/bblayers.conf.sample ____
48POKY_BBLAYERS_CONF_VERSION = "1"
49BBPATH = "${TOPDIR}"
50BBFILES ?= ""
51BBLAYERS ?= " \
52 ##OEROOT##/meta \
53 ##OEROOT##/meta-el-common \
54 ##OEROOT##/meta-el-standard \
55 ##OEROOT##/meta-enea-bsp-common \
56 ##OEROOT##/meta-enea-bsp-ppc \
57 ##OEROOT##/meta-fsl-ppc \
58 ##OEROOT##/meta-openembedded/meta-oe \
59 ##OEROOT##/meta-openembedded/meta-networking \
60 ##OEROOT##/meta-openembedded/meta-filesystems \
61 ##OEROOT##/meta-openembedded/meta-python \
62 ##OEROOT##/meta-poky \
63 "
64</programlisting>
65<programlisting>_____ template.p2041rdb/conf-notes.txt ____
66Common targets are:
67 enea-image-standard
68 enea-image-standard-sdk
69</programlisting>
70<programlisting>_____ template.p2041rdb/local.conf.sample ____
71MACHINE ?= "p2041rdb"
72DISTRO ?= "enea"
73PACKAGE_CLASSES ?= "package_rpm"
74EXTRA_IMAGE_FEATURES = "debug-tweaks"
75USER_CLASSES ?= "buildstats image-mklibs image-prelink"
76PATCHRESOLVE = "noop"
77BB_DISKMON_DIRS = "\
78 STOPTASKS,${TMPDIR},1G,100K \
79 STOPTASKS,${DL_DIR},1G,100K \
80 STOPTASKS,${SSTATE_DIR},1G,100K \
81 STOPTASKS,/tmp,100M,100K \
82 ABORT,${TMPDIR},100M,1K \
83 ABORT,${DL_DIR},100M,1K \
84 ABORT,${SSTATE_DIR},100M,1K \
85 ABORT,/tmp,10M,1K"
86PACKAGECONFIG_append_pn-qemu-native = " sdl"
87PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
88CONF_VERSION = "1"
89</programlisting>
90 </para>
91 <para>Configuration files in template.qemuarm</para>
92 <para>
93<programlisting>_____ template.qemuarm/bblayers.conf.sample ____
94POKY_BBLAYERS_CONF_VERSION = "1"
95BBPATH = "${TOPDIR}"
96BBFILES ?= ""
97BBLAYERS ?= " \
98 ##OEROOT##/meta \
99 ##OEROOT##/meta-el-common \
100 ##OEROOT##/meta-el-standard \
101 ##OEROOT##/meta-enea-bsp-common \
102 ##OEROOT##/meta-openembedded/meta-oe \
103 ##OEROOT##/meta-openembedded/meta-networking \
104 ##OEROOT##/meta-openembedded/meta-filesystems \
105 ##OEROOT##/meta-openembedded/meta-python \
106 ##OEROOT##/meta-poky \
107 "
108</programlisting>
109<programlisting>_____ template.qemuarm/conf-notes.txt ____
110Common targets are:
111 enea-image-standard
112 enea-image-standard-sdk
113</programlisting>
114<programlisting>_____ template.qemuarm/local.conf.sample ____
115MACHINE ?= "qemuarm"
116DISTRO ?= "enea"
117PACKAGE_CLASSES ?= "package_rpm"
118EXTRA_IMAGE_FEATURES = "debug-tweaks"
119USER_CLASSES ?= "buildstats image-mklibs image-prelink"
120PATCHRESOLVE = "noop"
121BB_DISKMON_DIRS = "\
122 STOPTASKS,${TMPDIR},1G,100K \
123 STOPTASKS,${DL_DIR},1G,100K \
124 STOPTASKS,${SSTATE_DIR},1G,100K \
125 STOPTASKS,/tmp,100M,100K \
126 ABORT,${TMPDIR},100M,1K \
127 ABORT,${DL_DIR},100M,1K \
128 ABORT,${SSTATE_DIR},100M,1K \
129 ABORT,/tmp,10M,1K"
130PACKAGECONFIG_append_pn-qemu-native = " sdl"
131PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
132CONF_VERSION = "1"
133</programlisting>
134 </para>
135 <para>Configuration files in template.qemuppc</para>
136 <para>
137<programlisting>_____ template.qemuppc/bblayers.conf.sample ____
138POKY_BBLAYERS_CONF_VERSION = "1"
139BBPATH = "${TOPDIR}"
140BBFILES ?= ""
141BBLAYERS ?= " \
142 ##OEROOT##/meta \
143 ##OEROOT##/meta-el-common \
144 ##OEROOT##/meta-el-standard \
145 ##OEROOT##/meta-enea-bsp-common \
146 ##OEROOT##/meta-openembedded/meta-oe \
147 ##OEROOT##/meta-openembedded/meta-networking \
148 ##OEROOT##/meta-openembedded/meta-filesystems \
149 ##OEROOT##/meta-openembedded/meta-python \
150 ##OEROOT##/meta-poky \
151 "
152</programlisting>
153<programlisting>_____ template.qemuppc/conf-notes.txt ____
154Common targets are:
155 enea-image-standard
156 enea-image-standard-sdk
157</programlisting>
158<programlisting>_____ template.qemuppc/local.conf.sample ____
159MACHINE ?= "qemuppc"
160DISTRO ?= "enea"
161PACKAGE_CLASSES ?= "package_rpm"
162EXTRA_IMAGE_FEATURES = "debug-tweaks"
163USER_CLASSES ?= "buildstats image-mklibs image-prelink"
164PATCHRESOLVE = "noop"
165BB_DISKMON_DIRS = "\
166 STOPTASKS,${TMPDIR},1G,100K \
167 STOPTASKS,${DL_DIR},1G,100K \
168 STOPTASKS,${SSTATE_DIR},1G,100K \
169 STOPTASKS,/tmp,100M,100K \
170 ABORT,${TMPDIR},100M,1K \
171 ABORT,${DL_DIR},100M,1K \
172 ABORT,${SSTATE_DIR},100M,1K \
173 ABORT,/tmp,10M,1K"
174PACKAGECONFIG_append_pn-qemu-native = " sdl"
175PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
176CONF_VERSION = "1"
177</programlisting>
178 </para>
179 <para>Images</para>
180 <programlisting>
181enea-image-standard.bb
182enea-image-standard-sdk.bb
183</programlisting>
184 </section>
185 <section>
186 <title>Various Config Files extracted from p2041rdb/poky</title>
187 <para>poky contains</para>
188 <programlisting>
189bitbake/
190documentation/
191LICENSE
192meta/
193meta-el-common/
194meta-el-standard/
195meta-enea-base-ppc/
196meta-enea-bsp-common/
197meta-enea-bsp-ppc/
198meta-fsl-ppc/
199meta-openembedded/
200meta-poky/
201meta-selftest/
202meta-skeleton/
203meta-yocto/
204meta-yocto-bsp/
205oe-init-build-env*
206oe-init-build-env-memres*
207README
208README.hardware
209scripts/
210</programlisting>
211 <para>Main version information in enea.conf is</para>
212 <programlisting>
213DISTRO_VERSION_MAJOR = "6.0"
214DISTRO_VERSION_MINOR ??= ""
215</programlisting>
216 <para>meta-el-* is meta-el-standard</para>
217 <para>Configuration files in template.p2041rdb</para>
218 <para>
219<programlisting>_____ template.p2041rdb/bblayers.conf.sample ____
220POKY_BBLAYERS_CONF_VERSION = "1"
221BBPATH = "${TOPDIR}"
222BBFILES ?= ""
223BBLAYERS ?= " \
224 ##OEROOT##/meta \
225 ##OEROOT##/meta-el-common \
226 ##OEROOT##/meta-el-standard \
227 ##OEROOT##/meta-enea-bsp-common \
228 ##OEROOT##/meta-enea-bsp-ppc \
229 ##OEROOT##/meta-fsl-ppc \
230 ##OEROOT##/meta-openembedded/meta-oe \
231 ##OEROOT##/meta-openembedded/meta-networking \
232 ##OEROOT##/meta-openembedded/meta-filesystems \
233 ##OEROOT##/meta-openembedded/meta-python \
234 ##OEROOT##/meta-poky \
235 "
236</programlisting>
237<programlisting>_____ template.p2041rdb/conf-notes.txt ____
238Common targets are:
239 enea-image-standard
240 enea-image-standard-sdk
241</programlisting>
242<programlisting>_____ template.p2041rdb/local.conf.sample ____
243MACHINE ?= "p2041rdb"
244DISTRO ?= "enea"
245PACKAGE_CLASSES ?= "package_rpm"
246EXTRA_IMAGE_FEATURES = "debug-tweaks"
247USER_CLASSES ?= "buildstats image-mklibs image-prelink"
248PATCHRESOLVE = "noop"
249BB_DISKMON_DIRS = "\
250 STOPTASKS,${TMPDIR},1G,100K \
251 STOPTASKS,${DL_DIR},1G,100K \
252 STOPTASKS,${SSTATE_DIR},1G,100K \
253 STOPTASKS,/tmp,100M,100K \
254 ABORT,${TMPDIR},100M,1K \
255 ABORT,${DL_DIR},100M,1K \
256 ABORT,${SSTATE_DIR},100M,1K \
257 ABORT,/tmp,10M,1K"
258PACKAGECONFIG_append_pn-qemu-native = " sdl"
259PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
260CONF_VERSION = "1"
261</programlisting>
262 </para>
263 <para>Configuration files in template.qemuarm</para>
264 <para>
265<programlisting>_____ template.qemuarm/bblayers.conf.sample ____
266POKY_BBLAYERS_CONF_VERSION = "1"
267BBPATH = "${TOPDIR}"
268BBFILES ?= ""
269BBLAYERS ?= " \
270 ##OEROOT##/meta \
271 ##OEROOT##/meta-el-common \
272 ##OEROOT##/meta-el-standard \
273 ##OEROOT##/meta-enea-bsp-common \
274 ##OEROOT##/meta-openembedded/meta-oe \
275 ##OEROOT##/meta-openembedded/meta-networking \
276 ##OEROOT##/meta-openembedded/meta-filesystems \
277 ##OEROOT##/meta-openembedded/meta-python \
278 ##OEROOT##/meta-poky \
279 "
280</programlisting>
281<programlisting>_____ template.qemuarm/conf-notes.txt ____
282Common targets are:
283 enea-image-standard
284 enea-image-standard-sdk
285</programlisting>
286<programlisting>_____ template.qemuarm/local.conf.sample ____
287MACHINE ?= "qemuarm"
288DISTRO ?= "enea"
289PACKAGE_CLASSES ?= "package_rpm"
290EXTRA_IMAGE_FEATURES = "debug-tweaks"
291USER_CLASSES ?= "buildstats image-mklibs image-prelink"
292PATCHRESOLVE = "noop"
293BB_DISKMON_DIRS = "\
294 STOPTASKS,${TMPDIR},1G,100K \
295 STOPTASKS,${DL_DIR},1G,100K \
296 STOPTASKS,${SSTATE_DIR},1G,100K \
297 STOPTASKS,/tmp,100M,100K \
298 ABORT,${TMPDIR},100M,1K \
299 ABORT,${DL_DIR},100M,1K \
300 ABORT,${SSTATE_DIR},100M,1K \
301 ABORT,/tmp,10M,1K"
302PACKAGECONFIG_append_pn-qemu-native = " sdl"
303PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
304CONF_VERSION = "1"
305</programlisting>
306 </para>
307 <para>Configuration files in template.qemuppc</para>
308 <para>
309<programlisting>_____ template.qemuppc/bblayers.conf.sample ____
310POKY_BBLAYERS_CONF_VERSION = "1"
311BBPATH = "${TOPDIR}"
312BBFILES ?= ""
313BBLAYERS ?= " \
314 ##OEROOT##/meta \
315 ##OEROOT##/meta-el-common \
316 ##OEROOT##/meta-el-standard \
317 ##OEROOT##/meta-enea-bsp-common \
318 ##OEROOT##/meta-openembedded/meta-oe \
319 ##OEROOT##/meta-openembedded/meta-networking \
320 ##OEROOT##/meta-openembedded/meta-filesystems \
321 ##OEROOT##/meta-openembedded/meta-python \
322 ##OEROOT##/meta-poky \
323 "
324</programlisting>
325<programlisting>_____ template.qemuppc/conf-notes.txt ____
326Common targets are:
327 enea-image-standard
328 enea-image-standard-sdk
329</programlisting>
330<programlisting>_____ template.qemuppc/local.conf.sample ____
331MACHINE ?= "qemuppc"
332DISTRO ?= "enea"
333PACKAGE_CLASSES ?= "package_rpm"
334EXTRA_IMAGE_FEATURES = "debug-tweaks"
335USER_CLASSES ?= "buildstats image-mklibs image-prelink"
336PATCHRESOLVE = "noop"
337BB_DISKMON_DIRS = "\
338 STOPTASKS,${TMPDIR},1G,100K \
339 STOPTASKS,${DL_DIR},1G,100K \
340 STOPTASKS,${SSTATE_DIR},1G,100K \
341 STOPTASKS,/tmp,100M,100K \
342 ABORT,${TMPDIR},100M,1K \
343 ABORT,${DL_DIR},100M,1K \
344 ABORT,${SSTATE_DIR},100M,1K \
345 ABORT,/tmp,10M,1K"
346PACKAGECONFIG_append_pn-qemu-native = " sdl"
347PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
348CONF_VERSION = "1"
349</programlisting>
350 </para>
351 <para>Images</para>
352 <programlisting>
353enea-image-standard.bb
354enea-image-standard-sdk.bb
355</programlisting>
356 </section>
357 <section>
358 <title>Various Config Files extracted from qemuarm/poky</title>
359 <para>poky contains</para>
360 <programlisting>
361bitbake/
362documentation/
363LICENSE
364meta/
365meta-el-common/
366meta-el-standard/
367meta-enea-base-arm/
368meta-enea-bsp-common/
369meta-openembedded/
370meta-poky/
371meta-selftest/
372meta-skeleton/
373meta-yocto/
374meta-yocto-bsp/
375oe-init-build-env*
376oe-init-build-env-memres*
377README
378README.hardware
379scripts/
380</programlisting>
381 <para>Main version information in enea.conf is</para>
382 <programlisting>
383DISTRO_VERSION_MAJOR = "6.0"
384DISTRO_VERSION_MINOR ??= ""
385</programlisting>
386 <para>meta-el-* is meta-el-standard</para>
387 <para>Configuration files in template.p2041rdb</para>
388 <para>
389<programlisting>_____ template.p2041rdb/bblayers.conf.sample ____
390POKY_BBLAYERS_CONF_VERSION = "1"
391BBPATH = "${TOPDIR}"
392BBFILES ?= ""
393BBLAYERS ?= " \
394 ##OEROOT##/meta \
395 ##OEROOT##/meta-el-common \
396 ##OEROOT##/meta-el-standard \
397 ##OEROOT##/meta-enea-bsp-common \
398 ##OEROOT##/meta-enea-bsp-ppc \
399 ##OEROOT##/meta-fsl-ppc \
400 ##OEROOT##/meta-openembedded/meta-oe \
401 ##OEROOT##/meta-openembedded/meta-networking \
402 ##OEROOT##/meta-openembedded/meta-filesystems \
403 ##OEROOT##/meta-openembedded/meta-python \
404 ##OEROOT##/meta-poky \
405 "
406</programlisting>
407<programlisting>_____ template.p2041rdb/conf-notes.txt ____
408Common targets are:
409 enea-image-standard
410 enea-image-standard-sdk
411</programlisting>
412<programlisting>_____ template.p2041rdb/local.conf.sample ____
413MACHINE ?= "p2041rdb"
414DISTRO ?= "enea"
415PACKAGE_CLASSES ?= "package_rpm"
416EXTRA_IMAGE_FEATURES = "debug-tweaks"
417USER_CLASSES ?= "buildstats image-mklibs image-prelink"
418PATCHRESOLVE = "noop"
419BB_DISKMON_DIRS = "\
420 STOPTASKS,${TMPDIR},1G,100K \
421 STOPTASKS,${DL_DIR},1G,100K \
422 STOPTASKS,${SSTATE_DIR},1G,100K \
423 STOPTASKS,/tmp,100M,100K \
424 ABORT,${TMPDIR},100M,1K \
425 ABORT,${DL_DIR},100M,1K \
426 ABORT,${SSTATE_DIR},100M,1K \
427 ABORT,/tmp,10M,1K"
428PACKAGECONFIG_append_pn-qemu-native = " sdl"
429PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
430CONF_VERSION = "1"
431</programlisting>
432 </para>
433 <para>Configuration files in template.qemuarm</para>
434 <para>
435<programlisting>_____ template.qemuarm/bblayers.conf.sample ____
436POKY_BBLAYERS_CONF_VERSION = "1"
437BBPATH = "${TOPDIR}"
438BBFILES ?= ""
439BBLAYERS ?= " \
440 ##OEROOT##/meta \
441 ##OEROOT##/meta-el-common \
442 ##OEROOT##/meta-el-standard \
443 ##OEROOT##/meta-enea-bsp-common \
444 ##OEROOT##/meta-openembedded/meta-oe \
445 ##OEROOT##/meta-openembedded/meta-networking \
446 ##OEROOT##/meta-openembedded/meta-filesystems \
447 ##OEROOT##/meta-openembedded/meta-python \
448 ##OEROOT##/meta-poky \
449 "
450</programlisting>
451<programlisting>_____ template.qemuarm/conf-notes.txt ____
452Common targets are:
453 enea-image-standard
454 enea-image-standard-sdk
455</programlisting>
456<programlisting>_____ template.qemuarm/local.conf.sample ____
457MACHINE ?= "qemuarm"
458DISTRO ?= "enea"
459PACKAGE_CLASSES ?= "package_rpm"
460EXTRA_IMAGE_FEATURES = "debug-tweaks"
461USER_CLASSES ?= "buildstats image-mklibs image-prelink"
462PATCHRESOLVE = "noop"
463BB_DISKMON_DIRS = "\
464 STOPTASKS,${TMPDIR},1G,100K \
465 STOPTASKS,${DL_DIR},1G,100K \
466 STOPTASKS,${SSTATE_DIR},1G,100K \
467 STOPTASKS,/tmp,100M,100K \
468 ABORT,${TMPDIR},100M,1K \
469 ABORT,${DL_DIR},100M,1K \
470 ABORT,${SSTATE_DIR},100M,1K \
471 ABORT,/tmp,10M,1K"
472PACKAGECONFIG_append_pn-qemu-native = " sdl"
473PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
474CONF_VERSION = "1"
475</programlisting>
476 </para>
477 <para>Configuration files in template.qemuppc</para>
478 <para>
479<programlisting>_____ template.qemuppc/bblayers.conf.sample ____
480POKY_BBLAYERS_CONF_VERSION = "1"
481BBPATH = "${TOPDIR}"
482BBFILES ?= ""
483BBLAYERS ?= " \
484 ##OEROOT##/meta \
485 ##OEROOT##/meta-el-common \
486 ##OEROOT##/meta-el-standard \
487 ##OEROOT##/meta-enea-bsp-common \
488 ##OEROOT##/meta-openembedded/meta-oe \
489 ##OEROOT##/meta-openembedded/meta-networking \
490 ##OEROOT##/meta-openembedded/meta-filesystems \
491 ##OEROOT##/meta-openembedded/meta-python \
492 ##OEROOT##/meta-poky \
493 "
494</programlisting>
495<programlisting>_____ template.qemuppc/conf-notes.txt ____
496Common targets are:
497 enea-image-standard
498 enea-image-standard-sdk
499</programlisting>
500<programlisting>_____ template.qemuppc/local.conf.sample ____
501MACHINE ?= "qemuppc"
502DISTRO ?= "enea"
503PACKAGE_CLASSES ?= "package_rpm"
504EXTRA_IMAGE_FEATURES = "debug-tweaks"
505USER_CLASSES ?= "buildstats image-mklibs image-prelink"
506PATCHRESOLVE = "noop"
507BB_DISKMON_DIRS = "\
508 STOPTASKS,${TMPDIR},1G,100K \
509 STOPTASKS,${DL_DIR},1G,100K \
510 STOPTASKS,${SSTATE_DIR},1G,100K \
511 STOPTASKS,/tmp,100M,100K \
512 ABORT,${TMPDIR},100M,1K \
513 ABORT,${DL_DIR},100M,1K \
514 ABORT,${SSTATE_DIR},100M,1K \
515 ABORT,/tmp,10M,1K"
516PACKAGECONFIG_append_pn-qemu-native = " sdl"
517PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
518CONF_VERSION = "1"
519</programlisting>
520 </para>
521 <para>Images</para>
522 <programlisting>
523enea-image-standard.bb
524enea-image-standard-sdk.bb
525</programlisting>
526 </section>
527 <section>
528 <title>Various Config Files extracted from qemuppc/poky</title>
529 <para>poky contains</para>
530 <programlisting>
531bitbake/
532documentation/
533LICENSE
534meta/
535meta-el-common/
536meta-el-standard/
537meta-enea-base-ppc/
538meta-enea-bsp-common/
539meta-openembedded/
540meta-poky/
541meta-selftest/
542meta-skeleton/
543meta-yocto/
544meta-yocto-bsp/
545oe-init-build-env*
546oe-init-build-env-memres*
547README
548README.hardware
549scripts/
550</programlisting>
551 <para>Main version information in enea.conf is</para>
552 <programlisting>
553DISTRO_VERSION_MAJOR = "6.0"
554DISTRO_VERSION_MINOR ??= ""
555</programlisting>
556 <para>meta-el-* is meta-el-standard</para>
557 <para>Configuration files in template.p2041rdb</para>
558 <para>
559<programlisting>_____ template.p2041rdb/bblayers.conf.sample ____
560POKY_BBLAYERS_CONF_VERSION = "1"
561BBPATH = "${TOPDIR}"
562BBFILES ?= ""
563BBLAYERS ?= " \
564 ##OEROOT##/meta \
565 ##OEROOT##/meta-el-common \
566 ##OEROOT##/meta-el-standard \
567 ##OEROOT##/meta-enea-bsp-common \
568 ##OEROOT##/meta-enea-bsp-ppc \
569 ##OEROOT##/meta-fsl-ppc \
570 ##OEROOT##/meta-openembedded/meta-oe \
571 ##OEROOT##/meta-openembedded/meta-networking \
572 ##OEROOT##/meta-openembedded/meta-filesystems \
573 ##OEROOT##/meta-openembedded/meta-python \
574 ##OEROOT##/meta-poky \
575 "
576</programlisting>
577<programlisting>_____ template.p2041rdb/conf-notes.txt ____
578Common targets are:
579 enea-image-standard
580 enea-image-standard-sdk
581</programlisting>
582<programlisting>_____ template.p2041rdb/local.conf.sample ____
583MACHINE ?= "p2041rdb"
584DISTRO ?= "enea"
585PACKAGE_CLASSES ?= "package_rpm"
586EXTRA_IMAGE_FEATURES = "debug-tweaks"
587USER_CLASSES ?= "buildstats image-mklibs image-prelink"
588PATCHRESOLVE = "noop"
589BB_DISKMON_DIRS = "\
590 STOPTASKS,${TMPDIR},1G,100K \
591 STOPTASKS,${DL_DIR},1G,100K \
592 STOPTASKS,${SSTATE_DIR},1G,100K \
593 STOPTASKS,/tmp,100M,100K \
594 ABORT,${TMPDIR},100M,1K \
595 ABORT,${DL_DIR},100M,1K \
596 ABORT,${SSTATE_DIR},100M,1K \
597 ABORT,/tmp,10M,1K"
598PACKAGECONFIG_append_pn-qemu-native = " sdl"
599PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
600CONF_VERSION = "1"
601</programlisting>
602 </para>
603 <para>Configuration files in template.qemuarm</para>
604 <para>
605<programlisting>_____ template.qemuarm/bblayers.conf.sample ____
606POKY_BBLAYERS_CONF_VERSION = "1"
607BBPATH = "${TOPDIR}"
608BBFILES ?= ""
609BBLAYERS ?= " \
610 ##OEROOT##/meta \
611 ##OEROOT##/meta-el-common \
612 ##OEROOT##/meta-el-standard \
613 ##OEROOT##/meta-enea-bsp-common \
614 ##OEROOT##/meta-openembedded/meta-oe \
615 ##OEROOT##/meta-openembedded/meta-networking \
616 ##OEROOT##/meta-openembedded/meta-filesystems \
617 ##OEROOT##/meta-openembedded/meta-python \
618 ##OEROOT##/meta-poky \
619 "
620</programlisting>
621<programlisting>_____ template.qemuarm/conf-notes.txt ____
622Common targets are:
623 enea-image-standard
624 enea-image-standard-sdk
625</programlisting>
626<programlisting>_____ template.qemuarm/local.conf.sample ____
627MACHINE ?= "qemuarm"
628DISTRO ?= "enea"
629PACKAGE_CLASSES ?= "package_rpm"
630EXTRA_IMAGE_FEATURES = "debug-tweaks"
631USER_CLASSES ?= "buildstats image-mklibs image-prelink"
632PATCHRESOLVE = "noop"
633BB_DISKMON_DIRS = "\
634 STOPTASKS,${TMPDIR},1G,100K \
635 STOPTASKS,${DL_DIR},1G,100K \
636 STOPTASKS,${SSTATE_DIR},1G,100K \
637 STOPTASKS,/tmp,100M,100K \
638 ABORT,${TMPDIR},100M,1K \
639 ABORT,${DL_DIR},100M,1K \
640 ABORT,${SSTATE_DIR},100M,1K \
641 ABORT,/tmp,10M,1K"
642PACKAGECONFIG_append_pn-qemu-native = " sdl"
643PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
644CONF_VERSION = "1"
645</programlisting>
646 </para>
647 <para>Configuration files in template.qemuppc</para>
648 <para>
649<programlisting>_____ template.qemuppc/bblayers.conf.sample ____
650POKY_BBLAYERS_CONF_VERSION = "1"
651BBPATH = "${TOPDIR}"
652BBFILES ?= ""
653BBLAYERS ?= " \
654 ##OEROOT##/meta \
655 ##OEROOT##/meta-el-common \
656 ##OEROOT##/meta-el-standard \
657 ##OEROOT##/meta-enea-bsp-common \
658 ##OEROOT##/meta-openembedded/meta-oe \
659 ##OEROOT##/meta-openembedded/meta-networking \
660 ##OEROOT##/meta-openembedded/meta-filesystems \
661 ##OEROOT##/meta-openembedded/meta-python \
662 ##OEROOT##/meta-poky \
663 "
664</programlisting>
665<programlisting>_____ template.qemuppc/conf-notes.txt ____
666Common targets are:
667 enea-image-standard
668 enea-image-standard-sdk
669</programlisting>
670<programlisting>_____ template.qemuppc/local.conf.sample ____
671MACHINE ?= "qemuppc"
672DISTRO ?= "enea"
673PACKAGE_CLASSES ?= "package_rpm"
674EXTRA_IMAGE_FEATURES = "debug-tweaks"
675USER_CLASSES ?= "buildstats image-mklibs image-prelink"
676PATCHRESOLVE = "noop"
677BB_DISKMON_DIRS = "\
678 STOPTASKS,${TMPDIR},1G,100K \
679 STOPTASKS,${DL_DIR},1G,100K \
680 STOPTASKS,${SSTATE_DIR},1G,100K \
681 STOPTASKS,/tmp,100M,100K \
682 ABORT,${TMPDIR},100M,1K \
683 ABORT,${DL_DIR},100M,1K \
684 ABORT,${SSTATE_DIR},100M,1K \
685 ABORT,/tmp,10M,1K"
686PACKAGECONFIG_append_pn-qemu-native = " sdl"
687PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
688CONF_VERSION = "1"
689</programlisting>
690 </para>
691 <para>Images</para>
692 <programlisting>
693enea-image-standard.bb
694enea-image-standard-sdk.bb
695</programlisting>
696 </section>
697 <section>
698 <title>Various Config Files extracted from qemux86/poky</title>
699 <para>poky contains</para>
700 <programlisting>
701bitbake/
702documentation/
703LICENSE
704meta/
705meta-el-common/
706meta-el-standard/
707meta-enea-base-x86/
708meta-enea-bsp-common/
709meta-openembedded/
710meta-poky/
711meta-selftest/
712meta-skeleton/
713meta-yocto/
714meta-yocto-bsp/
715oe-init-build-env*
716oe-init-build-env-memres*
717README
718README.hardware
719scripts/
720</programlisting>
721 <para>Main version information in enea.conf is</para>
722 <programlisting>
723DISTRO_VERSION_MAJOR = "6.0"
724DISTRO_VERSION_MINOR ??= ""
725</programlisting>
726 <para>meta-el-* is meta-el-standard</para>
727 <para>Configuration files in template.p2041rdb</para>
728 <para>
729<programlisting>_____ template.p2041rdb/bblayers.conf.sample ____
730POKY_BBLAYERS_CONF_VERSION = "1"
731BBPATH = "${TOPDIR}"
732BBFILES ?= ""
733BBLAYERS ?= " \
734 ##OEROOT##/meta \
735 ##OEROOT##/meta-el-common \
736 ##OEROOT##/meta-el-standard \
737 ##OEROOT##/meta-enea-bsp-common \
738 ##OEROOT##/meta-enea-bsp-ppc \
739 ##OEROOT##/meta-fsl-ppc \
740 ##OEROOT##/meta-openembedded/meta-oe \
741 ##OEROOT##/meta-openembedded/meta-networking \
742 ##OEROOT##/meta-openembedded/meta-filesystems \
743 ##OEROOT##/meta-openembedded/meta-python \
744 ##OEROOT##/meta-poky \
745 "
746</programlisting>
747<programlisting>_____ template.p2041rdb/conf-notes.txt ____
748Common targets are:
749 enea-image-standard
750 enea-image-standard-sdk
751</programlisting>
752<programlisting>_____ template.p2041rdb/local.conf.sample ____
753MACHINE ?= "p2041rdb"
754DISTRO ?= "enea"
755PACKAGE_CLASSES ?= "package_rpm"
756EXTRA_IMAGE_FEATURES = "debug-tweaks"
757USER_CLASSES ?= "buildstats image-mklibs image-prelink"
758PATCHRESOLVE = "noop"
759BB_DISKMON_DIRS = "\
760 STOPTASKS,${TMPDIR},1G,100K \
761 STOPTASKS,${DL_DIR},1G,100K \
762 STOPTASKS,${SSTATE_DIR},1G,100K \
763 STOPTASKS,/tmp,100M,100K \
764 ABORT,${TMPDIR},100M,1K \
765 ABORT,${DL_DIR},100M,1K \
766 ABORT,${SSTATE_DIR},100M,1K \
767 ABORT,/tmp,10M,1K"
768PACKAGECONFIG_append_pn-qemu-native = " sdl"
769PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
770CONF_VERSION = "1"
771</programlisting>
772 </para>
773 <para>Configuration files in template.qemuarm</para>
774 <para>
775<programlisting>_____ template.qemuarm/bblayers.conf.sample ____
776POKY_BBLAYERS_CONF_VERSION = "1"
777BBPATH = "${TOPDIR}"
778BBFILES ?= ""
779BBLAYERS ?= " \
780 ##OEROOT##/meta \
781 ##OEROOT##/meta-el-common \
782 ##OEROOT##/meta-el-standard \
783 ##OEROOT##/meta-enea-bsp-common \
784 ##OEROOT##/meta-openembedded/meta-oe \
785 ##OEROOT##/meta-openembedded/meta-networking \
786 ##OEROOT##/meta-openembedded/meta-filesystems \
787 ##OEROOT##/meta-openembedded/meta-python \
788 ##OEROOT##/meta-poky \
789 "
790</programlisting>
791<programlisting>_____ template.qemuarm/conf-notes.txt ____
792Common targets are:
793 enea-image-standard
794 enea-image-standard-sdk
795</programlisting>
796<programlisting>_____ template.qemuarm/local.conf.sample ____
797MACHINE ?= "qemuarm"
798DISTRO ?= "enea"
799PACKAGE_CLASSES ?= "package_rpm"
800EXTRA_IMAGE_FEATURES = "debug-tweaks"
801USER_CLASSES ?= "buildstats image-mklibs image-prelink"
802PATCHRESOLVE = "noop"
803BB_DISKMON_DIRS = "\
804 STOPTASKS,${TMPDIR},1G,100K \
805 STOPTASKS,${DL_DIR},1G,100K \
806 STOPTASKS,${SSTATE_DIR},1G,100K \
807 STOPTASKS,/tmp,100M,100K \
808 ABORT,${TMPDIR},100M,1K \
809 ABORT,${DL_DIR},100M,1K \
810 ABORT,${SSTATE_DIR},100M,1K \
811 ABORT,/tmp,10M,1K"
812PACKAGECONFIG_append_pn-qemu-native = " sdl"
813PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
814CONF_VERSION = "1"
815</programlisting>
816 </para>
817 <para>Configuration files in template.qemuppc</para>
818 <para>
819<programlisting>_____ template.qemuppc/bblayers.conf.sample ____
820POKY_BBLAYERS_CONF_VERSION = "1"
821BBPATH = "${TOPDIR}"
822BBFILES ?= ""
823BBLAYERS ?= " \
824 ##OEROOT##/meta \
825 ##OEROOT##/meta-el-common \
826 ##OEROOT##/meta-el-standard \
827 ##OEROOT##/meta-enea-bsp-common \
828 ##OEROOT##/meta-openembedded/meta-oe \
829 ##OEROOT##/meta-openembedded/meta-networking \
830 ##OEROOT##/meta-openembedded/meta-filesystems \
831 ##OEROOT##/meta-openembedded/meta-python \
832 ##OEROOT##/meta-poky \
833 "
834</programlisting>
835<programlisting>_____ template.qemuppc/conf-notes.txt ____
836Common targets are:
837 enea-image-standard
838 enea-image-standard-sdk
839</programlisting>
840<programlisting>_____ template.qemuppc/local.conf.sample ____
841MACHINE ?= "qemuppc"
842DISTRO ?= "enea"
843PACKAGE_CLASSES ?= "package_rpm"
844EXTRA_IMAGE_FEATURES = "debug-tweaks"
845USER_CLASSES ?= "buildstats image-mklibs image-prelink"
846PATCHRESOLVE = "noop"
847BB_DISKMON_DIRS = "\
848 STOPTASKS,${TMPDIR},1G,100K \
849 STOPTASKS,${DL_DIR},1G,100K \
850 STOPTASKS,${SSTATE_DIR},1G,100K \
851 STOPTASKS,/tmp,100M,100K \
852 ABORT,${TMPDIR},100M,1K \
853 ABORT,${DL_DIR},100M,1K \
854 ABORT,${SSTATE_DIR},100M,1K \
855 ABORT,/tmp,10M,1K"
856PACKAGECONFIG_append_pn-qemu-native = " sdl"
857PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
858CONF_VERSION = "1"
859</programlisting>
860 </para>
861 <para>Images</para>
862 <programlisting>
863enea-image-standard.bb
864enea-image-standard-sdk.bb
865</programlisting>
866 </section>
867</section>
diff --git a/doc/book-enea-linux-release-info/doc/targetscontain_template.xml b/doc/book-enea-linux-release-info/doc/targetscontain_template.xml
deleted file mode 100644
index b91350b..0000000
--- a/doc/book-enea-linux-release-info/doc/targetscontain_template.xml
+++ /dev/null
@@ -1,12 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="targetscontain">
5 <title>DEMO-Autogenerated chapter - Poky Components in this
6 Distribution</title>
7
8 <note>
9 <para>JUST A DEMO, Examples what could be autoextracted from poky if we
10 want to</para>
11 </note>
12</section> \ No newline at end of file
diff --git a/doc/docsrc_common/pardoc-distro.xml b/doc/docsrc_common/pardoc-distro.xml
index 2693c97..7772f1b 100644
--- a/doc/docsrc_common/pardoc-distro.xml
+++ b/doc/docsrc_common/pardoc-distro.xml
@@ -1,14 +1,6 @@
1<?xml version="1.0" encoding="ISO-8859-1"?> 1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ 3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<!-- Version and name entities
5==============================
6-->
7<!-- Distribution and release -->
8<!ENTITY ENEA_LINUX_REL_VER "MAJOR.MINOR"> <!-- TEMPLATE LINE, IS PATCHED by Makefile with values from enea.conf in poky/ -->
9<!ENTITY % common_poky_entities SYSTEM "../s_targets/qemuarm/poky/documentation/poky.ent">
10%common_poky_entities;
11]>
12 4
13<!-- Declarations to inherit by xi:include 5<!-- Declarations to inherit by xi:include
14========================================== --> 6========================================== -->
@@ -23,17 +15,9 @@
23 must be included, not just parts of them.</para> 15 must be included, not just parts of them.</para>
24 16
25 <para>**** The phrase elements below can be used as variables in several 17 <para>**** The phrase elements below can be used as variables in several
26 places in XML files ****</para> 18 places in XML files and/or in make script files ****</para>
27
28 <para>You can add more elements using ENTITY lines in poky.ent, e.g. like Poky_VER below</para>
29 19
30<!-- Distribution and release --> 20<!-- Distribution and release -->
31<para id="EneaLinux_REL_VER"><phrase>&ENEA_LINUX_REL_VER;</phrase></para>
32<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>
33<para id="Poky_VER"><phrase>&POKYVERSION;</phrase></para>
34<para id="Yocto_VER"><phrase>&DISTRO;</phrase></para>
35<para id="Yocto_NAME"><phrase>&DISTRO_NAME_NO_CAP;</phrase></para>
36<para id="ULINK_YOCTO_RELEASE_NOTES"><ulink url='&YOCTO_RELEASE_NOTES;'>&YOCTO_RELEASE_NOTES;</ulink></para>
37<para id="prev_baseline"><phrase>EL5</phrase></para> 21<para id="prev_baseline"><phrase>EL5</phrase></para>
38<para id="prev_lic_file"><phrase>doc/book-enea-linux-open-source/doc/licenses.xml</phrase></para> 22<para id="prev_lic_file"><phrase>doc/book-enea-linux-open-source/doc/licenses.xml</phrase></para>
39<para id="new_lic_file"><phrase>doc/book-enea-linux-open-source/doc/licenses.xml</phrase></para> 23<para id="new_lic_file"><phrase>doc/book-enea-linux-open-source/doc/licenses.xml</phrase></para>
diff --git a/doc/initbuildboot.sh b/doc/initbuildboot.sh
index ea8dc12..37b691f 100644
--- a/doc/initbuildboot.sh
+++ b/doc/initbuildboot.sh
@@ -1,14 +1,16 @@
1#!/bin/sh 1#!/bin/sh
2VER="R0.06" 2VER="R0.07"
3# R0.07/lejo 2017-01-20 Add -readmebasedir to the README files from the manifest instead of s_targets
3 4
4BBTEMPLATE= 5BBTEMPLATE=
5BBXML= 6BBXML=
7BB_TARGETREADME_BASE=
6 8
7USAGE="`basename $0` -xml buildbootxml-to-create -template templatexml-file ($VER) 9USAGE="`basename $0` -xml buildbootxml-to-create -template templatexml-file -readmebasedir targetreadmebase ($VER)
8 Currently only supports sequence types Build-command: and Boot-command: 10 Currently only supports sequence types Build-command: and Boot-command:
9 Both files should have path book-*release-info/doc/ 11 Both files should have path book-*release-info/doc/
10 Creates the XML file from the template, inserting build/boot commands 12 Creates the XML file from the template, inserting build/boot commands
11 from the various s_targets/XXXtargetXXX/README files 13 from the various s_manifests/el_manifest-XXX/XXXtargetXXX/README files
12 at the place in template with >SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE< 14 at the place in template with >SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE<
13 ignoring rest of template 15 ignoring rest of template
14 The code tries to fold too long lines, but this is not perfect. Best would 16 The code tries to fold too long lines, but this is not perfect. Best would
@@ -21,14 +23,16 @@ do
21 if [ "$OPT" = "--help" -o "$OPT" = "-h" -o "$OPT" = "-help" ] ; then echo "$USAGE" ; exit ; fi 23 if [ "$OPT" = "--help" -o "$OPT" = "-h" -o "$OPT" = "-help" ] ; then echo "$USAGE" ; exit ; fi
22 if [ "$OPT" = "-xml" ] ; then BBXML="$1" ; shift; fi 24 if [ "$OPT" = "-xml" ] ; then BBXML="$1" ; shift; fi
23 if [ "$OPT" = "-template" ] ; then BBTEMPLATE="$1" ; shift; fi 25 if [ "$OPT" = "-template" ] ; then BBTEMPLATE="$1" ; shift; fi
26 if [ "$OPT" = "-readmebasedir" ] ; then BB_TARGETREADME_BASE="$1" ; shift; fi
24done 27done
25if [ "$BBTEMPLATE" = "" ]; then echo "ERROR: Missing option -template templatefile"; exit ; fi 28if [ "$BBTEMPLATE" = "" ]; then echo "ERROR: Missing option -template templatefile"; exit ; fi
26if [ "$BBXML" = "" ]; then echo "ERROR: Missing option -xml buildbootxml-to-create"; exit ; fi 29if [ "$BBXML" = "" ]; then echo "ERROR: Missing option -xml buildbootxml-to-create"; exit ; fi
27if [ ! -f "$BBTEMPLATE" ]; then echo "ERROR: Missing templatefile '$BBTEMPLATE'"; exit; fi 30if [ ! -f "$BBTEMPLATE" ]; then echo "ERROR: Missing templatefile '$BBTEMPLATE'"; exit; fi
28if [ ! -d "`dirname \"$BBXML\"`" ]; then echo "ERROR: Missing parent directory for '$BBXML'"; exit ; fi 31if [ ! -d "`dirname \"$BBXML\"`" ]; then echo "ERROR: Missing parent directory for '$BBXML'"; exit ; fi
32if [ ! -d "$BB_TARGETREADME_BASE" ]; then echo "ERROR: Missing basedir for README files '$BB_TARGETREADME_BASE'"; exit; fi
29 33
30echo "`basename $0` Creating $BBXML from" 34echo "`basename $0` Creating $BBXML from"
31TARGETREADMES=`cd s_targets ; ls -d */README | tr '\n' ' '` 35TARGETREADMES=`cd $BB_TARGETREADME_BASE ; ls -d */README | tr '\n' ' '`
32echo " $TARGETREADMES" 36echo " $TARGETREADMES"
33 37
34# README file formats: 38# README file formats:
@@ -77,7 +81,7 @@ extractcmds_filter() {
77} 81}
78 82
79extractcmds_for_type() { # target/README BOOTorBUILD 83extractcmds_for_type() { # target/README BOOTorBUILD
80 README=s_targets/"$1" 84 README=$BB_TARGETREADME_BASE/"$1"
81 CMDTYPE="$2" 85 CMDTYPE="$2"
82 COMMANDSFOR=`egrep "___$CMDTYPE:" $README` 86 COMMANDSFOR=`egrep "___$CMDTYPE:" $README`
83 for CMDS in $COMMANDSFOR 87 for CMDS in $COMMANDSFOR
generated by cgit v1.2.3-54-g00ecf (git 2.39.0) at 2024-05-02 00:40:46 +0000