Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdetoys@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 92 insertions, 0 deletions

diff --git a/doc/kworldclock/man-kworldclock.1.docbook b/doc/kworldclock/man-kworldclock.1.docbook
new file mode 100644
index 0000000..a002159
--- /dev/null
+++ b/doc/kworldclock/man-kworldclock.1.docbook
@@ -0,0 +1,92 @@
+<?xml version="1.0" ?>
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!ENTITY % English "INCLUDE">
+]>
+
+<refentry lang="&language;">
+<refentryinfo>
+  <author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author>
+<date>April 8, 2003</date>
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>kworldclock</command></refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>kworldclock</command></refname>
+<refpurpose>Earth watcher for &kde;</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>kworldclock</command>
+
+<group><option>--dump</option></group>
+<group><option>--theme</option>
+<replaceable>file</replaceable></group>
+<group><option>-o</option> <replaceable>file</replaceable></group>
+<group><option>--size</option>
+<arg>WxH</arg></group>
+<group><option>KDE Generic Options</option></group>
+<group><option>Qt Generic Options</option></group>
+
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+<title>Description</title>
+
+<para>&kworldclock; displays where in the world it is light and dark
+depending on time, as well as offering the time in all of the major
+cities of the world. This can be run standalone, as an applet in the
+&kde; panel, or configured to draw the desktop background.</para> 
+
+<para>&kworldclock; is part of the official &kde; kdetoys
+package.</para>
+
+</refsect1>
+
+<refsect1>
+<title>Options</title>
+
+<variablelist>
+<varlistentry>
+<term><option>--dump</option></term>
+<listitem><para>Write out a file containing the actual
+map</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>--theme</option> <replaceable>file</replaceable></term>
+<listitem><para>The name of the theme to use for a map dump (default:
+earth).</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>-o</option> <replaceable>file</replaceable></term>
+<listitem><para>The name of the file to write to for a map dump
+(default: dump.ppm).</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>--size</option> <replaceable>WxH</replaceable></term>
+<listitem><para>The size of the map to dump.</para></listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>See Also</title>
+
+<para>More detailed user documentation is available from <ulink
+url="help:/kworldclock">help:/kworldclock</ulink> (either enter this
+<acronym>URL</acronym> into &konqueror;, or run
+<userinput><command>khelpcenter</command>
+<parameter>help:/kworldclock</parameter></userinput>).</para>
+
+</refsect1>
+<refsect1><title>Authors</title><para>&kworldclock; was written by
+&Matthias.Hoelzer-Kluepfel;
+&Matthias.Hoelzer-Kluepfel.mail;</para><para>This manual page was
+prepared by <personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></para></refsect1>
+</refentry>