From 8decb3267be14596c377155d6bc84a0eb61f04e9 Mon Sep 17 00:00:00 2001 From: Lennart Johansson Date: Thu, 2 Jun 2016 13:41:16 +0200 Subject: 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-.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 --- .../doc/about_release.xml | 122 +++++++++++---------- doc/book-enea-linux-release-info/doc/book.xml | 4 +- .../doc/build_boot_template.xml | 26 +++++ .../doc/main_changes.xml | 8 +- .../doc/prerequisites.xml | 75 +++++++++++++ .../doc/supported_features.xml | 2 +- 6 files changed, 174 insertions(+), 63 deletions(-) create mode 100644 doc/book-enea-linux-release-info/doc/build_boot_template.xml create mode 100644 doc/book-enea-linux-release-info/doc/prerequisites.xml (limited to 'doc/book-enea-linux-release-info') 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 3cdea52..017f7b2 100644 --- a/doc/book-enea-linux-release-info/doc/about_release.xml +++ b/doc/book-enea-linux-release-info/doc/about_release.xml @@ -4,15 +4,16 @@ About This Release - This release of Enea Linux 6 provides a publicly available Enea Linux - distribution for a selected set of targets. This release is generated from - branch dizzy-eneaEneaLinux_BRANCH FIXME Is this correct branch, try - to ONLY HAVE THIS INFO in one place, here of applicable git - repositories.MAYBE WE COULD EXTRACT Enea Linux major and minor - version from meta-el-common/conf/distro/enea.conf ? This would be via shell - code in Makefile, the names clashes with those used in poky.ent. Suggest - using the docbuild feature BOOK_PARAM_n (n=1-5) to define parameters in - Makefile that can be used in XML files + This release of Enea Linux provides a publicly available + Enea Linux distribution for a selected set of targets. This release is + generated from the yocto distribution .INFO Yocto distro autopicked + from poky.ent as DISTRO_NAME_NO_CAP Provided contents: @@ -36,47 +37,38 @@ - Eclipse executable plus application development tools (ADT) for - command line and Eclipse + Eclipse executable plus development tools for command line and + Eclipse - + Supported targets: - Supported targets: - - Freescale P2041RDB FIXME Why are these listed three - times? - + FIXME should autocreate a list of targets, hopefully from the + generated README file, by using MAKEFILE to update pardoc-distro AND/OR also + auto-create an XML file to includ here with description text for each target + etc.. + - Freescale P3041DS FIXME Why are these listed three - times? + Freescale P2041RDB, Power architecture, No DSPs, Quad-core QorIQ + P2041 processor, e500mc cores. - - Freescale T4240RDB FIXME Why are these listed three - times? - - - QEMU PPC - Kernel configuration: - P2041RDB: One kernel flavor (release) + P2041RDB: One kernel flavor (release)FIXME Why are these + listed three times? Why only "one kernel"?? - P3041DS: One kernel flavor (release) - - - - T4240RDB: Two kernel flavors (release & debug) + P3041DS: One kernel flavor (release)FIXME Why are these + listed three times? @@ -94,32 +86,33 @@ Supported versions: Yocto version INFO: This is fetched from + xpointer="element(Yocto_VER/1)" />INFO: Auto-fetched from poky.ent via pardoc-distro.xml poky source version INFO: This is fetched from + xpointer="element(Poky_VER/1)" />INFO: Auto-fetched from poky.ent via pardoc-distro.xml - gcc version: 4.9was EneaLinux_GCC_VER + gcc version: 4.9was EneaLinux_GCC_VER Not in + poky.en Linux kernel version for all targets: 3.12was - EneaLinux_KERNEL_VER + EneaLinux_KERNEL_VER Not in poky.ent - Eclipse version 4.3 Keplerwas Eclipse_VER and was - Eclipse_NAME + Eclipse version 4.5 Marswas Eclipse_VER and was + Eclipse_NAME Not in poky.ent @@ -130,10 +123,10 @@ Distribution channel: All deliverables can be downloaded from This is still in - pardoc-distro.xml + xpointer="element(ULINK_ENEA_LINUX_URL/1)" /> QUEST REMOVE???? + This is still in pardoc-distro.xml @@ -188,7 +181,7 @@ Packages provided by Yocto See the Yocto "Release Notes" @@ -221,19 +214,17 @@
Provided Documentation - The following Enea Linux manuals are available for : + The following Enea Linux manuals are available: - README.htm - top page of the documentation + README.htm - top page of the documentationFIXME Needs to + be fixed to easily find also online doc - README.release - text file describing the release contents, - installation, and quick getting started + README - text files describing various details like build- and + boot-commands @@ -241,12 +232,6 @@ Information (this document) - - Enea Linux User's Guide - - + User's Guides are available online, not inside the + distribution. + + + + Enea + Linux Application User's Guide + (https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-applications-dev-guide.pdf) + + + + Enea + Linux Platforms User's Guide + (https://portal.enea.com/wp-content/uploads/_mediavault/book-enea-linux-platforms-dev-guide.pdf) + + + + How to use Eclipse is described inside the Enea Linux user's guides. + Eclipse's own documentation is available in directory + eclipse/readme. + The Enea Linux Eclipse tarball and Eclipse Open Source Report is inherited from Enea Linux 4.0. How to use Eclipse is described inside the <trademark class="registered">Enea</trademark> Linux Release Information Release Version - + + 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 @@ + + + + Target Specific Build and Boot Instructions + + For each target, a README file contains the build and boot + instructions. To make it easier for the reader, the contents of these + build/boot instruction have been extracted below into this release + information document. + + The README files are parts of the distribution and can be seen after + the distribution is fetched.NOTE: Only EDIT THE TEMPLATE FILE! A new + build_boot.xml file is created from the template and sections are added + below automatically from the README files for each target when building the + book! Only in the template file you see a line below with SCRIPT_...._HERE + and the text telling that this is a template file. + + SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE + + This is a template file which you can edit. When + the book is built, a new XML chapter file is created where the above part of + this file is copied to the new XML file and all from the line above is + replaced automatically by build and boot sections from the README + files! + \ No newline at end of file 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 88ae1ef..2e6555b 100644 --- a/doc/book-enea-linux-release-info/doc/main_changes.xml +++ b/doc/book-enea-linux-release-info/doc/main_changes.xml @@ -5,7 +5,7 @@ Main Changes This chapter describes the major changes and additions in the Enea - Linux release compared to the previous general Enea Linux release (4.0-140919). @@ -44,17 +44,17 @@ Enea Linux is based on Yocto - (was 1.6) The poky source version is (was daisy-11.0) diff --git a/doc/book-enea-linux-release-info/doc/prerequisites.xml b/doc/book-enea-linux-release-info/doc/prerequisites.xml new file mode 100644 index 0000000..7241ed1 --- /dev/null +++ b/doc/book-enea-linux-release-info/doc/prerequisites.xml @@ -0,0 +1,75 @@ + + + + Prerequisites and Getting Enea Linux + +
+ Install Host Packages + + Building Enea Linux or compiling applications requires some packages + to be installed on your Linux development host. See the list of Required + Packages for Host Development System, found in the Yocto 2.1 document: + https://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#required-packages-for-the-host-development-system. + If needed, replace 2.1 with the actual Yocto version in your Enea Linux + distribution.Sorry by the list in the Yocto document do not seem + to be enough at all at least for platform building! Therefore we need to + add a complete list here, and we actually have a bigger list than we + needed, but it's better to have more and not be needed than to lack + information. + + Install Host Packages + + + The list below is generic and might contain packages that are not + necessary. Additional packages might be required to build for some + targets. See the Enea Linux Release Information if more packages are + needed and which hosts have been tested by Enea for this Enea Linux + release.QUEST: Are the lists below ok? The lists below try to + cover ALL normal use cases for both ApplGuide and PlatfGuide, incl. + Eclipse, instead of limiting to some use case. Easier to keep + updated. + + +
+ Ubuntu or Debian + + Ensure the system is up-to-date: + + $ sudo apt-get update + + For a supported Ubuntu + Ubuntu + and Debian + Debian + distributions you need the following packages: + + # sudo apt-get install sed wget subversion git-core +coreutils unzip texi2html texinfo libsdl1.2-dev docbook-utils fop gawk +python-pysqlite2 diffstat make gcc build-essential xsltproc g++ +desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev autoconf automake +groff libtool xterm libxml-parser-perl +
+
+ +
+ Getting Enea Linux + + For platform developers, an Enea Linux release is available for + cloning from git.enea.com. Releases are available in distribution-specific + repositories on git.enea.com, for cloning using the repo tool in the local + workstation. For more information on this topic, see the Enea Linux Platforms + Development Guide on http://portal.enea.com. + + Application developers will download pre-complied images from the + Enea Portal or will receive prebuilt images from the platform developers. + For further information on this see Enea Linux Application + Development Guide. +
+ \ 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 @@ The basic features provided by Yocto are listed on the "Features" tab on the ???? FIXME THIS WAS "ULINK_YOCTO_DOWN_MINOR_URL" in previous pardoc-distro file - I don't know what is shall be now. Perhaps it is Yocto release notes which I have changed this to, as found in poky.ent. -- cgit v1.2.3-54-g00ecf