Date   

[PATCH 18/35] documentation/kernel-manual/kernel-manual-eclipse-customization.xsl: new file

mail@...
 

From: Timo Mueller <timo.mueller@...>

This stylesheet uses the eclipse stylesheets of docbook to create
eclipse help from this documentation. In addition to simple html
files these stylesheets will also create xml files which are
needed to integrate the documentation into eclipse (e.g. toc.xml).
---
.../kernel-manual-eclipse-customization.xsl | 26 ++++++++++++++++++++
1 files changed, 26 insertions(+), 0 deletions(-)
create mode 100644 documentation/kernel-manual/kernel-manual-eclipse-customization.xsl

diff --git a/documentation/kernel-manual/kernel-manual-eclipse-customization.xsl b/documentation/kernel-manual/kernel-manual-eclipse-customization.xsl
new file mode 100644
index 0000000..70a1e19
--- /dev/null
+++ b/documentation/kernel-manual/kernel-manual-eclipse-customization.xsl
@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns="http://www.w3.org/1999/xhtml"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version="1.0">
+
+ <xsl:import
+ href="http://docbook.sourceforge.net/release/xsl/current/eclipse/eclipse3.xsl" />
+
+ <xsl:param name="chunker.output.indent" select="'yes'"/>
+ <xsl:param name="chunk.first.sections" select="1"/>
+ <xsl:param name="chunk.section.depth" select="10"/>
+ <xsl:param name="use.id.as.filename" select="1"/>
+ <xsl:param name="ulink.target" select="'_self'" />
+ <xsl:param name="base.dir" select="'html/kernel-manual/'"/>
+ <xsl:param name="html.stylesheet" select="'../book.css'"/>
+ <xsl:param name="eclipse.manifest" select="0"/>
+ <xsl:param name="create.plugin.xml" select="0"/>
+ <xsl:param name="suppress.navigation" select="1"/>
+ <xsl:param name="generate.index" select="0"/>
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="appendix.autolabel" select="A" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
+</xsl:stylesheet>
--
1.7.7.6


[PATCH 17/35] documentation: Move kernel-manual global parameters to customization file

mail@...
 

From: Timo Mueller <timo.mueller@...>

Standard stylesheet parameters were moved to the docbook customization
file tying them to the docbook stylesheet used. Removing these
parameters simplifies the Makefile.
---
documentation/Makefile | 7 +------
.../kernel-manual/kernel-manual-customization.xsl | 7 +++++--
2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index 9774932..d86868a 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -217,12 +217,7 @@ STYLESHEET = $(DOC)/*.css
endif

ifeq ($(DOC),kernel-manual)
-XSLTOPTS = --stringparam html.stylesheet kernel-style.css \
- --stringparam chapter.autolabel 1 \
- --stringparam appendix.autolabel A \
- --stringparam section.autolabel 1 \
- --stringparam section.label.includes.component.label 1 \
- --xinclude
+XSLTOPTS = --xinclude
ALLPREQ = html pdf tarball
TARFILES = kernel-manual.html kernel-manual.pdf kernel-style.css figures/kernel-title.png figures/kernel-architecture-overview.png
MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf
diff --git a/documentation/kernel-manual/kernel-manual-customization.xsl b/documentation/kernel-manual/kernel-manual-customization.xsl
index 8eb6905..6f46df2 100644
--- a/documentation/kernel-manual/kernel-manual-customization.xsl
+++ b/documentation/kernel-manual/kernel-manual-customization.xsl
@@ -3,6 +3,9 @@

<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl" />

-<!-- <xsl:param name="generate.toc" select="'article nop'"></xsl:param> -->
-
+ <xsl:param name="html.stylesheet" select="'kernel-style.css'" />
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="appendix.autolabel" select="A" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
</xsl:stylesheet>
--
1.7.7.6


[PATCH 16/35] documentation/Makefile: logic to make all for bsp guide and cleanup

mail@...
 

From: Timo Mueller <timo.mueller@...>

Eclipse help documents are now created when calling the 'make all'
target on the bsp-guide. Resulting files are archived into
the tarball as well. When calling 'make clean' artefacts of
the eclipse documentation build are deleted.
---
documentation/Makefile | 7 ++++---
1 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index 7420dec..9774932 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -71,9 +71,10 @@

ifeq ($(DOC),bsp-guide)
XSLTOPTS = --xinclude
-ALLPREQ = html pdf tarball
-TARFILES = bsp-style.css bsp-guide.html bsp-guide.pdf figures/bsp-title.png
-MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf
+ALLPREQ = html pdf eclipse tarball
+TARFILES = bsp-style.css bsp-guide.html bsp-guide.pdf figures/bsp-title.png \
+ eclipse
+MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf $(DOC)/eclipse
FIGURES = figures
STYLESHEET = $(DOC)/*.css

--
1.7.7.6


[PATCH 15/35] documentation/bsp-guide/bsp-guide.xml: Added Title tag

mail@...
 

From: Timo Mueller <timo.mueller@...>

The title of the document used to create metadata for output formats
such as eclipse help.
---
documentation/bsp-guide/bsp-guide.xml | 4 +++-
1 files changed, 3 insertions(+), 1 deletions(-)

diff --git a/documentation/bsp-guide/bsp-guide.xml b/documentation/bsp-guide/bsp-guide.xml
index 3b7ab6a..8ea48d6 100644
--- a/documentation/bsp-guide/bsp-guide.xml
+++ b/documentation/bsp-guide/bsp-guide.xml
@@ -16,7 +16,9 @@
</imageobject>
</mediaobject>

- <title></title>
+ <title>
+ The Yocto Project Board Support Package Developer's Guide
+ </title>

<authorgroup>
<author>
--
1.7.7.6


[PATCH 14/35] documentation/Makefile: Support for making Eclipse HTML bsp guide

mail@...
 

From: Timo Mueller <timo.mueller@...>

This target will generate eclipse help for the bsp-guide using
the bsp-guide-eclipse-customization.xsl stylesheet.

The output will be generated to a separate directory which can be used
for integrating the documentation into eclipse.
---
documentation/Makefile | 4 +++-
1 files changed, 3 insertions(+), 1 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index 86fb598..7420dec 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -281,12 +281,14 @@ endif
eclipse: BASE_DIR = html/$(DOC)/

eclipse:
-ifeq ($(filter $(DOC), adt-manual dev-manual),)
+ifeq ($(filter $(DOC), adt-manual bsp-guide dev-manual),)
@echo " "
@echo "ERROR: You can only create eclipse documentation"
@echo " of the following documentation parts:"
@echo " "
@echo " - The Yocto Project Application Developer's Guide (adt-manual)"
+ @echo " - The Yocto Project Board Support Package"
+ @echo " Developer's Guide (bsp-guide)"
@echo " - The Yocto Project Development Manual (dev-manual)"
@echo " "
else
--
1.7.7.6


[PATCH 13/35] documentation/bsp-guide/bsp-guide-eclipse-customization.xsl: new file

mail@...
 

From: Timo Mueller <timo.mueller@...>

This stylesheet uses the eclipse stylesheets of docbook to create
eclipse help from this documentation. In addition to simple html
files these stylesheets will also create xml files which are
needed to integrate the documentation into eclipse (e.g. toc.xml).
---
.../bsp-guide/bsp-guide-eclipse-customization.xsl | 26 ++++++++++++++++++++
1 files changed, 26 insertions(+), 0 deletions(-)
create mode 100644 documentation/bsp-guide/bsp-guide-eclipse-customization.xsl

diff --git a/documentation/bsp-guide/bsp-guide-eclipse-customization.xsl b/documentation/bsp-guide/bsp-guide-eclipse-customization.xsl
new file mode 100644
index 0000000..b9aceb2
--- /dev/null
+++ b/documentation/bsp-guide/bsp-guide-eclipse-customization.xsl
@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns="http://www.w3.org/1999/xhtml"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version="1.0">
+
+ <xsl:import
+ href="http://docbook.sourceforge.net/release/xsl/current/eclipse/eclipse3.xsl" />
+
+ <xsl:param name="chunker.output.indent" select="'yes'"/>
+ <xsl:param name="chunk.first.sections" select="1"/>
+ <xsl:param name="chunk.section.depth" select="10"/>
+ <xsl:param name="use.id.as.filename" select="1"/>
+ <xsl:param name="ulink.target" select="'_self'" />
+ <xsl:param name="base.dir" select="'html/bsp-guide/'"/>
+ <xsl:param name="html.stylesheet" select="'../book.css'"/>
+ <xsl:param name="eclipse.manifest" select="0"/>
+ <xsl:param name="create.plugin.xml" select="0"/>
+ <xsl:param name="suppress.navigation" select="1"/>
+ <xsl:param name="generate.index" select="0"/>
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="appendix.autolabel" select="1" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
+</xsl:stylesheet>
--
1.7.7.6


[PATCH 12/35] documentation: Move bsp-guide global parameters to customization file

mail@...
 

From: Timo Mueller <timo.mueller@...>

Standard stylesheet parameters were moved to the docbook customization
file tying them to the docbook stylesheet used. Removing these
parameters simplifies the Makefile.
---
documentation/Makefile | 6 +-----
.../bsp-guide/bsp-guide-customization.xsl | 4 ++++
2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index 3a3a2c3..86fb598 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -70,11 +70,7 @@
#

ifeq ($(DOC),bsp-guide)
-XSLTOPTS = --stringparam html.stylesheet bsp-style.css \
- --stringparam chapter.autolabel 1 \
- --stringparam section.autolabel 1 \
- --stringparam section.label.includes.component.label 1 \
- --xinclude
+XSLTOPTS = --xinclude
ALLPREQ = html pdf tarball
TARFILES = bsp-style.css bsp-guide.html bsp-guide.pdf figures/bsp-title.png
MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf
diff --git a/documentation/bsp-guide/bsp-guide-customization.xsl b/documentation/bsp-guide/bsp-guide-customization.xsl
index 362ebed..5560289 100644
--- a/documentation/bsp-guide/bsp-guide-customization.xsl
+++ b/documentation/bsp-guide/bsp-guide-customization.xsl
@@ -3,4 +3,8 @@

<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl" />

+ <xsl:param name="html.stylesheet" select="'bsp-style.css'" />
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
</xsl:stylesheet>
--
1.7.7.6


[PATCH 11/35] documentation/Makefile: logic to make all for dev manual and cleanup

mail@...
 

From: Timo Mueller <timo.mueller@...>

Eclipse help documents are now created when calling the 'make all'
target on the dev-manual. Resulting files are archived into
the tarball as well. When calling 'make clean' artefacts of
the eclipse documentation build are deleted.
---
documentation/Makefile | 7 ++++---
1 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index 8d70deb..3a3a2c3 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -85,7 +85,7 @@ endif

ifeq ($(DOC),dev-manual)
XSLTOPTS = --xinclude
-ALLPREQ = html pdf tarball
+ALLPREQ = html pdf eclipse tarball
#
# Note that the tarfile might produce the "Cannot stat: No such file or directory" error
# message for .PNG files that are not present when building a particular branch. The
@@ -119,10 +119,11 @@ TARFILES = dev-style.css dev-manual.html dev-manual.pdf \
figures/kernel-overview-1.png figures/kernel-overview-2.png \
figures/kernel-overview-3-denzil.png \
figures/source-repos.png figures/yp-download.png \
- figures/wip.png
+ figures/wip.png \
+ eclipse
endif

-MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf
+MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf $(DOC)/eclipse
FIGURES = figures
STYLESHEET = $(DOC)/*.css

--
1.7.7.6


[PATCH 10/35] documentation/dev-manual/dev-manual.xml: Added Title tag

mail@...
 

From: Timo Mueller <timo.mueller@...>

The title of the document used to create metadata for output formats
such as eclipse help.
---
documentation/dev-manual/dev-manual.xml | 4 +++-
1 files changed, 3 insertions(+), 1 deletions(-)

diff --git a/documentation/dev-manual/dev-manual.xml b/documentation/dev-manual/dev-manual.xml
index a5856e0..7c8f58d 100644
--- a/documentation/dev-manual/dev-manual.xml
+++ b/documentation/dev-manual/dev-manual.xml
@@ -16,7 +16,9 @@
</imageobject>
</mediaobject>

- <title></title>
+ <title>
+ The Yocto Project Development Manual
+ </title>

<authorgroup>
<author>
--
1.7.7.6


[PATCH 09/35] documentation/Makefile: Support for making Eclipse HTML dev manual

mail@...
 

From: Timo Mueller <timo.mueller@...>

This target will generate eclipse help for the dev-manual using
the dev-manual-eclipse-customization.xsl stylesheet.

The output will be generated to a separate directory which can be used
for integrating the documentation into eclipse.
---
documentation/Makefile | 10 ++++++----
1 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index dd5dd50..8d70deb 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -284,11 +284,13 @@ endif
eclipse: BASE_DIR = html/$(DOC)/

eclipse:
-ifneq ($(DOC),adt-manual)
+ifeq ($(filter $(DOC), adt-manual dev-manual),)
@echo " "
- @echo "ERROR: You can only create eclipse documentation of the"
- @echo " Yocto Project Application Development Toolkit (ADT)"
- @echo " User's Guide"
+ @echo "ERROR: You can only create eclipse documentation"
+ @echo " of the following documentation parts:"
+ @echo " "
+ @echo " - The Yocto Project Application Developer's Guide (adt-manual)"
+ @echo " - The Yocto Project Development Manual (dev-manual)"
@echo " "
else
@echo " "
--
1.7.7.6


[PATCH 08/35] documentation/dev-manual/dev-manual-eclipse-customization.xsl: new file

mail@...
 

From: Timo Mueller <timo.mueller@...>

This stylesheet uses the eclipse stylesheets of docbook to create
eclipse help from this documentation. In addition to simple html
files these stylesheets will also create xml files which are
needed to integrate the documentation into eclipse (e.g. toc.xml).
---
.../dev-manual-eclipse-customization.xsl | 26 ++++++++++++++++++++
1 files changed, 26 insertions(+), 0 deletions(-)
create mode 100644 documentation/dev-manual/dev-manual-eclipse-customization.xsl

diff --git a/documentation/dev-manual/dev-manual-eclipse-customization.xsl b/documentation/dev-manual/dev-manual-eclipse-customization.xsl
new file mode 100644
index 0000000..ff1de89
--- /dev/null
+++ b/documentation/dev-manual/dev-manual-eclipse-customization.xsl
@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns="http://www.w3.org/1999/xhtml"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version="1.0">
+
+ <xsl:import
+ href="http://docbook.sourceforge.net/release/xsl/current/eclipse/eclipse3.xsl" />
+
+ <xsl:param name="chunker.output.indent" select="'yes'"/>
+ <xsl:param name="chunk.first.sections" select="1"/>
+ <xsl:param name="chunk.section.depth" select="10"/>
+ <xsl:param name="use.id.as.filename" select="1"/>
+ <xsl:param name="ulink.target" select="'_self'" />
+ <xsl:param name="base.dir" select="'html/dev-manual/'"/>
+ <xsl:param name="html.stylesheet" select="'../book.css'"/>
+ <xsl:param name="eclipse.manifest" select="0"/>
+ <xsl:param name="create.plugin.xml" select="0"/>
+ <xsl:param name="suppress.navigation" select="1"/>
+ <xsl:param name="generate.index" select="0"/>
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="appendix.autolabel" select="1" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
+</xsl:stylesheet>
--
1.7.7.6


[PATCH 07/35] documentation: Move dev-manual global parameters to customization file

mail@...
 

From: Timo Mueller <timo.mueller@...>

Standard stylesheet parameters were moved to the docbook customization
file tying them to the docbook stylesheet used. Removing these
parameters simplifies the Makefile.
---
documentation/Makefile | 6 +-----
.../dev-manual/dev-manual-customization.xsl | 6 ++++--
2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index bb8ca37..dd5dd50 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -84,11 +84,7 @@ STYLESHEET = $(DOC)/*.css
endif

ifeq ($(DOC),dev-manual)
-XSLTOPTS = --stringparam html.stylesheet dev-style.css \
- --stringparam chapter.autolabel 1 \
- --stringparam section.autolabel 1 \
- --stringparam section.label.includes.component.label 1 \
- --xinclude
+XSLTOPTS = --xinclude
ALLPREQ = html pdf tarball
#
# Note that the tarfile might produce the "Cannot stat: No such file or directory" error
diff --git a/documentation/dev-manual/dev-manual-customization.xsl b/documentation/dev-manual/dev-manual-customization.xsl
index 8eb6905..8969605 100644
--- a/documentation/dev-manual/dev-manual-customization.xsl
+++ b/documentation/dev-manual/dev-manual-customization.xsl
@@ -3,6 +3,8 @@

<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl" />

-<!-- <xsl:param name="generate.toc" select="'article nop'"></xsl:param> -->
-
+ <xsl:param name="html.stylesheet" select="'dev-style.css'" />
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
</xsl:stylesheet>
--
1.7.7.6


[PATCH 06/35] documentation/Makefile: logic to make all for adt manual and cleanup

mail@...
 

From: Timo Mueller <timo.mueller@...>

Eclipse help documents are now created when calling the 'make all'
target on the adt-manual. Resulting files are archived into
the tarball as well. When calling 'make clean' artefacts of
the eclipse documentation build are deleted.
---
documentation/Makefile | 9 +++++----
1 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index 66eecaa..bb8ca37 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -214,9 +214,10 @@ endif

ifeq ($(DOC),adt-manual)
XSLTOPTS = --xinclude
-ALLPREQ = html pdf tarball
-TARFILES = adt-manual.html adt-manual.pdf adt-style.css figures/adt-title.png
-MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf
+ALLPREQ = html pdf eclipse tarball
+TARFILES = adt-manual.html adt-manual.pdf adt-style.css figures/adt-title.png \
+ eclipse
+MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf $(DOC)/eclipse
FIGURES = figures
STYLESHEET = $(DOC)/*.css
endif
@@ -332,4 +333,4 @@ publish:
fi

clean:
- rm -f $(MANUALS)
+ rm -rf $(MANUALS)
--
1.7.7.6


[PATCH 05/35] documentation/adt-manual/adt-manual.xml: Added Title tag

mail@...
 

From: Timo Mueller <timo.mueller@...>

The title of the document used to create metadata for output formats
such as eclipse help.
---
documentation/adt-manual/adt-manual.xml | 4 +++-
1 files changed, 3 insertions(+), 1 deletions(-)

diff --git a/documentation/adt-manual/adt-manual.xml b/documentation/adt-manual/adt-manual.xml
index e34dc1c..930bbde 100644
--- a/documentation/adt-manual/adt-manual.xml
+++ b/documentation/adt-manual/adt-manual.xml
@@ -16,7 +16,9 @@
</imageobject>
</mediaobject>

- <title></title>
+ <title>
+ The Yocto Project Application Developer's Guide
+ </title>

<authorgroup>
<author>
--
1.7.7.6


[PATCH 04/35] documentation/Makefile: Support for making Eclipse HTML adt manual

mail@...
 

From: Timo Mueller <timo.mueller@...>

This target will generate eclipse help for the adt-manual using
the adt-manual-eclipse-customization.xsl stylesheet.

The output will be generated to a separate directory which can be used
for integrating the documentation into eclipse.
---
documentation/Makefile | 23 +++++++++++++++++++++++
1 files changed, 23 insertions(+), 0 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index 380193d..66eecaa 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -284,6 +284,29 @@ else
endif


+eclipse: BASE_DIR = html/$(DOC)/
+
+eclipse:
+ifneq ($(DOC),adt-manual)
+ @echo " "
+ @echo "ERROR: You can only create eclipse documentation of the"
+ @echo " Yocto Project Application Development Toolkit (ADT)"
+ @echo " User's Guide"
+ @echo " "
+else
+ @echo " "
+ @echo "******** Building eclipse help of "$(DOC)
+ @echo " "
+ cd $(DOC) && \
+ xsltproc $(XSLTOPTS) \
+ --stringparam base.dir '$(BASE_DIR)' \
+ -o eclipse/$(DOC).html \
+ $(DOC)-eclipse-customization.xsl $(DOC).xml && \
+ mv eclipse/toc.xml eclipse/$(DOC)-toc.xml && \
+ cp -rf $(FIGURES) eclipse/$(BASE_DIR)/$(FIGURES) && \
+ cd ..
+endif
+
tarball: html
@echo " "
@echo "******** Creating Tarball of document files"
--
1.7.7.6


[PATCH 03/35] documentation/adt-manual/adt-manual-eclipse-customization.xsl: new file

mail@...
 

From: Timo Mueller <timo.mueller@...>

This stylesheet uses the eclipse stylesheets of docbook to create
eclipse help from this documentation. In addition to simple html
files these stylesheets will also create xml files which are
needed to integrate the documentation into eclipse (e.g. toc.xml).

Additional parameters are required so resolve links between different
documentation parts inside eclipse.
---
.../adt-manual-eclipse-customization.xsl | 26 ++++++++++++++++++++
1 files changed, 26 insertions(+), 0 deletions(-)
create mode 100644 documentation/adt-manual/adt-manual-eclipse-customization.xsl

diff --git a/documentation/adt-manual/adt-manual-eclipse-customization.xsl b/documentation/adt-manual/adt-manual-eclipse-customization.xsl
new file mode 100644
index 0000000..ff1464e
--- /dev/null
+++ b/documentation/adt-manual/adt-manual-eclipse-customization.xsl
@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns="http://www.w3.org/1999/xhtml"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version="1.0">
+
+ <xsl:import
+ href="http://docbook.sourceforge.net/release/xsl/current/eclipse/eclipse3.xsl" />
+
+ <xsl:param name="chunker.output.indent" select="'yes'"/>
+ <xsl:param name="chunk.first.sections" select="1"/>
+ <xsl:param name="chunk.section.depth" select="10"/>
+ <xsl:param name="use.id.as.filename" select="1"/>
+ <xsl:param name="ulink.target" select="'_self'" />
+ <xsl:param name="base.dir" select="'html/adt-manual/'"/>
+ <xsl:param name="html.stylesheet" select="'../book.css'"/>
+ <xsl:param name="eclipse.manifest" select="0"/>
+ <xsl:param name="create.plugin.xml" select="0"/>
+ <xsl:param name="suppress.navigation" select="1"/>
+ <xsl:param name="generate.index" select="0"/>
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="appendix.autolabel" select="1" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
+</xsl:stylesheet>
--
1.7.7.6


[PATCH 02/35] documentation: Move adt-manual global parameters to customization file

mail@...
 

From: Timo Mueller <timo.mueller@...>

Standard stylesheet parameters were moved to the docbook customization
file tying them to the docbook stylesheet used. Removing these
parameters simplifies the Makefile.

Furthermore supporting new output formats can now be achieved by
creating a new customization file containing its corresponding
parameters. Parameters that are used across different stylesheets with
different values will then be separated through different
customization files.

Global parameters can still be set through the XSLTOPTS variable since
this precedes the parameters in the customization file.
---
documentation/Makefile | 7 +------
.../adt-manual/adt-manual-customization.xsl | 7 +++++--
2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/documentation/Makefile b/documentation/Makefile
index ee7089a..380193d 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -213,12 +213,7 @@ endif


ifeq ($(DOC),adt-manual)
-XSLTOPTS = --stringparam html.stylesheet adt-style.css \
- --stringparam chapter.autolabel 1 \
- --stringparam appendix.autolabel A \
- --stringparam section.autolabel 1 \
- --stringparam section.label.includes.component.label 1 \
- --xinclude
+XSLTOPTS = --xinclude
ALLPREQ = html pdf tarball
TARFILES = adt-manual.html adt-manual.pdf adt-style.css figures/adt-title.png
MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf
diff --git a/documentation/adt-manual/adt-manual-customization.xsl b/documentation/adt-manual/adt-manual-customization.xsl
index 8eb6905..373bdb7 100644
--- a/documentation/adt-manual/adt-manual-customization.xsl
+++ b/documentation/adt-manual/adt-manual-customization.xsl
@@ -3,6 +3,9 @@

<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl" />

-<!-- <xsl:param name="generate.toc" select="'article nop'"></xsl:param> -->
-
+ <xsl:param name="html.stylesheet" select="'adt-style.css'" />
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="appendix.autolabel" select="1" />
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
</xsl:stylesheet>
--
1.7.7.6


[PATCH 01/35] documentation/template/titlepage.templates.xml: Remove title info

mail@...
 

From: Timo Mueller <timo.mueller@...>

The title of a pdf document is part of the image used on the title
page. Thus the title defined (e.g. bookinfo.title) in a document
should never be used when creating title pages for pdf documents. As
other output formats may use the title information to create metadata
the title has been removed from the template.
---
documentation/template/titlepage.templates.xml | 13 -------------
1 files changed, 0 insertions(+), 13 deletions(-)

diff --git a/documentation/template/titlepage.templates.xml b/documentation/template/titlepage.templates.xml
index ff640fa..f53f147 100644
--- a/documentation/template/titlepage.templates.xml
+++ b/documentation/template/titlepage.templates.xml
@@ -140,14 +140,6 @@

<mediaobject/>

- <title
- t:named-template="division.title"
- param:node="ancestor-or-self::book[1]"
- text-align="center"
- font-size="&hsize5;"
- space-before="&hsize5space;"
- font-weight="bold"
- font-family="{$title.fontset}"/>
<subtitle
text-align="center"
font-size="&hsize4;"
@@ -163,11 +155,6 @@
</t:titlepage-content>

<t:titlepage-content t:side="verso">
- <title
- t:named-template="book.verso.title"
- font-size="&hsize2;"
- font-weight="bold"
- font-family="{$title.fontset}"/>
<corpauthor/>
<authorgroup t:named-template="verso.authorgroup"/>
<author/>
--
1.7.7.6


[PATCH 00/35][yocto-docs] Add eclipse help generation to build system

mail@...
 

From: Timo Mueller <timo.mueller@...>

Hi,

this is a rework of the patches I've been submitting to include the
generation of eclipse help files into the documentation build system.

From original rfc ([yocto-docs] Add eclipse help generation to
build system):
<snip>
I've added the target 'eclipse' to the documentation's build system to
automate the process of eclipse help generation. This can help to
facilitate the process of keeping the integrated documentation in sync
with the yocto documentation.
<snip>

This patch set incorporates all changes I've been making so far:

1: Remove the use if title in pdf documents
2..6: Add eclipse generation to adt-manual
7..11: Add eclipse generation to dev-manual
12..16: Add eclipse generation to bsp-guide
17..21: Add eclipse generation to kernel-manual
22..26: Add eclipse generation to poky-ref-manual
27..32: Add eclipse generation to yocto-project-qs
33..34: Handle links between documents
35: Makefile documentation update

Best regards,
Timo

Timo Mueller (35):
documentation/template/titlepage.templates.xml: Remove title info
documentation: Move adt-manual global parameters to customization
file
documentation/adt-manual/adt-manual-eclipse-customization.xsl: new
file
documentation/Makefile: Support for making Eclipse HTML adt manual
documentation/adt-manual/adt-manual.xml: Added Title tag
documentation/Makefile: logic to make all for adt manual and cleanup
documentation: Move dev-manual global parameters to customization
file
documentation/dev-manual/dev-manual-eclipse-customization.xsl: new
file
documentation/Makefile: Support for making Eclipse HTML dev manual
documentation/dev-manual/dev-manual.xml: Added Title tag
documentation/Makefile: logic to make all for dev manual and cleanup
documentation: Move bsp-guide global parameters to customization file
documentation/bsp-guide/bsp-guide-eclipse-customization.xsl: new file
documentation/Makefile: Support for making Eclipse HTML bsp guide
documentation/bsp-guide/bsp-guide.xml: Added Title tag
documentation/Makefile: logic to make all for bsp guide and cleanup
documentation: Move kernel-manual global parameters to customization
file
documentation/kernel-manual/kernel-manual-eclipse-customization.xsl:
new file
documentation/Makefile: Support for making Eclipse HTML kernel manual
documentation/kernel-manual/kernel-manual.xml: Added Title tag
documentation/Makefile: logic to make all for kernel-manual and
cleanup
documentation: Move poky-ref-manual global parameters to
customization file
documentation/poky-ref-manual/poky-ref-manual-eclipse-customization.xsl:
new file
documentation/Makefile: Support for making Eclipse HTML poky ref
manual
documentation/poky-ref-manual/poky-ref-manual.xml: Added Title tag
documentation/Makefile: logic to make all for poky-ref-manual and
cleanup
documentation: Move yocto-project-qs global parameters to
customization file
documentation/yocto-project-qs: Added custom title page
documentation/yocto-project-qs/yocto-project-qs-eclipse-customization.xsl:
new file
documentation/Makefile: Support for making Eclipse HTML yocto project
qs manual
documentation/yocto-project-qs/yocto-project-qs.xml: Convert
fake-title section into articleinfo
documentation/Makefile: logic to make all for yocto-project-qs and
cleanup
documentation/tools/eclipse-help.sed: Processes external links for
eclipse html files
documentation/Makefile: Added conversion of links to other
documentation parts.
documentation/Makefile: Clean up eclipse target and update help.

documentation/Makefile | 119 +-
.../adt-manual/adt-manual-customization.xsl | 7 +-
.../adt-manual-eclipse-customization.xsl | 26 +
documentation/adt-manual/adt-manual.xml | 4 +-
.../bsp-guide/bsp-guide-customization.xsl | 4 +
.../bsp-guide/bsp-guide-eclipse-customization.xsl | 26 +
documentation/bsp-guide/bsp-guide.xml | 4 +-
.../dev-manual/dev-manual-customization.xsl | 6 +-
.../dev-manual-eclipse-customization.xsl | 26 +
documentation/dev-manual/dev-manual.xml | 4 +-
.../kernel-manual/kernel-manual-customization.xsl | 7 +-
.../kernel-manual-eclipse-customization.xsl | 26 +
documentation/kernel-manual/kernel-manual.xml | 4 +-
.../poky-ref-manual-customization.xsl | 5 +
.../poky-ref-manual-eclipse-customization.xsl | 26 +
documentation/poky-ref-manual/poky-ref-manual.xml | 4 +-
documentation/template/titlepage.templates.xml | 13 -
documentation/tools/eclipse-help.sed | 18 +
.../yocto-project-qs-customization.xsl | 3 +-
.../yocto-project-qs-eclipse-customization.xsl | 24 +
.../yocto-project-qs-titlepage.xsl | 3820 ++++++++++++++++++++
.../yocto-project-qs/yocto-project-qs.xml | 20 +-
22 files changed, 4116 insertions(+), 80 deletions(-)
create mode 100644 documentation/adt-manual/adt-manual-eclipse-customization.xsl
create mode 100644 documentation/bsp-guide/bsp-guide-eclipse-customization.xsl
create mode 100644 documentation/dev-manual/dev-manual-eclipse-customization.xsl
create mode 100644 documentation/kernel-manual/kernel-manual-eclipse-customization.xsl
create mode 100644 documentation/poky-ref-manual/poky-ref-manual-eclipse-customization.xsl
create mode 100644 documentation/tools/eclipse-help.sed
create mode 100644 documentation/yocto-project-qs/yocto-project-qs-eclipse-customization.xsl
create mode 100644 documentation/yocto-project-qs/yocto-project-qs-titlepage.xsl

--
1.7.7.6


Re: [PATCHv2 2/5] crownbay.conf: specify the 8.0.4 version as preferred version of mesa-dri

Burton, Ross <ross.burton@...>
 

On 10 October 2012 02:16, <nitin.a.kamble@...> wrote:
Avoid following warnings while building crownbay BSPs:

NOTE: preferred version 7.11 of mesa-dri not available (for item virtual/libgl)
NOTE: versions of mesa-dri available: 2:8.0.4 2:8.0.4+git1+c1f4867c89adb1a6b19d66ec8ad146115909f0a7
This is the preferred version in oe-core, so wouldn't it be easier to
just drop this preferred version line and avoid this repeating itself
in the future?

Ross