building book does not work

[iainsproat]

I cloned the repository and successfully built the sources.
However, on attempting to build the book, I received the following error(s):

C:\path-to-watchmaker\watchmaker>ant book
Buildfile: C:\path-to-watchmaker\watchmaker\build.xml

book:
[mkdir] Created dir: C:\path-to-watchmaker\watchmaker\book\build
[uncommons:docbook] Making portrait pages on A4 paper (210mmx297mm)
[uncommons:docbook] WARN notifyFontReplacement, Font 'Symbol,normal,700' not f
ound. Substituting with 'Symbol,normal,400'.
[uncommons:docbook] WARN notifyFontReplacement, Font 'ZapfDingbats,normal,700'
not found. Substituting with 'ZapfDingbats,normal,400'.
[uncommons:docbook] Element include in namespace 'http://www.w3.org/2001/XInclud
e' encountered in book, but no template matches.
[uncommons:docbook] Error at xsl:text on line 112 of jar:file:/C:/path-to-watchmaker/watchmaker/lib/compilet
ime/uncommons-antlib-0.3.1.jar!/docbook-xsl/fo/docbook.xsl:
[uncommons:docbook] org.apache.fop.fo.ValidationException: Error(-1/-1): fo:bl
ock is not a valid child element of fo:root.

BUILD FAILED
C:\path-to-watchmaker\watchmaker\b
uild.xml:234: java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.
java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcces
sorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.uncommons.antlib.tasks.docbook.DocBook.execute(DocBook.java:160)
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291)
at sun.reflect.GeneratedMethodAccessor4.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcces
sorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.jav
a:106)
at org.apache.tools.ant.Task.perform(Task.java:348)
at org.apache.tools.ant.Target.execute(Target.java:390)
at org.apache.tools.ant.Target.performTasks(Target.java:411)
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1399)
at org.apache.tools.ant.Project.executeTarget(Project.java:1368)
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExe
cutor.java:41)
at org.apache.tools.ant.Project.executeTargets(Project.java:1251)
at org.apache.tools.ant.Main.runBuild(Main.java:809)
at org.apache.tools.ant.Main.startAnt(Main.java:217)
at org.apache.tools.ant.launch.Launcher.run(Launcher.java:280)
at org.apache.tools.ant.launch.Launcher.main(Launcher.java:109)
Caused by: javax.xml.transform.TransformerException: org.apache.fop.fo.Validatio
nException: Error(-1/-1): fo:block is not a valid child element of fo:root.
at com.icl.saxon.style.StyleElement.styleError(StyleElement.java:818)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
5)
at com.icl.saxon.style.LiteralResultElement.process(LiteralResultElement
.java:290)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:229)
at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:202)
at com.icl.saxon.Controller.applyTemplates(Controller.java:297)
at com.icl.saxon.style.XSLApplyTemplates.process(XSLApplyTemplates.java:
139)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:229)
at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:202)
at com.icl.saxon.Controller.applyTemplates(Controller.java:288)
at com.icl.saxon.style.XSLApplyTemplates.process(XSLApplyTemplates.java:
139)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.LiteralResultElement.process(LiteralResultElement
.java:290)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:229)
at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:202)
at com.icl.saxon.Controller.applyTemplates(Controller.java:288)
at com.icl.saxon.Controller.defaultAction(Controller.java:313)
at com.icl.saxon.Controller.applyTemplates(Controller.java:278)
at com.icl.saxon.style.XSLApplyTemplates.process(XSLApplyTemplates.java:
139)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLIf.process(XSLIf.java:78)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLOtherwise.process(XSLOtherwise.java:48)
at com.icl.saxon.style.XSLChoose.process(XSLChoose.java:96)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
at com.icl.saxon.style.XSLTemplate.expand(XSLTemplate.java:229)
at com.icl.saxon.style.XSLTemplate.start(XSLTemplate.java:202)
at com.icl.saxon.Controller.applyTemplates(Controller.java:288)
at com.icl.saxon.Controller.run(Controller.java:220)
at com.icl.saxon.Controller.transformDocument(Controller.java:1125)
at com.icl.saxon.Controller.transform(Controller.java:994)
at org.uncommons.antlib.tasks.docbook.DocBookPublisher.createDocument(Do
cBookPublisher.java:166)
... 21 more
Caused by: org.apache.fop.fo.ValidationException: Error(-1/-1): fo:block is not
a valid child element of fo:root.
at org.apache.fop.fo.FONode.invalidChildError(FONode.java:435)
at org.apache.fop.fo.FONode.invalidChildError(FONode.java:420)
at org.apache.fop.fo.pagination.Root.validateChildNode(Root.java:126)
at org.apache.fop.fo.FOTreeBuilder$MainFOHandler.startElement(FOTreeBuil
der.java:271)
at org.apache.fop.fo.FOTreeBuilder.startElement(FOTreeBuilder.java:163)
at com.icl.saxon.output.ContentHandlerProxy.startElement(ContentHandlerP
roxy.java:129)
at com.icl.saxon.output.ProxyEmitter.startElement(ProxyEmitter.java:80)
at com.icl.saxon.output.NamespaceEmitter.startElement(NamespaceEmitter.j
ava:95)
at com.icl.saxon.output.GeneralOutputter.flushStartTag(GeneralOutputter.
java:745)
at com.icl.saxon.output.GeneralOutputter.writeContent(GeneralOutputter.j
ava:461)
at com.icl.saxon.output.GeneralOutputter.writeContent(GeneralOutputter.j
ava:444)
at com.icl.saxon.style.XSLText.process(XSLText.java:83)
at com.icl.saxon.style.StyleElement.processChildren(StyleElement.java:64
3)
... 60 more

Total time: 3 seconds

[dwdyer]

Thanks for letting me know. The book target isn't really intended for public consumption, I was just be being lazy in not creating a separate repo. There is nothing of value in it that is not already in the HTML version of the manual on the website. That said, it ought to work, and it did work. Bizarrely, it now fails for every version of the repository, right back to the intial DocBook source from 3 years ago.

Since the DocBook stylesheets and almost the entire toolchain are stored in the repository and haven't changed recently, I'm not sure what broke it. The error is coming from FOP but I think maybe it was treating these errors as warnings before.

[dwdyer]

Eventually figured out that this was due to a different default XML parser being used instead of the Xerces parser that was used previously. Fixed to ensure that it always uses Xerces.