[postgis-devel] Can't build doc on Windows (ticket #1692)
Pierre Racine
Pierre.Racine at sbf.ulaval.ca
Mon Mar 26 07:57:10 PDT 2012
So I gave another attempt at building on Windows 7 bypassing the doc problem. Some observations:
1) If xsltproc is absent. Make install fails like this:
---------------------------------------------------------------------
configure was unable to find 'xsltproc' which is required
to build the documentation.
Install xsltproc and then re-run configure. Alternatively
refer to online manual:
http://www.postgis.org/docs
cat postgis.xml | sed -e "s/@@LAST_RELEASE_VERSION@@/2.0.0beta5SVN/g" -e "s;@@MATHML_PATH@@;http://www.w3.org/Math/DTD/mathml2/mathml2.dtd;g
" > postgis-out.xml
/c/projects/pg/pg90/bin/xmllint --loaddtd --xinclude --valid postgis-out.xml > /dev/null
warning: failed to load external entity "postgis_aggs_mm.xml"
postgis-out.xml:151: parser error : Failure to process entity postgis_aggs_mm
&postgis_aggs_mm;
^
postgis-out.xml:151: parser error : Entity 'postgis_aggs_mm' not defined
&postgis_aggs_mm;
^
make[1]: *** [check] Error 1
make[1]: Leaving directory `/c/projects/postgis/doc'
make: *** [docs-check] Error 2
------------------------------------------------------------------------
2) If I install xsltproc from ftp://ftp.zlatkovic.com/libxml/libxslt-1.1.26.win32.zip and rerun configure:
-------- Documentation Generation --------
xsltproc: /mingw/bin/xsltproc
xsl style sheets:
dblatex:
convert: /c/Windows/system32/convert
mathml2.dtd: http://www.w3.org/Math/DTD/mathml2/mathml2.dtd
--------------------------------------------------
xsltproc.exe crashes with:
--------------------------------------------------------------------------------
make[3]: Entering directory `/c/projects/postgis/doc'
cat postgis.xml | sed -e "s/@@LAST_RELEASE_VERSION@@/2.0.0beta5SVN/g" -e "s;@@MATHML_PATH@@;http://www.w3.org/Math/DTD/mathml2/mathml2.dtd;g
" > postgis-out.xml
/mingw/bin/xsltproc ./xsl/postgis_aggs_mm.xml.xsl postgis-out.xml > postgis_aggs_mm.xml
error : No such file or directory
postgis-out.xml:11: warning: failed to load external entity "http://www.w3.org/Math/DTD/mathml2/mathml2.dtd"
%mathml;
^
Entity: line 1:
%mathml;
^
error : No such file or directory
postgis-out.xml:104: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
]>
^
...
...
make[3]: *** [postgis_aggs_mm.xml] Error 5
make[3]: Leaving directory `/c/projects/postgis/doc'
make[2]: *** [../../doc/topology_comments.sql] Error 2
make[2]: Leaving directory `/c/projects/postgis/extensions/postgis_topology'
make[1]: *** [all] Error 2
make[1]: Leaving directory `/c/projects/postgis/extensions'
make: *** [all] Error 1
--------------------------------------------------------
3) I have no idea how to enable xsltproc.exe to fetch the DTDs from the web if this is the problem. strk was speaking about passing some arguments to it setting this flag: XSLTPROCFLAGS=''. How? There does not seem to be any option to "allow" it to fetch from the web. There seems to be a "dissallow" option though (--nonet).
4) I have no idea where to install a local copy of those DTDs.
5) I'm really wondering how you guys can produce a Windows version with the tip of the trunk...
Pierre
> I guess no reason. We should probably ticket this. I don't think testing
> comments is necessary all the time.
> Besides I have no clue how to install docbook or mathml2 DTD on windows and
> frankly would rather not be bothered whne I have more important things to
> occupy my time right now.
>
>
>
> > -----Original Message-----
> > From: Sandro Santilli [mailto:sandro.santilli at gmail.com] On Behalf Of
> > 'Sandro Santilli'
> > Sent: Wednesday, March 14, 2012 2:52 AM
> > To: Paragon Corporation
> > Cc: 'Pierre Racine'; 'Bborie Park'; 'Paul Ramsey'
> > Subject: Re: Can't build doc on Windows
> >
> > Any reason why we're not discussing this on postgis-devel ?
> >
> > Pierre can avoid the crash appending ``XSLTPROCFLAGS='' to the make
> > calls, thus allowing for network connection.
> > Or installing docbook and mathml2 DTDs, which would make building docs
> > fast.
> >
> > I agree a way to disable building docs could be useful, but note that
> > doing so you'd not be able to test comments (which you should).
> > Indeed the 'make' call is only attempting to build the comments, not
> > the whole documentation.
> >
> > --strk;
> >
> > On Tue, Mar 13, 2012 at 09:50:30PM -0400, Paragon Corporation wrote:
> > > You know I get that every so often and it goes away. I
> > think it has
> > > something to do with it trying to download from the internet.
> > >
> > > Paul and Sandro,
> > >
> > > Is there anyway we can have an option to turn that off.
> > It's really
> > > slowing down my compile process (I losose 5 minutes in each
> > iteration)
> > > since I need to wait for the comments to build etc. We can keep it
> > > enabled by default, but we really got to have a way to turn it off
> > >
> > > Thanks,
> > > Regina
> > >
> > > > -----Original Message-----
> > > > From: Pierre Racine [mailto:Pierre.Racine at sbf.ulaval.ca]
> > > > Sent: Tuesday, March 13, 2012 6:21 PM
> > > > To: Paragon Corporation
> > > > Cc: Bborie Park (bkpark at ucdavis.edu)
> > > > Subject: Can't build doc on Windows
> > > >
> > > > Regina,
> > > >
> > > > My doc did not use to try to build before when
> > xsltproc.exe was not
> > > > found by ./configure...
> > > >
> > > > Now it seems to try to build anyway so I installed
> > > > libxslt-1.1.26.win32.zip from
> > ftp://ftp.zlatkovic.com/libxml/ to get
> > > > xsltproc.exe
> > > >
> > > > However I still get this to crash badly:
> > > >
> > > > -------------------------------------------
> > > > /mingw/bin/xsltproc ./xsl/postgis_comments.sql.xsl
> > postgis-out.xml >
> > > > postgis_comments.sql error : No such file or directory
> > > > postgis-out.xml:11: warning: failed to load external entity
> > > > "http://www.w3.org/Math/DTD/mathml2/mathml2.dtd"
> > > > %mathml;
> > > > ^
> > > > Entity: line 1:
> > > > %mathml;
> > > > ^
> > > > error : No such file or directory
> > > > postgis-out.xml:104: warning: failed to load external entity
> > > > "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
> > > > ]>
> > > > ^
> > > > using_postgis_dataman.xml:1294: namespace error :
> > Namespace prefix
> > > > mml on math is not defined
> > > > <mml:math display="block">
> > > > ^ ...
> > > > ^
> > > > using_postgis_dataman.xml:1413: namespace error :
> > Namespace prefix
> > > > mml on mtext is not defined
> > > > <mml:mtext
> > > > mathvariant="italic">E(b) )</mml:mtext>
> > > > ^
> > > > make[3]: *** [postgis_comments.sql] Error 5
> > > > make[3]: Leaving directory `/c/projects/postgis/doc'
> > > > make[2]: *** [../../doc/topology_comments.sql] Error 2
> > > > make[2]: Leaving directory
> > > > `/c/projects/postgis/extensions/postgis_topology'
> > > > make[1]: *** [all] Error 2
> > > > make[1]: Leaving directory `/c/projects/postgis/extensions'
> > > > make: *** [all] Error 1
> > > > ------------------------------------------
> > > >
> > > > I don't know if this is related but I still don't have everything
> > > > after ./configure:
> > > >
> > > > ./configure --with-projdir=/c/projects/pg/pg90
> > > > --with-xml2config=/c/projects/libxml/libxml2-2.7.8release/bin/
> > > > xml2-config
> > > >
> > > > -------- Documentation Generation --------
> > > > xsltproc: /mingw/bin/xsltproc
> > > > xsl style sheets:
> > > > dblatex:
> > > > convert: /c/Windows/system32/convert
> > > > mathml2.dtd:
> > http://www.w3.org/Math/DTD/mathml2/mathml2.dtd
> > > >
> > > > I could not find dblatex for Windows and what do I have
> > to install
> > > > to get "xsl style sheets"?
> > > >
> > > > Could we have a configure option to NOT compile the doc
> > > > --without-doc ?
> > > >
> > > > Which version of xsltproc are you using on Windows 7 so
> > it doesn't
> > > > crashes?
> > > >
> > > > Pierre
> > > >
> > >
> > >
> >
> > --
> >
> > ,------o-.
> > | __/ | Delivering high quality PostGIS 2.0 !
> > | / 2.0 | http://strk.keybit.net - http://vizzuality.com
> > `-o------'
> >
> >
>
More information about the postgis-devel
mailing list