Compile PostgreSQL documentation on Gentoo Linux

Christian Kruse

For my work on the huge pages patch for PostgreSQL I also had to write some documentation. This was the first time I did this, and so I didn't have a working documentation building environment. At first the PostgreSQL documentation seems fairly easy: install requirements, go to directory, type make:

<pre>sudo emerge -av app-text/openjade app-text/docbook-sgml-dtd app-text/docbook-dsssl-stylesheets app-text/docbook-xsl-stylesheets libxsltcd /home/ckruse/dev/postgresql/src/docmake</pre></code><p> But since Gentoo handles installation of different versions of packages, it wasn’t that easy. I always got this error message:</p><code><pre>openjade:postgres.sgml:3:55:W: cannot generate system identifier for public text “-//OASIS//DTD DocBook V4.2//EN”</pre></code><p> After reading some source code I finally got the solution: you need the 4.2 slot of the docbook SGML DTD:</p><code><pre>emerge app-text/docbook-sgml-dtd:4.2cd /home/ckruse/dev/postgresql/src/docmake</pre></code><p> After that everything just compiles well.</p>