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

[Alvaro Herrera-7]

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

--
Sent via pgsql-docs mailing list (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Stefan Kaltenbrunner]

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

--
Sent via pgsql-docs mailing list (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Peter Eisentraut-2]

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.

--
Sent via pgsql-docs mailing list (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Dave Page-7]

On Fri, Aug 14, 2009 at 10:34 PM, Stefan
Kaltenbrunner<stefan@...> 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

--
Sent via pgsql-docs mailing list (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Peter Eisentraut-2]

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@...> 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.


--
Sent via pgsql-docs mailing list (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

[Dave Page-7]

On 8/15/09, Peter Eisentraut <peter_e@...> 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@...> 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

--
Sent via pgsql-docs mailing list (pgsql-docs@...)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs