[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