[gentoo-dev] Docbook XML/XSL Fixes

[gentoo-dev] Docbook XML/XSL Fixes

[Mike Gardiner]

Hi,

Firstly I'd like to apologise for taking a while to get around to the
docbook-xml situation. I'm quite surprised things have survived this
long without too many errors, although the number of bugs related to
xsl-stylesheets have been steadily growing over the last month or so.
I'd like to outline the current problems, and my fixes for the
docbook-xml/xsl catalogs before I commit them, to allow for some
feedback.

For some bugzilla background, see bugs [1], [2], and [3] for
xsl-stylesheets, and [4] for an outline of the docbook-xml-dtd problem.
Keep in mind the two aren't mutually exclusive. The xsl-stylesheets
problems are almost certainly due to the references installed in
/etc/xml/catalog by docbook-xml-dtd's 'automagic' (or not) catalog
creating script, build-docbook-catalog.


The basic problems currently are:
o  incorrect build-docbook-catalog for docbook-xml-dtd-4.2
o  docbook-xml-dtd versions are slotted, but both install a common file
(build-docbook-catalog)
o  xsl-stylesheets installed versions not being reflected in the
catalog, of which the culprit is most likely,
o  multiple locations of the catalog definitions (the ebuilds
themselves, and build-docbook-catalog)


I'd like to address these issues in the following ways:
docbook-xml-dtd:
o  version 4.2 'build-docbook-catalog' script /fix
o  versioning the build-docbook-catalog script with SLOT as
build-docbook-catalog-${PVR}
o  remove the cataloging of the xsl-stylesheets from the
build-docbook-catalog-${PVR} scripts


docbook-xsl-stylesheets:
o  handle the stylesheets refs in /etc/xml/catalog in the
xsl-stylesheets ebuilds only, not in the build-docbook-catalog-${PVR}
scripts.
o  provide a common /usr/share/sgml/docbook/xsl-stylesheets symlink to
the currently installed version
o  refer to this symlink for the catalog reference 'current' in
/etc/xml/catalog.


I have implemented all of these fixes locally with success, but haven't
pushed the big red button on them yet, and would prefer some feedback
before I do. However, I also realise this stuff might not actually be of
interest to a lot of people, who would just dearly like it to work and
not make too much noise. 

The plan therefore will be to wait a short time, say until about midday
UTC Wednesday, before I plan on committing the changes (they will be in
~arch).

I'm open to all suggestions/flames/ideas,
Regards.

Mike
(Obz).

[1]: http://bugs.gentoo.org/show_bug.cgi?id=34811
[2]: http://bugs.gentoo.org/show_bug.cgi?id=32542
[3]: http://bugs.gentoo.org/show_bug.cgi?id=33151
[4]: http://bugs.gentoo.org/show_bug.cgi?id=17698


--
gentoo-dev@gentoo.org mailing list