From kde-core-devel  Wed May 19 20:53:16 2010
From: Albert Astals Cid <aacid () kde ! org>
Date: Wed, 19 May 2010 20:53:16 +0000
To: kde-core-devel
Subject: Re: DocBook XML & XSL: work in progess, new dependencies
Message-Id: <201005192153.16381.aacid () kde ! org>
X-MARC-Message: https://marc.info/?l=kde-core-devel&m=127430243604563

A Dijous, 13 de maig de 2010, David Hubner va escriure:
> On Saturday 01 May 2010 14:24:37 Luigi Toscano wrote:
> > Hi,
> > I'm currently working (with Albert) to remove the embedded copies of
> > DocBook XML and XSL (http://www.docbook.org/) from kdelibs/kdoctools.
> > This change (if accepted) will introduce two new dependencies (see
> > below).
> > I plan to complete this task before SC 4.5 will be released, but I won't
> > be able to commit all the changes before the dependency freeze.
> > 
> > The steps involved are:
> > 
> > 0) Use only one version of DocBook XML:
> >    * convert the remaining docbook manuals which uses the old DTD
> >    
> >      (V4.1.2) to V4.2 (done);
> >    
> >    * regenerate the translated docbooks (in progress);
> >    * remove the obsolete/ directory, which is needed only for DTD v4.1.2,
> >    
> >      from kdoctools/customization (planned for next week).
> > 
> > 1) Remove DocBook XML DTDs from kdoctools/docbook/ (xml-dtd-4.x) and
> > use the external ones. This step introduces a dependency on DocBook XML
> > DTDs, which are packaged on many distributions:
> > ArchLinux: docbook-xml
> > Debian & Ubuntu: docbook-xml
> > Fedora: docbook-dtds
> > Gentoo: docbook-xml-dtd-4.2-r2
> > Mandriva: docbook-dtd42-xml
> > OpenSuse: docbook_4
> > 
> > Status: the code is almost working, I will probably submit a new cmake
> > module to kde-buildsystem for review.
> > 
> > 
> > 2) Remove DocBooc XSL from kdocbook/docbook/xsl, move customizations to
> > kdoctools/customizaton. This step will introduce a dependency on DocBook
> > XSL, which are again packaged on many distributions.
> > 
> > Status: no code for this yet; this is the most complicated step, as the
> > customizations that have been directly made to kdoctools/docbook/xsl/
> > must be properly identified and moved to the proper place.
> > 
> > Please consider that those changes should not touch the "core" kdelibs at
> > all; only the generation of docbook will be affected.
> > 
> > Any comments/remarks?
> > 
> > Regards
> 
> On a side note, at the moment when i try and build a application manual
> search index in KHelpCenter KDE 4.4, i get the following error 
> "/usr/share/apps/ksgmltools2/customization/htdig_index.xsl line 38 element
> template xsltCompilePattern : failed to compile 'sect*/title'" for every
> help doc it tries to compile.
> 
> Will this be fixed with the removal of embedded copies? Or do i have to
> look at what is causing this and if broken patch it? :)
> 
> Thanks
> 
> PS: Can anyone else replicate this error? KHelpCenter->Search
> Options->Build Search Index?

I think this error is unrelated.

Albert