Bug 134450

Summary: postgresql-docs include only sgml and broken Makefile
Product: [Fedora] Fedora Reporter: Dave Cook <dave>
Component: postgresqlAssignee: Tom Lane <tgl>
Status: CLOSED RAWHIDE QA Contact: David Lawrence <dkl>
Severity: medium Docs Contact:
Priority: medium    
Version: 3CC: hhorak, rgorosito, scop
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2005-01-24 04:37:59 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Dave Cook 2004-10-02 21:13:31 UTC
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:

Comment 1 Tom Lane 2004-10-05 01:47:18 UTC
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.

Comment 2 Tom Lane 2004-12-08 22:41:46 UTC
*** Bug 139550 has been marked as a duplicate of this bug. ***

Comment 3 Tom Lane 2005-01-24 04:37:59 UTC
These files have been removed from the 8.0 packaging of PostgreSQL.

Comment 4 Tom Lane 2005-02-12 17:08:55 UTC
*** Bug 147897 has been marked as a duplicate of this bug. ***