 <sect1 id="anotherclock">
  <title>Another Clock</title>
  <para>
   <application>Another Clock</application> applet, shown in <xref
   linkend="anotherclock-applet">, is a simple analog clock (similar
   to that in the CDE, Common Desktop Environment, panel). To add this
   applet to a <interface>Panel</interface>, 
   right-click on the <interface>Panel</interface> and choose
   <menuchoice>
    <guimenu>Panel</guimenu>
    <guisubmenu>Add to panel</guisubmenu>
    <guisubmenu>Applet</guisubmenu>
    <guisubmenu>Clocks</guisubmenu>
    <guimenuitem>Another Clock</guimenuitem>
   </menuchoice>.
  </para>

  <figure id="anotherclock-applet">
    <title>Another Clock Applet</title>
    <screenshot>
      <screeninfo>Another Clock Applet</screeninfo>
      <graphic format="png" fileref="figures/anotherclock-applet" 
	     srccredit="Eric Baudais">
      </graphic>
    </screenshot>
  </figure>
  
  <!-- ============= Usage  ================================ -->
  <sect2 id="anotherclock-usage">
    <title>Usage</title>
    <para>
      You don't need to do anything special to this clock. It will just
      sit on your panel and tell the time for you.
    </para>
    
    <itemizedlist>
      
      <listitem>
	<para>
	  <guimenuitem>Properties&hellip;</guimenuitem> &mdash;
	  opens the <link linkend="anotherclock-prefs">
	  <guilabel>Properties</guilabel></link> dialog.
	</para>
      </listitem>
      
      <listitem>
	<para>
	  <guimenuitem>Help</guimenuitem> &mdash;
	  displays this document.
	</para>
      </listitem>
      
      <listitem>
	<para>
	  <guimenuitem>About&hellip;</guimenuitem> &mdash;
	  shows basic information about <application>Another Clock
	  Applet</application>, inluding the applet's version and the
	  author's name.
	</para>
      </listitem>

    </itemizedlist>

   </sect2>


  <!-- ============= Customization ============================= -->
   <sect2 id="anotherclock-prefs">
    <title>Customization</title>
    <para>
     You can customize <application>Another Clock</application> by
      right-clicking on it and choosing 
      <guimenuitem>Properties&hellip;</guimenuitem>. This will open the
      <interface>Properties</interface> dialog(shown in <xref
      linkend="anotherclock-settings-fig">), which allows you to
      change various settings.
    </para>


    <figure id="anotherclock-settings-fig">
      <title>Properties dialog</title>
      <screenshot>
	<screeninfo>Properties dialog</screeninfo>
	<graphic format="png" fileref="figures/anotherclock-properties"
	       srccredit="Eric Baudais">
	</graphic>
      </screenshot>
    </figure>

    <para>
     The properties are:
     <itemizedlist>

      <listitem>
       <para>
        Clock color &mdash; This is currently greyed-out, but in the
        future it will  be possible to adjust the colour of the clockface. 
       </para>
      </listitem>

      <listitem>
       <para>
        Hour needle color &mdash; Set this to the color you wish to
        use for the hour needle (hand) of the clock.
       </para>
      </listitem>

      <listitem>
       <para>
        Minute needle color &mdash; Set this to the color you wish to
        use for the minute needle (hand) of the clock.
       </para>
      </listitem>

      <listitem>
       <para>
        Second needle color &mdash; Set this to the color you wish to
        use for the second needle (hand) of the clock.
       </para>
      </listitem>

      <listitem>
       <para>
        Show seconds needle &mdash; If this button is checked, the
        second needle (hand) of the clock will be shown.
       </para>
      </listitem>

     </itemizedlist>
    </para>

    <para> 
      After you have made all the changes you want, click on
      <guibutton>OK</guibutton> to apply the changes and close the
      <interface>Properties</interface> dialog. To cancel the changes
      and return to previous values, click the
      <guibutton>Cancel</guibutton> button.
    </para>
  </sect2>


  <!-- ============= Bugs ================================== -->
  <!-- This section should describe known bugs and limitations of
       the program if there are any - please be frank and list all
       problems you know of -->
   <sect2 id="anotherclock-bugs">
    <title>Known Bugs and Limitations</title>
    <orderedlist>
<!--     <listitem>  Jacob says this should be fixed with GTK+-1.2.7.
      <para>
        You can't change the time through the clock properties. This
        is not really a bug; it's because you must be root to alter 
        the time for the whole of the system, using the <command>
        date</command> command.
      </para>
     </listitem>-->
     <listitem>
      <para>
        If you adjust the system clock backwards using the <command>
        date</command> command, the clock will stop working until the
        system time reaches the time the clock displays. It will start
        working normally then.
      </para>
     </listitem>
    </orderedlist>
   </sect2>

  <!-- ============= Authors ================================ -->

  <sect2 id="authors">
   <title>Authors</title>
   <para>
    <application>Another Clock</application> was written by 
    I&ntilde;igo Serna (<email>inigo@gazletan.bi.ehu.es</email>).  
    Please send all comments, suggestions, and bug 
    reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
    bug tracking database</ulink>. (Instructions for submitting bug
    reports can be found <ulink
    url="http://bugs.gnome.org/Reporting.html" type="http">
    on-line</ulink>. If you are using
    GNOME 1.1 or later, you can also use <application>Bug Report
    Tool</application> (<command>bug-buddy</command>), available in the
    <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
    Menu</guimenu>, for submitting bug reports.
   </para>

   <para>
    This manual was written by Telsa Gwynne (<email>telsa@linuxchix.org</email>)
    and Eric Baudais (<email>baudais@okstate.edu</email>). Please send all comments and
    suggestions regarding this manual to the <ulink type="http"
    url="http://www.gnome.org/gdp">GNOME Documentation Project</ulink> 
    by sending an email to <email>docs@gnome.org</email>. You can also
    submit comments online by using the <ulink type="http"
    url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
    Table</ulink>.
   </para>

   <!-- For translations: uncomment this:

   <para>  
    Latin translation was done by ME
    (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
    suggestions regarding this translation to SOMEWHERE.
   </para>

   -->

  </sect2>


  <!-- ============= Application License ============================= -->

  <sect2 id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the  <ulink type="help" url="gnome-help:gpl">
    <citetitle>GNU General Public License</citetitle></ulink> as
   published by the Free Software Foundation; 
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   You may obtain a copy of the <citetitle>GNU General Public License</citetitle>
   from the Free Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect2>

  </sect1>



