<HTML
><HEAD
><TITLE
>Clock Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>Clock Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>Dan Mueth</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#CLOCK"
>Clock Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="CLOCK"
>Clock Applet</A
></H1
><P
>   <TT
CLASS="APPLICATION"
>Clock</TT
> applet, shown in <A
HREF="index.html#CLOCKAPPLET-FIG"
>Figure 1</A
>, is a simple applet which shows the
   time (and optionally the date too) in any of several formats.  To
   add this applet to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, 
   right-click on the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and choose
   <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Clocks</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Clock</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="CLOCKAPPLET-FIG"
></A
><P
><IMG
SRC="clock_applet.png"></P
><P
><B
>Figure 1. Clock Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="CLOCK-USAGE"
>Usage</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>Clock</TT
> applet requires no user
    input. You may optionally configure it, as described below. 
   </P
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
       opens the <A
HREF="index.html#CLOCK-PREFS"
>       <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
> dialog.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212;
       displays this document.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>About&#8230;</B
> &#8212;
       shows basic information about <TT
CLASS="APPLICATION"
>Clock
       Applet</TT
>, including the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="CLOCK-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>Clock</TT
>
      applet by right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog(shown in <A
HREF="index.html#CLOCK-SETTINGS-FIG"
>Figure 2</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="CLOCK-SETTINGS-FIG"
></A
><P
><IMG
SRC="clock_settings.png"></P
><P
><B
>Figure 2. Properties dialog</B
></P
></DIV
><P
>     The properties are:
     <P
></P
><UL
><LI
><P
>        Time Format &#8212; Select either <TT
CLASS="GUILABEL"
><B
>12 hour</B
></TT
>
        format for <SPAN
CLASS="QUOTE"
>"AM/PM"</SPAN
> formatted time, or
        <TT
CLASS="GUILABEL"
><B
>24 hour</B
></TT
> for a 24 hour clock.
       </P
></LI
><LI
><P
>        Show date in applet &#8212; Select this to show the date
        inside the applet.
       </P
></LI
><LI
><P
>        Show date in tooltip &#8212; Select this to show the date in
        the tooltip that pops up when the mouse is briefly left over
        the applet.
       </P
></LI
><LI
><P
>        Use GMT &#8212; Select this to show the Greenwich Mean Time
        instead of the local time.
       </P
></LI
><LI
><P
>        Unix time &#8212; Select this to show the time, in seconds,
        that has elapsed since Jan 1, 1970.
       </P
></LI
></UL
>
    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Close</B
> button.
    </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Setting the Time</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>     <TT
CLASS="APPLICATION"
>Clock</TT
> applet only displays the time;
     it does not allow you to set the time.  In order to set the time
     on a Unix or Linux system, you should use the
     <B
CLASS="COMMAND"
>date</B
> command. For example, to set the time to
     11:43:01PM and the date to April 4, use <B
CLASS="COMMAND"
>date --set="Apr
     4 23:43:01"</B
>. Note that you must be logged in as root to
     set the time. To learn more about the <B
CLASS="COMMAND"
>date</B
> command,
     type <B
CLASS="COMMAND"
>man date</B
> at a terminal prompt. You may
     set your timezone using the <B
CLASS="COMMAND"
>timeconfig</B
> or
     <B
CLASS="COMMAND"
>tzselect</B
> commands on some Linux
     distributions.
    </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="BUGS"
>Known Bugs and Limitations</A
></H2
><P
>    This applet has no known bugs.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AUTHORS"
>Authors</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>Clock</TT
> was written by Miguel de Icaza
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:miguel@kernel.org"
>miguel@kernel.org</A
>&#62;</TT
>), Federico Mena
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:quartic@gimp.org"
>quartic@gimp.org</A
>&#62;</TT
>), and Stuart Parmenter
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:pavlov@innerx.net"
>pavlov@innerx.net</A
>&#62;</TT
>).  Please send all comments,
    suggestions, and bug 
    reports to the <A
HREF="http://bugs.gnome.org"
TARGET="_top"
>GNOME
    bug tracking database</A
>. (Instructions for submitting bug
    reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>    on-line</A
>. If you are using
    GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
    Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
    <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
    Menu</B
>, for submitting bug reports.
   </P
><P
>    This manual was written by Dan Mueth
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:d-mueth@uchicago.edu"
>d-mueth@uchicago.edu</A
>&#62;</TT
>). Please send all comments and
    suggestions regarding this manual to the <A
HREF="http://www.gnome.org/gdp"
TARGET="_top"
>GNOME Documentation Project</A
> 
    by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
    submit comments online by using the <A
HREF="http://www.gnome.org/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
    Table</A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
    License</I
> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </P
><P
>    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
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
   </P
><P
>    A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
    included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
    Guide</I
>.  You may also obtain a copy of the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
    Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
></DIV
></DIV
></DIV
></BODY
></HTML
>