Sounds like a plan to me, probably a stupid question but.... I presume they are compatible with gnome-doc-utils ? as quite a few components within gnome use gnome-doc-utils and xml2po for automatic generation of localized versions of help files.....
Just my 2 cents.. Matt Laszlo (Laca) Peter wrote: > 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 > > >
