Gideon from cvs kdex.dtd compilation comments

[kdevelop at lgeezer.net]

Summary
kdex.dtd outside of path causes make to fail in ./kdevelop/doc. Workaround and 
solution below. 

Suggestion: Gideon will compile just fine without ./doc; could a check be made 
for the availability of kdex.dtd, and if not found flash a warning but 
continue compiling? Failing that, as Googling on this problem turned up few 
answers (most of which were ambiguous or even wrong), a mention in the 
readme?



Detail: kdex.dtd outside of path cause make to fail in ./kdevelop/doc. 
('Release' compiled as per website)
 
Fail occurs at:
/usr/local/kde/bin/meinproc --check --cache index.cache.bz2 ./index.docbook

First 5 (of 4382) lines reported are
index.docbook:22: error: failed to load external entity "dtd/kdex.dtd"
]>
 ^
index.docbook:24: error: Entity 'language' not defined
<book lang="&language;">
                      ^
index.docbook:24: validity error: No declaration for attribute lang of element 
book
<book lang="&language;">
                       ^
index.docbook:27: validity error: No declaration for element title
<title>&kdevelop; Documentation</title>
                                      ^
index.docbook:29: validity error: No declaration for element date
<date>2002-11-25</date>
                      ^
index.docbook:30: validity error: No declaration for element releaseinfo
<releaseinfo>3.0</releaseinfo>
                             ^
Quick workaround:
In kdevelop/Makefile remove the reference to 'doc' at SUBDIR and TOPSUBDIR.
Make now completes as per notes on kdevelop site.

Solution:
I googled (eventually, this appears to be rare) a reference to a post by Jakob 
Simon to another list back in June at [1]. My solution is based on his:
1. find out where the file kdex.dtd is
$ locate kdex.dtd
...
/usr/local/kde/share/apps/ksgmltools2/customization/dtd/kdex.dtd
...
if locate doesn't work, try the slower
$ find / -name *kdex.dtd*

2. find out where the index.docbook files are
$ find . -name *index.docbook*
./kdearch/index.docbook
./kdevelop/index.docbook

3. And softlink them together
$ ln -s /usr/local/kde/share/apps/ksgmltools2/customization/dtd 
doc/kdearch/dtd
$ ln -s /usr/local/kde/share/apps/ksgmltools2/customization/dtd 
doc/kdevelop/dtd

4. And complete the make
$ make


Cheers, all
-- 
Alistair Mann

[1] 
http://barney.cs.uni-potsdam.de/pipermail/kdevelop-devel/2002-June/008575.html


-
to unsubscribe from this list send an email to kdevelop-request at kdevelop.org with the following body:
unsubscribe »your-email-address«