 <sect1 id="asclock">
  <title>AfterStep Clock Applet</title>

   <para>
   The <application>AfterStep Clock</application> applet, shown in <xref
   linkend="asclock-applet-fig">, is an applet which 
   displays the time in both analogue (clockface) and digital format 
   along with the day of the week and the date. It is based on the look
   of the NeXTStep clock.  This document describes version 2.1.10 of 
   <application>AfterStep Clock</application>.
  </para>
  <para>  
   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>AfterStep Clock</guimenuitem>
   </menuchoice>.
  </para>

  <figure id="asclock-applet-fig">
   <title>AfterStep Clock Applet</title>
   <screenshot>
    <screeninfo>AfterStep Clock Applet</screeninfo>
    <graphic format="png" fileref="figures/asclock_applet" 
    srccredit="Aaron Weber">
    </graphic>
   </screenshot>
  </figure>

  <!-- ============= Usage  ================================ -->
  <sect2 id="asclock-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 you the time and date.
   </para>

   <para>
    Right-clicking on the applet brings up a menu containing the
    following items:
    <itemizedlist>

     <listitem>
      <para>
       <guimenuitem>Properties&hellip;</guimenuitem> &mdash;
       opens the <link linkend="asclock-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>ASClock
       Applet</application>, inluding the applet's version and the
       author's name.
      </para>
     </listitem>

    </itemizedlist>
   </para>
  </sect2>


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

    <figure id="asclock-settings-fig">
     <title>Properties dialog</title>
     <screenshot>
      <screeninfo>Properties dialog</screeninfo>
      <graphic format="png" fileref="figures/asclock_settings"
      srccredit="Aaron Weber">
      </graphic>
     </screenshot>
    </figure>

  <para>
    Your properties in the <guilabel>General</guilabel> tab are:
    <itemizedlist>

     <listitem>
      <para>
       Display time in 12 hour format (AM/PM) &mdash;  Clicking this
       will display the time in a 12 hour format. The default state,
       off, uses a 24-hour clock. 
      </para>
     </listitem>

     <listitem>
      <para>
       Blinking elements in clock &mdash;  When the
       <application>AfterStep clock applet</application> starts 
       up, by default it displays a blinking colon between the hour and
       minute display. Clicking this turns this blinking off.
      </para>
     </listitem>

     <listitem>
      <para>
       Clock theme &mdash;  The <application>AS Clock</application>
       applet can take on a number of different appearances. Select
       the theme (appearance) from this list.
      </para>
     </listitem>

    </itemizedlist>
   </para>


   <para>
    The <guilabel>Timezone</guilabel> tab is used to specify your
    timezone. Select the continent and city your are in or closest
    to.
   </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="bugs">
   <title>Known Bugs and Limitations</title>
     <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>
     <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>
     <para>
        Switching between a lot of themes or a lot of timezones seems
        to use up inordinate amounts of memory.
      </para>
   </sect2>


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

  <sect2 id="authors">
   <title>Authors</title>


  <para>
     The <application>AfterStep Clock applet</application> was written
     by Beat Christen (<email>spiff@longstreet.ch</email>) and
     Patrick Rogan (<email>rogan@lycos.com</email>).
     Please send all comments, suggestions, and bug 
     reports regarding the software 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>hobbit@aloss.ukuu.org.uk</email>) and Aaron Weber 
    (<email>aaron@helixcode.com</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 <citetitle>GNU General Public
    License</citetitle> 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>
    A copy of the <citetitle>GNU General Public License</citetitle> is
    included as an appendix to the <citetitle>GNOME Users
    Guide</citetitle>.  You may also 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>





