Red Hat Bugzilla – Bug 90559
Gnome 1.4 documentation won't build from SGML sources (missing DTDs and utilities)
Last modified: 2007-04-18 12:53:38 EDT
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):
Steps to Reproduce:
1.try to build any Gnome 1.4 documentation which uses the PNG Variant DTD
Actual Results: document doesn't build
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
so it probably isn't necessary to include the style sheet in the package.
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.
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.