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)
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):
Steps to Reproduce:
1. Try to find HTML docs in /usr/share/postgresql-docs-*
2. Try to build the sgml source with make
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-*
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
*** 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. ***