Patch: compiling the docs under Gentoo
Hi,
as a Gentoo user I had a hard time getting the documentation
compiled. Attached you will find a Patch explaining exactly this: how
to compile the documentation under Gentoo.
Best regards,
--
Christian Kruse http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services
Attachments:
gentoo_docs_patch.patchtext/x-diff; charset=us-asciiDownload
diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
index c9c9862..6133205 100644
--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -290,6 +290,24 @@ sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl lib
</sect2>
<sect2>
+ <title>Gentoo</title>
+
+ <para>
+ When using Gentoo setting up the tool chain is relatively easy:
+<programlisting>
+sudo emerge -av app-text/openjade app-text/docbook-sgml-dtd:4.2 app-text/docbook-dsssl-stylesheets app-text/docbook-xsl-stylesheets libxslt
+</programlisting>
+ Since Gentoo often supports different versions of a package to be
+ installed you have to tell the PostgreSQL build environment where the
+ Docbook DTD is located:
+<programlisting>
+cd /path/to/postgresql/sources/doc
+make DOCBOOKSTYLE=/usr/share/sgml/docbook/sgml-dtd-4.2
+</programlisting>
+ </para>
+ </sect2>
+
+ <sect2>
<title>Manual Installation from Source</title>
<para>
Christian Kruse wrote:
+ Since Gentoo often supports different versions of a package to be + installed you have to tell the PostgreSQL build environment where the + Docbook DTD is located: +<programlisting> +cd /path/to/postgresql/sources/doc +make DOCBOOKSTYLE=/usr/share/sgml/docbook/sgml-dtd-4.2 +</programlisting>
AFAICS this should be handled in config/docbook.m4 by adding
sgml/docbook/sgml-dtd-4.2 to the list already there. Maybe a wildcard
could be used to avoid the version dependency, not sure.
--
�lvaro Herrera http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services
--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers
On 1/30/14, 2:42 AM, Christian Kruse wrote:
+ Since Gentoo often supports different versions of a package to be + installed you have to tell the PostgreSQL build environment where the + Docbook DTD is located: +<programlisting> +cd /path/to/postgresql/sources/doc +make DOCBOOKSTYLE=/usr/share/sgml/docbook/sgml-dtd-4.2 +</programlisting>
This is wrong. DOCBOOKSTYLE points to the DSSSL style sheets, not the
DTD. The DTD should be found automatically using the SGML catalog
mechanism. (That's something that the package system should manage.)
--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers
Hi,
On Tuesday 11 February 2014 16:04:30 Peter Eisentraut wrote:
On 1/30/14, 2:42 AM, Christian Kruse wrote:
+ Since Gentoo often supports different versions of a package to be + installed you have to tell the PostgreSQL build environment where the + Docbook DTD is located: +<programlisting> +cd /path/to/postgresql/sources/doc +make DOCBOOKSTYLE=/usr/share/sgml/docbook/sgml-dtd-4.2 +</programlisting>This is wrong.
To be honest I noticed a few days ago that this is unnecessary. Just
installing the right packages already solved the problem, it was a
fallacy that setting DOCBOOKSTYLE did help.
I just didn't have had the time to send a new version of the patch,
yet…
Best regards,
--
Christian Kruse http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services