Hi all,
1 What is it?
SUNWgnome-xml-share is a package that contains docbook sgml and xsl
stylesheets. It's used for generating the gtk-docs and the GNOME
html content and user guides.
2 Historical background
Given that there was (and is) no experise in the JDS team with this
stuff, we took that SuSE (8?) spec files and wrapped them into a
Solaris spec file, only changing whatever was absolutely necessary.
3 The problem
We have not upgraded or fixed any part of it since it was
created in February 2004. By now it fossilized, has lots of
bugs and no-one (including me) dares touch it. Speak up if
you do. The stylesheets we ship are no longer available anywhere
on the net and the maintainers advise against using them.
They may well be the reason for the gtk+ api doc build taking
hours(!). Having looked at the spec files and the sources today,
I think I would need a few weeks to come up to speed and I really
really don't want to waste that much time with this.
4 The proposal
Given that we still don't have any expertise in this area, I suggest
we dump the SuSE spec files and use the latest Fedora Core ones.
We could use the latest SuSE ones, but they are far more complicated
and generally uglier than the Fedora ones.
This will change the directory structure under /usr/share/sgml and
/usr/share/xml. (It's looks nice and tidy, unlike the current
SuSE heritage.) It will include more and more up-to-date stylesheets.
I'm planning to include the following FC6 packages:
docbook-dtds-1.0-30.1.src.rpm
docbook-style-dsssl-1.79-1.src.rpm
docbook-style-xsl-1.69.1-5.1.src.rpm
sgml-common-0.6.3-18.src.rpm
They seem pretty straight forward, and probably wouldn't require
any changes to work with pkgbuild. This would make it easy to
update to a newer set of FC rpms, should we need to do so.
These spec files come with a bunch of patches. Since we're not the
creators of these patches and don't really know their status,
I will declare them to be upsteam bug fixes, to keep my patch
statistics favourable.
5 Request
Before I start doing this, if you have any comments, objections, or
if you insist on doing this yourself, please let me know ASAP.
Thanks,
Laca
