From d90afc5a675cab7a48f18625d226e4549de72eb7 Mon Sep 17 00:00:00 2001
From: Darrell Anderson <humanreadable@yahoo.com>
Date: Sun, 26 Jan 2014 04:33:50 -0600
Subject: [PATCH] Update incomplete (template-only) help handbook to new
 default format.

---
 doc/Makefile.am                       |  2 +-
 doc/kdevdesigner/CMakeLists.txt       |  9 ++++
 doc/kdevdesigner/Makefile.am          |  3 ++
 doc/kdevdesigner/index.docbook        | 65 +++++++++++++++++++++++++++
 kdevdesigner/src/kdevdesigner.desktop |  8 +---
 5 files changed, 79 insertions(+), 8 deletions(-)
 create mode 100644 doc/kdevdesigner/CMakeLists.txt
 create mode 100644 doc/kdevdesigner/Makefile.am
 create mode 100644 doc/kdevdesigner/index.docbook

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 06f6c7cb..8275eb30 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,2 +1,2 @@
-SUBDIRS = tdevelop std extras kde_app_devel
+SUBDIRS = tdevelop std extras kde_app_devel kdevdesigner
 
diff --git a/doc/kdevdesigner/CMakeLists.txt b/doc/kdevdesigner/CMakeLists.txt
new file mode 100644
index 00000000..db314d97
--- /dev/null
+++ b/doc/kdevdesigner/CMakeLists.txt
@@ -0,0 +1,9 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION kdevdesigner )
diff --git a/doc/kdevdesigner/Makefile.am b/doc/kdevdesigner/Makefile.am
new file mode 100644
index 00000000..41691557
--- /dev/null
+++ b/doc/kdevdesigner/Makefile.am
@@ -0,0 +1,3 @@
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kdevdesigner/index.docbook b/doc/kdevdesigner/index.docbook
new file mode 100644
index 00000000..729a7120
--- /dev/null
+++ b/doc/kdevdesigner/index.docbook
@@ -0,0 +1,65 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY kdevdesigner "<application>KDevDesigner</application>">
+  <!ENTITY kappname "&kdevdesigner;">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE">
+]>
+
+<!-- Note: When updating this empty handbook, remember that usually most handbooks -->
+<!-- use the book model rather than article. Feel free to use article if the new handbook -->
+<!-- remains really short. -->
+
+<article lang="&language;">
+<title>The &kdevdesigner; Handbook</title>
+
+<articleinfo>
+<title>The &kdevdesigner; Handbook</title>
+
+<authorgroup>
+<corpauthor>&tde-team;</corpauthor>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
+
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
+
+<!-- <legalnotice>&FDLNotice;</legalnotice> -->
+
+<abstract>
+<para>
+&kdevdesigner; is a GUI designer environment for &tde;.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>TDE</keyword>
+</keywordset>
+
+</articleinfo>
+
+<sect1 id="apologies">
+<title>We Apologize</title>
+<para>No documentation has yet been written for &kdevdesigner;.</para>
+
+<para>If you need help, please check <ulink url="http://www.trinitydesktop.org">The &tde;
+web site</ulink>, submit questions to the <ulink url="http://www.trinitydesktop.org/mailinglist.php">
+&tde; mail lists</ulink>, or file a bug report at the <ulink url="http://bugs.trinitydesktop.org/">
+&tde; bug tracker</ulink>.</para>
+
+<para>If you are interested in helping, please consider writing the help file.
+Submitting a basic text file is acceptable as the &tde-team; will convert the text.</para>
+
+<para>Thank you for helping and thank you for your patience.</para>
+
+&underFDL;
+
+</sect1>
+
+&documentation.index; 
+</article>
diff --git a/kdevdesigner/src/kdevdesigner.desktop b/kdevdesigner/src/kdevdesigner.desktop
index c106f699..1cd245f1 100644
--- a/kdevdesigner/src/kdevdesigner.desktop
+++ b/kdevdesigner/src/kdevdesigner.desktop
@@ -58,13 +58,7 @@ GenericName[zh_TW]=介面設計器
 Exec=kdevdesigner %i -caption "%c"
 Icon=kdevdesigner
 Type=Application
-# 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=kdevdesigner/kdevdesigner.html
+DocPath=kdevdesigner/index.html
 Comment=GUI Designer for Qt/TDE
 Comment[ca]=Dissenyador de IGU per Qt/TDE
 Comment[da]=Grafisk brugerfladedesigner til Qt/TDE