Skip to contentSkip to conversation

New source files and Makefile update for Test Manual

PATCH In review Mark Morton 3 participants 9 messages Jun 16, 2020 – Jun 25, 2020 1 message not in the archive

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 New source files and Makefile update for Test Manual

---
 documentation/Makefile                        |   2 +-
 .../test-manual/figures/ab-test-cluster.png   | Bin 0 -> 18684 bytes
 .../test-manual/figures/test-manual-title.png | Bin 0 -> 15382 bytes
 .../test-manual/test-manual-customization.xsl |  27 +
 .../test-manual/test-manual-intro.xml         | 634 +++++++++++
 .../test-manual/test-manual-style.css         | 989 ++++++++++++++++++
 .../test-manual/test-manual-test-process.xml  | 109 ++
 .../test-manual-understand-autobuilder.xml    | 312 ++++++
 documentation/test-manual/test-manual.xml     | 103 ++
 9 files changed, 2175 insertions(+), 1 deletion(-)
 create mode 100644 documentation/test-manual/figures/ab-test-cluster.png
 create mode 100644 documentation/test-manual/figures/test-manual-title.png
 create mode 100644 documentation/test-manual/test-manual-customization.xsl
 create mode 100644 documentation/test-manual/test-manual-intro.xml
 create mode 100644 documentation/test-manual/test-manual-style.css
 create mode 100644 documentation/test-manual/test-manual-test-process.xml
 create mode 100644 documentation/test-manual/test-manual-understand-autobuilder.xml
 create mode 100755 documentation/test-manual/test-manual.xml
documentation/Makefile +1 -1
index 3bdf32b89..ff0494b95 100644
@@ -361,7 +361,7 @@ ifeq ($(DOC),test-manual)
 XSLTOPTS = --xinclude
 ALLPREQ = html tarball
 TARFILES = test-manual.html test-manual-style.css \
-	   figures/test-manual-title.png figures/ab-test-stack.png
+	   figures/test-manual-title.png figures/ab-test-cluster.png
 MANUALS = $(DOC)/$(DOC).html
 FIGURES = figures
 STYLESHEET = $(DOC)/*.css
documentation/test-manual/figures/ab-test-cluster.png new file binary +0 -0
new file mode 100644
index 0000000000000000000000000000000000000000..6a6a7882b43895cd3e81e18b8829c88af5b2ca8c
GIT binary patch
documentation/test-manual/figures/test-manual-title.png new file binary +0 -0
new file mode 100644
index 0000000000000000000000000000000000000000..c709cb9d09cfa38b0909cdf70b459946e3b4615b
GIT binary patch
documentation/test-manual/test-manual-customization.xsl new file +27 -0
new file mode 100644
index 000000000..6e437d482
@@ -0,0 +1,27 @@
+<?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://downloads.yoctoproject.org/mirror/docbook-mirror/docbook-xsl-1.76.1/xhtml/docbook.xsl" />
+
+<!--
+
+  <xsl:import href="../template/1.76.1/docbook-xsl-1.76.1/xhtml/docbook.xsl" />
+
+  <xsl:import href="http://docbook.sourceforge.net/release/xsl/1.76.1/xhtml/docbook.xsl" />
+
+-->
+
+  <xsl:include href="../template/permalinks.xsl"/>
+  <xsl:include href="../template/section.title.xsl"/>
+  <xsl:include href="../template/component.title.xsl"/>
+  <xsl:include href="../template/division.title.xsl"/>
+  <xsl:include href="../template/formal.object.heading.xsl"/>
+
+  <xsl:param name="html.stylesheet" select="'test-manual-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:param name="generate.id.attributes" select="1" />
+
+</xsl:stylesheet>
documentation/test-manual/test-manual-intro.xml new file +634 -0

634 lines not on this page · raw message

documentation/test-manual/test-manual-style.css new file +989 -0

989 lines not on this page · raw message

documentation/test-manual/test-manual-test-process.xml new file +109 -0

109 lines not on this page · raw message

documentation/test-manual/test-manual-understand-autobuilder.xml new file +312 -0

312 lines not on this page · raw message

documentation/test-manual/test-manual.xml new file +103 -0

103 lines not on this page · raw message

Signature · 1 line
2.17.1
#1 lore raw
Quoted 12 lines · Mark Morton
---
 documentation/Makefile                        |   2 +-
 .../test-manual/figures/ab-test-cluster.png   | Bin 0 -> 18684 bytes
 .../test-manual/figures/test-manual-title.png | Bin 0 -> 15382 bytes
 .../test-manual/test-manual-customization.xsl |  27 +
 .../test-manual/test-manual-intro.xml         | 634 +++++++++++
 .../test-manual/test-manual-style.css         | 989 ++++++++++++++++++
 .../test-manual/test-manual-test-process.xml  | 109 ++
 .../test-manual-understand-autobuilder.xml    | 312 ++++++
 documentation/test-manual/test-manual.xml     | 103 ++
 9 files changed, 2175 insertions(+), 1 deletion(-)
Quoted 8 lines
 create mode 100644 documentation/test-manual/figures/ab-test-cluster.png
 create mode 100644 documentation/test-manual/figures/test-manual-title.png
 create mode 100644 documentation/test-manual/test-manual-customization.xsl
 create mode 100644 documentation/test-manual/test-manual-intro.xml
 create mode 100644 documentation/test-manual/test-manual-style.css
 create mode 100644 documentation/test-manual/test-manual-test-process.xml
 create mode 100644 documentation/test-manual/test-manual-understand-autobuilder.xml
 create mode 100755 documentation/test-manual/test-manual.xml

Thanks Mark, its great to have this here!

I've queued it in master-next. The only issue was the patch didn't apply cleanly, the Makefile change was trying to change something which wasn't there. I've made it do what I think it was meant to but you'd better check I have that part of the change correct.

Cheers,

Richard

#2 lore raw
Quoted 36 lines

-----Original Message-----
From: Richard Purdie <[email protected]>
Sent: Tuesday, June 16, 2020 3:08 PM
To: Morton, Mark <[email protected]>; [email protected]
Subject: Re: [docs] [PATCH] New source files and Makefile update for Test Manual

Quoted 16 lines · Mark Morton
---
 documentation/Makefile                        |   2 +-
 .../test-manual/figures/ab-test-cluster.png   | Bin 0 -> 18684 bytes
 .../test-manual/figures/test-manual-title.png | Bin 0 -> 15382 bytes
.../test-manual/test-manual-customization.xsl |  27 +
 .../test-manual/test-manual-intro.xml         | 634 +++++++++++
 .../test-manual/test-manual-style.css         | 989 ++++++++++++++++++
 .../test-manual/test-manual-test-process.xml  | 109 ++
 .../test-manual-understand-autobuilder.xml    | 312 ++++++
 documentation/test-manual/test-manual.xml     | 103 ++
 9 files changed, 2175 insertions(+), 1 deletion(-)  create mode
100644 documentation/test-manual/figures/ab-test-cluster.png
 create mode 100644
documentation/test-manual/figures/test-manual-title.png
 create mode 100644
Quoted 8 lines

documentation/test-manual/test-manual-customization.xsl

 create mode 100644 documentation/test-manual/test-manual-intro.xml
 create mode 100644 documentation/test-manual/test-manual-style.css
 create mode 100644
documentation/test-manual/test-manual-test-process.xml
 create mode 100644
documentation/test-manual/test-manual-understand-autobuilder.xml
 create mode 100755 documentation/test-manual/test-manual.xml
Quoted 6 lines

Thanks Mark, its great to have this here!

I've queued it in master-next. The only issue was the patch didn't apply cleanly, the Makefile change was trying to change something which wasn't there. I've made it do what I think it was meant to but you'd better check I have that part of the change correct.

Hi Richard - I just checked the file and tested the output. We are good to go.

Thanks,
-Mark

Quoted 5 lines

Cheers,

Richard

#3 lore raw

Building the new test-manual for pdf doesn't succeed for me. But that could indicate something wrong on my end.
A relevant snip is below, I'm not sure what the most important parts are.

$ cd yocto-docs/documentation
$ make pdf DOC=test-manual

cd test-manual; ../tools/poky-docbook-to-pdf test-manual.xml ../template; cd ..
Note: namesp. cut : stripped namespace before processing
Yocto Project Test Environment Manual

Making portrait pages on A4 paper (210mmx297mm)
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
...
SEVERE: javax.xml.transform.TransformerException:
file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178:
Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)
Jun 24, 2020 3:32:48 PM FOP startFOP
SEVERE: Exception
org.apache.fop.apps.FOPException: org.apache.fop.fo.ValidationException:
file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178:
Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)
javax.xml.transform.TransformerException:
org.apache.fop.fo.ValidationException:
file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178:
Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)

#6 lore raw
Quoted 1 line · Mark

It looks like a duplicate in the ID name – I’ll take a look and try and fix that.

Great! Thanks for the quick reply.

Again, not sure if this is just happening to me or not but in the pdf the diagram isn't included.

A message that is not in the archive (sent off-list or not yet received): [email protected]

#8 lore raw
Quoted 3 lines · Trevor Woerner via lists.yoctoproject.org

Again, not sure if this is just happening to me or not but in the pdf the diagram isn't included.

Hmm... I just noticed the diagram(s) aren't showing up in my kernel-devl pdf manual either. Perhaps something on my side?

#9 lore raw
In reply to Trevor Woerner

Hi Trevor:

I just pushed a patch – it should be arriving soon. PDFs are now building (with existing caveats)

Thanks for finding this.

-Mark

From: Trevor Woerner <[email protected]>
Sent: Wednesday, June 24, 2020 12:36 PM
To: Morton, Mark <[email protected]>
Cc: Richard Purdie <[email protected]>; [email protected]
Subject: Re: [docs] [PATCH] New source files and Makefile update for Test Manual

Building the new test-manual for pdf doesn't succeed for me. But that could indicate something wrong on my end. A relevant snip is below, I'm not sure what the most important parts are.

$ cd yocto-docs/documentation
$ make pdf DOC=test-manual

cd test-manual; ../tools/poky-docbook-to-pdf test-manual.xml ../template; cd ..
Note: namesp. cut : stripped namespace before processing
Yocto Project Test Environment Manual

Making portrait pages on A4 paper (210mmx297mm)
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
...
SEVERE: javax.xml.transform.TransformerException: file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178: Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178) Jun 24, 2020 3:32:48 PM FOP startFOP
SEVERE: Exception
org.apache.fop.apps.FOPException: org.apache.fop.fo.ValidationException: file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178: Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178) javax.xml.transform.TransformerException: org.apache.fop.fo.ValidationException: file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178: Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)