Re: Docs build error in alpha1

I'm hacking up our build framework to allow us to build installers for
the upcoming alpha2 release. When I install the Linux port, I'm seeing
the following failure:

Writing dblink_build_sql_insert.1 for refentry(contrib-dblink-build-sql-insert)
Writing dblink_build_sql_delete.1 for refentry(contrib-dblink-build-sql-delete)
Writing dblink_build_sql_update.1 for refentry(contrib-dblink-build-sql-update)
rm ./man1/dblink*
rm: cannot remove `./man1/dblink*': No such file or directory
make[3]: *** [man-stamp] Error 1
make[3]: Leaving directory
`/mnt/hgfs/pginstaller-repo/DevServer/source/postgres.linux/doc/src/sgml'
make[2]: *** [install] Error 2make[2]: Leaving directory
`/mnt/hgfs/pginstaller-repo/DevServer/source/postgres.linux/doc/src'

make[1]: *** [install] Error 2
make[1]: Leaving directory
`/mnt/hgfs/pginstaller-repo/DevServer/source/postgres.linux/doc'
make: *** [install] Error 2

The dblink man pages all appear to be in doc/src/sgml, not
doc/src/sgml/man1. If I stick a dummy file in there to satisfy the rm
command, the installation runs to completion, though there are no
dblink man pages in the installation directory.

I'm not sure what's going on here (or, what's intended to be going
on). Any hints?

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

On Fri, 2009-09-25 at 11:31 +0100, Dave Page wrote:
> I'm hacking up our build framework to allow us to build installers for
> the upcoming alpha2 release. When I install the Linux port, I'm seeing
> the following failure:
>
> Writing dblink_build_sql_insert.1 for refentry(contrib-dblink-build-sql-insert)
> Writing dblink_build_sql_delete.1 for refentry(contrib-dblink-build-sql-delete)
> Writing dblink_build_sql_update.1 for refentry(contrib-dblink-build-sql-update)
> rm ./man1/dblink*
> rm: cannot remove `./man1/dblink*': No such file or directory
> make[3]: *** [man-stamp] Error 1
> make[3]: Leaving directory
> `/mnt/hgfs/pginstaller-repo/DevServer/source/postgres.linux/doc/src/sgml'
> make[2]: *** [install] Error 2make[2]: Leaving directory
> `/mnt/hgfs/pginstaller-repo/DevServer/source/postgres.linux/doc/src'

I think you have an old version of docbook-xsl.

On Fri, Sep 25, 2009 at 4:28 PM, Peter Eisentraut <peter_e(at)gmx(dot)net> wrote:
> On Fri, 2009-09-25 at 11:31 +0100, Dave Page wrote:
>> I'm hacking up our build framework to allow us to build installers for
>> the upcoming alpha2 release. When I install the Linux port, I'm seeing
>> the following failure:
>>
>> Writing dblink_build_sql_insert.1 for refentry(contrib-dblink-build-sql-insert)
>> Writing dblink_build_sql_delete.1 for refentry(contrib-dblink-build-sql-delete)
>> Writing dblink_build_sql_update.1 for refentry(contrib-dblink-build-sql-update)
>> rm ./man1/dblink*
>> rm: cannot remove `./man1/dblink*': No such file or directory
>> make[3]: *** [man-stamp] Error 1
>> make[3]: Leaving directory
>> `/mnt/hgfs/pginstaller-repo/DevServer/source/postgres.linux/doc/src/sgml'
>> make[2]: *** [install] Error 2make[2]: Leaving directory
>> `/mnt/hgfs/pginstaller-repo/DevServer/source/postgres.linux/doc/src'
>
> I think you have an old version of docbook-xsl.

It's the latest available for CentOS 4.6:

[buildfarm(at)bf-linux ~]$ rpm -q -a |grep docbook
docbook-utils-0.6.14-4
docbook-style-xsl-1.65.1-2
docbook-style-dsssl-1.78-4
docbook-dtds-1.0-25

What do I need?

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

On Fri, 2009-09-25 at 16:47 +0100, Dave Page wrote:
> > I think you have an old version of docbook-xsl.
>
> It's the latest available for CentOS 4.6:
>
> [buildfarm(at)bf-linux ~]$ rpm -q -a |grep docbook
> docbook-utils-0.6.14-4
> docbook-style-xsl-1.65.1-2
> docbook-style-dsssl-1.78-4
> docbook-dtds-1.0-25
>
> What do I need?

I quick grep through the changelog suggests that docbook-style-xsl
1.69.1 or later will get you a lot closer.

Note that the release tarballs contain the built documentation, so maybe
this isn't really necessary.

On Fri, Sep 25, 2009 at 4:56 PM, Peter Eisentraut <peter_e(at)gmx(dot)net> wrote:
> On Fri, 2009-09-25 at 16:47 +0100, Dave Page wrote:
>> > I think you have an old version of docbook-xsl.
>>
>> It's the latest available for CentOS 4.6:
>>
>> [buildfarm(at)bf-linux ~]$ rpm -q -a |grep docbook
>> docbook-utils-0.6.14-4
>> docbook-style-xsl-1.65.1-2
>> docbook-style-dsssl-1.78-4
>> docbook-dtds-1.0-25
>>
>> What do I need?
>
> I quick grep through the changelog suggests that docbook-style-xsl
> 1.69.1 or later will get you a lot closer.

Can we detect this and give the user a more helpful error message?
CentOS 4.x (and RHEL 4.x) are older distros certainly, but not exactly
ancient yet.

> Note that the release tarballs contain the built documentation, so maybe
> this isn't really necessary.

It would seem like wasted effort in that case.

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