<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appletversion "2.5.3.1">
  <!ENTITY manrevision "2.5">
  <!ENTITY date "February 2004">
  <!ENTITY applet "Clock">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 11, 2002
  
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
	 <title>&applet; Manual</title> 
	 <copyright> 
		<year>2002</year>
		<year>2003</year>  
		<year>2004</year>  
		<holder>Sun Microsystems</holder> 
	 </copyright> 
	 <copyright> 
		<year>2000</year> 
		<holder>Dan Mueth</holder> 
	 </copyright>
<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
	 <publisher role="maintainer"> 
		<publishername> GNOME Documentation Project </publishername> 
	 </publisher> 

&legal;
<!-- This file  contains link to license for the documentation (GNU FDL), and 
     other legal stuff such as "NO WARRANTY" statement. Please do not change 
     any of this. -->

	 <authorgroup> 
		<author> 
		  <firstname>Sun </firstname> 
		  <surname>Microsystems</surname> 
		  <affiliation> 
			 <orgname>GNOME Documentation Project</orgname> 
			 <address></address> 
		  </affiliation> 
		</author> 
		<author> 
		  <firstname>Dan </firstname> 
		  <surname> Mueth</surname> 
		  <affiliation> 
			 <orgname>GNOME Documentation Project</orgname> 
			 <address> <email>d-mueth@uchicago.edu</email> </address> 
		  </affiliation> 
		</author> 
      <!-- This is appropriate place for other contributors: translators,
           maintainers,  etc. Commented out by default.
           <othercredit role="translator">
	     <firstname>Latin</firstname> 
	     <surname>Translator 1</surname> 
	     <affiliation> 
	       <orgname>Latin Translation Team</orgname> 
	       <address> <email>translator@gnome.org</email> </address> 
	     </affiliation>
	     <contrib>Latin translation</contrib>
           </othercredit>
-->
	 </authorgroup>
  
	 <revhistory>
		<revision> 
		  <revnumber>&applet; Applet Manual V&manrevision;</revnumber> 
		  <date>&date;</date> 
		  <revdescription> 
			 <para role="author">Sun Microsystems</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>
		<revision> 
		  <revnumber>Clock Applet Manual V2.4</revnumber> 
		  <date>September 2003</date> 
		  <revdescription> 
			 <para role="author">Sun Microsystems</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>
		<revision> 
		  <revnumber>Clock Applet Manual V2.3</revnumber> 
		  <date>January 2003</date> 
		  <revdescription> 
			 <para role="author">Sun Microsystems</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>
		<revision> 
		  <revnumber>Clock Applet Manual V2.2</revnumber> 
		  <date>August 2002</date> 
		  <revdescription> 
			 <para role="author">Sun Microsystems</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>
		<revision> 
		  <revnumber>Clock Applet Manual V2.1</revnumber> 
		  <date>June 2002</date> 
		  <revdescription> 
			 <para role="author">Sun Microsystems</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>
		<revision> 
		  <revnumber>Clock Applet Manual V2.0</revnumber> 
		  <date>March 2002</date> 
		  <revdescription> 
			 <para role="author">Sun Microsystems</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>&applet; Applet Manual</revnumber> 
		  <date>April 2000</date> 
		  <revdescription> 
			 <para role="author">Dan Mueth
				<email>d-mueth@uchicago.edu</email></para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
	 </revhistory> 
	 <releaseinfo> This manual describes version &appletversion; of the &applet; applet.
		</releaseinfo> 
	 <legalnotice> 
		<title>Feedback</title> 
		<para> To report a bug or make a suggestion regarding the &applet; applet or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. </para>
		
	 </legalnotice> 
	 <abstract role="description">
	 	<para>The &applet; displays the time and date in a panel.</para>
	 </abstract>
  </articleinfo> 
  <indexterm> 
	 <primary>Clock</primary> 
  </indexterm> 
<!-- ============= Document Body ============================= -->

<!-- ============= Introduction ============================== -->

  <sect1 id="clock-introduction"> 
	 <title>Introduction</title> 
	 
<!-- ==== Figure ============================================= -->
	 <figure id="clock-fig"> 
		<title>&applet; Applet</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/clock_applet.png"
				format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows &applet; applet.</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 
    <!-- ==== End of Figure ======================================= -->
<para>
The <application>&applet;</application> applet displays the time and the date in a panel. 
</para>

<sect2 id="clock-introduction-add">
<title>To Add &applet; to a Panel</title>
  <para>Perform the following steps:</para>
         <orderedlist>
           <listitem>
             <para>
               Right-click on the panel.
             </para>
           </listitem>
           <listitem>
             <para>
               Choose <guimenuitem>Add to Panel</guimenuitem>.
             </para>
           </listitem>
           <listitem>
             <para>
               Scroll down the list of items in the <guilabel>Add to Panel</guilabel> dialog, then select <guilabel>Clock</guilabel>.
             </para>
           </listitem>
           <listitem>
             <para>
               Click <guibutton>Add</guibutton>.
             </para>
           </listitem>
         </orderedlist>
    </sect2>
</sect1>
<!-- ================ Usage ================================ -->

  <sect1 id="clock-usage"> 
	 <title>Usage</title> 

	<sect2 id="clock-usage-calendar">
	<title>To Show the Calendar</title>	
	<para>Click on the applet to open a small calendar showing the current month. To close the calendar, click again on the part of the applet that is in the panel.</para>
	
	<para>You can change the month shown in the calendar by clicking the arrows to each side of the month and year text.</para>	
	
	<para>Double-click a day in the calendar to launch the <application>Evolution</application> groupware application.</para>
	</sect2>

	<sect2 id="clock-usage-copy">
	<title>To Insert the Date or Time Into an Application</title>	
<para>The <application>&applet;</application> applet takes the time from the system clock.
</para>
<para>
	To insert the date or time from the <application>&applet;</application> applet into an application, perform the following steps:</para>
	<orderedlist>
		<listitem>
			<para>Right-click on the <application>&applet;</application> applet.
			</para>
		</listitem>
		<listitem>
			<para>
				Choose one of the following menu items from the applet popup menu:
			</para>
			<itemizedlist>
				<listitem>
					<para>
					<guimenuitem>Copy Time</guimenuitem>
					</para>
				</listitem>
				<listitem>
					<para>
					<guimenuitem>Copy Date</guimenuitem>
					</para>
				</listitem>
			</itemizedlist>
		</listitem>
		<listitem>
			<para>
			Point to the location in your application where you want to insert the item.
			</para>
		</listitem>
		<listitem>
			<para>
			Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem> </menuchoice> or middle-click to insert the item.
			</para>
		</listitem>
		</orderedlist>
	</sect2>

	<sect2 id="clock-usage-adjust">
	<title>To Adjust the System Date or Time</title>
	<para>To adjust the system date or time that the <application>&applet;</application> applet displays, perform the following steps:	</para>
	<orderedlist>
	<listitem>
			<para>Right-click on the applet, then choose <guimenuitem>Adjust Date &amp; Time</guimenuitem>.
			</para>
	</listitem>
	<listitem>
			<para>Type the <literal>root</literal> password, then click <guibutton>OK</guibutton>.
			</para>
	</listitem>
	<listitem>
			<para>The <application>&applet;</application> applet starts the system tool that sets the system date and time. Use the tool to adjust the date and time.
			</para>
	</listitem>
	</orderedlist>
	</sect2>

</sect1>

<!-- ============= Preferences ============================= -->

<sect1 id="clock-settings"> 
<title>Preferences</title> 
	<para>
	To configure <application>&applet;</application>, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>. </para>
	
	
	<variablelist> 
		  <varlistentry> 
			 <term><guilabel>Clock type</guilabel></term> 
			 <listitem> 
			 <para>Select one of the following options:</para> 
			 <itemizedlist>
			 <listitem>
			 <para><guilabel>12 hour</guilabel></para>
			 <para>Display the time in the a.m./p.m. format.</para>
			 <note><para>This option is not shown if your session language does not use the 12 hour clock.</para></note>
			 </listitem>
			 <listitem>
			 <para><guilabel>24 hour</guilabel></para>
			 <para>Display the time in the 00.00 to 24.00 format.</para>
			 </listitem>
			 <listitem>
			 <para><guilabel>UNIX time</guilabel></para>
			 <para>Display the time in seconds elapsed since January 1, 1970. Developers are the primary users of UNIX time. </para>
			 </listitem>
			 <listitem>
			 <para><guilabel>Internet time</guilabel></para>
			 <para>Display Internet time in the applet. Internet time is the same all over the world, which enables Internet users to synchronize to a common time. The day is divided into 1000 parts called ".beats".</para>
			 </listitem>
			 </itemizedlist>
			 </listitem> 
		  </varlistentry> 
		  <varlistentry> 
			 <term><guilabel>Show seconds</guilabel></term>
			 <listitem> 
			 <para>Select this option to display seconds in the applet.</para> 
			 </listitem> 
		  </varlistentry>
		  <varlistentry> 
			 <term><guilabel>Show date</guilabel></term>
			 <listitem> 
			 <para>Select this option to display the date in the applet.</para> 
			 </listitem> 
		  </varlistentry>
		  <varlistentry> 
			 <term><guilabel>Use UTC</guilabel></term>
			 <listitem> 
			 <para>Select this option to display Universal Coordinated Time, also known as Greenwich Mean Time, in the applet.</para> 
			 </listitem> 
		  </varlistentry>
	</variablelist>		  
	
</sect1> 
</article> 
