<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<!--
	``MakeMan'' SGML Template for a man page
	For more Information, please see http://mama.sourceforge.net

	$Author: Jan Schaumann <jschauma@netmeister.org> $
	$Id: template.sgml, v 0.2 2001/08/24 11:18:34 jschauma Exp $
-->

<refentry id="gnomecal">
	<refmeta>
		<refentrytitle>GNOMECAL</refentrytitle>
		<manvolnum>1</manvolnum>
		<refmiscinfo class="date">August 25th, 2001</refmiscinfo>
		<refmiscinfo class="source">gnome-pim</refmiscinfo>
		<refmiscinfo class="title">GNOME User's Manual</refmiscinfo>
	</refmeta>

	<refnamediv>
		<refname>gnomecal</refname>
		<refpurpose>the GNOME calendar</refpurpose>
	</refnamediv>

	<refsynopsisdiv>
		<cmdsynopsis>
			<command>gnomecal</command>
				<arg choice="opt" rep="repeat">OPTION</arg>
		</cmdsynopsis>
	</refsynopsisdiv>

	<refsect1>
		<title>DESCRIPTION</title>
		<para>
			<command>gnomecal</command>, part of the
			<emphasis>gnome-pim</emphasis> package, is a simple calendar
			applications which can be quite useful in your daily work. The
			Calendar, like much of GNOME, is in its infancy and while it is a
			very useful application, there is some very impressive
			functionality still to come like network shared calendar usage,
			and syncing capability with Palm Pilots and other hand held PDAs.
			The Calendar can be launched from the Applications submenu of the
			Main Menu.
		</para>
		<para>
			The Calendar is broken up into four main tabs: Day, Week, Month,
			and Year. Each view allows you to view the respective time
			period but will also allow you to schedule appointments from any
			one of the tabs.
		</para>
	</refsect1>
	
	<refsect1>
		<title>OPTIONS</title>
		<para>
			This program follows the usual GNU command line syntax,
            with long options starting with two dashes (`--'). A
            summary of the options supported by <command>gnomecal</command>
            is included below.
		</para>
		<refsect2>
			<title>GNOME options</title>
			<variablelist>
				<varlistentry>
					<term>--disable-sound</term>
					<listitem>
						<para>Disable sound server usage</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--enable-sound</term>
					<listitem>
						<para>Enable sound server usage</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--espeaker=<replaceable>HOSTNAME:PORT</replaceable></term>
					<listitem>
						<para>
							Host:port on which the sound server to use is running
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--version</term>
					<listitem>
						<para>Display version information and exit</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>Help options</title>
			<variablelist>
				<varlistentry>
					<term>-?, --help</term>
					<listitem>
						<para>Show help and exit</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--usage</term>
					<listitem>
						<para>Display brief usage message</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>GTK options</title>
			<variablelist>
				<varlistentry>
					<term>--gdk-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gdk debugging flags to set</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gdk-no-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gdk debugging flags to unset</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--display=<replaceable>DISPLAY</replaceable></term>
					<listitem>
						<para>X display to use</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--sync</term>
					<listitem>
						<para>Make X calls synchronous</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--no-xshm</term>
					<listitem>
						<para>Don't use X shared memory extension</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--name=<replaceable>NAME</replaceable></term>
					<listitem>
						<para>
							Program name as used by the window manager
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--class=<replaceable>CLASS</replaceable></term>
					<listitem>
						<para>Program class as used by the window
						manager</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gxid_host=<replaceable>HOST</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--gxid_port=<replaceable>PORT</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--xim-preedit=<replaceable>STYLE</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--xim-status=<replaceable>STYLE</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--gtk-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gtk+ debugging flags to set</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gtk-no-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gtk+ debugging flags to unset</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--g-fatal-warnings</term>
					<listitem>
						<para>Make all warnings fatal</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gtk-module=<replaceable>MODULE</replaceable></term>
					<listitem>
						<para>Load an additional Gtk module</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>GNOME GUI options</title>
			<variablelist>
				<varlistentry>
					<term>--disable-crash-dialog</term>
					<listitem><para></para></listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>Session management options</title>
			<variablelist>
				<varlistentry>
					<term>--sm-client-id=<replaceable>ID</replaceable></term>
					<listitem>
						<para>Specify session management ID</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--sm-config-prefix=<replaceable>PREFIX</replaceable></term>
					<listitem>
						<para>Specify prefix of saved configuration</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--sm-disable</term>
					<listitem>
						<para>Disable connection to session manager</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>gnomecal options</title>
			<variablelist>
				<varlistentry>
					<term>-e, --events</term>
					<listitem><para>Show events and quit</para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--todo</term>
					<listitem><para>Show TO-DO items and quit</para></listitem>
				</varlistentry>
				<varlistentry>
					<term>-f, --from=<replaceable>DATE</replaceable></term>
					<listitem>
						<para>
							Specifies start <replaceable>DATE</replaceable> (for <command>--events</command>)
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>-F, --file=<replaceable>FILE</replaceable></term>
					<listitem><para><replaceable>FILE</replaceable> to load calendar from</para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--userfile</term>
					<listitem><para>Load the user calendar</para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--geometry=<replaceable>GEOMETRY</replaceable></term>
					<listitem><para><replaceable>GEOMETRY</replaceable> for starting up</para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--view=<replaceable>VIEW</replaceable></term>
					<listitem>
						<para>
							The startup view mode (dayview, weekview, monthview, yearview)
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--hidden</term>
					<listitem>
						<para>
							If used, starts in iconic mode
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>-d, --debug=<replaceable>TYPE</replaceable></term>
					<listitem>
						<para>
							Enable debugging output of <replaceable>TYPE</replaceable> (alarms)
						</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
	</refsect1>

	<refsect1>
		<title>BUGS</title>
		<para>
			Please report bugs at <ulink
			url="http://bugs.gnome.org/">http://bugs.gnome.org/</ulink>.
		</para>
	</refsect1>

	<refsect1>
		<title>SEE ALSO</title>
		<para>
			<command>gnomecard(1)</command>
		</para>
		<para>
			The <command>gnomecal</command> manual:
			<filename>/usr/share/gnome/help/gnomecal/C/index.html</filename>
		</para>
		<para>
			<ulink url="www.gnome.org/gnome-office/gnome-pim.shtml">GNOME PIM
			Homepage</ulink>
		</para>
		<para>
			<ulink url="http://www.gnome.org">GNOME</ulink>
		</para>
	</refsect1>

	<refsect1>
		<title>AUTHOR</title>
		<para>
			Dave Mason <email>dcm@redhat.com</email>		
		</para>
		<para>
			Miguel de Icaza Amozurrutia <email>miguel@gnu.org</email>
		</para>
		<para>
			This man-page was written by Jan Schaumann
			<email>jschauma@netmeister.org</email> as part of "<ulink
			url="http://www.netmeister.org/misc/m2p2/index.html">The Missing
			Man Pages Project</ulink>".
		</para>
	</refsect1>
</refentry>
