Re: Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches

On Saturday 15 August 2009 00:20:27 Alvaro Herrera wrote:
> I'm working on fixing the script that generates the snapshots.  I have
> fixed the script so that it works on my machine, but Stefan reports that
> it fails on developer.postgresql.org with:
>
> http://docbook.sourceforge.net/release/xsl/current/manpages/inline.xsl:1:
> parser error : Start tag expected, '<' not found HTTP/1.1 504 Gateway
> Time-out
> ^
> compilation error: file
> http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
> line 36 element include xsl:include : unable to load
> http://docbook.sourceforge.net/release/xsl/current/manpages/inline.xsl
> gmake[3]: *** [man-stamp] Error 5
> gmake[3]: Leaving directory `/usr/local/pgsql/snapshot/pgsql/doc/src/sgml'
> gmake[2]: *** [man] Error 2
> gmake[2]: Leaving directory `/usr/local/pgsql/snapshot/pgsql/doc/src'
> gmake[1]: *** [man] Error 2
> gmake[1]: Leaving directory `/usr/local/pgsql/snapshot/pgsql/doc'
> gmake: *** [man] Error 2
>
>
> His complaint is that we're now depending on a random website to be up
> and reachable to generate the manpages :-(  Is there a way we can have
> the necessary stylesheets locally?

Sure, you just have to install them correctly. ;-)

xsltproc looks for a catalog file in /etc/xml/catalog that ultimately links to
the place where the local installation is to be found.  I guess the FreeBSD
port installation, or whatever you have there, fails to do this correctly.