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

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: pgsql-docs(at)postgresql(dot)org
Cc: Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Stefan Kaltenbrunner <stefan(at)kaltenbrunner(dot)cc>
Subject: Re: Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches
Date: 2009-08-14 22:39:12
Message-ID: 200908150139.13775.peter_e@gmx.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-docs pgsql-hackers

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.

In response to

Browse pgsql-committers by date

  From Date Subject
Next Message Peter Eisentraut 2009-08-14 23:25:51 pgsql: Remove the test case that depends on the platform's float output
Previous Message Alvaro Herrera 2009-08-14 21:37:18 pgsql: Be able to easily figure out the target directory of "make dist".

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2009-08-15 00:33:30 Re: pl/perl doc correction: subroutines
Previous Message Peter Eisentraut 2009-08-14 22:32:33 Re: documentation output directory

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2009-08-14 22:41:12 Re: More cruft left behind in doc directory
Previous Message Stefan Kaltenbrunner 2009-08-14 21:34:53 Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches