<?xml version="1.0" encoding="utf-8"?>
<!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 "1.10.1">
<!ENTITY manrevision "2.8">
<!ENTITY date "July 2015">
<!ENTITY applet "Clock">
]>
<!--
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://wiki.mate-desktop.org/dev-doc:doc-team-guide
  Template version: 2.0 beta
  Template last modified Feb 11, 2002

-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en-GB">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo>
	 <title>Clock Manual</title>
     <copyright><year>2015-2021</year> <holder>MATE Documentation Project</holder></copyright>
	 <copyright><year>2009</year> <year>2010</year> <holder>Paul Cutler</holder></copyright>
	 <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>MATE Documentation Project</publishername>
	 </publisher>
	 <publisher>
		<publishername>GNOME Documentation Project</publishername>
	 </publisher>


<!-- 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 role="maintainer"><firstname>MATE Documentation Project</firstname> <surname/> <affiliation><orgname>MATE Desktop</orgname></affiliation></author>
		<author><firstname>Paul </firstname> <surname> Cutler</surname> <affiliation> <orgname>GNOME Documentation Project</orgname> <address> <email>pcutler@gnome.org</email> </address> </affiliation></author>
		<author><firstname>Sun </firstname> <surname>Microsystems</surname> <affiliation> <orgname>GNOME Documentation Project</orgname> <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>

	 <releaseinfo revision="1.10.1" role="review">
	 </releaseinfo>

	 <revhistory>

		<revision><revnumber>Clock Applet Manual V2.8</revnumber> <date>July 2015</date> <revdescription>
			 <para role="author">MATE Documentation Team</para>
			 <para role="publisher">MATE Documentation Project</para>
		  </revdescription></revision>
		<revision><revnumber>Clock Applet Manual V2.7;</revnumber> <date>July 2015</date> <revdescription>
			 <para role="author">Paul Cutler</para>
			 <para role="publisher">GNOME Documentation Project</para>
		  </revdescription></revision>
		<revision><revnumber>Clock Applet Manual V2.6</revnumber> <date>July 2015</date> <revdescription>
			 <para role="author">Paul Cutler</para>
			 <para role="publisher">GNOME Documentation Project</para>
		  </revdescription></revision>
		<revision><revnumber>Clock Applet Manual V2.5</revnumber> <date>February 2004</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>Clock 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 1.10.1 of the Clock applet.</releaseinfo>
	 <legalnotice>
		<title>Feedback</title>
		<para>To report a bug or make a suggestion regarding the Clock applet or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.</para>

	 </legalnotice>
	 <abstract role="description">
		<para>The <application>Clock</application> applet displays the date and time, and when clicked, displays a calendar. The <application>Clock</application> can be customised to show seconds or a 12 or 24 hour clock.</para>
	 </abstract>
  </articleinfo>
  <indexterm><primary>Clock</primary></indexterm>
<!-- ============= Document Body ============================= -->

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

  <sect1 id="clock-introduction">
	 <title>Introduction</title>

<!-- ==== Figure ============================================= -->
	 <figure id="clock-fig">
		<title>Clock Applet</title>
		<screenshot>
		  <mediaobject><imageobject><imagedata fileref="figures/clock_applet.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows Clock applet.</phrase> </textobject></mediaobject>
		</screenshot>
	 </figure>
    <!-- ==== End of Figure ======================================= -->
<para>The <application>Clock</application> applet displays the date and time, and when clicked, displays a calendar. The <application>Clock</application> can be customised to show seconds or a 12 or 24 hour clock.</para>



<sect2 id="clock-introduction-add">
<title>To Add Clock 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> dialogue, 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>Clock</application> applet takes the time from the system clock.</para>
<para>To insert the date or time from the <application>Clock</application> applet into an application, perform the following steps:</para>
	<orderedlist>
		<listitem>
			<para>Right-click on the <application>Clock</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>

</sect1>

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

<sect1 id="clock-settings">
<title>Clock Preferences</title>
	<para>To configure the <application>Clock</application>, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>. You will be presented with three tabs to change preferences for <guimenuitem>General</guimenuitem>, <guimenuitem>Locations</guimenuitem> or <guimenuitem>Weather</guimenuitem>.</para>


<sect2 id="generalprefs">
	<title>General Preferences</title>
	<variablelist>
		  <varlistentry>
			 <term><guilabel>Clock Format</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>
			 </itemizedlist>
			 </listitem>
		  </varlistentry>
		  <varlistentry>
			 <term><guilabel>Show the date</guilabel></term>
			 <listitem>
			 <para>Select this option to display the date in the applet.</para>
			 </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 week numbers in calendar</guilabel></term>
			 <listitem>
			 <para>Select this option to display week numbers in the calendar.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry>
			 <term><guilabel>Show the weather</guilabel></term>
			 <listitem>
			 <para>Select this option to display the current weather forecast at your location. The weather will be displayed as an icon for sunny, cloudy, rainy or more.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry>
			 <term><guilabel>Show temperature</guilabel></term>
			 <listitem>
			 <para>Select this option to display the temperature at your location.</para>
			 </listitem>
		  </varlistentry>

	</variablelist>

</sect2>

<sect2 id="locationprefs">
	<title>Location Preferences</title>

	<variablelist>
		  <varlistentry>
			 <term><guilabel>Locations</guilabel></term>
			 <listitem>
			 <para>You can add one or more locations and their local time to be displayed in the Clock. To add a location:</para>
			 <itemizedlist>
			 <listitem>
			 <para>Press <guilabel>Add</guilabel></para>
			</listitem>
			 <listitem>
			 <para>Type the city, region or country name, and a list of options will appear in a drop-down box. Select a match from the pop-up and the <guilabel>Timezone</guilabel>, <guilabel>Latitude</guilabel>, and <guilabel>Longitude</guilabel> entries will be automatically filled in.</para>
			 </listitem>
			 </itemizedlist>
			 </listitem>
		  </varlistentry>
	</variablelist>

</sect2>


<sect2 id="weatherprefs">
	<title>Weather Preferences</title>

	<variablelist>
		  <varlistentry>
			 <term><guilabel>Weather</guilabel></term>
			 <listitem>
			 <para>You can display the Temperature unit in one of the following options from the drop-down box:</para>
			 <itemizedlist>
			 <listitem>
			 <para><guilabel>F</guilabel> (Fahrenheit)</para>
			</listitem>
			 <listitem>
			 <para><guilabel>C</guilabel> (Celsius)</para>
			</listitem>
			 <listitem>
			 <para><guilabel>K</guilabel> (Kelvin)</para>
			</listitem>
			 <listitem>
			 <para><guilabel>Default</guilabel> The default display for your region.</para>
			 </listitem>
			 </itemizedlist>
			 </listitem>
		  </varlistentry>
		  <varlistentry>
			 <term><guilabel>Wind speed unit</guilabel></term>
			 <listitem>
			 <para>You can display the Speed unit in one of the following options from the drop-down box:</para>
			 <itemizedlist>
			 <listitem>
			 <para><guilabel>Beaufort scale</guilabel></para>
			</listitem>
			 <listitem>
			 <para><guilabel>Knots</guilabel></para>
			</listitem>
			 <listitem>
			 <para><guilabel>mph</guilabel> (miles per hour)</para>
			</listitem>
			 <listitem>
			 <para><guilabel>km/h</guilabel> (kilometres per hour)</para>
			</listitem>
			 <listitem>
			 <para><guilabel>m/s</guilabel> (metres per second)</para>
			</listitem>
			 <listitem>
			 <para><guilabel>Default</guilabel> The default display for your region.</para>
			 </listitem>
			 </itemizedlist>
			 </listitem>
		  </varlistentry>
	</variablelist>

</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>Clock</application> applet displays, perform the following steps:</para>
    <orderedlist>
        <listitem>
            <para>Press the <guibutton>Time Settings</guibutton> button in the Preferences dialogue.</para>
        </listitem>
        <listitem>
            <para>Use the <guilabel>Date &amp; Time</guilabel> dialog to adjust the date and time.</para>
        </listitem>
        <listitem>
            <para>Press the <guibutton>Set System Time</guibutton> button, then the <application>mate-polkit</application> dialogue prompts for the administration password. Enter the administration password and press the <guibutton>Authenticate</guibutton> button.</para>
        </listitem>
    </orderedlist>
</sect2>

</sect1>

</article>
