Drop automake build support.

Add basic cmake build instructions in the INSTALL file.
Deleted empty file: NEWS.
Deleted obsolete file: kkbswitch.spec .
Some cleanup in the README, the "man" page and the "help" page files.
The man page as well as the icons have moved in their own folder.

Signed-off-by: gregory guy <gregory-tde@laposte.net>

6 files changed, 525 insertions, 83 deletions

diff --git a/doc/Makefile.am b/doc/Makefile.am
deleted file mode 100644
index 1492e3f..0000000
--- a/doc/Makefile.am
+++ /dev/null
@@ -1,6 +0,0 @@
-# the SUBDIRS is filled automatically by am_edit. If files are 
-# in this directory they are installed into the english dir
-
-KDE_LANG = en
-KDE_DOCS = kkbswitch
-SUBDIRS = $(AUTODIRS)  
diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am
deleted file mode 100644
index 77aefea..0000000
--- a/doc/en/Makefile.am
+++ /dev/null
@@ -1,13 +0,0 @@
-KDE_DOCS = kkbswitch
-KDE_LANG = en
-
-.PHONY: html
-
-html: HTML/index.html
-
-HTML/index.html: $(srcdir)/index.docbook
-	rm -fr HTML
-	mkdir HTML
-	(cd HTML && meinproc --check --stylesheet $(KDE_XSL_STYLESHEET) ../$(srcdir)/index.docbook && ln -s /usr/share/doc/HTML/en/common; \
-  for name in ../$(srcdir)/*.png; do ln -s $$name; done)
-
diff --git a/doc/en/index.docbook b/doc/en/index.docbook
index c059822..159dbdb 100644
--- a/doc/en/index.docbook
+++ b/doc/en/index.docbook
@@ -46,7 +46,7 @@
 
 <abstract>
 <para>
-&kkbswitch; is a keyboard layout indicator for &kde;.
+&kkbswitch; is a keyboard layout indicator for &tde;.
 </para>
 </abstract>
 
@@ -65,7 +65,7 @@
 <title>Introduction</title>
 
 <para>
-&kkbswitch; is a keyboard layout indicator for &kde; 2 or 3. It is useful when
+&kkbswitch; is a keyboard layout indicator for &tde;. It is useful when
 you have configured the XKeyboard extension of your X Server to have more than
 one keyboard group (layout), for example US/ASCII and Russian. &kkbswitch;
 displays an icon in the system tray that indicates which layout is currently
@@ -74,10 +74,8 @@ serves as the indicator of the current layout. You still have to configure
 XKeyboard by editing the <filename>XF86Config</filename> file.
 </para>
 <para>
-Please report any problems or feature requests to the author, Leonid
-Zeitlin, at the address <email>lz@europe.com</email>.
+Please report any problems or feature requests to the Trinity Desktop Environment project.
 </para>
-
 </chapter>
 
 <chapter id="using-kapp">
@@ -154,7 +152,7 @@ This style displays the two-letter ISO language code corresponding to the curren
 <varlistentry>
 <term>Flag and code</term>
 <listitem><para>
-This style displays the language code against the background of a country flag. This style mimics &kde;'s <application>kxkb</application> application.
+This style displays the language code against the background of a country flag. This style mimics &tde;'s <application>kxkb</application> application.
 </para></listitem>
 </varlistentry>
 </variablelist>
@@ -400,7 +398,7 @@ active (like selecting a layout from the tray icon popup menu).
 
 <funcsynopsis>
 <funcprototype>
-<funcdef>QStringList <function>getGroupNames</function></funcdef>
+<funcdef>TQStringList <function>getGroupNames</function></funcdef>
 <void/>
 </funcprototype>
 </funcsynopsis>
@@ -541,63 +539,23 @@ Documentation copyright 2001-2005 Leonid Zeitlin <email>lz@europe.com</email>
 <title>How to obtain &kkbswitch;</title>
 
 <para>
-&kkbswitch; has a home page at SourceForge: 
-<ulink url="http://kkbswitch.sourceforge.net">
-http://kkbswitch.sourceforge.net</ulink>. Check there for the latest news. The latest version is available for download from the project page: <ulink url="http://sourceforge.net/projects/kkbswitch">
-http://sourceforge.net/projects/kkbswitch</ulink>.
-</para>
-<!-- <para>
-&kkbswitch; can be found in the at the <ulink
-url="http://apps.kde.com/">apps.kde.com</ulink> site at <ulink
-url="http://ftp.kde.com/Desktop/Utilities/KKBSwitch/">
-http://ftp.kde.com/Desktop/Utilities/KKBSwitch/</ulink>
+&kkbswitch; is part of the Trinity Desktop Environment project: 
+<ulink url="http://trinitydesktop.org/">http://trinitydesktop.org</ulink>. Check there for the latest news.
 </para>
-<para>
-&kkbswitch; doesn't have a homepage yet. For the latest version check <ulink
-url="http://apps.kde.com/">apps.kde.com</ulink>
-</para> -->
 </sect1>
 
 <sect1 id="requirements">
 <title>Requirements</title>
 <para>
 &kkbswitch; doesn't require any special environment to compile and run besides
- the standard &kde; 2 or 3 tdelibs and tdebase.
+ the standard &tde; tdelibs and tdebase.
 </para>
 </sect1>
 
 <sect1 id="compilation">
 <title>Compilation and Installation</title>
 <para>
-In order to compile and install &kkbswitch; on your system, type the following
-in the  base directory of the &kkbswitch; distribution:
-<screen width="40">
-<prompt>&percnt;</prompt> <userinput>./configure</userinput>
-<prompt>&percnt;</prompt> <userinput>make</userinput>
-<prompt>&percnt;</prompt> <userinput>make install</userinput>
-</screen>
-</para>
-
-<para>
-Options you may want or need to give to the <command>configure</command> command are:
-</para>
-<simplelist>
-<member>
-<option>--prefix</option>=<replaceable>dir</replaceable> - set the prefix where your &kde; installation is located. Alternatively, you can set $<envar>TDEDIR</envar> environment variable to the &kde; directory. Under regular circumstances, the configuration script will find the &kde; location automatically; use this option only if you are having problems without it.
-</member>
-<member>
-<option>--enable-ru-ua-layout</option> - install the Russian/Ukrainian layout file (described in <xref linkend="ru_ua"/>). This option is useful for users of XFree86 prior to version 4.3, who want to use Russian/Ukrainian layout file. Note that with this option it is not possible to install &kkbswitch; without root privileges, because the layout file <emphasis>must</emphasis> go to the system XKB layout directory where ordinary users don't have write access.
-</member>
-<member>
-<option>--without-arts</option> - do not check for &arts; development headers. &arts; is &kde;'s multimedia framework, which &kkbswitch; does not use. However, since &kkbswitch; uses standard &kde; configuration macros, the configuration script will check for &arts; headers and complain if they are not found. If this happens to you, specify this option to compile &kkbswitch;. Alternatively, install &arts; development headers, you'll need them one day.
-</member>
-</simplelist>
-
-
-<para>
-Since &kkbswitch; uses autoconf and automake you should have not trouble
-compiling it. &kkbswitch; was tested under several versions of &Linux; and FreeBSD, 
-and a FreeBSD port is available.
+&kkbswitch; relies on cmake to build, please read the INSTALL file.
 </para>
 
 <para>
@@ -680,16 +638,3 @@ sgml-indent-step:0
 sgml-indent-data:nil
 End:
 -->
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/man/CMakeLists.txt b/doc/man/CMakeLists.txt
new file mode 100644
index 0000000..8512250
--- /dev/null
+++ b/doc/man/CMakeLists.txt
@@ -0,0 +1,5 @@
+INSTALL(
+    FILES ${PROJECT_NAME}.1
+    DESTINATION ${MAN_INSTALL_DIR}/man1
+    COMPONENT doc
+)
diff --git a/doc/man/kkbswitch.1 b/doc/man/kkbswitch.1
new file mode 100644
index 0000000..11c23d5
--- /dev/null
+++ b/doc/man/kkbswitch.1
@@ -0,0 +1,136 @@
+.\" This manpage has been automatically generated by docbook2man 
+.\" from a DocBook document.  This tool can be found at:
+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "KKBSWITCH" "1" "06 November 2004" "" ""
+
+.SH NAME
+kkbswitch \- A keyboard layout indicator for TDE.
+.SH SYNOPSIS
+
+\fBkkbswitch\fR [ \fB\-\-help\fI\fB\fR ] [ \fB\-\-help-tde\fI\fB\fR ] [ \fB\-\-help-qt\fI\fB\fR ] [ \fB\-\-version\fI \-v\fB\fR ] [ \fB\-\-license\fI\fB\fR ] [ \fB\-\-author\fI\fB\fR ] [ \fB\-\-caption <caption>\fI\fB\fR ] [ \fB\-\-icon <icon>\fI\fB\fR ] [ \fB\-\-miniicon <icon>\fI\fB\fR ] [ \fB\-\-dcopserver <server>\fI\fB\fR ] [ \fB\-\-nocrashhandler\fI\fB\fR ] [ \fB\-\-waitforwm\fI\fB\fR ] [ \fB\-\-style <style>\fI\fB\fR ] [ \fB\-\-geometry <geometry>\fI\fB\fR ] [ \fB\-\-display <display>\fI\fB\fR ] [ \fB\-\-session <sessionid>\fI\fB\fR ] [ \fB\-\-cmap\fI\fB\fR ] [ \fB\-\-ncols <columns>\fI\fB\fR ] [ \fB\-\-nograb\fI\fB\fR ] [ \fB\-\-dograb\fI\fB\fR ] [ \fB\-\-sync\fI\fB\fR ] [ \fB\-\-font\fI \-\-fn <fontname>\fB\fR ] [ \fB\-\-background\fI \-\-bg <colour>\fB\fR ] [ \fB\-\-button\fI \-\-btn <colour>\fB\fR ] [ \fB\-\-name\fI <name>\fB\fR ] [ \fB\-\-title\fI <title>\fB\fR ] [ \fB\-\-visual\fI TrueColor\fB\fR ] [ \fB\-\-inputstyle\fI <style>\fB\fR ] [ \fB\-\-im\fI <server>\fB\fR ] [ \fB\-\-noxim\fI\fB\fR ]
+
+.SH "DESCRIPTION"
+.PP
+This manual page documents briefly the
+\fBkkbswitch\fR command.
+.PP
+This manual page was written for the Debian GNU/Linux distribution
+because the original program does not have a manual page.
+Instead, it has documentation in the KDE handbook format; see below.
+.PP
+\fBkkbswitch\fR is a keyboard layout indicator for KDE.
+.PP
+It is useful when you have configured the XKeyboard extension of your X Server to have more than one keyboard group (layout), for example US/ASCII and Russian. 
+KKBSwitch displays an icon in the system tray that indicates which layout is currently active and enables layout switching by clicking the icon or by right click and selecting layout from a popup menu. Note that KKBSwitch does not help you configure XKeyboard.
+This means that you still have to configure XKeyboard by editing the XF86Config file or use a setup program to do it for you.
+KKBSwitch is a TDE application, but is reported to work under GNOME as well.
+.SH "OPTIONS"
+.PP
+These programs follow the usual GNU command line syntax,
+with long options starting with two dashes (`-').  A summary of
+options is included below.
+.TP
+\fB\-h \-\-help \fR
+Show summary of options.
+.TP
+\fB\-v \-\-version \fR
+Show version information.
+.TP
+\fB\-\-author \fR
+Show information about the author.
+.TP
+\fB\-\-license \fR
+Show license information.
+.TP
+\fB\-\-caption <caption> \fR
+Specify the caption of the window.
+.TP
+\fB\-\-icon <icon> \fR
+Specify the icon of the window.
+.TP
+\fB\-\-miniicon <icon> \fR
+Specify the mini-icon of the window.
+.TP
+\fB\-\-dcopserver <server> \fR
+Specify the DCOP server to use.
+.TP
+\fB\-\-nocrashhandler \fR
+Disable KDE crash handler (enables core dumps).
+.TP
+\fB\-\-waitforwm \fR
+Waits for a compatible window manager to start.
+.TP
+\fB\-\-style <style> \fR
+Sets the application's GUI style (overrides KDE).
+.TP
+\fB\-\-geometry <geometry> \fR
+Sets the geometry of the window.
+.TP
+\fB\-\-display <display> \fR
+Specifies the X display to use.
+.TP
+\fB\-\-session <sessionid> \fR
+Restores the application for the given session ID.
+.TP
+\fB\-\-cmap \fR
+Forces use of an internal colour map on an 8-bit display.
+.TP
+\fB\-\-ncols <count> \fR
+Limits the number of colours allowed in an 8-bit display.
+.TP
+\fB\-\-nograb \fR
+Forces Qt to never grab the mouse or keyboard.
+.TP
+\fB\-\-dograb \fR
+Overrides \-\-nograb, which may be implicitly set.
+.TP
+\fB\-\-sync \fR
+Forces synchronous mode (for debugging).
+.TP
+\fB\-\-font <font> \-\-fn <font>\fR
+Sets the default application font.
+.TP
+\fB\-\-background <colour> \-\-bg <colour>\fR
+Sets the default background colour and application
+pallette.
+.TP
+\fB\-\-foreground <colour> \-\-fg <colour>\fR
+Sets the default foreground colour.
+.TP
+\fB\-\-button <colour> \-\-btn <colour>\fR
+Sets the default button colour.
+.TP
+\fB\-\-name <name> \fR
+Sets the application name.
+.TP
+\fB\-\-title <name> \fR
+Sets the application title.
+.TP
+\fB\-\-visual TrueColor \fR
+Forces the application to use a True Colour visual on 8-bit
+displays.
+.TP
+\fB\-\-inputstyle <style> \fR
+Sets X Input Method (XIM) input style. Possible values are: 
+onthespot, overthespot, offthespot, and root.
+.TP
+\fB\-\-im <server> \fR
+Sets X Input Method (XIM) server.
+.TP
+\fB\-\-noxim \fR
+Disables X Input Method (XIM) support.
+.SH "SEE ALSO"
+.PP
+This program includes documentation in the format of TDE handbook available in /usr/share/doc/kde/HTML/en/kkbswitch/ or by help option in the user interface.
+.SH "AUTHOR"
+.PP
+This manual page was written by Shlomi Loubaton <shlomister@gmail.com> for
+the Debian GNU/Linux system (but may be used by others). Permission is
+granted to copy, distribute and/or modify this document under
+the terms of the GNU General Public License, Version 2 any 
+later version published by the Free Software Foundation.
+.PP
+On Debian systems, the complete text of the GNU General Public
+License can be found in /usr/share/common-licenses/GPL.
diff --git a/doc/man/kkbswitch.sgml b/doc/man/kkbswitch.sgml
new file mode 100644
index 0000000..96a16f7
--- /dev/null
+++ b/doc/man/kkbswitch.sgml
@@ -0,0 +1,375 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
+     less'.  A typical entry in a Makefile or Makefile.am is:
+
+manpage.1: manpage.sgml
+	docbook-to-man $< > $@
+
+    
+	The docbook-to-man binary is found in the docbook-to-man package.
+	Please remember that if you create the nroff version in one of the
+	debian/rules file targets (such as build), you will need to include
+	docbook-to-man in your Build-Depends control field.
+
+  -->
+
+  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
+  <!ENTITY dhfirstname "<firstname>Shlomi</firstname>">
+  <!ENTITY dhsurname   "<surname>Loubaton</surname>">
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY dhdate      "<date>October 24, 2004</date>">
+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+       allowed: see man(7), man(1). -->
+  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
+  <!ENTITY dhemail     "<email>shlomister@gmail.com</email>">
+  <!ENTITY dhusername  "Shlomi Loubaton">
+  <!ENTITY dhucpackage "<refentrytitle>KKBSWITCH</refentrytitle>">
+  <!ENTITY dhpackage   "kkbswitch">
+
+  <!ENTITY debian      "<productname>Debian GNU/Linux</productname>">
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      &dhemail;
+    </address>
+    <author>
+      &dhfirstname;
+      &dhsurname;
+    </author>
+    <copyright>
+      <year>2004</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    &dhdate;
+  </refentryinfo>
+  <refmeta>
+    &dhucpackage;
+
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>&dhpackage;</refname>
+
+    <refpurpose>A keyboard layout indicator for KDE 3.</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+
+      <arg><option>--help<replaceable></replaceable></option></arg>
+      <arg><option>--help-kde<replaceable></replaceable></option></arg>
+      <arg><option>--help-qt<replaceable></replaceable></option></arg>
+      <arg><option>--version<replaceable> -v</replaceable></option></arg>
+      <arg><option>--license<replaceable></replaceable</option></arg>
+      <arg><option>--author<replaceable></replaceable></option></arg>
+      <arg><option>--caption &lt;caption&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--icon &lt;icon&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--miniicon &lt;icon&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--dcopserver &lt;server&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--nocrashhandler<replaceable></replaceable></option></arg>
+      <arg><option>--waitforwm<replaceable></replaceable></option></arg>
+      <arg><option>--style &lt;style&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--geometry &lt;geometry&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--display &lt;display&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--session &lt;sessionid&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--cmap<replaceable></replaceable></option></arg>
+      <arg><option>--ncols &lt;columns&gt;<replaceable></replaceable></option></arg>
+      <arg><option>--nograb<replaceable></replaceable></option></arg>
+      <arg><option>--dograb<replaceable></replaceable></option></arg>
+      <arg><option>--sync<replaceable></replaceable></option></arg>
+      <arg><option>--font<replaceable> --fn &lt;fontname&gt;</replaceable></option></arg>
+      <arg><option>--background<replaceable> --bg &lt;colour&gt;</replaceable></option></arg>
+      <arg><option>--button<replaceable> --btn &lt;colour&gt;</replaceable></option></arg>
+      <arg><option>--name<replaceable> &lt;name&gt;</replaceable></option></arg>
+      <arg><option>--title<replaceable> &lt;title&gt;</replaceable></option></arg>
+      <arg><option>--visual<replaceable> TrueColor</replaceable></option></arg>
+      <arg><option>--inputstyle<replaceable> &lt;style&gt;</replaceable></option></arg>
+      <arg><option>--im<replaceable> &lt;server&gt;</replaceable></option></arg>
+      <arg><option>--noxim<replaceable></replaceable></option></arg>
+
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para>This manual page documents briefly the
+      <command>&dhpackage;</command> command.</para>
+
+    <para>This manual page was written for the &debian; distribution
+      because the original program does not have a manual page.
+      Instead, it has documentation in the KDE handbook format; see below.</para>
+
+    <para><command>&dhpackage;</command> is a keyboard layout indicator for KDE.
+    </para>
+
+    <para>It is useful when you have configured the XKeyboard extension of your X Server to have more than one keyboard group (layout), for example US/ASCII and Russian. 
+    KKBSwitch displays an icon in the system tray that indicates which layout is currently active and enables layout switching by clicking the icon or by right click and selecting layout from a popup menu. Note that KKBSwitch does not help you configure XKeyboard.
+    This means that you still have to configure XKeyboard by editing the XF86Config file or use a setup program to do it for you.
+    KKBSwitch is a KDE application, but is reported to work under GNOME as well.</para>
+
+  </refsect1>
+  <refsect1>
+    <title>OPTIONS</title>
+
+    <para>These programs follow the usual &gnu; command line syntax,
+      with long options starting with two dashes (`-').  A summary of
+      options is included below.</para>
+
+    <variablelist>
+      <varlistentry>
+        <term><option>-h</option>
+          <option>--help</option>
+        </term>
+        <listitem>
+          <para>Show summary of options.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-v</option>
+	  <option>--version</option>
+	</term>
+	<listitem>
+	  <para>Show version information.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--author</option>
+	</term>
+	<listitem>
+	  <para>Show information about the author.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--license</option>
+	</term>
+	<listitem>
+	  <para>Show license information.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--caption &lt;caption&gt;</option>
+	</term>
+	<listitem>
+	  <para>Specify the caption of the window.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--icon &lt;icon&gt;</option>
+	</term>
+	<listitem>
+	  <para>Specify the icon of the window.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--miniicon &lt;icon&gt;</option>
+	</term>
+	<listitem>
+	  <para>Specify the mini-icon of the window.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--dcopserver &lt;server&gt;</option>
+	</term>
+	<listitem>
+	  <para>Specify the DCOP server to use.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--nocrashhandler</option>
+	</term>
+	<listitem>
+	  <para>Disable KDE crash handler (enables core dumps).</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--waitforwm</option>
+	</term>
+	<listitem>
+	  <para>Waits for a compatible window manager to start.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--style &lt;style&gt;</option>
+	</term>
+	<listitem>
+	  <para>Sets the application's GUI style (overrides KDE).</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--geometry &lt;geometry&gt;</option>
+	</term>
+	<listitem>
+	  <para>Sets the geometry of the window.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--display &lt;display&gt;</option>
+	</term>
+	<listitem>
+	  <para>Specifies the X display to use.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--session &lt;sessionid&gt;</option>
+	</term>
+	<listitem>
+	  <para>Restores the application for the given session ID.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--cmap</option>
+	</term>
+	<listitem>
+	  <para>Forces use of an internal colour map on an 8-bit display.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--ncols &lt;count&gt;</option>
+	</term>
+	<listitem>
+	  <para>Limits the number of colours allowed in an 8-bit display.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--nograb</option>
+	</term>
+	<listitem>
+	  <para>Forces Qt to never grab the mouse or keyboard.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--dograb</option>
+	</term>
+	<listitem>
+	  <para>Overrides --nograb, which may be implicitly set.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--sync</option>
+	</term>
+	<listitem>
+	  <para>Forces synchronous mode (for debugging).</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--font &lt;font&gt;</option>
+	  <option>--fn &lt;font&gt;</option></term>
+	<listitem>
+	  <para>Sets the default application font.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--background &lt;colour&gt;</option>
+	  <option>--bg &lt;colour&gt;</option></term>
+	<listitem>
+	  <para>Sets the default background colour and application
+	  pallette.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--foreground &lt;colour&gt;</option>
+	  <option>--fg &lt;colour&gt;</option></term>
+	<listitem>
+	  <para>Sets the default foreground colour.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--button &lt;colour&gt;</option>
+	  <option>--btn &lt;colour&gt;</option></term>
+	<listitem>
+	  <para>Sets the default button colour.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--name &lt;name&gt;</option>
+	  </term>
+	<listitem>
+	  <para>Sets the application name.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--title &lt;name&gt;</option>
+	  </term>
+	<listitem>
+	  <para>Sets the application title.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--visual TrueColor</option>
+	  </term>
+	<listitem>
+	  <para>Forces the application to use a True Colour visual on 8-bit
+	  displays.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--inputstyle &lt;style&gt;</option>
+	  </term>
+	<listitem>
+	  <para>Sets X Input Method (XIM) input style. Possible values are: 
+	  onthespot, overthespot, offthespot, and root.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--im &lt;server&gt;</option>
+	  </term>
+	<listitem>
+	  <para>Sets X Input Method (XIM) server.</para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--noxim</option>
+	  </term>
+	<listitem>
+	  <para>Disables X Input Method (XIM) support.</para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>This program includes documentation in the format of KDE handbook available in /usr/share/doc/HTML/en/kkbswitch or by help option in the user interface.</para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was written by &dhusername; &dhemail; for
+      the &debian; system (but may be used by others).  Permission is
+      granted to copy, distribute and/or modify this document under
+      the terms of the &gnu; General Public License, Version 2 any 
+	  later version published by the Free Software Foundation.
+    </para>
+	<para>
+	  On Debian systems, the complete text of the GNU General Public
+	  License can be found in /usr/share/common-licenses/GPL.
+	</para>
+
+  </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
+