Patch: compiling the docs under Gentoo

Lists: pgsql-hackers
From: Christian Kruse <christian(at)2ndQuadrant(dot)com>
To: "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Patch: compiling the docs under Gentoo
Date: 2014-01-30 07:42:08
Message-ID: 20140130074208.GC3557@defunct.ch
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

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

Attachment Content-Type Size
gentoo_docs_patch.patch text/x-diff 983 bytes

From: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
To: Christian Kruse <christian(at)2ndQuadrant(dot)com>
Cc: "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Patch: compiling the docs under Gentoo
Date: 2014-01-30 18:11:32
Message-ID: 20140130181131.GD10723@eldon.alvh.no-ip.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

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


From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Christian Kruse <christian(at)2ndQuadrant(dot)com>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Patch: compiling the docs under Gentoo
Date: 2014-02-11 21:04:30
Message-ID: 52FA905E.1040704@gmx.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: 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.)


From: Christian Kruse <christian(at)2ndquadrant(dot)com>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Patch: compiling the docs under Gentoo
Date: 2014-02-12 08:52:59
Message-ID: 4576128.lmPIdPAqEv@sunshine
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: 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