Bug 372973

Summary:	missing Help handbook
Product:	[Applications] kmail2	Reporter:	Nick Levinson <Nick_Levinson>
Component:	misc	Assignee:	kdepim bugs <kdepim-bugs>
Status:	RESOLVED DOWNSTREAM
Severity:	normal	CC:	lueck
Priority:	NOR
Version:	4.14.10
Target Milestone:	---
Platform:	Other
OS:	Linux
Latest Commit:		Version Fixed In:
Sentry Crash Report:

Description Nick Levinson 2016-11-27 00:09:31 UTC

Help > KMail Handbook produces a Help window that says:

Document Not Found
The URI ‘help:/kmail/index.html’ does not point to a valid page.
Search for packages containing this document.

I'm running KMail on openSuse 13.2 Linux, kept evergreen. I don't know if this is KMail2, but your bug tracking system doesn't list KMail as a product, so I guess this is the same thing.

Comment 1 Burkhard Lück 2016-11-27 13:43:04 UTC

in a fresh install of openSuse 13.2 in a virtual machine Help > KMail Handbook works for me and opens the KMail Handbook.
Do you have KHelpcenter installed?

Comment 2 Christoph Feck 2016-11-30 14:42:51 UTC

If you can provide the information requested in comment #1, please add a comment.

Comment 3 Nick Levinson 2016-12-03 02:43:00 UTC

Apparently I don't have KHelpCenter (it's not listed in the distro's Software app or when I search the apps on the laptop). Therefore, shouldn't the window say something about KHelpCenter, so users don't see a message that looks like a dead end and thus wind up trying to work without access to Help, maybe fruitlessly?

Comment 4 Christoph Feck 2016-12-07 14:51:15 UTC

As comment #1 says, the default installation of OpenSUSE 13.2 has KHelpCenter installed. If you removed it and got no dependency warning, please report this to the bug tracker of your distribution.

Comment 5 Nick Levinson 2016-12-10 21:33:48 UTC

I didn't remove it, as far as I know. I install everything in a distro, even stuff I don't want, specifically to preclude any dependency failure. I can ask a forum about why it might be missing.

Comment 6 Nick Levinson 2017-01-07 01:28:04 UTC

GUI/CLI followup (especially @Burkhard Lueck): Apparently, KHelpCenter is available but only through a command line interface (https://forums.opensuse.org/showthread.php/391430-Khelpcenter-for-OpenSuSE-where-do-I-find-it?p=1848523#post1848523) or the KDE Plasma Workspace (one graphical user interface), not the Gnome or IceWM desktop environment GUIs. I asked about the CLI preference at a forum (https://forums.opensuse.org/showthread.php/521603-why-need-CLI-console-to-use-GUI-KMail-Help?p=2803654#post2803654) before I knew it worked in KDE's DE but no one replied. Why isn't KHelpCenter working in whatever GUI desktop environment we happen to be using? Are you getting it in any GUI other than KDE? If not, then this may need an enhancement request somewhere, probably first within KDE to make KHelpCenter compatible with a competitor's GUI. An alternative would be a message that, instead of saying essentially that we can't use the help, would say to switch DEs.

Comment 7 Burkhard Lück 2017-01-08 17:13:38 UTC

Fresh install of Ubuntu 16.04.01 (with the default Gnome desktop environment) in a VM.
Then I installed KMail, KHelpcenter was not a dependency and not installed. The Help actions in KMail opened docs.kde.org.
Next I installed KHelpcenter, now the Help actions in KMail opened KHelpcenter as expected.
Due to https://bugs.kde.org/show_bug.cgi?id=374756 the correct docbooks was not displayed, but in fact Ubuntu got it right. This is clearly a openSUSE issue.

Comment 8 Nick Levinson 2017-01-10 00:52:48 UTC

I'm following up other there:

https://bugzilla.opensuse.org/show_bug.cgi?id=1018970

Thank you for your work.