From 3b51330e0f60b2337084a9ccd3580c5ea262c413 Mon Sep 17 00:00:00 2001
From: Darrell Anderson <humanreadable@yahoo.com>
Date: Sat, 25 Jan 2014 19:43:07 -0600
Subject: Update incomplete (template-only) help handbook to new default
 format.

---
 doc/kbugbuster/index.docbook  | 83 ++++++++++++++++++-------------------------
 kbugbuster/kbugbuster.desktop |  6 +---
 2 files changed, 36 insertions(+), 53 deletions(-)

diff --git a/doc/kbugbuster/index.docbook b/doc/kbugbuster/index.docbook
index 573f8d5d..3a5458a0 100644
--- a/doc/kbugbuster/index.docbook
+++ b/doc/kbugbuster/index.docbook
@@ -1,78 +1,65 @@
 <?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 kbugbuster "<application>KBugBuster</application>">
   <!ENTITY kappname "&kbugbuster;">
-  <!ENTITY package "tdesdk">
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE">
 ]>
 
-<book lang="&language;">
+<!-- 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. -->
 
-<bookinfo>
+<article lang="&language;">
+<title>The &kbugbuster; Handbook</title>
+
+<articleinfo>
 <title>The &kbugbuster; 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>
 
-<!-- Date and version information of the documentation
-Don't forget to include this last date and this last revision number, we
-need them for translation coordination !
-Please respect the format of the date (DD/MM/YYYY) and of the version
-(Major.minor.lesser), it could be used by automation scripts -->
+<copyright>
+<year>&tde-copyright-date;</year>
+<holder>&tde-team;</holder>
+</copyright>
 
-<date>2002-03-31</date>
-<releaseinfo>0.00.00</releaseinfo>
-
-<!-- Abstract about this handbook -->
+<!-- <legalnotice>&FDLNotice;</legalnotice> -->
 
 <abstract>
 <para>
-&kbugbuster; is part of the tdesdk package.
+&kbugbuster; is a tool to manage the &tde; Bug Report System.
 </para>
 </abstract>
 
-
 <keywordset>
-<keyword>KDE</keyword>
-<keyword>kbugbuster</keyword>
+<keyword>TDE</keyword>
 </keywordset>
 
-</bookinfo>
+</articleinfo>
+
+<sect1 id="apologies">
+<title>We Apologize</title>
+<para>No documentation has yet been written for &kbugbuster;.</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>
 
-<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>Thank you for helping and thank you for your patience.</para>
 
 &underFDL;
 
-</chapter>
+</sect1>
 
 &documentation.index; 
-</book>
-
-<!--
-Local Variables:
-mode: sgml
-sgml-minimize-attributes:nil
-sgml-general-insert-case:lower
-sgml-indent-step:0
-sgml-indent-data:nil
-End:
-
-// vim:ts=2:sw=2:tw=78:noet
--->
+</article>
diff --git a/kbugbuster/kbugbuster.desktop b/kbugbuster/kbugbuster.desktop
index 9f6b5741..fb0cbb7b 100644
--- a/kbugbuster/kbugbuster.desktop
+++ b/kbugbuster/kbugbuster.desktop
@@ -2,11 +2,7 @@
 Type=Application
 Exec=kbugbuster -caption "%c" %i %m
 Icon=kbugbuster
-# 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 and a resulting error message of
-# 'There is no documentation available for /xyz/index.html.'
-# DocPath=kbugbuster/index.html
+DocPath=kbugbuster/index.html
 GenericName=TDE Bug Management
 GenericName[af]=TDE Fout Bestuuring
 GenericName[bg]=Управление на грешки - TDE
-- 
cgit v1.2.1