diff options
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 |
2 | SUBSYSROOT := $(shell pwd) | 4 | SUBSYSROOT := $(shell pwd) |
3 | 5 | ||
@@ -7,21 +9,13 @@ include manifest_conf.mk | |||
7 | MANIFESTDIR := $(shell echo "$(MANIFESTURL)" | sed 's/.*\///;s/\.git//') | 9 | MANIFESTDIR := $(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 |
15 | include init.mk | 17 | include init.mk |
16 | 18 | ||
17 | # ****************** SUPPORT FOR TARGETS *************************** | ||
18 | PATH_TARGETS = $(SUBSYSROOT)/s_targets | ||
19 | #Git repositories to be cloned | ||
20 | NAME_TARGETS := targets | ||
21 | #Path to the directory under which repos shall be cloned. | ||
22 | DOCBASEDIR=$(shell pwd) | ||
23 | REPODIR=$(DOCBASEDIR)/.. | ||
24 | TMPCLONEROOT_TARGETS := $(TMPCLONEROOT)/$(NAME_TARGETS) | ||
25 | TMPCLONEROOT_MANIFEST := $(TMPCLONEROOT)/manifest | 19 | TMPCLONEROOT_MANIFEST := $(TMPCLONEROOT)/manifest |
26 | 20 | ||
27 | 21 | ||
@@ -32,7 +26,11 @@ BUILDBOOT_TEMPLATE := book-enea-linux-release-info/doc/build_boot_template.xml | |||
32 | PKGDIFF_GEN_XML := book-enea-linux-release-info/doc/pkgdiff_generated.xml | 26 | PKGDIFF_GEN_XML := book-enea-linux-release-info/doc/pkgdiff_generated.xml |
33 | JIRA_ISSUES_GEN_XML := book-enea-linux-release-info/doc/jiraissues_generated.xml | 27 | JIRA_ISSUES_GEN_XML := book-enea-linux-release-info/doc/jiraissues_generated.xml |
34 | 28 | ||
35 | MANIFESTFILES_XML := book-enea-linux-release-info/doc/manifestfiles_generated.xml | 29 | MACHINE_LIST_XML := book-enea-linux-release-info/doc/machine_list_generated.xml |
30 | |||
31 | ELTF_PARAMS_TEMPLATE := book-enea-linux-release-info/doc/eltf_params_template.xml | ||
32 | ELTF_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 |
74 | export | 72 | export |
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 | ||
79 | docusage: | 77 | docusage: |
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) | |||
143 | endif | 140 | endif |
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 |
146 | init: initbuild initmanifest inittargets initpardoc initbuildboot initpkgdiff initissues | 143 | init: initbuild initmanifest initpardoc initbuildboot initpkgdiff initissues |
147 | pullall: pullbuild | 144 | pullall: 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 | ||
185 | books: init | 182 | books: 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 *************************** |
218 | initmanifest: s_manifest | 214 | initmanifest: s_manifest |
219 | inittargets: 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 | ||
231 | cleanmanifest: | 226 | cleanmanifest: |
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 | |||
257 | s_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 | |||
294 | s_docsrc_common: $(TMPCLONEROOT_DOCSRC_COMMON) | 265 | s_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 | ||
321 | initbuildboot: $(BUILDBOOT_XML) | 277 | initbuildboot: $(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 | ||
358 | initissues: $(JIRA_ISSUES_GEN_XML) | 314 | initissues: $(JIRA_ISSUES_GEN_XML) |
359 | 315 | ||
316 | |||
360 | cleanissues: | 317 | cleanissues: |
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 | ||
329 | eltf: | ||
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 & < > 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 & 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 | <row>, 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 | ||
26 | sudo apt-get -y update | ||
27 | sudo 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 | ||
37 | curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo | ||
38 | chmod a+x ~/bin/repo | ||
39 | export 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 | ||
62 | cd enea-linux | ||
63 | repo init -u git://git.enea.com/linux/el_manifests-standard.git \ | ||
64 | -b refs/tags/EL6 -m $MACHINE/default.xml | ||
65 | repo 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 @@ | |||
1 | eltf_params_template_updated_howto_use.txt | ||
2 | |||
3 | This is a way to collect all parameters for an Enea Linux release | ||
4 | in one parameter file, easy to automatically update by ELTF regularly. | ||
5 | |||
6 | NOTE: 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 | |||
9 | NOTE: 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 | |||
17 | The ordinary book XML files use xi:include statements to include elements | ||
18 | from this parameter file. The book XML files can thus be manually edited. | ||
19 | Before editing, you must run "make init". | ||
20 | Any other text in the template or updated.xml file, outside the parts that | ||
21 | are included in the book, are not used but still all must be correct | ||
22 | DocBook XML files. | ||
23 | |||
24 | ELTF work: | ||
25 | template => ELTF replaces ALL ELTF_xxx variables => updated XML file | ||
26 | => push to git only if changed | ||
27 | |||
28 | |||
29 | eltf_params_template.xml (in git) | ||
30 | File used by ELTF to autocreate/update the real parameter | ||
31 | file eltf_params_updated.xml. | ||
32 | |||
33 | eltf_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 | |||
39 | xi: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 | |||
48 | DocBook XML: All XML files must be correct DocBook XML files. | ||
49 | |||
50 | Do 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 | |||
54 | ELTF should autocreate a temporary "real" file but only replace | ||
55 | and push the eltf_params_updated.xml if it is changed. | ||
56 | |||
57 | |||
58 | make eltf | ||
59 | This lists all ELTF_xxx variables and some rules how to treat them | ||
60 | |||
61 | DocBook 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 < > and & | ||
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 | |||
71 | DocBook 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 | |||
81 | DocBook 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 | |||
85 | Each 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 | |||
98 | Tables 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 | |||
102 | Special - 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 | |||
112 | BELOW WE TRY TO EXPLAIN EACH ELTF_* variable, but always check with make eltf | ||
113 | if there are more new variables, missing in this description file. | ||
114 | |||
115 | _____________________________________________________________________________ | ||
116 | ELTF_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 | ||
125 | sudo apt-get update | ||
126 | sudo 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 | _____________________________________________________________________________ | ||
133 | ELTF_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: | ||
137 | mkdir -p ~/bin | ||
138 | curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo | ||
139 | chmod a+x ~/bin/repo | ||
140 | export PATH=~/bin:$PATH | ||
141 | |||
142 | _____________________________________________________________________________ | ||
143 | ELTF_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: | ||
150 | 6 | ||
151 | or | ||
152 | 6.1 | ||
153 | |||
154 | _____________________________________________________________________________ | ||
155 | ELTF_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: | ||
160 | 2.1 | ||
161 | |||
162 | _____________________________________________________________________________ | ||
163 | ELTF_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: | ||
168 | krogoth | ||
169 | |||
170 | _____________________________________________________________________________ | ||
171 | ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL | ||
172 | ELTF_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: | ||
177 | http://www.yoctoproject.org/downloads/core/krogoth/21 | ||
178 | |||
179 | _____________________________________________________________________________ | ||
180 | ELTF_EL_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL strings | ||
181 | ELTF_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: | ||
187 | http://linux.enea.com/6 | ||
188 | |||
189 | _____________________________________________________________________________ | ||
190 | ELTF_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: | ||
197 | mkdir enea-linux | ||
198 | cd enea-linux | ||
199 | repo init -u git://git.enea.com/linux/el_manifests-standard.git \ | ||
200 | -b refs/tags/EL6 -m $MACHINE/default.xml | ||
201 | repo sync | ||
202 | |||
203 | _____________________________________________________________________________ | ||
204 | ELTF_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. | ||
214 | 4.5 (Mars) | ||
215 | |||
216 | |||
217 | _____________________________________________________________________________ | ||
218 | ELTF_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 | _____________________________________________________________________________ | ||
226 | ELTF_T_MANIFEST_DIR This happens to be in two places. Must be exactly | ||
227 | ELTF_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: | ||
232 | p2041rgb | ||
233 | or | ||
234 | ls1021aiot | ||
235 | or | ||
236 | qemuarm | ||
237 | |||
238 | _____________________________________________________________________________ | ||
239 | ELTF_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: | ||
243 | P2041RGB | ||
244 | or | ||
245 | LS1021a-IoT | ||
246 | or | ||
247 | qemuarm | ||
248 | |||
249 | _____________________________________________________________________________ | ||
250 | ELTF_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: | ||
255 | Power, e500mc | ||
256 | or | ||
257 | ARM Cortex-A7 | ||
258 | |||
259 | _____________________________________________________________________________ | ||
260 | ELTF_T_DS_TXTURL Target specific: "Link to target datasheet. These | ||
261 | ELTF_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: | ||
268 | url="http://wiki.qemu.org">http://wiki.qemu.org | ||
269 | or | ||
270 | url="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 | _____________________________________________________________________________ | ||
273 | ELTF_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: | ||
279 | 15.0.0 | ||
280 | or | ||
281 | Git commit id: 75ca53211488a3e268037a44ee2a7ac5c7181bd2 | ||
282 | |||
283 | _____________________________________________________________________________ | ||
284 | ELTF_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: | ||
290 | 5.3 | ||
291 | |||
292 | _____________________________________________________________________________ | ||
293 | ELTF_T_KERN_VER Target specific: "Linux Kernel Version". Often | ||
294 | different per target. | ||
295 | In book: An <entry> in a row | ||
296 | Example: | ||
297 | 3.12 | ||
298 | |||
299 | _____________________________________________________________________________ | ||
300 | ELTF_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: | ||
306 | Ethernet, I2C, SPI, PCI, USB, SD/SDHC/SDXC | ||
307 | |||
308 | |||
309 | _____________________________________________________________________________ | ||
310 | ELTF_T_EL_RPM_TXTURL Target specific: "Enea rpm folder for downloading | ||
311 | ELTF_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: | ||
318 | url="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 > ~/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 <manifest file> | ||
60 | $ repo sync</programlisting> | ||
61 | 56 | ||
62 | <para>The parameter <manifest file> 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> | ||
17 | bitbake/ | ||
18 | documentation/ | ||
19 | LICENSE | ||
20 | meta/ | ||
21 | meta-el-common/ | ||
22 | meta-el-standard/ | ||
23 | meta-enea-base-arm/ | ||
24 | meta-enea-bsp-arm/ | ||
25 | meta-enea-bsp-common/ | ||
26 | meta-fsl-arm/ | ||
27 | meta-openembedded/ | ||
28 | meta-poky/ | ||
29 | meta-selftest/ | ||
30 | meta-skeleton/ | ||
31 | meta-yocto/ | ||
32 | meta-yocto-bsp/ | ||
33 | oe-init-build-env* | ||
34 | oe-init-build-env-memres* | ||
35 | README | ||
36 | README.hardware | ||
37 | scripts/ | ||
38 | </programlisting> | ||
39 | <para>Main version information in enea.conf is</para> | ||
40 | <programlisting> | ||
41 | DISTRO_VERSION_MAJOR = "6.0" | ||
42 | DISTRO_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 ____ | ||
48 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
49 | BBPATH = "${TOPDIR}" | ||
50 | BBFILES ?= "" | ||
51 | BBLAYERS ?= " \ | ||
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 ____ | ||
66 | Common targets are: | ||
67 | enea-image-standard | ||
68 | enea-image-standard-sdk | ||
69 | </programlisting> | ||
70 | <programlisting>_____ template.p2041rdb/local.conf.sample ____ | ||
71 | MACHINE ?= "p2041rdb" | ||
72 | DISTRO ?= "enea" | ||
73 | PACKAGE_CLASSES ?= "package_rpm" | ||
74 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
75 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
76 | PATCHRESOLVE = "noop" | ||
77 | BB_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" | ||
86 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
87 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
88 | CONF_VERSION = "1" | ||
89 | </programlisting> | ||
90 | </para> | ||
91 | <para>Configuration files in template.qemuarm</para> | ||
92 | <para> | ||
93 | <programlisting>_____ template.qemuarm/bblayers.conf.sample ____ | ||
94 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
95 | BBPATH = "${TOPDIR}" | ||
96 | BBFILES ?= "" | ||
97 | BBLAYERS ?= " \ | ||
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 ____ | ||
110 | Common targets are: | ||
111 | enea-image-standard | ||
112 | enea-image-standard-sdk | ||
113 | </programlisting> | ||
114 | <programlisting>_____ template.qemuarm/local.conf.sample ____ | ||
115 | MACHINE ?= "qemuarm" | ||
116 | DISTRO ?= "enea" | ||
117 | PACKAGE_CLASSES ?= "package_rpm" | ||
118 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
119 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
120 | PATCHRESOLVE = "noop" | ||
121 | BB_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" | ||
130 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
131 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
132 | CONF_VERSION = "1" | ||
133 | </programlisting> | ||
134 | </para> | ||
135 | <para>Configuration files in template.qemuppc</para> | ||
136 | <para> | ||
137 | <programlisting>_____ template.qemuppc/bblayers.conf.sample ____ | ||
138 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
139 | BBPATH = "${TOPDIR}" | ||
140 | BBFILES ?= "" | ||
141 | BBLAYERS ?= " \ | ||
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 ____ | ||
154 | Common targets are: | ||
155 | enea-image-standard | ||
156 | enea-image-standard-sdk | ||
157 | </programlisting> | ||
158 | <programlisting>_____ template.qemuppc/local.conf.sample ____ | ||
159 | MACHINE ?= "qemuppc" | ||
160 | DISTRO ?= "enea" | ||
161 | PACKAGE_CLASSES ?= "package_rpm" | ||
162 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
163 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
164 | PATCHRESOLVE = "noop" | ||
165 | BB_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" | ||
174 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
175 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
176 | CONF_VERSION = "1" | ||
177 | </programlisting> | ||
178 | </para> | ||
179 | <para>Images</para> | ||
180 | <programlisting> | ||
181 | enea-image-standard.bb | ||
182 | enea-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> | ||
189 | bitbake/ | ||
190 | documentation/ | ||
191 | LICENSE | ||
192 | meta/ | ||
193 | meta-el-common/ | ||
194 | meta-el-standard/ | ||
195 | meta-enea-base-ppc/ | ||
196 | meta-enea-bsp-common/ | ||
197 | meta-enea-bsp-ppc/ | ||
198 | meta-fsl-ppc/ | ||
199 | meta-openembedded/ | ||
200 | meta-poky/ | ||
201 | meta-selftest/ | ||
202 | meta-skeleton/ | ||
203 | meta-yocto/ | ||
204 | meta-yocto-bsp/ | ||
205 | oe-init-build-env* | ||
206 | oe-init-build-env-memres* | ||
207 | README | ||
208 | README.hardware | ||
209 | scripts/ | ||
210 | </programlisting> | ||
211 | <para>Main version information in enea.conf is</para> | ||
212 | <programlisting> | ||
213 | DISTRO_VERSION_MAJOR = "6.0" | ||
214 | DISTRO_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 ____ | ||
220 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
221 | BBPATH = "${TOPDIR}" | ||
222 | BBFILES ?= "" | ||
223 | BBLAYERS ?= " \ | ||
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 ____ | ||
238 | Common targets are: | ||
239 | enea-image-standard | ||
240 | enea-image-standard-sdk | ||
241 | </programlisting> | ||
242 | <programlisting>_____ template.p2041rdb/local.conf.sample ____ | ||
243 | MACHINE ?= "p2041rdb" | ||
244 | DISTRO ?= "enea" | ||
245 | PACKAGE_CLASSES ?= "package_rpm" | ||
246 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
247 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
248 | PATCHRESOLVE = "noop" | ||
249 | BB_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" | ||
258 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
259 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
260 | CONF_VERSION = "1" | ||
261 | </programlisting> | ||
262 | </para> | ||
263 | <para>Configuration files in template.qemuarm</para> | ||
264 | <para> | ||
265 | <programlisting>_____ template.qemuarm/bblayers.conf.sample ____ | ||
266 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
267 | BBPATH = "${TOPDIR}" | ||
268 | BBFILES ?= "" | ||
269 | BBLAYERS ?= " \ | ||
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 ____ | ||
282 | Common targets are: | ||
283 | enea-image-standard | ||
284 | enea-image-standard-sdk | ||
285 | </programlisting> | ||
286 | <programlisting>_____ template.qemuarm/local.conf.sample ____ | ||
287 | MACHINE ?= "qemuarm" | ||
288 | DISTRO ?= "enea" | ||
289 | PACKAGE_CLASSES ?= "package_rpm" | ||
290 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
291 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
292 | PATCHRESOLVE = "noop" | ||
293 | BB_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" | ||
302 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
303 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
304 | CONF_VERSION = "1" | ||
305 | </programlisting> | ||
306 | </para> | ||
307 | <para>Configuration files in template.qemuppc</para> | ||
308 | <para> | ||
309 | <programlisting>_____ template.qemuppc/bblayers.conf.sample ____ | ||
310 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
311 | BBPATH = "${TOPDIR}" | ||
312 | BBFILES ?= "" | ||
313 | BBLAYERS ?= " \ | ||
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 ____ | ||
326 | Common targets are: | ||
327 | enea-image-standard | ||
328 | enea-image-standard-sdk | ||
329 | </programlisting> | ||
330 | <programlisting>_____ template.qemuppc/local.conf.sample ____ | ||
331 | MACHINE ?= "qemuppc" | ||
332 | DISTRO ?= "enea" | ||
333 | PACKAGE_CLASSES ?= "package_rpm" | ||
334 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
335 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
336 | PATCHRESOLVE = "noop" | ||
337 | BB_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" | ||
346 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
347 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
348 | CONF_VERSION = "1" | ||
349 | </programlisting> | ||
350 | </para> | ||
351 | <para>Images</para> | ||
352 | <programlisting> | ||
353 | enea-image-standard.bb | ||
354 | enea-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> | ||
361 | bitbake/ | ||
362 | documentation/ | ||
363 | LICENSE | ||
364 | meta/ | ||
365 | meta-el-common/ | ||
366 | meta-el-standard/ | ||
367 | meta-enea-base-arm/ | ||
368 | meta-enea-bsp-common/ | ||
369 | meta-openembedded/ | ||
370 | meta-poky/ | ||
371 | meta-selftest/ | ||
372 | meta-skeleton/ | ||
373 | meta-yocto/ | ||
374 | meta-yocto-bsp/ | ||
375 | oe-init-build-env* | ||
376 | oe-init-build-env-memres* | ||
377 | README | ||
378 | README.hardware | ||
379 | scripts/ | ||
380 | </programlisting> | ||
381 | <para>Main version information in enea.conf is</para> | ||
382 | <programlisting> | ||
383 | DISTRO_VERSION_MAJOR = "6.0" | ||
384 | DISTRO_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 ____ | ||
390 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
391 | BBPATH = "${TOPDIR}" | ||
392 | BBFILES ?= "" | ||
393 | BBLAYERS ?= " \ | ||
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 ____ | ||
408 | Common targets are: | ||
409 | enea-image-standard | ||
410 | enea-image-standard-sdk | ||
411 | </programlisting> | ||
412 | <programlisting>_____ template.p2041rdb/local.conf.sample ____ | ||
413 | MACHINE ?= "p2041rdb" | ||
414 | DISTRO ?= "enea" | ||
415 | PACKAGE_CLASSES ?= "package_rpm" | ||
416 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
417 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
418 | PATCHRESOLVE = "noop" | ||
419 | BB_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" | ||
428 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
429 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
430 | CONF_VERSION = "1" | ||
431 | </programlisting> | ||
432 | </para> | ||
433 | <para>Configuration files in template.qemuarm</para> | ||
434 | <para> | ||
435 | <programlisting>_____ template.qemuarm/bblayers.conf.sample ____ | ||
436 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
437 | BBPATH = "${TOPDIR}" | ||
438 | BBFILES ?= "" | ||
439 | BBLAYERS ?= " \ | ||
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 ____ | ||
452 | Common targets are: | ||
453 | enea-image-standard | ||
454 | enea-image-standard-sdk | ||
455 | </programlisting> | ||
456 | <programlisting>_____ template.qemuarm/local.conf.sample ____ | ||
457 | MACHINE ?= "qemuarm" | ||
458 | DISTRO ?= "enea" | ||
459 | PACKAGE_CLASSES ?= "package_rpm" | ||
460 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
461 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
462 | PATCHRESOLVE = "noop" | ||
463 | BB_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" | ||
472 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
473 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
474 | CONF_VERSION = "1" | ||
475 | </programlisting> | ||
476 | </para> | ||
477 | <para>Configuration files in template.qemuppc</para> | ||
478 | <para> | ||
479 | <programlisting>_____ template.qemuppc/bblayers.conf.sample ____ | ||
480 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
481 | BBPATH = "${TOPDIR}" | ||
482 | BBFILES ?= "" | ||
483 | BBLAYERS ?= " \ | ||
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 ____ | ||
496 | Common targets are: | ||
497 | enea-image-standard | ||
498 | enea-image-standard-sdk | ||
499 | </programlisting> | ||
500 | <programlisting>_____ template.qemuppc/local.conf.sample ____ | ||
501 | MACHINE ?= "qemuppc" | ||
502 | DISTRO ?= "enea" | ||
503 | PACKAGE_CLASSES ?= "package_rpm" | ||
504 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
505 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
506 | PATCHRESOLVE = "noop" | ||
507 | BB_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" | ||
516 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
517 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
518 | CONF_VERSION = "1" | ||
519 | </programlisting> | ||
520 | </para> | ||
521 | <para>Images</para> | ||
522 | <programlisting> | ||
523 | enea-image-standard.bb | ||
524 | enea-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> | ||
531 | bitbake/ | ||
532 | documentation/ | ||
533 | LICENSE | ||
534 | meta/ | ||
535 | meta-el-common/ | ||
536 | meta-el-standard/ | ||
537 | meta-enea-base-ppc/ | ||
538 | meta-enea-bsp-common/ | ||
539 | meta-openembedded/ | ||
540 | meta-poky/ | ||
541 | meta-selftest/ | ||
542 | meta-skeleton/ | ||
543 | meta-yocto/ | ||
544 | meta-yocto-bsp/ | ||
545 | oe-init-build-env* | ||
546 | oe-init-build-env-memres* | ||
547 | README | ||
548 | README.hardware | ||
549 | scripts/ | ||
550 | </programlisting> | ||
551 | <para>Main version information in enea.conf is</para> | ||
552 | <programlisting> | ||
553 | DISTRO_VERSION_MAJOR = "6.0" | ||
554 | DISTRO_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 ____ | ||
560 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
561 | BBPATH = "${TOPDIR}" | ||
562 | BBFILES ?= "" | ||
563 | BBLAYERS ?= " \ | ||
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 ____ | ||
578 | Common targets are: | ||
579 | enea-image-standard | ||
580 | enea-image-standard-sdk | ||
581 | </programlisting> | ||
582 | <programlisting>_____ template.p2041rdb/local.conf.sample ____ | ||
583 | MACHINE ?= "p2041rdb" | ||
584 | DISTRO ?= "enea" | ||
585 | PACKAGE_CLASSES ?= "package_rpm" | ||
586 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
587 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
588 | PATCHRESOLVE = "noop" | ||
589 | BB_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" | ||
598 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
599 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
600 | CONF_VERSION = "1" | ||
601 | </programlisting> | ||
602 | </para> | ||
603 | <para>Configuration files in template.qemuarm</para> | ||
604 | <para> | ||
605 | <programlisting>_____ template.qemuarm/bblayers.conf.sample ____ | ||
606 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
607 | BBPATH = "${TOPDIR}" | ||
608 | BBFILES ?= "" | ||
609 | BBLAYERS ?= " \ | ||
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 ____ | ||
622 | Common targets are: | ||
623 | enea-image-standard | ||
624 | enea-image-standard-sdk | ||
625 | </programlisting> | ||
626 | <programlisting>_____ template.qemuarm/local.conf.sample ____ | ||
627 | MACHINE ?= "qemuarm" | ||
628 | DISTRO ?= "enea" | ||
629 | PACKAGE_CLASSES ?= "package_rpm" | ||
630 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
631 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
632 | PATCHRESOLVE = "noop" | ||
633 | BB_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" | ||
642 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
643 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
644 | CONF_VERSION = "1" | ||
645 | </programlisting> | ||
646 | </para> | ||
647 | <para>Configuration files in template.qemuppc</para> | ||
648 | <para> | ||
649 | <programlisting>_____ template.qemuppc/bblayers.conf.sample ____ | ||
650 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
651 | BBPATH = "${TOPDIR}" | ||
652 | BBFILES ?= "" | ||
653 | BBLAYERS ?= " \ | ||
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 ____ | ||
666 | Common targets are: | ||
667 | enea-image-standard | ||
668 | enea-image-standard-sdk | ||
669 | </programlisting> | ||
670 | <programlisting>_____ template.qemuppc/local.conf.sample ____ | ||
671 | MACHINE ?= "qemuppc" | ||
672 | DISTRO ?= "enea" | ||
673 | PACKAGE_CLASSES ?= "package_rpm" | ||
674 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
675 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
676 | PATCHRESOLVE = "noop" | ||
677 | BB_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" | ||
686 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
687 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
688 | CONF_VERSION = "1" | ||
689 | </programlisting> | ||
690 | </para> | ||
691 | <para>Images</para> | ||
692 | <programlisting> | ||
693 | enea-image-standard.bb | ||
694 | enea-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> | ||
701 | bitbake/ | ||
702 | documentation/ | ||
703 | LICENSE | ||
704 | meta/ | ||
705 | meta-el-common/ | ||
706 | meta-el-standard/ | ||
707 | meta-enea-base-x86/ | ||
708 | meta-enea-bsp-common/ | ||
709 | meta-openembedded/ | ||
710 | meta-poky/ | ||
711 | meta-selftest/ | ||
712 | meta-skeleton/ | ||
713 | meta-yocto/ | ||
714 | meta-yocto-bsp/ | ||
715 | oe-init-build-env* | ||
716 | oe-init-build-env-memres* | ||
717 | README | ||
718 | README.hardware | ||
719 | scripts/ | ||
720 | </programlisting> | ||
721 | <para>Main version information in enea.conf is</para> | ||
722 | <programlisting> | ||
723 | DISTRO_VERSION_MAJOR = "6.0" | ||
724 | DISTRO_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 ____ | ||
730 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
731 | BBPATH = "${TOPDIR}" | ||
732 | BBFILES ?= "" | ||
733 | BBLAYERS ?= " \ | ||
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 ____ | ||
748 | Common targets are: | ||
749 | enea-image-standard | ||
750 | enea-image-standard-sdk | ||
751 | </programlisting> | ||
752 | <programlisting>_____ template.p2041rdb/local.conf.sample ____ | ||
753 | MACHINE ?= "p2041rdb" | ||
754 | DISTRO ?= "enea" | ||
755 | PACKAGE_CLASSES ?= "package_rpm" | ||
756 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
757 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
758 | PATCHRESOLVE = "noop" | ||
759 | BB_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" | ||
768 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
769 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
770 | CONF_VERSION = "1" | ||
771 | </programlisting> | ||
772 | </para> | ||
773 | <para>Configuration files in template.qemuarm</para> | ||
774 | <para> | ||
775 | <programlisting>_____ template.qemuarm/bblayers.conf.sample ____ | ||
776 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
777 | BBPATH = "${TOPDIR}" | ||
778 | BBFILES ?= "" | ||
779 | BBLAYERS ?= " \ | ||
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 ____ | ||
792 | Common targets are: | ||
793 | enea-image-standard | ||
794 | enea-image-standard-sdk | ||
795 | </programlisting> | ||
796 | <programlisting>_____ template.qemuarm/local.conf.sample ____ | ||
797 | MACHINE ?= "qemuarm" | ||
798 | DISTRO ?= "enea" | ||
799 | PACKAGE_CLASSES ?= "package_rpm" | ||
800 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
801 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
802 | PATCHRESOLVE = "noop" | ||
803 | BB_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" | ||
812 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
813 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
814 | CONF_VERSION = "1" | ||
815 | </programlisting> | ||
816 | </para> | ||
817 | <para>Configuration files in template.qemuppc</para> | ||
818 | <para> | ||
819 | <programlisting>_____ template.qemuppc/bblayers.conf.sample ____ | ||
820 | POKY_BBLAYERS_CONF_VERSION = "1" | ||
821 | BBPATH = "${TOPDIR}" | ||
822 | BBFILES ?= "" | ||
823 | BBLAYERS ?= " \ | ||
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 ____ | ||
836 | Common targets are: | ||
837 | enea-image-standard | ||
838 | enea-image-standard-sdk | ||
839 | </programlisting> | ||
840 | <programlisting>_____ template.qemuppc/local.conf.sample ____ | ||
841 | MACHINE ?= "qemuppc" | ||
842 | DISTRO ?= "enea" | ||
843 | PACKAGE_CLASSES ?= "package_rpm" | ||
844 | EXTRA_IMAGE_FEATURES = "debug-tweaks" | ||
845 | USER_CLASSES ?= "buildstats image-mklibs image-prelink" | ||
846 | PATCHRESOLVE = "noop" | ||
847 | BB_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" | ||
856 | PACKAGECONFIG_append_pn-qemu-native = " sdl" | ||
857 | PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl" | ||
858 | CONF_VERSION = "1" | ||
859 | </programlisting> | ||
860 | </para> | ||
861 | <para>Images</para> | ||
862 | <programlisting> | ||
863 | enea-image-standard.bb | ||
864 | enea-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 |
2 | VER="R0.06" | 2 | VER="R0.07" |
3 | # R0.07/lejo 2017-01-20 Add -readmebasedir to the README files from the manifest instead of s_targets | ||
3 | 4 | ||
4 | BBTEMPLATE= | 5 | BBTEMPLATE= |
5 | BBXML= | 6 | BBXML= |
7 | BB_TARGETREADME_BASE= | ||
6 | 8 | ||
7 | USAGE="`basename $0` -xml buildbootxml-to-create -template templatexml-file ($VER) | 9 | USAGE="`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 | ||
24 | done | 27 | done |
25 | if [ "$BBTEMPLATE" = "" ]; then echo "ERROR: Missing option -template templatefile"; exit ; fi | 28 | if [ "$BBTEMPLATE" = "" ]; then echo "ERROR: Missing option -template templatefile"; exit ; fi |
26 | if [ "$BBXML" = "" ]; then echo "ERROR: Missing option -xml buildbootxml-to-create"; exit ; fi | 29 | if [ "$BBXML" = "" ]; then echo "ERROR: Missing option -xml buildbootxml-to-create"; exit ; fi |
27 | if [ ! -f "$BBTEMPLATE" ]; then echo "ERROR: Missing templatefile '$BBTEMPLATE'"; exit; fi | 30 | if [ ! -f "$BBTEMPLATE" ]; then echo "ERROR: Missing templatefile '$BBTEMPLATE'"; exit; fi |
28 | if [ ! -d "`dirname \"$BBXML\"`" ]; then echo "ERROR: Missing parent directory for '$BBXML'"; exit ; fi | 31 | if [ ! -d "`dirname \"$BBXML\"`" ]; then echo "ERROR: Missing parent directory for '$BBXML'"; exit ; fi |
32 | if [ ! -d "$BB_TARGETREADME_BASE" ]; then echo "ERROR: Missing basedir for README files '$BB_TARGETREADME_BASE'"; exit; fi | ||
29 | 33 | ||
30 | echo "`basename $0` Creating $BBXML from" | 34 | echo "`basename $0` Creating $BBXML from" |
31 | TARGETREADMES=`cd s_targets ; ls -d */README | tr '\n' ' '` | 35 | TARGETREADMES=`cd $BB_TARGETREADME_BASE ; ls -d */README | tr '\n' ' '` |
32 | echo " $TARGETREADMES" | 36 | echo " $TARGETREADMES" |
33 | 37 | ||
34 | # README file formats: | 38 | # README file formats: |
@@ -77,7 +81,7 @@ extractcmds_filter() { | |||
77 | } | 81 | } |
78 | 82 | ||
79 | extractcmds_for_type() { # target/README BOOTorBUILD | 83 | extractcmds_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 |