[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-core-devel
Subject: Re: DocBook XML & XSL: work in progess, new dependencies
From: David Hubner <hubnerd () ntlworld ! com>
Date: 2010-05-13 22:25:36
Message-ID: 201005132225.36674.hubnerd () ntlworld ! com
[Download RAW message or body]
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?
--
David Hubner
IRC: hubnerd
MSN: hubnerd@hubnerd.org
ICQ: 24308559
[Attachment #3 (text/html)]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html><head><meta name="qrichtext" content="1" /><style type="text/css">
p, li { white-space: pre-wrap; }
</style></head><body style=" font-family:'Sans Serif'; font-size:10pt; font-weight:400; \
font-style:normal;"> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">On Saturday 01 May \
2010 14:24:37 Luigi Toscano wrote:</p> <p style=" margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> \
Hi,</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> I'm currently working (with \
Albert) to remove the embedded copies of DocBook </p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> XML and XSL (http://www.docbook.org/) from kdelibs/kdoctools. This \
change (if </p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> accepted) will \
introduce two new dependencies (see below).</p> <p style=" margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> \
I plan to complete this task before SC 4.5 will be released, but I won't be</p> <p style=" \
margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; \
text-indent:0px; -qt-user-state:0;">> able to commit all the changes before the dependency \
freeze.</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> </p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> The steps involved are:</p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> </p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> 0) Use only one \
version of DocBook XML:</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> * convert the \
remaining docbook manuals which uses the old DTD</p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> (V4.1.2) to V4.2 (done);</p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> * regenerate the translated docbooks (in progress);</p> <p style=" \
margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; \
text-indent:0px; -qt-user-state:0;">> * remove the obsolete/ directory, which is needed \
only for DTD v4.1.2,</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> from \
kdoctools/customization (planned for next week).</p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> </p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> 1) Remove \
DocBook XML DTDs from kdoctools/docbook/ (xml-dtd-4.x) and</p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> use the external ones. This step introduces a dependency on DocBook XML \
DTDs, </p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> which are packaged on many \
distributions:</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> ArchLinux: \
docbook-xml</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> Debian & \
Ubuntu: docbook-xml</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> Fedora: \
docbook-dtds</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> Gentoo: \
docbook-xml-dtd-4.2-r2</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> Mandriva: \
docbook-dtd42-xml</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> OpenSuse: \
docbook_4</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> </p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> Status: the code is almost working, I will probably submit a new cmake \
module</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> to kde-buildsystem for review.</p> \
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> </p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> </p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> 2) Remove \
DocBooc XSL from kdocbook/docbook/xsl, move customizations to </p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> kdoctools/customizaton. This step will introduce a dependency on \
DocBook XSL, </p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> which are again \
packaged on many distributions.</p> <p style=" margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> \
</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> Status: no code for this yet; this \
is the most complicated step, as the </p> <p style=" margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> \
customizations that have been directly made to kdoctools/docbook/xsl/ must be </p> <p style=" \
margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; \
text-indent:0px; -qt-user-state:0;">> properly identified and moved to the proper place.</p> \
<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> </p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> Please consider that those changes should not touch the \
"core" kdelibs at</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> all; only the \
generation of docbook will be affected.</p> <p style=" margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> \
</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> Any comments/remarks?</p> <p \
style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> </p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">> Regards</p> <p style=" margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">> \
</p> <p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;"></p> <p style=" \
margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; \
text-indent:0px; -qt-user-state:0;">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 "<span \
style=" font-style:italic;">/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. </span></p> <p style="-qt-paragraph-type:empty; margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0; font-style:italic;"></p> <p style=" margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">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? :) </p> <p style="-qt-paragraph-type:empty; margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;"></p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">Thanks</p> <p \
style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;"></p> <p style=" \
margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; \
text-indent:0px; -qt-user-state:0;">PS: Can anyone else replicate this error? \
KHelpCenter->Search Options->Build Search Index?</p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">-- </p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; \
margin-right:0px; -qt-block-indent:0; text-indent:0px; -qt-user-state:0;">David Hubner</p> <p \
style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;">IRC: hubnerd</p> <p style=" \
margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; \
text-indent:0px; -qt-user-state:0;">MSN: hubnerd@hubnerd.org</p> <p style=" margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;">ICQ: 24308559</p></body></html>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic