More Info re: KDevelop Docs Problem

[Paul Derbyshire]

Okay. Here are some details, copied laboriously onto paper and then
laboriously into an email program in 'doze after a laborious 'doze boot.

In the documentation tree, the Qt and KDE library docs actually work now.

The other docs, for KDevelop itself and the C/C++ reference, don't work. I
know the latter has to be obtained separately from your FTP site; I got the
i386 linux rpm and installed it, and KDevelop still can't find it. It looks
for it and for all the stuff it can't find in
/usr/doc/kde/HTML/default/kdevelop, and there is no
/usr/doc/kde/HTML/default. Whereas the C/C++ reference apparently installs
in /opt/somewhere, and the KDE program guide itself is apparently supposed
to install in /ust/doc/kde/HTML/en/kdevelop.

It seems like the default versus en thing is a locale issue, except that
there is no setting in KDevelop for locale, and the KDE locale is (I
assume) set to English. Which means part of the problem is a bad hardcoded
path in KDevelop, where there should be either a configurable path or setup
code to make sure the hardcoded path exists and to copy the appropriate
documentation there, or the hardcoded path should be correct. That's not
all the problem however.

There is a directory structure under .../en/kdevelop, but it is a skeleton,
without any actual html files or other files in it! It looks as if the
directory structure is in the distribution, but the documentation itself is
missing.

So we have 3 problems, and all of them are problems with KDevelop itself,
not with the procedure I followed -- i.e. they are the fault of the guy who
packages the KDevelop RPMs, or maybe the KDevelop team itself.

1. Hardcoded path in KDevelop to C/C++ reference, which is wrong
   (/usr/doc/kde/HTML/default/kdevelop/reference, when the reference actually
   installs in /opt/something)
2. Hardcoded path in KDevelop to program documentation, also wrong
   (/usr/doc/kde/HTML/default/kdevelop, when the documentation actually
   installs in /usr/doc/kde/HTML/default/*your locale*/kdevelop
3. All the English-locale documentation files are missing in distribution,
   leaving just the directory structure under .../en/kdevelop.

The fixes are obvious:
1. Either hardcode the right path, or make it configurable with the default
the
   right path.
2. Either hardcode use of the KDE locale string in place of "default", or make
   it configurable with the default the KDE locale string.
3. For God's sake, in the next RPM you ship, include the actual HTML files and
   the needed images or other media in the en directory! (And in those for
   other locales -- or else, ship RPMs for various locales, with the locale in
   the name, i.e. kdevelop-1.3beta27-en.rpm, kdevelop-1.3beta27-fr.rpm,
   supposing it gets to beta 1.3 build 27.


Until then, does anyone know a workaround? I can make two symlinks to fix
the problem of the hardcoded paths, pointing one at the C/C++ reference and
the other at .../en/kdevelop, but of course I then need to obtain the
actual HTML files and their satellite files and store them under
.../en/kdevelop, in what is currently a skeleton directory structure.


-- 
   .*.  "Clouds are not spheres, mountains are not cones, coastlines are not
-()  <  circles, and bark is not smooth, nor does lightning travel in a
   `*'  straight line."    -------------------------------------------------
        -- B. Mandelbrot  |http://surf.to/pgd.net derbyshire at globalserve.net
_____________________ ____|________                          Paul Derbyshire
Programmer & Humanist|ICQ: 10423848|