<?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 toolversion "2.15.2">
  <!ENTITY manrevision "2.15.2">
  <!ENTITY date "August 2006">
  <!ENTITY tool "Time Administration Tool">
]>
<!-- 
      (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 06, 2003
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&tool; Manual</title> 
    <copyright>
      <year>2004-2006</year>
      <holder>Carlos Garnacho Parro</holder>
    </copyright>

<!-- translators: uncomment this:
  <copyright>
   <year>2003</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>
   -->

    <publisher role="maintainer"> 
	 <publishername>Carlos Garnacho Parro</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>Carlos</firstname>
        <surname>Garnacho Parro</surname>
      </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>&tool; Manual V&manrevision;</revnumber>
	   <date>&date;</date>
	   <revdescription>
          <para role="author">carlosg@gnome.org (Carlos Garnacho Parro)</para>
          <para role="publisher">carlosg@gnome.org (Carlos Garnacho Parro)</para>
	   </revdescription>
	 </revision>
	 <revision>
	   <revnumber>&tool; Manual V0.35</revnumber>
	   <date>June 2004</date>
	   <revdescription>
          <para role="author">carlosg@gnome.org (Carlos Garnacho Parro)</para>
          <para role="publisher">carlosg@gnome.org (Carlos Garnacho Parro)</para>
	   </revdescription>
	 </revision>
    </revhistory>

    <releaseinfo>This manual describes version &toolversion; of &tool;.</releaseinfo> 

    <legalnotice> 
	 <title>Feedback</title> 
	 <para> To report a bug or make a suggestion regarding the &tool; 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 &tool; allows you to set the time, date and timezone of your system, as well as setting any time server to synchronize your local time server.</para>
    </abstract> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>Time Administration Tool</primary> 
  </indexterm> 

  <!-- ============= Document Body ============================= -->
  <sect1 id="tool-introduction"> 
    <title>Introduction</title> 
    <para>The <application>&tool;</application> allows you to set the time, date and timezone of your system, as well as setting any time server to synchronize your local time server.</para> 
  </sect1>

  <sect1 id="tool-getting-started">
    <title>Getting started</title>

    <para>You can start <application>&tool;</application> in the following ways:</para>

    <variablelist>
	 <varlistentry>
	   <term><guimenu>System</guimenu> menu</term>
	   <listitem>
		<para>Choose <menuchoice><guisubmenu>Administration</guisubmenu><guimenuitem>Time and Date</guimenuitem></menuchoice>.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Context menu in the clock applet</term>
	   <listitem>
		<para>Choose <menuchoice><guisubmenu>Adjust Date and Time</guisubmenu></menuchoice>.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Command line</term>
	   <listitem>
		<para>Execute the following command: <command>time-admin</command></para>
	   </listitem>
	 </varlistentry>
    </variablelist>

    <para>When you start <application>&tool;</application>, you may be prompted for the administrator password, this is necessary because the changes done with this tool will affect the whole system.</para>

    <para>After entering the administrator password, the time configuration window is displayed.</para>

    <figure id="time-main-window-automatic">
	 <title>&tool; main window, automatic configuration mode</title>
	 <screenshot>
	   <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/time-tool-automatic.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>Shows &tool; main window, automatic configuration mode.</phrase>
		</textobject>
	   </mediaobject>
	 </screenshot>
    </figure>

    <figure id="time-main-window-manual">
	 <title>&tool; main window, manual configuration mode</title>
	 <screenshot>
	   <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/time-tool-manual.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>Shows &tool; main window, manual configuration mode.</phrase>
		</textobject>
	   </mediaobject>
	 </screenshot>
    </figure>

    <para>The <application>&tool;</application> main window contains the following elements:</para>

    <variablelist>
	 <varlistentry>
	   <term>Time zone</term>
	   <listitem>
		<para>Displays your current timezone, the button displays a map for selecting timezone.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Configuration type</term>
	   <listitem>
	     <para>It can be either:</para>
	     <variablelist>
	       <varlistentry>
	         <term><guilabel>Keep synchronized with Internet servers</guilabel></term>
		 <listitem>
		   <para>You will be able to choose from a list of Internet servers to keep your computer clock synchronized automatically.</para>
		 </listitem>
	       </varlistentry>
	       <varlistentry>
	         <term><guilabel>Manual</guilabel></term>
		 <listitem>
		   <para>You will be able to fully specify date and time by hand.</para>
		 </listitem>
	       </varlistentry>
	     </variablelist>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term><guilabel>Synchronize now</guilabel> button</term>
	   <listitem>
		<para>This will allow you to synchronize just once with the selected Internet servers.</para>
	   </listitem>
	 </varlistentry>
    </variablelist>
  </sect1>

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

    <sect2>
	 <title>To change your time or date</title>
	 <para>Just change the time spin buttons or the date in the calendar.</para>
    </sect2>

    <sect2 id="tool-time-zone">
	 <title>To change your time zone</title>
	 <para>Click on the <guilabel>Select time zone</guilabel> button and select the new location, alternatively you can also select the new location from the list below.</para>

	 <figure id="time-map-window">
	   <title>&tool; map</title>
	   <screenshot>
		<mediaobject>
		  <imageobject>
		    <imagedata fileref="figures/time-map.png" format="PNG"/>
		  </imageobject>
		  <textobject>
		    <phrase>Shows &tool; map window.</phrase>
		  </textobject>
		</mediaobject>
	   </screenshot>
	 </figure>
    </sect2>

    <sect2 id="tool-time-servers">
	 <title>To synchronize your local time server with internet time servers</title>
	 <para>If the checkbox is disabled, enable it, then click on the <guilabel>Select servers</guilabel> button and select a new server in the list.</para>

	 <figure id="time-servers-window">
	   <title>&tool; servers window</title>
	   <screenshot>
		<mediaobject>
		  <imageobject>
		    <imagedata fileref="figures/time-servers.png" format="PNG"/>
		  </imageobject>
		  <textobject>
		    <phrase>Shows &tool; servers window.</phrase>
		  </textobject>
		</mediaobject>
	   </screenshot>
	 </figure>
    </sect2>
  </sect1>
</article> 
