[kde-doc-english] [Bug 78597] links in kioslave documentations are dead

[Burkhard Lueck]

------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
         
http://bugs.kde.org/show_bug.cgi?id=78597         




------- Additional Comments From lueck hube-lueck de  2007-02-07 23:57 -------
Very confusing comments to this bugreport, until I realized, that there are 
different views for ioslave documentation.

To clarify the situation, here a list of all different views of ioslave 
documentation on a system with 3.5.6 compiled from sources with all kde main 
modules:

1. minicli or konquerors location bar: help:/kioslave/index.html
IO-Slaves
Table of Contents
list of links to all ioslave documentation in kdebase: 
bzip, bzip2, cgi, data, file, finger, fish, floppy, ftp, gopher, gzip, 
help, http, https, imap, imaps, info, lan, ldap, mac, mailto, 
man, mrml, news, nfs, nntp, pop3, pop3s, print, rlan, rlogin, sftp, 
smb, smtp, tar, telnet, thumbnail, webdav, webdavs, zip (added by me)

usual helpcenter view with blue header and footer with "Would you like... KDE 
Docs Team" + Prev, Next, Up+Home. 
Next + Prev links work.
Up and Home both link to help:/kioslave/index.html, one should be removed

gopher no longer in the kde main modules, lives now 
in /extragear/network/kio_gopher/gopher.protocol, docs should be moved 
to /extragear/network/doc

Some docs are for ioslaves outside kdebase:
kdenetwork (lan, rlan), kdepim (imap, imaps,news), kdegraphics (mrml)


2. khelpcenter->Kioslaves
list of all ioslaves from no 1 + audiocd (I have a fix for 106066)
+ other ioslaves (ar, groupwise, groupwises, mbox, nntps, nxfish)
missing from no 1 gopher, help, smb

ioslave documentation articles from kdebase + audiocd + nntps (link to nntp 
docs) + nxfish (link to fish docs)

View as in no 1.
Prev + Next link work, Home+Up->help:/kioslave/index.html
audiocd has no Prev, Next, Home, Up links

No docs for ar + groupwise[s], error message
"Could not find filename foo.html in 
file:///$KDEDIRS/share/doc/HTML/en//kioslave/foo.html"
No docs for mbox, error message
"There is no documentation available for /index.html."


3. kcmshell ioslaveinfo or KInfocenter->Protocols
list of all ioslaves from no 1 + about, aim, applications, ar, atlantik, 
audiocd, camera, feed, fonts, ghelp, groupwise, groupwises, invitation, irc, 
jabber, ldaps, mbox, media, metainfo, mms, mmst, mmsu, ms-its, nntps, nxfish, 
perldoc, pnm, printdb, programs, pydoc, rdp, remote, rtsp, rtspt, rtspu, 
settings, sieve, smpts, ssh, svn, svn+file, svn+htp, svn+https, svn+ssh, 
system, trash, vnc, webcal, zeroconf, zip.

missing from no 1 gopher, smb.

ar+audiocd no message, all others "Some info about protocol foo:/ ..."

ioslave docs from kdebase/docs are displayed, but wrong:
Prev+Next -> opens file:///home/kdestable/foo.html in konqueror
Home+Up -> opens file:///home/kdestable/index.html
no blue header or footer bar, Next,Home,Up scrambled, two grey squares at 
bottom left (are this the blue header and footer bars?)
and 
"Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team" at bottom

no ar + audiocd docs? Why?


4. helpcenter->Information->Protocols + 
khelpcenter->KInfoCenterModules->Protocols open 
help:/kinfocenter/protocols/index.html


Bugs in the views:
no 1: gopher doc is obsolete, Home+Up are the same link.
no 2: Prev,Next,Home,Up links work, but only for ioslave docs from kdebase, 
docs from other modules like audiocd do not have this link, this is 
irritating.
no 3: scrambled view, links not working. Even with working links this a very 
confusing view, as the links Prev+Next do not correspond to the list on the 
left, but to the order in view no 1. 

Possible solution:
Change all ioslave documentations from articles to complete documentations, 
remove kioslave/index.docbook and view no 1.
Move all docs for ioslaves outside kdebase from kdebase to the corresponding 
modules as I have done for audiocd.

In all other views (no 2 and 3) navigate with the list on the left as in a lot 
of configuration dialogs.