diff options
author | Lennart Johansson <lennart.johansson@enea.com> | 2016-06-02 13:41:04 +0200 |
---|---|---|
committer | Lennart Johansson <lennart.johansson@enea.com> | 2016-06-02 13:41:04 +0200 |
commit | 70919fc0a582f58aeac67863f5e0f5c232613f72 (patch) | |
tree | 6ca479c08be2d3449d361418f94dc83c83deb7d1 /doc/book-enea-linux-release-info | |
parent | 236463c519085d87a3096d6171f3e92d9b68db00 (diff) | |
download | el_manifests-standard-70919fc0a582f58aeac67863f5e0f5c232613f72.tar.gz |
Doc Add autovariables from manifest, poky.ent, enea.conf
Add autovariable from manifest repository name,
e.g. the profile name
Add autovariables from poky.ent, e.g. Yocto version etc..
in pardoc-distro
Add autovariables from enea.conf e.g. release MAJOR MINOR
via generated s_docsrc_common/pardoc-distro
and also pick up MAJOR MINOR into the
make system to create BOOK_VER => BL_LABEL on books
Add autocreate build_boot chapter in release info
from the README files in all included targets
Adapt book XML files to the above
Currently this makes the Makefile and init scripts identical
in different el6-<profile>.git
All are now automatic: Just clone el6-xxxx.git and
cd el6-xxx/doc ; make doc
and all are done until the books are built and ready.
It takes several minutes to autofetch all from git
using the repo command according to the target manifests
before the books start to build.
Rebuilding books are quick.
Signed-off-by: Lennart Johansson <lennart.johansson@enea.com>
Diffstat (limited to 'doc/book-enea-linux-release-info')
6 files changed, 44 insertions, 6 deletions
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 d60a10c..90bedaa 100644 --- a/doc/book-enea-linux-release-info/doc/about_release.xml +++ b/doc/book-enea-linux-release-info/doc/about_release.xml | |||
@@ -55,7 +55,7 @@ | |||
55 | </listitem> | 55 | </listitem> |
56 | 56 | ||
57 | <listitem> | 57 | <listitem> |
58 | <para>Freescale P2041DS, Power architecture, No DSPs, Quad-core QorIQ | 58 | <para>Freescale P2041RDB, Power architecture, No DSPs, Quad-core QorIQ |
59 | P2041 processor, e500mc cores.</para> | 59 | P2041 processor, e500mc cores.</para> |
60 | </listitem> | 60 | </listitem> |
61 | 61 | ||
@@ -137,7 +137,7 @@ | |||
137 | <para>Distribution channel:<itemizedlist spacing="compact"> | 137 | <para>Distribution channel:<itemizedlist spacing="compact"> |
138 | <listitem> | 138 | <listitem> |
139 | <para>All deliverables can be downloaded from <xi:include | 139 | <para>All deliverables can be downloaded from <xi:include |
140 | href="../../docsrc_common/pardoc-distro.xml" | 140 | href="../../s_docsrc_common/pardoc-distro.xml" |
141 | xmlns:xi="http://www.w3.org/2001/XInclude" | 141 | xmlns:xi="http://www.w3.org/2001/XInclude" |
142 | xpointer="element(ULINK_ENEA_LINUX_URL/1)" /> <remark>QUEST REMOVE???? | 142 | xpointer="element(ULINK_ENEA_LINUX_URL/1)" /> <remark>QUEST REMOVE???? |
143 | This is still in pardoc-distro.xml</remark></para> | 143 | This is still in pardoc-distro.xml</remark></para> |
@@ -195,7 +195,7 @@ | |||
195 | <entry>Packages provided by Yocto</entry> | 195 | <entry>Packages provided by Yocto</entry> |
196 | 196 | ||
197 | <entry><para>See the Yocto "Release Notes" <xi:include | 197 | <entry><para>See the Yocto "Release Notes" <xi:include |
198 | href="../../docsrc_common/pardoc-distro.xml" | 198 | href="../../s_docsrc_common/pardoc-distro.xml" |
199 | xmlns:xi="http://www.w3.org/2001/XInclude" | 199 | xmlns:xi="http://www.w3.org/2001/XInclude" |
200 | xpointer="element(ULINK_YOCTO_RELEASE_NOTES/1)" /></para></entry> | 200 | xpointer="element(ULINK_YOCTO_RELEASE_NOTES/1)" /></para></entry> |
201 | </row> | 201 | </row> |
diff --git a/doc/book-enea-linux-release-info/doc/book.xml b/doc/book-enea-linux-release-info/doc/book.xml index cc5788f..2be87b0 100644 --- a/doc/book-enea-linux-release-info/doc/book.xml +++ b/doc/book-enea-linux-release-info/doc/book.xml | |||
@@ -10,6 +10,7 @@ | |||
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" /> |
12 | <xi:include href="prerequisites.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | 12 | <xi:include href="prerequisites.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
13 | <xi:include href="build_boot_generated.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | ||
13 | <xi:include href="main_changes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | 14 | <xi:include href="main_changes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
14 | <xi:include href="known_bugs_and_limitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | 15 | <xi:include href="known_bugs_and_limitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
15 | <xi:include href="extracted_info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> | 16 | <xi:include href="extracted_info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
diff --git a/doc/book-enea-linux-release-info/doc/build_boot_template.xml b/doc/book-enea-linux-release-info/doc/build_boot_template.xml new file mode 100644 index 0000000..709e624 --- /dev/null +++ b/doc/book-enea-linux-release-info/doc/build_boot_template.xml | |||
@@ -0,0 +1,26 @@ | |||
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="target_build_boot"> | ||
5 | <title>Target Specific Build and Boot Instructions</title> | ||
6 | |||
7 | <para>For each target, a README file contains the build and boot | ||
8 | instructions. To make it easier for the reader, the contents of these | ||
9 | build/boot instruction have been extracted below into this release | ||
10 | information document.</para> | ||
11 | |||
12 | <para>The README files are parts of the distribution and can be seen after | ||
13 | the distribution is fetched.<remark>NOTE: Only EDIT THE TEMPLATE FILE! A new | ||
14 | build_boot.xml file is created from the template and sections are added | ||
15 | below automatically from the README files for each target when building the | ||
16 | book! Only in the template file you see a line below with SCRIPT_...._HERE | ||
17 | and the text telling that this is a template file.</remark></para> | ||
18 | |||
19 | <para>SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</para> | ||
20 | |||
21 | <para><emphasis role="bold">This is a template file which you can edit. When | ||
22 | the book is built, a new XML chapter file is created where the above part of | ||
23 | this file is copied to the new XML file and all from the line above is | ||
24 | replaced automatically by build and boot sections from the README | ||
25 | files!</emphasis></para> | ||
26 | </chapter> \ No newline at end of file | ||
diff --git a/doc/book-enea-linux-release-info/doc/supported_features.xml b/doc/book-enea-linux-release-info/doc/supported_features.xml index 11e49b1..ebc4b59 100644 --- a/doc/book-enea-linux-release-info/doc/supported_features.xml +++ b/doc/book-enea-linux-release-info/doc/supported_features.xml | |||
@@ -6,7 +6,7 @@ | |||
6 | 6 | ||
7 | <para>The basic features provided by Yocto are listed on the "Features" tab | 7 | <para>The basic features provided by Yocto are listed on the "Features" tab |
8 | on the <xi:include | 8 | on the <xi:include |
9 | href="../../docsrc_common/pardoc-distro.xml" | 9 | href="../../s_docsrc_common/pardoc-distro.xml" |
10 | xmlns:xi="http://www.w3.org/2001/XInclude" | 10 | xmlns:xi="http://www.w3.org/2001/XInclude" |
11 | xpointer="element(ULINK_YOCTO_RELEASE_NOTES/1)" /><remark>???? FIXME THIS WAS "ULINK_YOCTO_DOWN_MINOR_URL" in previous pardoc-distro file - I don't know what is shall be | 11 | xpointer="element(ULINK_YOCTO_RELEASE_NOTES/1)" /><remark>???? FIXME THIS WAS "ULINK_YOCTO_DOWN_MINOR_URL" in previous pardoc-distro file - I don't know what is shall be |
12 | now. Perhaps it is Yocto release notes which I have changed this to, as found in poky.ent</remark>.</para> | 12 | now. Perhaps it is Yocto release notes which I have changed this to, as found in poky.ent</remark>.</para> |
diff --git a/doc/book-enea-linux-release-info/doc/targetscontain.xml b/doc/book-enea-linux-release-info/doc/targetscontain.xml index 06ec23d..42522ae 100644 --- a/doc/book-enea-linux-release-info/doc/targetscontain.xml +++ b/doc/book-enea-linux-release-info/doc/targetscontain.xml | |||
@@ -2,7 +2,13 @@ | |||
2 | <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 2 | <!DOCTYPE section 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 | <section id="targetscontain"> | 4 | <section id="targetscontain"> |
5 | <title>Poky Components in this Distribution</title> | 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> | ||
6 | 12 | ||
7 | <section> | 13 | <section> |
8 | <title>Various Config Files extracted from ls1021atwr/poky</title> | 14 | <title>Various Config Files extracted from ls1021atwr/poky</title> |
diff --git a/doc/book-enea-linux-release-info/doc/targetscontain_template.xml b/doc/book-enea-linux-release-info/doc/targetscontain_template.xml index ea29af5..b91350b 100644 --- a/doc/book-enea-linux-release-info/doc/targetscontain_template.xml +++ b/doc/book-enea-linux-release-info/doc/targetscontain_template.xml | |||
@@ -2,6 +2,11 @@ | |||
2 | <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 2 | <!DOCTYPE section 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 | <section id="targetscontain"> | 4 | <section id="targetscontain"> |
5 | <title>Poky Components in this Distribution</title> | 5 | <title>DEMO-Autogenerated chapter - Poky Components in this |
6 | Distribution</title> | ||
6 | 7 | ||
8 | <note> | ||
9 | <para>JUST A DEMO, Examples what could be autoextracted from poky if we | ||
10 | want to</para> | ||
11 | </note> | ||
7 | </section> \ No newline at end of file | 12 | </section> \ No newline at end of file |