Red Hat Bugzilla – Bug 134450
postgresql-docs include only sgml and broken Makefile
Last modified: 2013-07-02 23:02:26 EDT
From Bugzilla Helper: User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; rv:1.7.3) Gecko/20040928 Firefox/0.10 Description of problem: The postgresql-docs package includes only sgml source and a broken Makefile (i.e. needed includes have the wrong path or are missing.) Do you really expect the average user to build from sgml anyway? HTML should be fine, and the interested users can get the sgml source from the src rpm or tarball. This dir usually has HTML docs, so maybe this is just a regression. Version-Release number of selected component (if applicable): 7.4.5-2 How reproducible: Always Steps to Reproduce: 1. Try to find HTML docs in /usr/share/postgresql-docs-* 2. Try to build the sgml source with make 3. Actual Results: The build fails Makefile:6: ../../src/Makefile.global: No such file or directory make: *** No rule to make target `../../src/Makefile.global'. Stop. Expected Results: HTML files in /usr/share/doc/postgresql-docs-* Additional info:
The Postgres docs are actually included in the base 'postgresql' package, both as to html and man formats (look under /usr/share/doc/postgresql-7.4.5/html for the former, and in /usr/share/man for the latter). I'm honestly unclear on the point of including the SGML files in the distribution RPMs --- as you say, they can't be built into anything without additional parts of the original source tree, and the average user is unlikely to want to try. My inclination is to either do nothing or remove the sgml subdirectory and Makefile from this package.
*** Bug 139550 has been marked as a duplicate of this bug. ***
These files have been removed from the 8.0 packaging of PostgreSQL.
*** Bug 147897 has been marked as a duplicate of this bug. ***