Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 90559

Summary:	Gnome 1.4 documentation won't build from SGML sources (missing DTDs and utilities)
Product:	[Retired] Red Hat Linux	Reporter:	Leif Harcke <lharcke>
Component:	gnome-user-docs	Assignee:	Havoc Pennington <hp>
Status:	CLOSED CURRENTRELEASE	QA Contact:
Severity:	medium	Docs Contact:
Priority:	medium
Version:	7.3	Keywords:	FutureFeature
Target Milestone:	---
Target Release:	---
Hardware:	noarch
OS:	Linux
URL:	http://cvs.gnome.org/lxr/source/gnome-docu/gdp/gnome-doc-tools/
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2003-05-09 17:40:48 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 Leif Harcke 2003-05-09 16:39:47 UTC

From Bugzilla Helper:
User-Agent: Mozilla/5.0 Galeon/1.2.6 (X11; Linux i686; U;) Gecko/20020913

Description of problem:
This is a request for the gnome-doc-tools package, which is missing from Red
Hat.  This omission only affects developers who try to build Gnome 1.4
documentation from SGML sources.  Currently there is no Red Hat package which
contains the DTDs, style sheet, and tools needed to build Gnome documentation. 
Gnome 1.4 documentation used the Docbook 3.0 and 3.1 templates, which did not
originally support PNG files.  The gnome-doc-tools package patches the DocBook
3.0/3.1 to allow PNG files in documents.

Version-Release number of selected component (if applicable):
gnome-user-docs-1.4.1-1

How reproducible:
Always

Steps to Reproduce:
1.try to build any Gnome 1.4 documentation which uses the PNG Variant DTD


Actual Results:  document doesn't build

Additional info:

The gnome-doc-tools package contains the SGML DTD's which modify the standard
DocBook 3.0 and 3.1 DTD's to allow for PNG files to be included in DocBook SGML
files.  It also contains a style sheet for building Gnome documentation

Red Hat already contains a modified version of this style sheet
  /usr/share/sgml/docbook/utils-0.6.9/docbook-utils.dsl
so it probably isn't necessary to include the style sheet in the package.

Comment 1 Havoc Pennington 2003-05-09 17:40:48 UTC

I'm pretty sure we did have a way to build these docs at some point. 
We may have just added the PNG patches to our standard docbook rpms or something.

In any case, 1.4 is in "obsolete don't touch it" mode; the applications from 1.4
have been gone for two releases. Adding a new package at this point doesn't 
make sense to me. You already have to download a lot of third-party stuff
to get a working GNOME 1.4 with RHL 8 or RHL 9.
Basically, issue no longer applies to the current release.

Comment 2 Leif Harcke 2003-05-09 18:18:28 UTC

OK, Gnome 1.4 is history. An issue with the style sheet in docbook-utils
(#90452) was turned away for a similar reason.  We'll probably be upgrading to
RHL 9.1 when it comes out in a few months, anyway.  In the meantime, we've got
one machine patched to build documentation using the DocBook 3.1 PNG Variant
DTD.  Thanks much.