Red Hat Bugzilla – Bug 90452
docbook-utils.dsl: %use-id-as-filename% #f breaks Gnome help documentation file names
Last modified: 2007-04-18 12:53:34 EDT
From Bugzilla Helper:
User-Agent: Mozilla/5.0 Galeon/1.2.6 (X11; Linux i686; U;) Gecko/20020913
Description of problem:
Turning off %use-id-as-filename% in the docbook-utils.dsl stylesheet has broken
the standard filename structure when building Gnome help documentation for Balsa
(and probably other applications).
Version-Release number of selected component (if applicable):
Steps to Reproduce:
0.install Gnome PNG DocBook DTD's for DocBook 3.0 and 3.1
1.download balsa-1.4.3.tar.bz2 (or earlier versions)
2.unpack and cd balsa-1.4.3/help/C
3.jw -o balsa balsa.sgml
Actual Results: ls balsa/*.html
Expected Results: authors.html
from the ChangeLog for docbook-utils:
2002-05-01 Tim Waugh <email@example.com>
* docbook-utils.dsl: Turn off %use-id-as-filename%.
Why was it turned off?
Use a custom stylesheet, or just use -V (like the docbook-utils tarball does
itself when building). No bug here.
*** Bug 90464 has been marked as a duplicate of this bug. ***
Sorry about the duplicate bug submission, first time bugzilla user.
There is another problem with building Gnome documentation, that being
the PNG Variant 3.0 and 3.1 DTD's aren't included in Red Hat anywhere.
The question is, should this be reported as a problem with docbook-dtds, or with
one of the Gnome packages, such as gnome-user-docs? Perhaps a new package is
called for, gnome-user-docs-devel, which contains the DTDs and the Gnome
documentaton specific stylesheet?
Against gnome-user-docs I think; yes, a new package probably would be the way to go.