<?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>
