2006-11-15

Building PostgreSQL documentation

Follow http://developer.postgresql.org/pgdocs/postgres/docguide-toolsets.html with some corrections:

• Use --enable-default-catalog=/usr/local/share/sgml/catalog option when configuring both OpenSP and OpenJade
• collateindex.pl contains in docbook-dsssl distribution under bin/ directory. I did symbolic link from /usr/bin
• You need to install SGMLSpm module. I had to modify PERL, BINDIR and PERL5DIR to match my environment

# Where is the binary for perl5 located on your system?
PERL = /usr/bin/perl

# Where do you want the sgmlspl executable script to be installed?
BINDIR = /usr/bin

# Where do you put local perl5 libaries?
PERL5DIR = /usr/lib/perl5/site_perl

• install docbook-utils

After that building of documentation went smoothly :)