Docs build error in alpha1

Started by Dave Pageover 16 years ago5 messages
#1Dave Page
dpage@pgadmin.org

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

#2Peter Eisentraut
peter_e@gmx.net
In reply to: Dave Page (#1)
Re: Docs build error in alpha1

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.

#3Dave Page
dpage@pgadmin.org
In reply to: Peter Eisentraut (#2)
Re: Docs build error in alpha1

On Fri, Sep 25, 2009 at 4:28 PM, Peter Eisentraut <peter_e@gmx.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@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

#4Peter Eisentraut
peter_e@gmx.net
In reply to: Dave Page (#3)
Re: Docs build error in alpha1

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

#5Dave Page
dpage@pgadmin.org
In reply to: Peter Eisentraut (#4)
Re: Docs build error in alpha1

On Fri, Sep 25, 2009 at 4:56 PM, Peter Eisentraut <peter_e@gmx.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@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