Bug 90559 - Gnome 1.4 documentation won't build from SGML sources (missing DTDs and utilities)
Summary: Gnome 1.4 documentation won't build from SGML sources (missing DTDs and utili...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Linux
Classification: Retired
Component: gnome-user-docs
Version: 7.3
Hardware: noarch
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Havoc Pennington
QA Contact:
URL: http://cvs.gnome.org/lxr/source/gnome...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2003-05-09 16:39 UTC by Leif Harcke
Modified: 2007-04-18 16:53 UTC (History)
0 users

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Clone Of:
Environment:
Last Closed: 2003-05-09 17:40:48 UTC
Embargoed:


Attachments (Terms of Use)

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.



Note You need to log in before you can comment on or make changes to this bug.