Prevent non-existent help handbooks from populating the main handbook table of contents.

6 files changed, 42 insertions, 8 deletions

diff --git a/kcontrol/display/display.desktop b/kcontrol/display/display.desktop
index 3da4e03d2..67a289f0a 100644
--- a/kcontrol/display/display.desktop
+++ b/kcontrol/display/display.desktop
@@ -2,7 +2,13 @@
 Icon=tdescreensaver
 Type=Application
 Exec=tdecmshell display
-DocPath=kcontrol/kcmdisplay/index.html
+# Restore the following key and remove this comment when a help handbook
+# is written. Disabling this key prevents populating the main handbook
+# table of contents with a non-existent document, which results in a
+# main handbook error message of
+# 'There is no documentation available for /xyz/index.html.'
+# Also disable this key when there exists only a useless template handbook.
+# DocPath=kcontrol/kcmdisplay/index.html
 
 X-TDE-Library=display
 X-TDE-FactoryName=display
diff --git a/kcontrol/displayconfig/displayconfig.desktop b/kcontrol/displayconfig/displayconfig.desktop
index 738d3a293..3a6cecc10 100644
--- a/kcontrol/displayconfig/displayconfig.desktop
+++ b/kcontrol/displayconfig/displayconfig.desktop
@@ -2,7 +2,13 @@
 Categories=Qt;TDE;X-TDE-settings-system;
 Comment=Configure display
 Comment[en_US]=Configure display
-DocPath=kcontrol/displayconfig.html
+# Restore the following key and remove this comment when a help handbook
+# is written. Disabling this key prevents populating the main handbook
+# table of contents with a non-existent document, which results in a
+# main handbook error message of
+# 'There is no documentation available for /xyz/index.html.'
+# Also disable this key when there exists only a useless template handbook.
+# DocPath=kcontrol/displayconfig.html
 Exec=tdecmshell displayconfig
 GenericName=
 GenericName[en_US]=
diff --git a/kcontrol/hwmanager/hwmanager.desktop b/kcontrol/hwmanager/hwmanager.desktop
index d8a870f98..151a30411 100644
--- a/kcontrol/hwmanager/hwmanager.desktop
+++ b/kcontrol/hwmanager/hwmanager.desktop
@@ -2,7 +2,13 @@
 Exec=tdecmshell hwmanager
 Icon=background
 Type=Application
-DocPath=kcontrol/hwmanager/index.html
+# Restore the following key and remove this comment when a help handbook
+# is written. Disabling this key prevents populating the main handbook
+# table of contents with a non-existent document, which results in a
+# main handbook error message of
+# 'There is no documentation available for /xyz/index.html.'
+# Also disable this key when there exists only a useless template handbook.
+# DocPath=kcontrol/hwmanager/index.html
 
 X-TDE-Library=hwmanager
 X-TDE-ParentApp=kcontrol
@@ -12,7 +18,6 @@ X-TDE-SubstituteUID=true
 Categories=Qt;TDE;X-TDE-settings-hardware;
 Comment=Configure hardware devices
 Comment[en_US]=Configure hardware devices
-DocPath=kcontrol/hwmanager.html
 GenericName=
 GenericName[en_US]=
 Keywords=hardware
diff --git a/kcontrol/iccconfig/iccconfig.desktop b/kcontrol/iccconfig/iccconfig.desktop
index 008914acb..efa8fb294 100644
--- a/kcontrol/iccconfig/iccconfig.desktop
+++ b/kcontrol/iccconfig/iccconfig.desktop
@@ -2,7 +2,13 @@
 Exec=tdecmshell iccconfig
 Icon=background
 Type=Application
-DocPath=kcontrol/iccconfig/index.html
+# Restore the following key and remove this comment when a help handbook
+# is written. Disabling this key prevents populating the main handbook
+# table of contents with a non-existent document, which results in a
+# main handbook error message of
+# 'There is no documentation available for /xyz/index.html.'
+# Also disable this key when there exists only a useless template handbook.
+# DocPath=kcontrol/iccconfig/index.html
 
 X-TDE-Library=iccconfig
 X-TDE-ParentApp=kcontrol
@@ -12,7 +18,6 @@ X-TDE-SubstituteUID=true
 Categories=Qt;TDE;X-TDE-settings-hardware;
 Comment=Configure display ICC profile
 Comment[en_US]=Configure display ICC profile
-DocPath=kcontrol/iccconfig.html
 GenericName=
 GenericName[en_US]=
 Keywords=ICC,display,color,profile
diff --git a/kcontrol/kcontrol/kinfocenter.desktop b/kcontrol/kcontrol/kinfocenter.desktop
index 73610e854..080459037 100644
--- a/kcontrol/kcontrol/kinfocenter.desktop
+++ b/kcontrol/kcontrol/kinfocenter.desktop
@@ -2,7 +2,13 @@
 Exec=kinfocenter -caption "%c" %i %m
 Icon=hwinfo
 Type=Application
-DocPath=kinfocenter/index.html
+# Restore the following key and remove this comment when a help handbook
+# is written. Disabling this key prevents populating the main handbook
+# table of contents with a non-existent document, which results in a
+# main handbook error message of
+# 'There is no documentation available for /xyz/index.html.'
+# Also disable this key when there exists only a useless template handbook.
+# DocPath=kinfocenter/index.html
 X-TDE-StartupNotify=true
 OnlyShowIn=TDE;
 
diff --git a/kcontrol/view1394/kcmview1394.desktop b/kcontrol/view1394/kcmview1394.desktop
index 61dfde6e2..e1f6bc361 100644
--- a/kcontrol/view1394/kcmview1394.desktop
+++ b/kcontrol/view1394/kcmview1394.desktop
@@ -1,7 +1,13 @@
 [Desktop Entry]
 Icon=ieee1394
 Type=Application
-DocPath=kinfocenter/view1394/index.html
+# Restore the following key and remove this comment when a help handbook
+# is written. Disabling this key prevents populating the main handbook
+# table of contents with a non-existent document, which results in a
+# main handbook error message of
+# 'There is no documentation available for /xyz/index.html.'
+# Also disable this key when there exists only a useless template handbook.
+# DocPath=kinfocenter/view1394/index.html
 Exec=tdecmshell kcmview1394
 
 X-TDE-Library=view1394