GNOME Bugzilla – Bug 684731
Build breaks on cogl-2.0-experimental docs
Last modified: 2021-06-10 11:19:08 UTC
Created attachment 225076 [details] [review] fix doc build in cogl-2.0-experimental An excerpt from build log follows: DOC Building HTML ../xml/cogl-context.xml:139: parser error : Opening and ending tag mismatch: note line 133 and para </para> ^ ../xml/cogl-context.xml:153: parser error : Opening and ending tag mismatch: note line 152 and para </para> ^ ../xml/cogl-context.xml:154: parser error : Opening and ending tag mismatch: para line 145 and refsect1 </refsect1> ^ ../xml/cogl-context.xml:930: parser error : Opening and ending tag mismatch: para line 132 and refentry </refentry> ^ ../xml/cogl-context.xml:931: parser error : Premature end of data in tag refsect1 line 110 ^ ../xml/cogl-context.xml:931: parser error : Premature end of data in tag refentry line 6 ^ ../cogl-2.0-experimental-docs.xml:65: element include: XInclude error : could not load ../xml/cogl-context.xml, and no fallback was found make[4]: *** [html-build.stamp] Error 6 make[4]: Leaving directory `/home/mitya/mageia/cogl/BUILD/cogl-1.12.0/doc/reference/cogl-2.0-experimental' make[3]: *** [all-recursive] Error 1 make[3]: Leaving directory `/home/mitya/mageia/cogl/BUILD/cogl-1.12.0/doc/reference' make[2]: *** [all-recursive] Error 1 make[2]: Leaving directory `/home/mitya/mageia/cogl/BUILD/cogl-1.12.0/doc' make[1]: *** [all-recursive] Error 1 make[1]: Leaving directory `/home/mitya/mageia/cogl/BUILD/cogl-1.12.0' make: *** [all] Error 2 Mageia Linux (Cauldron), gtk-doc-1.18, docbook-style-xsl-1.77.1. Seems like multi-paragraph <note>'s (in cogl-context.h) are not understood with this combination of software. Additionally, there is a typo in the closing tag. Please see the patch that fixes this.
Specifically, the build fails because of a change in behavior in xsltproc with libxslt-1.1.27. Earlier versions of xsltproc had treated xinclude errors as non-fatal, but 1.1.27 is stricter.
GNOME is going to shut down bugzilla.gnome.org in favor of gitlab.gnome.org. As part of that, we are mass-closing older open tickets in bugzilla.gnome.org which have not seen updates for a longer time (resources are unfortunately quite limited so not every ticket can get handled). If you can still reproduce the situation described in this ticket in a recent and supported software version of cogl, then please follow https://wiki.gnome.org/GettingInTouch/BugReportingGuidelines and create a ticket at https://gitlab.gnome.org/GNOME/cogl/-/issues/ Thank you for your understanding and your help.