Bug 374756 - Help docbook not found
Summary: Help docbook not found
Status: RESOLVED FIXED
Alias: None
Product: kmail2
Classification: Applications
Component: general (show other bugs)
Version: Git (master)
Platform: Other Linux
: NOR normal
Target Milestone: ---
Assignee: kdepim bugs
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-01-08 14:46 UTC by Burkhard Lück
Modified: 2017-01-09 05:56 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed In: 5.5.0


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Burkhard Lück 2017-01-08 14:46:13 UTC
Using Help->KMail Handbook or F1 the docbook for KMail is not found and KHelpcenter displays the "Documentation not found" page.
Possible fixes:
1) change the componentname in kaboutdata to kmail
~/src/pim/kmail(trunk)$ git diff src/
diff --git a/src/aboutdata.cpp b/src/aboutdata.cpp
index 9c356e5..9a380c9 100644
--- a/src/aboutdata.cpp
+++ b/src/aboutdata.cpp
@@ -360,7 +360,7 @@ static const about_data credits[] = {
 };
 
 AboutData::AboutData()
-    : KAboutData(QStringLiteral("kmail2"),
+    : KAboutData(QStringLiteral("kmail"),
                  i18n("KMail"),
                  QStringLiteral(KDEPIM_VERSION),
                  i18n("KDE Email Client"),

But this maybe have unwanted side effects?

2) Install into subdir kmail2
~/src/pim/kmail(trunk)$ git diff doc/kmail/CMakeLists.txt 
diff --git a/doc/kmail/CMakeLists.txt b/doc/kmail/CMakeLists.txt
index 381d075..7388d88 100644
--- a/doc/kmail/CMakeLists.txt
+++ b/doc/kmail/CMakeLists.txt
@@ -1 +1 @@
-kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kmail)
+kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kmail2)

For this fix the X-DocPath has to be changed as well and we have to "translate" kmail to kmail2 via scripts/documentation_paths or rename the folder doc/kmail to doc/kmail2, so that autogen.sh generates the correct install path for the translated docbooks.
Comment 1 Laurent Montel 2017-01-09 05:56:33 UTC
Git commit fa60adffbd7c8a10025968db57fb49b6f703c923 by Montel Laurent.
Committed on 09/01/2017 at 05:55.
Pushed by mlaurent into branch 'master'.

Fix Bug 374756 - Help docbook not found

FIXED-IN: 5.5.0
Thanks Burkhard Lueck to give me some potential patch

M  +1    -1    doc/CMakeLists.txt
R  +1    -1    doc/kmail2/CMakeLists.txt [from: doc/kmail/CMakeLists.txt - 060% similarity]
R  +-    --    doc/kmail2/accountwizard.png [from: doc/kmail/accountwizard.png - 100% similarity]
R  +-    --    doc/kmail2/aggregationtheme.png [from: doc/kmail/aggregationtheme.png - 100% similarity]
R  +0    -0    doc/kmail2/configure.docbook [from: doc/kmail/configure.docbook - 100% similarity]
R  +-    --    doc/kmail2/configure.png [from: doc/kmail/configure.png - 100% similarity]
R  +0    -0    doc/kmail2/credits-and-licenses.docbook [from: doc/kmail/credits-and-licenses.docbook - 100% similarity]
R  +0    -0    doc/kmail2/faq.docbook [from: doc/kmail/faq.docbook - 100% similarity]
R  +-    --    doc/kmail2/folder-example.png [from: doc/kmail/folder-example.png - 100% similarity]
R  +-    --    doc/kmail2/folder-properties.png [from: doc/kmail/folder-properties.png - 100% similarity]
R  +-    --    doc/kmail2/folderarchiveagent.png [from: doc/kmail/folderarchiveagent.png - 100% similarity]
R  +0    -0    doc/kmail2/getting-started.docbook [from: doc/kmail/getting-started.docbook - 100% similarity]
R  +-    --    doc/kmail2/identitiesadvanced.png [from: doc/kmail/identitiesadvanced.png - 100% similarity]
R  +-    --    doc/kmail2/identity.png [from: doc/kmail/identity.png - 100% similarity]
R  +-    --    doc/kmail2/identitycryptography.png [from: doc/kmail/identitycryptography.png - 100% similarity]
R  +-    --    doc/kmail2/identitygeneral.png [from: doc/kmail/identitygeneral.png - 100% similarity]
R  +-    --    doc/kmail2/identitypicture.png [from: doc/kmail/identitypicture.png - 100% similarity]
R  +-    --    doc/kmail2/identitysignature.png [from: doc/kmail/identitysignature.png - 100% similarity]
R  +-    --    doc/kmail2/identitytemplate.png [from: doc/kmail/identitytemplate.png - 100% similarity]
R  +0    -0    doc/kmail2/index.docbook [from: doc/kmail/index.docbook - 100% similarity]
R  +0    -0    doc/kmail2/intro.docbook [from: doc/kmail/intro.docbook - 100% similarity]
R  +-    --    doc/kmail2/kmailwelcome.png [from: doc/kmail/kmailwelcome.png - 100% similarity]
R  +-    --    doc/kmail2/layout.png [from: doc/kmail/layout.png - 100% similarity]
R  +-    --    doc/kmail2/mail-mark-important.png [from: doc/kmail/mail-mark-important.png - 100% similarity]
R  +-    --    doc/kmail2/mail-mark-read.png [from: doc/kmail/mail-mark-read.png - 100% similarity]
R  +-    --    doc/kmail2/mail-mark-task.png [from: doc/kmail/mail-mark-task.png - 100% similarity]
R  +-    --    doc/kmail2/mail-mark-unread.png [from: doc/kmail/mail-mark-unread.png - 100% similarity]
R  +-    --    doc/kmail2/mail-thread-ignored.png [from: doc/kmail/mail-thread-ignored.png - 100% similarity]
R  +-    --    doc/kmail2/mail-thread-watch.png [from: doc/kmail/mail-thread-watch.png - 100% similarity]
R  +0    -0    doc/kmail2/menus.docbook [from: doc/kmail/menus.docbook - 100% similarity]
R  +-    --    doc/kmail2/message.png [from: doc/kmail/message.png - 100% similarity]
R  +-    --    doc/kmail2/messagelisttheme.png [from: doc/kmail/messagelisttheme.png - 100% similarity]
R  +-    --    doc/kmail2/smile.png [from: doc/kmail/smile.png - 100% similarity]
R  +0    -0    doc/kmail2/troubleshooting.docbook [from: doc/kmail/troubleshooting.docbook - 100% similarity]
R  +0    -0    doc/kmail2/using-kmail.docbook [from: doc/kmail/using-kmail.docbook - 100% similarity]
M  +1    -1    src/data/org.kde.kmail.appdata.xml
M  +1    -1    src/data/org.kde.kmail.desktop

https://commits.kde.org/kmail/fa60adffbd7c8a10025968db57fb49b6f703c923