Documentation build errors again

[robe]

We seem to be having documentation build errors again and am stumped as to what could be wrong. When it broke there was no change any of the places it was complaining about. So I suspect its a recurrence of this #471.

Wonder if we need to upgrade MathML to 3.0, but have no clue how all that works. When I did make comments locally it would sometimes give arbitrary errors and sometimes complete fine so it doesn't seem to be a specific document error.

Seems to be choking when building postgis_aggs_mm.xml file though when I did make comments it actually built the postgis_comments.sql and postgis_raster.sql and then choke on topology_comments.sql. But then it worked fine the next time around.

chmod +x postgis_restore.pl create_undef.pl postgis_proc_upgrade.pl profile_intersects.pl test_estimation.pl test_joinestimation.pl
make[1]: Leaving directory `/var/home/buildbot/opt/hudson/jobs/PostGIS-trunk-build/workspace/build/utils'
PostGIS was built successfully. Ready to install.
+ cd doc
+ mv postgis.xml postgis.xml.orig
+ sed -e 's:</title>:</title><subtitle><subscript>SVN Revision (<emphasis>7054</emphasis>)</subscript></subtitle>:' postgis.xml.orig
+ make -e chunked-html
+ tee -a doc-errors.log
/usr/bin/xsltproc ./xsl/postgis_aggs_mm.xml.xsl postgis.xml > postgis_aggs_mm.xml
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: " or ' expected

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : xmlParseEntityDecl: entity list.class not terminated

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : XML conditional section not closed

^
unable to parse postgis.xml
make: *** [postgis_aggs_mm.xml] Error 6
+ make comments
+ tee -a doc-errors.log
/usr/bin/xsltproc ./xsl/postgis_comments.sql.xsl postgis.xml > postgis_comments.sql
/usr/bin/xsltproc ./xsl/raster_comments.sql.xsl postgis.xml > raster_comments.sql
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: '%' forbidden except for entities references

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : EntityValue: " or ' expected

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : xmlParseEntityDecl: entity list.class not terminated

^
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd:171: parser error : XML conditional section not closed

^
unable to parse postgis.xml
make: *** [raster_comments.sql] Error 6
+ make pdf

and all I had changed when this started happening was this file

/trunk/doc/xsl/postgis_gardentest.sql.xsl

which doesn't even get called by the build.

If anyone has insights into the problem, that would be much appreciated.

[robe]

Now I'm a bit baffled. Clearly it was able to generate an update to date documentation

​http://office.refractions.net:1500/job/PostGIS-trunk-build/ws/build/doc/postgis-2.0.0SVN.pdf (reads 7056), so must not have trouble creating the special index file.

I guess might have to turn off the comments building until can figure out what its complaining about.

[robe]

This seems to have mysteriously gone away just as mysteriously appeared. Thus pointing at it possibly downloading corrupt dtds from oasis docbook site.