[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-devel
Subject:    Re: meinproc fails to compile the docs (the libxml bug?)
From:       Randy Pearson <blueboy () bamafolks ! com>
Date:       2002-12-27 15:00:17
[Download RAW message or body]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi All,

I did some digging on this for my own projects which failed to produce 
documentation after moving up to the latest KDE cvs.

Some projects have index.docbook files that are still using an older DTD 
definition, like this:

<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" 
"dtd/kdex.dtd" [

They should be updated to use this declaration instead:

<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [

I think the real fix is to update the index.docbook files to use the newer 
V4.1.2/V1.1 declaration instead of the older V4.1/V1.0 version.

There is another work around however.  You can add the following lines to the 
end of kdelibs/kdoctools/customization/catalog (source code) or 
$KDEDIR/share/apps/ksgmltools2/customization/catalog (binary):

- -- DocBook 4.1 KDE Variant V1.0 --

PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN"
       "obsolete/kdex-412-10.dtd"

That will allow meinproc to use the "obsolete/kdex-412-10.dtd" whenever the 
older V4.1/V1.0 declaration is used.  So far everything I've built works fine 
that way.

Hope this helps,
Randy

On Friday 27 December 2002 07:26 am, Malte S. Stretz wrote:
> Hi,
>
> I'll take Bug 51952 [1] to this list.
>
> I've got two different machines where the compilation of the docs fails.
> The problem is that meinproc can't find the kdex.dtd. Symlinking the dtd
> dir into the dir where index.docbook dwells is a workaround.
>
> I tried to compile
>   kdelibs 3.1-rc{3,5} on Gentoo 1.4, libxml2 2.4.30 (compiled from sources)
> and
>   kdevelop-3.0-alpha1 on SuSE 7.3, KDE 3.0.5, libxml 2.4.23 (SuSE RPMs).
>
> Both failed.
>
> Coolo says it's a bug in my installation but I did everything as described
> on the "compiling KDE" pages. Either I'm too stupid and can't see the wood
> for the trees or it must be a bug in either meinproc or the Makefiles.
>
> I don't really care if it's really a bug as I know the workaround but I
> think it should be possible to pin it down and have configure check for
> this probable "bug in my installation". Esp. can configure check for a
> known-bad version of libxml2 (2.4.26 - 2.4.28, I think), I'll attach a
> patch for kdelibs to do so. Hmmm... the current configure does only spit
> out a warning if no working libxml is found, maybe this could be changed in
> a way that the compilation of the docs is skipped?
>
> For more information see [1].
>
> Regards,
> Malte
>
> [1]http://bugs.kde.org/show_bug.cgi?id=51952

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)

iD8DBQE+DGsK9OOSVYFT6BQRAqBAAKCX9Jv2+I98jNjbNIlLF60py/T7zACguneB
kM5xjgT6ECWUmPyN9sMNSC8=
=GAkI
-----END PGP SIGNATURE-----


>> Visit http://mail.kde.org/mailman/listinfo/kde-devel#unsub to unsubscribe <<
[prev in list] [next in list] [prev in thread] [next in thread]