manual pages not installed correctly

[Morten Kjeldgaard]

Binary package hint: postgresql-8.3

The manual pages are not installed in /usr/share/man as required by policy section 12.1. Instead, they are installed in /usr/share/postgresql/8.3/man/man1/, which means they cannot be read by man without doing funny stuff to the MANPATH.

I have verified this to be the case for package, postgresql-client-8.3_8.3.5-0ubuntu8.10 from Intrepid Ibex.

[Morten Kjeldgaard (mok0)]

This patch makes the build put manpages in the /usr/man/ tree. Also adds clean target to remove temp cdbs files.

[Morten Kjeldgaard (mok0)]

PS: The above patch is for jaunty version.

[Colin Watson (cjwatson)]

This looks clearly wrong; it will result in conflicts between different postgresql-client-* packages (8.2, 8.3, etc.), which are currently coinstallable.

Isn't this already handled in the postinst? I see a _link_manpages function in /usr/share/postgresql-common/maintscripts-functions, which seems to be doing appropriate things with alternatives.

[Morten Kjeldgaard (mok0)]

I don't see why you'd want to co-install different versions of postgresql-client? Perhaps I'm missing something.

If the package is supposed to do things with alternatives (thanks for pointing it out, I missed that) it is not working. I noticed this bug on my own machine, when I needed to consult the manpages they were not found.

I will investigate a bit further.

[Martin Pitt (pitti)]

It's fine as they are. postgresql-common deals with making them available in the "normal" manpath for the latest version.

[Martin Pitt (pitti)]

Morten, please see http://people.debian.org/~mpitt/architecture.html for the general idea of postgresql-common.

[Morten Kjeldgaard (mok0)]

Thanks for the URL, a good read. The upgrade path of postgresql is indeed very clever! I used to have lots of problems with it on Redhat-derived systems in the past.

The alternatives are apparently screwed up on my system, I've now fixed it for postgresql and the manpages show up as they should.