Bug 274892

Summary: Some but not all help files cannot be located by KDE Help Center
Product: [Websites] docs.kde.org Reporter: Jim <guilfordstuff>
Component: generalAssignee: Documentation Editorial Team <kde-doc-english>
Status: RESOLVED DOWNSTREAM    
Severity: normal CC: lueck
Priority: NOR    
Version: 0.5   
Target Milestone: ---   
Platform: openSUSE   
OS: Linux   
Latest Commit: Version Fixed In:
Sentry Crash Report:
Attachments: Shot of KDE Help Center failing to find help file
kwincompositing/index.docbook

Description Jim 2011-06-04 10:48:02 UTC
Created attachment 60603 [details]
Shot of KDE Help Center failing to find help file

Version:           4.6 (using KDE 4.6.3) 
OS:                Linux

Control center module help files can't be located.  Returns error: The requested help file could not be parsed:<br/>/usr/share/doc/kde/HTML/en//kcontrol/kwincompositing/index.docbook

Reproducible: Didn't try

Steps to Reproduce:
Open KDE Help Center
Select Control Center Modules in left window
Select any of the control center modules to display its help file

Actual Results:  
Can't parse the location of the help file.
Comment 1 Burkhard Lück 2011-06-05 08:00:08 UTC
Works on http://docs.kde.org/stable/en/kdebase-workspace/kcontrol/kwincompositing/index.html an master/branch 4.6.3 compiled from sources here.

Please attach your kwincompositing/index.docbook
Comment 2 Jim 2011-06-05 13:56:43 UTC
Created attachment 60658 [details]
kwincompositing/index.docbook

Don't know why you want it, but, here you go.
Comment 3 Burkhard Lück 2011-06-05 22:04:22 UTC
(In reply to comment #2)
> Created an attachment (id=60658) [details]
> kwincompositing/index.docbook
> 
> Don't know why you want it, but, here you go.

You reported the error message "The requested help file could not be parsed"

I have docbook-xsl 1.75.2+dfsg-5 (Kubuntu 10.10), which version of docbook-xsl does your system have?
Comment 4 Jim 2011-06-05 23:53:37 UTC
Lueck:  You're being a bit too literal.  All the Control Center
Modulest couldn't resolve their help files.  It's not just this one.
Clearly  the help files are there.  The error message in the
screenshot has a filename prefaced with <br/>.  I suspect this is why
it can't resolve.  Someone left an html tag open or some such thing.

On 6/5/11, Burkhard Lueck <lueck@hube-lueck.de> wrote:
> https://bugs.kde.org/show_bug.cgi?id=274892
>
>
>
>
>
> --- Comment #3 from Burkhard Lueck <lueck hube-lueck de>  2011-06-05
> 22:04:22 ---
> (In reply to comment #2)
>> Created an attachment (id=60658)
>  --> (http://bugs.kde.org/attachment.cgi?id=60658) [details]
>> kwincompositing/index.docbook
>>
>> Don't know why you want it, but, here you go.
>
> You reported the error message "The requested help file could not be parsed"
>
> I have docbook-xsl 1.75.2+dfsg-5 (Kubuntu 10.10), which version of
> docbook-xsl
> does your system have?
>
> --
> Configure bugmail: https://bugs.kde.org/userprefs.cgi?tab=email
> ------- You are receiving this mail because: -------
> You reported the bug.
>
Comment 5 Burkhard Lück 2011-06-06 08:22:15 UTC
@Jim:
Please confirm/answer the following questions to help tackling down this issue:

* You get this error with help files for systemsettings modules, KIoslaves,  Online Help (docbook articles)?

* You can view the handbooks for applications, like e.g. Kate, Kwrite, Dolphin, Konqueror (docbook books), but the "Next" and "Previous" buttons at the top/bottom of the pages are missing?

* You have a docbook-xsl package version !=1.75.x, maybe version 1.76?

Thanks.
Comment 6 Jim 2011-06-06 16:37:02 UTC
I didn't have docbook-xsl installed.  Nothing required it.
docbook-xsl 1.75 is now installed and things work.  It's a little slow
on the rendering but something eventually comes up for all the
terminal branches of the help tree.  Unless you want to check
something else, this was probably an opensuse issue.  I installed base
x64_64 11.4 and then upgraded to KDE 4.6.3 using repositories set up
for that purpose.  This is a new system, and, I haven't been removing
packages, so, it probably never got installed.


On 6/6/11, Burkhard Lueck <lueck@hube-lueck.de> wrote:
> https://bugs.kde.org/show_bug.cgi?id=274892
>
>
>
>
>
> --- Comment #5 from Burkhard Lueck <lueck hube-lueck de>  2011-06-06
> 08:22:15 ---
> @Jim:
> Please confirm/answer the following questions to help tackling down this
> issue:
>
> * You get this error with help files for systemsettings modules, KIoslaves,
> Online Help (docbook articles)?
>
> * You can view the handbooks for applications, like e.g. Kate, Kwrite,
> Dolphin,
> Konqueror (docbook books), but the "Next" and "Previous" buttons at the
> top/bottom of the pages are missing?
>
> * You have a docbook-xsl package version !=1.75.x, maybe version 1.76?
>
> Thanks.
>
> --
> Configure bugmail: https://bugs.kde.org/userprefs.cgi?tab=email
> ------- You are receiving this mail because: -------
> You reported the bug.
>
Comment 7 Burkhard Lück 2011-06-08 15:16:14 UTC
(In reply to comment #6)
> I didn't have docbook-xsl installed.  Nothing required it.

docbook-xsl is a runtime requirement for the kde help systems since kde removed the internal copy of docbook-xsl in kde >4.5. Please report downstream.

> docbook-xsl 1.75 is now installed and things work.