Update non-existent and incomplete (template-only) help handbooks to new default format.

11 files changed, 253 insertions, 115 deletions

diff --git a/doc/kcharselect/index.docbook b/doc/kcharselect/index.docbook
index 7326d52..acce127 100644
--- a/doc/kcharselect/index.docbook
+++ b/doc/kcharselect/index.docbook
@@ -1,66 +1,64 @@
 <?xml version="1.0" ?>
-<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
   <!ENTITY kappname "&kcharselect;">
   <!ENTITY package "tdeutils">
   <!ENTITY % English "INCLUDE">
   <!ENTITY % addindex "IGNORE">
 ]>
 
-<book lang="&language;">
+<article lang="&language;">
+<title>The &kcharselect; Handbook</title>
 
-<bookinfo>
+<articleinfo>
 <title>The &kcharselect; Handbook</title>
 
 <authorgroup>
-<author>
-<firstname></firstname>
-<othername></othername>
-<surname></surname>
-<affiliation>
-<address><email></email></address>
-</affiliation>
-</author>
+<corpauthor>&tde-team;</corpauthor>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<legalnotice>&FDLNotice;</legalnotice>
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
+
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
 
-<date>2001-01-20</date>
-<releaseinfo>0.00.00</releaseinfo>
+<!-- <legalnotice>&FDLNotice;</legalnotice> -->
 
 <abstract>
 <para>
-&kcharselect; is part of the tdeutils package.
+&kcharselect; is a character selection utility.
 </para>
 </abstract>
 
-
 <keywordset>
-<keyword>KDE</keyword>
+<keyword>TDE</keyword>
 <keyword>tdeutils</keyword>
 <keyword>kcharselect</keyword>
 </keywordset>
 
-</bookinfo>
+</articleinfo>
+
+<sect1 id="apologies">
+<title>We Apologize</title>
+<para>No documentation has yet been written for &kcharselect;.</para>
 
-<chapter id="introduction">
-<title>Introduction</title>
-<para>The documentation for &kappname; was not finished when &kde; was installed on this computer.</para> 
-<para>If you need help, please check <ulink url="http://www.kde.org">The KDE Web site</ulink> for updates, or by submitting your question to <ulink url="mailto:kde@kde.org">The &kde; User Mailing list</ulink>.</para>
-<para><emphasis>The &kde; Team</emphasis></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;
 &underGPL;
 
-</chapter>
+</sect1>
 
 &documentation.index; 
-</book>
-<!--
-Local Variables:
-mode: sgml
-sgml-minimize-attributes: nil
-sgml-general-insert-case: lower
-End:
--->
-
+</article>
diff --git a/doc/ksim/index.docbook b/doc/ksim/index.docbook
index 611a159..f885b36 100644
--- a/doc/ksim/index.docbook
+++ b/doc/ksim/index.docbook
@@ -1,66 +1,64 @@
 <?xml version="1.0" ?>
-<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
   <!ENTITY kappname "&ksim;">
   <!ENTITY package "tdeutils">
   <!ENTITY % English "INCLUDE">
   <!ENTITY % addindex "IGNORE">
 ]>
 
-<book lang="&language;">
+<article lang="&language;">
+<title>The &ksim; Handbook</title>
 
-<bookinfo>
+<articleinfo>
 <title>The &ksim; Handbook</title>
 
 <authorgroup>
-<author>
-<firstname></firstname>
-<othername></othername>
-<surname></surname>
-<affiliation>
-<address><email></email></address>
-</affiliation>
-</author>
+<corpauthor>&tde-team;</corpauthor>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<legalnotice>&FDLNotice;</legalnotice>
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
+
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
 
-<date>2001-01-20</date>
-<releaseinfo>0.00.00</releaseinfo>
+<!-- <legalnotice>&FDLNotice;</legalnotice> -->
 
 <abstract>
 <para>
-&ksim; is part of the tdeutils package.
+&ksim; is a system monitor panel plugin with support for GKrellm skins.
 </para>
 </abstract>
 
-
 <keywordset>
-<keyword>KDE</keyword>
+<keyword>TDE</keyword>
 <keyword>tdeutils</keyword>
-<keyword>ksim</keyword>
+<keyword>kcharselect</keyword>
 </keywordset>
 
-</bookinfo>
+</articleinfo>
+
+<sect1 id="apologies">
+<title>We Apologize</title>
+<para>No documentation has yet been written for &ksim;.</para>
 
-<chapter id="introduction">
-<title>Introduction</title>
-<para>The documentation for &kappname; was not finished when &kde; was installed on this computer.</para> 
-<para>If you need help, please check <ulink url="http://www.kde.org">The KDE Website</ulink> for updates, or by submitting your question to <ulink url="mailto:kde@kde.org">The &kde; User Mailing list</ulink>.</para>
-<para><emphasis>The &kde; Team</emphasis></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;
 &underGPL;
 
-</chapter>
+</sect1>
 
 &documentation.index; 
-</book>
-<!--
-Local Variables:
-mode: sgml
-sgml-minimize-attributes: nil
-sgml-general-insert-case: lower
-End:
--->
-
+</article>
diff --git a/doc/ktimer/index.docbook b/doc/ktimer/index.docbook
index e28117e..c439565 100644
--- a/doc/ktimer/index.docbook
+++ b/doc/ktimer/index.docbook
@@ -1,66 +1,64 @@
 <?xml version="1.0" ?>
-<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
   <!ENTITY kappname "&ktimer;">
   <!ENTITY package "tdeutils">
   <!ENTITY % English "INCLUDE">
   <!ENTITY % addindex "IGNORE">
 ]>
 
-<book lang="&language;">
+<article lang="&language;">
+<title>The &ktimer; Handbook</title>
 
-<bookinfo>
+<articleinfo>
 <title>The &ktimer; Handbook</title>
 
 <authorgroup>
-<author>
-<firstname></firstname>
-<othername></othername>
-<surname></surname>
-<affiliation>
-<address><email></email></address>
-</affiliation>
-</author>
+<corpauthor>&tde-team;</corpauthor>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<legalnotice>&FDLNotice;</legalnotice>
+<releaseinfo>&tde-release-version;</releaseinfo>
+<date>Reviewed: &tde-release-date;</date>
+
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
 
-<date>2001-01-20</date>
-<releaseinfo>0.00.00</releaseinfo>
+<!-- <legalnotice>&FDLNotice;</legalnotice> -->
 
 <abstract>
 <para>
-&ktimer; is part of the tdeutils package.
+&ktimer; is a simple countdown timer.
 </para>
 </abstract>
 
-
 <keywordset>
-<keyword>KDE</keyword>
+<keyword>TDE</keyword>
 <keyword>tdeutils</keyword>
-<keyword>ktimer</keyword>
+<keyword>kcharselect</keyword>
 </keywordset>
 
-</bookinfo>
+</articleinfo>
+
+<sect1 id="apologies">
+<title>We Apologize</title>
+<para>No documentation has yet been written for &ktimer;.</para>
 
-<chapter id="introduction">
-<title>Introduction</title>
-<para>The documentation for &kappname; was not finished when &kde; was installed on this computer.</para> 
-<para>If you need help, please check <ulink url="http://www.kde.org">The KDE Website</ulink> for updates, or by submitting your question to <ulink url="mailto:kde@kde.org">The &kde; User Mailing list</ulink>.</para>
-<para><emphasis>The &kde; Team</emphasis></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;
 &underGPL;
 
-</chapter>
+</sect1>
 
 &documentation.index; 
-</book>
-<!--
-Local Variables:
-mode: sgml
-sgml-minimize-attributes: nil
-sgml-general-insert-case: lower
-End:
--->
-
+</article>
diff --git a/doc/kvaio/CMakeLists.txt b/doc/kvaio/CMakeLists.txt
new file mode 100644
index 0000000..614fa58
--- /dev/null
+++ b/doc/kvaio/CMakeLists.txt
@@ -0,0 +1,10 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION kcontrol/kvaio )
+
diff --git a/doc/kvaio/Makefile.am b/doc/kvaio/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kvaio/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kvaio/index.docbook b/doc/kvaio/index.docbook
new file mode 100644
index 0000000..1844644
--- /dev/null
+++ b/doc/kvaio/index.docbook
@@ -0,0 +1,64 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY kvaio "<application>Sony Vaio</application>">
+  <!ENTITY package "tdeutils">
+  <!ENTITY % English "INCLUDE">
+  <!ENTITY % addindex "IGNORE">
+]>
+
+<article lang="&language;">
+<title>The &kvaio; Handbook</title>
+
+<articleinfo>
+<title>The &kvaio; 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>
+&kvaio; is a plugin supporting Sony Vaio laptop power management options.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>TDE</keyword>
+<keyword>tdeutils</keyword>
+<keyword>kcharselect</keyword>
+</keywordset>
+
+</articleinfo>
+
+<sect1 id="apologies">
+<title>We Apologize</title>
+<para>No documentation has yet been written for &kvaio;.</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;
+&underGPL;
+
+</sect1>
+
+&documentation.index; 
+</article>
diff --git a/doc/thinkpad/CMakeLists.txt b/doc/thinkpad/CMakeLists.txt
new file mode 100644
index 0000000..301de82
--- /dev/null
+++ b/doc/thinkpad/CMakeLists.txt
@@ -0,0 +1,10 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION kcontrol/thinkpad )
+
diff --git a/doc/thinkpad/Makefile.am b/doc/thinkpad/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/thinkpad/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/thinkpad/index.docbook b/doc/thinkpad/index.docbook
new file mode 100644
index 0000000..3907f6c
--- /dev/null
+++ b/doc/thinkpad/index.docbook
@@ -0,0 +1,64 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY thinkpad "<application>IBM Thinkpad</application>">
+  <!ENTITY package "tdeutils">
+  <!ENTITY % English "INCLUDE">
+  <!ENTITY % addindex "IGNORE">
+]>
+
+<article lang="&language;">
+<title>The &thinkpad; Handbook</title>
+
+<articleinfo>
+<title>The &thinkpad; 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>
+&thinkpad; is a plugin supporting IBM Thinkpad laptop buttons.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>TDE</keyword>
+<keyword>tdeutils</keyword>
+<keyword>kcharselect</keyword>
+</keywordset>
+
+</articleinfo>
+
+<sect1 id="apologies">
+<title>We Apologize</title>
+<para>No documentation has yet been written for &thinkpad;.</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;
+&underGPL;
+
+</sect1>
+
+&documentation.index; 
+</article>
diff --git a/kmilo/kmilo_kvaio/kcmkvaio/kvaio.desktop b/kmilo/kmilo_kvaio/kcmkvaio/kvaio.desktop
index 5375183..750c780 100644
--- a/kmilo/kmilo_kvaio/kcmkvaio/kvaio.desktop
+++ b/kmilo/kmilo_kvaio/kcmkvaio/kvaio.desktop
@@ -2,13 +2,7 @@
 Type=Application
 Exec=tdecmshell kvaio
 Icon=laptop
-# 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/kvaio/index.html
+DocPath=kcontrol/kvaio/index.html
 
 X-TDE-Library=kvaio
 X-TDE-ParentApp=kcontrol
diff --git a/kmilo/thinkpad/kcmthinkpad/thinkpad.desktop b/kmilo/thinkpad/kcmthinkpad/thinkpad.desktop
index 6f37a92..6b76314 100644
--- a/kmilo/thinkpad/kcmthinkpad/thinkpad.desktop
+++ b/kmilo/thinkpad/kcmthinkpad/thinkpad.desktop
@@ -2,13 +2,7 @@
 Type=Application
 Exec=tdecmshell thinkpad
 Icon=laptop
-# 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/thinkpad/index.html
+DocPath=kcontrol/thinkpad/index.html
 
 X-TDE-Library=thinkpad
 X-TDE-ParentApp=kcontrol