Version: (using KDE Devel) Installed from: Compiled sources OS: Linux Currently, the kio_audiocd help does not show up in help center. I think renaming kdemultimedia/doc/kio_audiocd to kdemultimedia/doc/kioslave should solve that, but I have not tested it myself. All kioslave help files are installed in $KDEDIR/share/doc/HTML/??/kioslave, but the audiocd ioslave has its own directory ($KDEDIR/share/doc/HTML/??/kio_audiocd).
You could also check and adapt the help path (DocPath) defined in the .protocol file instead of moving the documentation. (Assuming that the documentation is installed at the right place.) Have a nice day!
To anybody who has SVN access: Please rename this folder now so the issue can be resolved!
SVN commit 432745 by thiago: Renaming the directory. This looks like the proper solution and is in line with other kioslaves' documentation files. The docbook should now get installed in $KDEDIR/share/doc/HTML/en/kioslave (which is what DocPath points to anyways). BUG:106066 D kio_audiocd (directory) A kioslave (directory) kio_audiocd#432743
With KDE 3.4.1, I made this directory move (kio_audiocd --> kioslave), regenerated the build files, and rebuilt kdemultimedia. audiocd.docbook was installed in the proper kioslave directory, but it was still not accessible from the KInfoCenter, or the KHelpCenter. So either I've missed something, or this isn't the complete fix. Thanks for any help, Christopher Martin
I also don't see it. I am re-opening it till I can figure out what is wrong.
I'm working on kio_locate, and I've sort of the same problem as kio_audiocd (though the documentation does show up for kio_locate; the doc path is set correctly). I noticed that in the kioslave documentation directory, there's only one index.cache.bz2 for ALL kioslaves. I think meinproc must be run after installation in the kioslave directory to update / regenerate index.cache.bz2 Just my 0.02 cent though..
On Friday 19 August 2005 11:48, Tobi Vollebregt wrote: (...) > I'm working on kio_locate, and I've sort of the same problem as > kio_audiocd (though the documentation does show up for kio_locate; the doc > path is set correctly). > > I noticed that in the kioslave documentation directory, there's only one > index.cache.bz2 for ALL kioslaves. That is an interesting observation. So according to this only the help generated from kdebase/doc/kioslave would work. > I think meinproc must be run after > installation in the kioslave directory to update / regenerate > index.cache.bz2 That is not possible, as they are different packages. (you could not do this with binary packages.) So perhaps the solution is more to offer a complete documentation for each kioslave. (Currently they are only "articles".) > > Just my 0.02 cent though.. Seems to be worth more ;-) Have a nice day!
It seems to be a general documentation problem, so change the product. (However I am not sure if it can be solved for KDE 3.5, if we need to change the full KIO documentation.) Have a nice day!
See also bug #78597
It seems that $KDEDIR/share/doc/HTML/en/kioslave/index.docbook needs to be regenerated when new ioslaves are installed, but I can't work out what's responsible for generating the index.docbook file.
There are two ways to make the documentation and all translations visible in khelpcenter again: 1. Move audiocd.docbook back to kdebase/doc/kioslaves Add audiocd to index.docbook Tell the translators to move their translations also and regenerate the language docbooks too and regenerate the documentation of kioslave audiocd is the only kioslave documentation outside kdebase and there some more kioslave documentations from other kdemodules (kdenetwork: lan, rlan; kdepim: imap, imaps, news; kdegraphics: mrml) in kdebase 2. Change audiocd.docbook from an article to a complete documentation Adjust the DocPath in audiocd.docbook I want to fix this bug, what is the preferred solution? For me it is no 1, but mainly because that fix is already running in my system, no problem to commit a patch for solution no 2. In stable this can only be fixed in a docmessage unfreeze for 3.5.7.
The underlying problem is the way that kioslaves are handled in khelpcenter. Ideally, we should fix that, but I think solution no 2 is a good workaround, especially since audiocd:/ is a bit more of an "end-user" tool than other kioslaves. We'll have to look into this for KDE 4. Burkhard, can you make and commit a patch for solution no. 2? If you don't have time, I can do it.
I have changed the audiocd.docbook from an article to a complete documentation, and get it installed and meinproc generates an index.cache.bz2. But it is only accessible via help:/kio_audiocd, I try to find the right way to see it in khelpcenter->Kioslaves. I will do it together with some more error fixes for khelpcenter: Applet Manuals is empty, ktimemon and kolourpicker from kdeaddons are missing Move KHexEdit from Utilities->File to Utilities->Editors Window Behavior + Window-Specific Settings and some other odd things in khelpcenter
SVN commit 883365 by lueck: reorganize the kioslave documentation: documentation source has to be now in modul/doc/kioslave/name_of_ioslave/index.docbook and has to be installed now to INSTALL_DESTINATION /en SUBDIR kioslave/name_of_ioslave change the existing docs to separate index.docbooks join bip/bzip2 into one docbook, same for http/https, webdav/webdavs imap/imaps pop3/pop3s move the documentation to the moduls where the code lives: data, file, ftp, help, http, mailto, rlogin, telnet, webdav into kdelibs imap, ldap, nntp, pop3, smtp into kdepimlibs news into kdepim gopher into extragear/network the other docs stay in kdebase/runtime and are moved inside kdebase/runtime to doc/kioslave/name_of_ioslave/index.docbook move the audiocd doc in kdemultimedia to doc/kioslave/audiocd/index.docbook remove the documentation for lan, rlan mac, mrml, no ioslaves in kde4 adjust the X-DocPath entry in all ioslave protocol files according to the move of the doc adapt kdebase/apps/kinfocenter/ioslaveinfo/kcmioslaveinfo.cpp and l10n-kde4/scripts/autogen.sh to the new install location BUG:106066 M +2 -0 doc/CMakeLists.txt A doc/kioslave (directory) A doc/kioslave/CMakeLists.txt AM doc/kioslave/data (directory) A doc/kioslave/data/CMakeLists.txt AM doc/kioslave/data/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/data.docbook#866038 A doc/kioslave/file (directory) AM doc/kioslave/file/CMakeLists.txt AM doc/kioslave/file/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/file.docbook#866038 AM doc/kioslave/ftp (directory) A doc/kioslave/ftp/CMakeLists.txt AM doc/kioslave/ftp/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/ftp.docbook#866038 A doc/kioslave/help (directory) AM doc/kioslave/help/CMakeLists.txt AM doc/kioslave/help/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/help.docbook#866038 A doc/kioslave/http (directory) AM doc/kioslave/http/CMakeLists.txt AM doc/kioslave/http/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/http.docbook#866038 A doc/kioslave/mailto (directory) AM doc/kioslave/mailto/CMakeLists.txt AM doc/kioslave/mailto/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/mailto.docbook#866038 A doc/kioslave/rlogin (directory) AM doc/kioslave/rlogin/CMakeLists.txt AM doc/kioslave/rlogin/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/rlogin.docbook#866038 A doc/kioslave/telnet (directory) AM doc/kioslave/telnet/CMakeLists.txt AM doc/kioslave/telnet/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/telnet.docbook#866038 A doc/kioslave/webdav (directory) AM doc/kioslave/webdav/CMakeLists.txt AM doc/kioslave/webdav/index.docbook trunk/KDE/kdebase/runtime/doc/kioslave/webdav.docbook#866038 M +1 -0 kdoctools/help.protocol M +1 -1 kio/data.protocol M +1 -1 kio/misc/kmailservice.protocol M +1 -1 kio/misc/rlogin.protocol M +1 -1 kio/misc/telnet.protocol WebSVN link: http://websvn.kde.org/?view=rev&revision=883365