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

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

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

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Alvaro Herrera 2009-08-14 21:37:18 pgsql: Be able to easily figure out the target directory of "make dist".
Previous Message Alvaro Herrera 2009-08-14 21:20:27 Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches

Browse pgsql-docs by date

  From Date Subject
Next Message Andreas Wenk 2009-08-14 21:39:07 Re: wording for 38.6.2.4. Simple CASE and 38.6.2.5. Searched CASE
Previous Message Alvaro Herrera 2009-08-14 21:28:48 documentation output directory

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2009-08-14 22:39:12 Re: Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches
Previous Message Alvaro Herrera 2009-08-14 21:20:27 Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches