Cannot build docs on Ubuntu 10.04?

Josh Berkus <josh@agliodbs.com> wrote:

What packages and versions do I need to install to build the docs
on Ubuntu?

I tried 10.04's version of Openjade, which wasn't recognized

Requirements for building the docs are not documented in our docs.

I did find that getting the doc build going was a bit fussy, even
after reading the docs on it:

http://www.postgresql.org/docs/current/static/docguide.html

There were recently some posts that helped me clear up a lot of
warnings I was getting, which basically boiled down to the need to
install the opensp package.

-Kevin

http://www.postgresql.org/docs/current/static/docguide.html

There were recently some posts that helped me clear up a lot of
warnings I was getting, which basically boiled down to the need to
install the opensp package.

Yeah, that guide isn't much help, because the named requirements don't
relate at all to debian/ubuntu packages.

We'd probably get more help on the docs if it wasn't a day-long effort
to build them. Sphinx anyone?

--
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com

To be more specific, having installed all of the requirements listed in
builddocs, I'm still getting a fatal error:

make[3]: Entering directory `/usr/local/src/test/doc/src/sgml'
{ \
echo "<!ENTITY version \"9.2devel\">"; \
echo "<!ENTITY majorversion \"9.2\">"; \
} > version.sgml
'/usr/bin/perl' ./mk_feature_tables.pl YES
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-supported.sgml
'/usr/bin/perl' ./mk_feature_tables.pl NO
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-unsupported.sgml
'/usr/bin/perl' ./generate-errcodes-table.pl
../../../src/backend/utils/errcodes.txt > errcodes-table.sgml
jade -wall -wno-unused-param -wno-empty -wfully-tagged -D . -D . -d
stylesheet.dsl -t sgml -i output-html -V html-index postgres.sgml
jade:E: unknown warning type "fully-tagged"
LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
bookindex.sgml HTML.index
Can't open perl script "/bin/collateindex.pl": No such file or directory
make[3]: *** [bookindex.sgml] Error 2

--
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com

On 1/12/12 12:28 PM, Josh Berkus wrote:

To be more specific, having installed all of the requirements listed in
builddocs, I'm still getting a fatal error:

make[3]: Entering directory `/usr/local/src/test/doc/src/sgml'
{ \
echo "<!ENTITY version \"9.2devel\">"; \
echo "<!ENTITY majorversion \"9.2\">"; \
} > version.sgml
'/usr/bin/perl' ./mk_feature_tables.pl YES
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-supported.sgml
'/usr/bin/perl' ./mk_feature_tables.pl NO
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-unsupported.sgml
'/usr/bin/perl' ./generate-errcodes-table.pl
../../../src/backend/utils/errcodes.txt > errcodes-table.sgml
jade -wall -wno-unused-param -wno-empty -wfully-tagged -D . -D . -d
stylesheet.dsl -t sgml -i output-html -V html-index postgres.sgml
jade:E: unknown warning type "fully-tagged"
LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
bookindex.sgml HTML.index
Can't open perl script "/bin/collateindex.pl": No such file or directory
make[3]: *** [bookindex.sgml] Error 2

So apparently I needed to do a "make distclean" and then ./configure
again after installing a couple of the missing packages. Built now.

--
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com

Excerpts from Josh Berkus's message of jue ene 12 17:28:28 -0300 2012:

To be more specific, having installed all of the requirements listed in
builddocs, I'm still getting a fatal error:

make[3]: Entering directory `/usr/local/src/test/doc/src/sgml'
{ \
echo "<!ENTITY version \"9.2devel\">"; \
echo "<!ENTITY majorversion \"9.2\">"; \
} > version.sgml
'/usr/bin/perl' ./mk_feature_tables.pl YES
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-supported.sgml
'/usr/bin/perl' ./mk_feature_tables.pl NO
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-unsupported.sgml
'/usr/bin/perl' ./generate-errcodes-table.pl
../../../src/backend/utils/errcodes.txt > errcodes-table.sgml
jade -wall -wno-unused-param -wno-empty -wfully-tagged -D . -D . -d
stylesheet.dsl -t sgml -i output-html -V html-index postgres.sgml
jade:E: unknown warning type "fully-tagged"
LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
bookindex.sgml HTML.index
Can't open perl script "/bin/collateindex.pl": No such file or directory
make[3]: *** [bookindex.sgml] Error 2

Did you re-run configure after installing everything? It seems to me
the path to collateindex.pl is not correctly set -- looks like a
variable expanding to empty string.

The warning about "unknown warning type" means you're using the wrong
tool to me. My toolchain here uses "openjade" which is a fork of the
earlier jade (so install opensp as Kevin suggested, and rerun configure
after that); my guess is that we're pretty much dependent on openjade
features that did not exist in plain jade. Maybe we should just get rid
of our attempts to use the older tool.

--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

On 12-01-2012 17:28, Josh Berkus wrote:

Can't open perl script "/bin/collateindex.pl": No such file or directory
make[3]: *** [bookindex.sgml] Error 2

Did you install docbook-dsssl? It must contain that script.

--
Euler Taveira de Oliveira - Timbira http://www.timbira.com.br/
PostgreSQL: Consultoria, Desenvolvimento, Suporte 24x7 e Treinamento

The warning about "unknown warning type" means you're using the wrong
tool to me. My toolchain here uses "openjade" which is a fork of the
earlier jade (so install opensp as Kevin suggested, and rerun configure
after that); my guess is that we're pretty much dependent on openjade
features that did not exist in plain jade. Maybe we should just get rid
of our attempts to use the older tool.

Yeah, the problem is that if you install just "openjade" on
debian/ubuntu, it doesn't create the command "jade", which is what our
make script is looking for.

--
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com

On 1/12/12 1:43 PM, Euler Taveira de Oliveira wrote:

On 12-01-2012 17:28, Josh Berkus wrote:

Can't open perl script "/bin/collateindex.pl": No such file or directory
make[3]: *** [bookindex.sgml] Error 2

Did you install docbook-dsssl? It must contain that script.

Per prior email, I needed to do a "make distclean" and re-configure.

--
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com

Josh Berkus <josh@agliodbs.com> writes:

We'd probably get more help on the docs if it wasn't a day-long effort
to build them.

[ shrug... ] On Fedora, installing the "authoring/publishing tools"
package group has always gotten me everything needed.

regards, tom lane

Josh Berkus <josh@agliodbs.com> writes:

LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
bookindex.sgml HTML.index
Can't open perl script "/bin/collateindex.pl": No such file or directory

On Fedora, that script comes in the docbook-style-dsssl package. Don't
know how Ubuntu has chopped things up.

regards, tom lane

Excerpts from Josh Berkus's message of jue ene 12 18:43:39 -0300 2012:

The warning about "unknown warning type" means you're using the wrong
tool to me. My toolchain here uses "openjade" which is a fork of the
earlier jade (so install opensp as Kevin suggested, and rerun configure
after that); my guess is that we're pretty much dependent on openjade
features that did not exist in plain jade. Maybe we should just get rid
of our attempts to use the older tool.

Yeah, the problem is that if you install just "openjade" on
debian/ubuntu, it doesn't create the command "jade", which is what our
make script is looking for.

BS. You just neglected to rerun configure at that point.

# config/docbook.m4

# PGAC_PROG_JADE
# --------------
AC_DEFUN([PGAC_PROG_JADE],
[AC_CHECK_PROGS([JADE], [openjade jade])])

I think the main failure of the docs is to make it more prominent that
you need to rerun configure after you install stuff.

--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

Alvaro Herrera <alvherre@commandprompt.com> writes:

The warning about "unknown warning type" means you're using the wrong
tool to me. My toolchain here uses "openjade" which is a fork of the
earlier jade (so install opensp as Kevin suggested, and rerun configure
after that); my guess is that we're pretty much dependent on openjade
features that did not exist in plain jade. Maybe we should just get rid
of our attempts to use the older tool.

Hm ... on my machine /usr/bin/jade is a symlink to openjade, anyway.

My recollection is that even with openjade, it won't work real well with
older versions because of assorted bugs in that tool that have been
fixed over time. So original jade might be pretty hopeless by now.

regards, tom lane

Excerpts from Tom Lane's message of jue ene 12 18:55:41 -0300 2012:

Josh Berkus <josh@agliodbs.com> writes:

LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
bookindex.sgml HTML.index
Can't open perl script "/bin/collateindex.pl": No such file or directory

On Fedora, that script comes in the docbook-style-dsssl package. Don't
know how Ubuntu has chopped things up.

$ dpkg -S collateindex.pl
docbook-dsssl: /usr/share/man/man1/collateindex.pl.1.gz
docbook-dsssl: /usr/bin/collateindex.pl

--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

On Thu, Jan 12, 2012 at 4:50 PM, Josh Berkus <josh@agliodbs.com> wrote:

On 1/12/12 1:43 PM, Euler Taveira de Oliveira wrote:

On 12-01-2012 17:28, Josh Berkus wrote:

Can't open perl script "/bin/collateindex.pl": No such file or directory
make[3]: *** [bookindex.sgml] Error 2

Did you install docbook-dsssl? It must contain that script.

Per prior email, I needed to do a "make distclean" and re-configure.

So do we have a complete list of the packages needed on Ubuntu now,
that we could add to the documentation? I grow weary of figuring this
out every time I set up a new machine.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

On fre, 2012-01-27 at 12:19 -0500, Robert Haas wrote:

So do we have a complete list of the packages needed on Ubuntu now,
that we could add to the documentation? I grow weary of figuring this
out every time I set up a new machine.

The list we have had in the documentation (under Debian) is correct.