On Wed, 2007-02-07 at 10:03 +0000, Matt Keenan wrote: > 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.....
That's a good point. I will test a full build including docs and l10n before I commit, but AFAICT, the fedora packages include the same components but newer versions, and some more. Looking at the docbook web site, the subsequent docbook4 releases are supposed to be backward compatible, so I don't expect problems. Also, I assume that the fedora people also build the gnome docs (: Thanks, Laca > 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 > > > > > > >
