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

Peter Eisentraut wrote:
> Log Message:
> -----------
> Use DocBook XSL stylesheets for man page building

So, continuing with this seemingly endless saga :-(

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?

--
Alvaro Herrera                                http://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

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.

Alvaro Herrera wrote:
> Peter Eisentraut wrote:
>> Log Message:
>> -----------
>> Use DocBook XSL stylesheets for man page building
>
> So, continuing with this seemingly endless saga :-(
>
> 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?

yeah . having the doc builds depend on the availabilty of some random
external website is fairly problematic and feels really wrong(and not an
improvement in general at all)



Stefan

On Fri, Aug 14, 2009 at 10:34 PM, Stefan
Kaltenbrunner<stefan@kaltenbrunner.cc> wrote:
>> 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?
>
> yeah . having the doc builds depend on the availabilty of some random
> external website is fairly problematic and feels really wrong(and not an
> improvement in general at all)

Hasn't this always been the case? When building the installers, I
occasionally have 'make html' fail because it can't reach sourceforge
(iirc).


--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

On lör, 2009-08-15 at 09:53 +0100, Dave Page wrote:
> On Fri, Aug 14, 2009 at 10:34 PM, Stefan
> Kaltenbrunner<stefan@kaltenbrunner.cc> wrote:
> >> 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?
> >
> > yeah . having the doc builds depend on the availabilty of some random
> > external website is fairly problematic and feels really wrong(and not an
> > improvement in general at all)
>
> Hasn't this always been the case? When building the installers, I
> occasionally have 'make html' fail because it can't reach sourceforge
> (iirc).

Only when you use an XSL-based toolchain, which make html has never
been.  You might have observed with with the HTMLHelp build.

On 8/15/09, Peter Eisentraut <peter_e@gmx.net> wrote:
> On lör, 2009-08-15 at 09:53 +0100, Dave Page wrote:
>> On Fri, Aug 14, 2009 at 10:34 PM, Stefan
>> Kaltenbrunner<stefan@kaltenbrunner.cc> wrote:
>> >> 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?
>> >
>> > yeah . having the doc builds depend on the availabilty of some random
>> > external website is fairly problematic and feels really wrong(and not an
>> > improvement in general at all)
>>
>> Hasn't this always been the case? When building the installers, I
>> occasionally have 'make html' fail because it can't reach sourceforge
>> (iirc).
>
> Only when you use an XSL-based toolchain, which make html has never
> been.  You might have observed with with the HTMLHelp build.
>

Sorry, yes - 'make htmlhelp' is what I meant.

--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com