GNOME Bugzilla – Bug 487727
DocBook XML DTD version
Last modified: 2008-06-24 13:18:42 UTC
Maybe I'm totally off-base, and just don't see it, but... gtk-doc depends hard on DocBook XML DTD V4.1.2, whereas gnome-user-docs uses version 4.3. Can this be somehow unified, so one doesn't need to keep both around? In case I just missed something, please feel free to tell me. :)
I have lots of those installed: grep "DTD DocBook XML" /etc/xml/docbook-xml.xml <delegatePublic publicIdStartString="-//Norman Walsh//DTD DocBook XML V4.0//EN" catalog="file:///usr/share/xml/docbook/schema/dtd/4.0/catalog.xml"/> <delegatePublic publicIdStartString="-//OASIS//DTD DocBook XML V4.1//EN" catalog="file:///usr/share/xml/docbook/schema/dtd/4.1.2/catalog.xml"/> <delegatePublic publicIdStartString="-//OASIS//DTD DocBook XML V4.2//EN" catalog="file:///usr/share/xml/docbook/schema/dtd/4.2/catalog.xml"/> <delegatePublic publicIdStartString="-//Norman Walsh//DTD DocBook XML V3" catalog="file:///usr/share/xml/docbook/schema/dtd/3.1.7/catalog.xml"/> <delegatePublic publicIdStartString="-//OASIS//DTD DocBook XML V4.1.2//EN" catalog="file:///usr/share/xml/docbook/schema/dtd/4.1.2/catalog.xml"/> <delegatePublic publicIdStartString="-//OASIS//DTD DocBook XML V4.4//EN" catalog="file:///usr/share/xml/docbook/schema/dtd/4.4/catalog.xml"/> <delegatePublic publicIdStartString="-//OASIS//DTD DocBook XML V4.3//EN" catalog="file:///usr/share/xml/docbook/schema/dtd/4.3/catalog.xml"/> in the configure we probe against 4.1.2 and then the online one. Could you try the attached patch?
Created attachment 97627 [details] [review] try various version of the stylesheets works down from newest known version ...
Bah, the patch is non-sense. We're talking about the dtd version here and not abut the xsl-stylesheets. Of the later we prefer more recent versions. Regarding the dtd, there question is what benefits newser dtd bring? Bumping the dtd version could causes gtk-doc documents to become invalid (no idea if they remove tags). If you can find some usefull pointers regarding the changes, please let me know.
(In reply to comment #3) > Regarding the dtd, there question is what benefits newser dtd bring? The benefit of a common used version that I see is, that you don't need all different (used) versions installed, or tweak your catalog to hold *all* 4.x.y versions and make them point to a single install... I actually don't see any benefit in using a newer DTD, but a common one. > Bumping the dtd version could causes gtk-doc documents to become invalid > (no idea if they remove tags). > > If you can find some usefull pointers regarding the changes, please let me > know. My google foo suggests that there are no incompatability issues. This quote [1] is of particular interest: The OASIS DocBook Technical Committee (TC) observes a very cautious policy regarding changes to the DTD. Backward-incompatible changes can only be introduced: * In major releases (4.0, 5.0, 6.0, and so on) Changes made at point-releases are always backward-compatible to the previous major release. Other sources seem to state, that 4.x generally is in maintenance mode, with no backwards incompatible changes [2]. Also see the FAQ [3]. [1] http://www.faqs.org/docs/docbook/html/appc.html [2] http://www.docbook.org/specs/docbook-4.5-spec.html [3] http://www.dpawson.co.uk/docbook/reference.html#d17e1205
I found some concrete benefits, less validation errors. For gtk-doc 1.11 we'll switch to 4.3.
2008-06-24 Stefan Kost <ensonic@users.sf.net> * configure.in: * gtkdoc-mkdb.in: * tests/bugs/docs/tester-docs.xml: * tests/gobject/docs-tmpl/tester-docs.xml: * tests/gobject/docs/tester-docs.xml: Switch to docbook 4.3 dtd. Fixes #487727.