Quanta documentation symlinks pointig to none existing place

[Bèr Kessels (berkes)]

Binary package hint: quanta

In kubuntu, the orgininal package comes with documentation pre-installed. So it does not only point to khotnewstuff.

 However, these docs don't exist.

 beralt@penelope:/usr/share/apps/quanta/doc$ find -type l -exec ls -hal {} \;
 lrwxrwxrwx 1 root root 48 2006-10-28 15:16 ./html -> ../../../doc/wdg-html-reference/reference/html40
 lrwxrwxrwx 1 root root 45 2006-10-28 15:16 ./css -> ../../../doc/wdg-html-reference/reference/css
 lrwxrwxrwx 1 root root 34 2006-10-28 15:16 ./docbook -> ../../../doc/docbook-defguide/html
 lrwxrwxrwx 1 root root 24 2006-10-28 15:16 ./php -> ../../../doc/phpdoc/html

 However, under /usr/share/doc these entries (wdg-html-reference, docbook-defguide and phpdoc) are not existing.
 I searched for a package containing these files assuming quanta had a broken dependency in kubuntu, but that seemed not the case either.

 This seems to be a specific kubuntu issue, but it is annoying nonetheless.

See the (now closed) issue in KDE bugtracker here: http://bugs.kde.org/show_bug.cgi?id=140011

[Rich Johnson (nixternal)]

So it seems for Quanta we need to add the following dependencies:
 * php-doc (also change the link to ../../../doc/php-doc/html)
 * docbook-defguide
 * wdg-html-reference (no installation candidate)

the wdg-html-reference package would also complement the css link as well.

[Ricardo Pérez López (ricardo)]

According to:

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=266415

the wdg-html-reference is not DFSG free, so it was removed from the Debian archive.

It talks about the w3-recs package, which is DFSG compliant (although it's non-free, and resides in Ubuntu's multiverse).

[Andrew Lowe (bugzrevenge)]

This documentation is available from KDEs Hot New Stuff. Right-clicking in the documentation side-bar, and selecting "Download Documentation" will open the Hot New Stuff window to get documentation.

This does cause a problem, because it does not override the broken indexes, and you now have two indexes for some documentation libraries. To fix this you need to remove the broken indexes from /usr/share/apps/quanta/docs as 'root' (using sudo)

We have been discussing this bug on the Quanta Users mailing list, and Andras suggested the following:
1) fix the dependencies and install the missing documentations.
2) remove the documentations completely and allow the users to download
via hot new stuff. This way at least there won't be duplicate items.

Of course, 1) is the preferred.

[Vincenzo Ampolo (vincenzo-ampolo)]

I can confirm that installing php-doc package, the php documentation starts to work.
php-doc appears to be in suggest, it should be in recommends to have high visibility.

docbook-defguide is already on recommends and it's ok.

The package has also a "gubed" package which is unavailable, i tried to get infos about this pacakge, but debian does not know it: http://packages.debian.org/search?keywords=gubed&searchon=names&suite=all&section=all
So it should be removed.

But the worst problem is that, even if you install the w3-recs package, it seems not to be organized as the old wdg-html-reference. So quanta can't work with it.

Workaround:

You can still install the package (w3-recs) and look the documentation in a separate browser pointing at /usr/share/doc/w3-recs/html/index.html .

To solve this last problem i see two ways:
Contact upstream and say to use the files provided at w3-recs (it can also be done by a patch to the debian version only done by the maintainer) or try to fix the license issue with wdg-html-reference .

If someone tells me which way to follow i can start working on this bug. Please let me know.