<HTML
><HEAD
><TITLE
>Clock Applets</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="GNOME User's Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNOME Applets"
HREF="gnome-applets.html"><LINK
REL="PREVIOUS"
TITLE="Utility Applets"
HREF="utility-applets.html"><LINK
REL="NEXT"
TITLE=" If you are new to Linux/UNIX"
HREF="newbies.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNOME User's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="utility-applets.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>GNOME Applets</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="newbies.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="CLOCK-APPLETS"
>Clock Applets</A
></H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="ANOTHERCLOCK"
>Another Clock</A
></H2
><P
>     The <TT
CLASS="APPLICATION"
>Another Clock</TT
> applet is an analogue
     clock similar to that in the CDE (Common Desktop Environment, an
     earlier UNIX desktop environment) panel. In its default state it is a 
     small analogue clockface with no background around it. It was part of
     the gnome-core package up to October GNOME (gnome-core-1.0.53). It
     is now distributed in gnome-applets. This guide describes the version 
     distributed in gnome-applets-1.1.2.
   </P
><P
>     To add <TT
CLASS="APPLICATION"
>Another Clock</TT
> to your panel,
     you can click <SPAN
CLASS="MOUSEBUTTON"
>right</SPAN
> click on an
     empty part of the <SPAN
CLASS="INTERFACE"
>panel</SPAN
> and follow the
     sequence:
    <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>+<B
CLASS="GUIMENU"
>Applets</B
>-&gt;<B
CLASS="GUISUBMENU"
>Clocks</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Another Clock</B
>
    or you can type the following command at a command line:
    <B
CLASS="COMMAND"
>another_clock_applet --activate-goad-server another_clock_applet</B
>
  </P
><DIV
CLASS="FIGURE"
><A
NAME="ANOTHERCLOCK-APPLET"
></A
><P
><IMG
SRC="./figs/anotherclock-applet.png"></P
><P
><B
>Figure 90. Another Clock Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="ANOTHERCLOCK-USAGE"
>Usage</A
></H3
><P
>      You don't need to do anything special to this clock. It will just
      sit on your panel and tell the time for you.
    </P
><P
></P
><UL
><LI
><P
>	  <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
	  opens the <A
HREF="clock-applets.html#ANOTHERCLOCK-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"
>Another Clock
	  Applet</TT
>, inluding the applet's version and the
	  author's name.
	</P
></LI
></UL
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="ANOTHERCLOCK-PREFS"
>Preferences</A
></H3
><P
>      The <SPAN
CLASS="INTERFACE"
>preferences dialogue box</SPAN
> (which calls
      itself "Clock Settings" rather than preferences) is very simple.
      There are four colours that may be changed, and there is a 
      <B
CLASS="GUIBUTTON"
>checkbox</B
>.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="ANOTHERCLOCK-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/anotherclock-properties.png"></P
><P
><B
>Figure 91. Properties dialog</B
></P
></DIV
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Clock colour</DT
><DD
><P
>         This is currently greyed-out, but in the future it will
         be possible to adjust the colour of the clockface.
       </P
></DD
><DT
>Hour needle colour</DT
><DD
><P
>         Clicking on the <B
CLASS="GUIBUTTON"
>box</B
> containing the
         colour here will invoke the <TT
CLASS="APPLICATION"
>GNOME colourwheel</TT
>
         which will let you change the colour of the hour needle. The
         default is a very pale grey.
       </P
></DD
><DT
>Minute needle colour</DT
><DD
><P
>         Clicking on the <B
CLASS="GUIBUTTON"
>box</B
> containing the
         colour here will invoke the <TT
CLASS="APPLICATION"
>GNOME colourwheel</TT
>
         which will let you change the colour of the minute needle.
         The default is a very pale grey.
       </P
></DD
><DT
>Second needle colour</DT
><DD
><P
>         Clicking on the <B
CLASS="GUIBUTTON"
>box</B
> containing the
         colour here will invoke the <TT
CLASS="APPLICATION"
>GNOME colourwheel</TT
>
         which will let you change the colour of the second needle. The
         default is red.
       </P
></DD
><DT
>Show seconds needle</DT
><DD
><P
>         Clicking on this <B
CLASS="GUIBUTTON"
>checkbox</B
> lets you
         toggle whether the second needle is shown or not. It is 
         shown by default.
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="ANOTHERCLOCK-BUGS"
>Known Bugs and Limitations</A
></H3
><P
></P
><OL
TYPE="1"
><LI
><P
>        If you adjust the system clock backwards using the <B
CLASS="COMMAND"
>        date</B
> command, the clock will stop working until the
        system time reaches the time the clock displays. It will start
        working normally then.
      </P
></LI
></OL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="ASCLOCK"
>AfterStep Clock Applet</A
></H2
><P
>   The <TT
CLASS="APPLICATION"
>AfterStep Clock</TT
> applet, shown in <A
HREF="clock-applets.html#ASCLOCK-APPLET-FIG"
>Figure 92</A
>, 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 
   <TT
CLASS="APPLICATION"
>AfterStep Clock</TT
>.
  </P
><P
>  
   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"
>AfterStep Clock</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="ASCLOCK-APPLET-FIG"
></A
><P
><IMG
SRC="./figs/asclock_applet.png"></P
><P
><B
>Figure 92. AfterStep Clock Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="ASCLOCK-USAGE"
>Usage</A
></H3
><P
>    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.
   </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="clock-applets.html#ASCLOCK-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"
>ASClock
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="ASCLOCK-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>AfterStep 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="clock-applets.html#ASCLOCK-SETTINGS-FIG"
>Figure 93</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="ASCLOCK-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/asclock_settings.png"></P
><P
><B
>Figure 93. Properties dialog</B
></P
></DIV
><P
>    Your properties in the <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab are:
    <P
></P
><UL
><LI
><P
>       Display time in 12 hour format (AM/PM) &#8212;  Clicking this
       will display the time in a 12 hour format. The default state,
       off, uses a 24-hour clock. 
      </P
></LI
><LI
><P
>       Blinking elements in clock &#8212;  When the
       <TT
CLASS="APPLICATION"
>AfterStep clock applet</TT
> starts 
       up, by default it displays a blinking colon between the hour and
       minute display. Clicking this turns this blinking off.
      </P
></LI
><LI
><P
>       Clock theme &#8212;  The <TT
CLASS="APPLICATION"
>AS Clock</TT
>
       applet can take on a number of different appearances. Select
       the theme (appearance) from this list.
      </P
></LI
></UL
>
   </P
><P
>    The <TT
CLASS="GUILABEL"
><B
>Timezone</B
></TT
> tab is used to specify your
    timezone. Select the continent and city your are in or closest
    to.
   </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"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="ASCLOCK-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>         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 <B
CLASS="COMMAND"
>         date</B
> command.
     </P
><P
>        If you adjust the system clock backwards using the <B
CLASS="COMMAND"
>        date</B
> command, the clock will stop working until the
        system time reaches the time the clock displays. It will start
        working normally then.
     </P
><P
>        Switching between a lot of themes or a lot of timezones seems
        to use up inordinate amounts of memory.
      </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="CLOCK"
>Clock Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>Clock</TT
> applet, shown in <A
HREF="clock-applets.html#CLOCKAPPLET-FIG"
>Figure 94</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="./figs/clock_applet.png"></P
><P
><B
>Figure 94. Clock Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CLOCK-USAGE"
>Usage</A
></H3
><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="clock-applets.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="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CLOCK-PREFS"
>Customization</A
></H3
><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="clock-applets.html#CLOCK-SETTINGS-FIG"
>Figure 95</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="CLOCK-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/clock_settings.png"></P
><P
><B
>Figure 95. 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.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</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="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CLOCK-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>    This applet has no known bugs.
   </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="CLOCKMAIL"
>Clock and Mailcheck Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>Clock and Mailcheck</TT
> applet, shown in <A
HREF="clock-applets.html#CLOCKMAILAPPLET-FIG"
>Figure 96</A
>, displays the current time and how
   much mail is in your mailbox.  It also notifies you when new mail
   arrives by flashing.   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 and Mailcheck</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="CLOCKMAILAPPLET-FIG"
></A
><P
><IMG
SRC="./figs/clockmail_applet.png"></P
><P
><B
>Figure 96. Clock and Mailcheck Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CLOCKMAIL-USAGE"
>Usage</A
></H3
><P
>    View the time and number of messages in your inbox in the applet's
    display. The envelope will flash when new email arrives.
   </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="clock-applets.html#CLOCKMAIL-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 and Mailcheck
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CLOCKMAIL-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>Clock and Mailcheck</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="clock-applets.html#CLOCKMAIL-SETTINGS-FIG"
>Figure 97</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="CLOCKMAIL-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/clockmail-prefs-general.png"></P
><P
><B
>Figure 97. Properties dialog</B
></P
></DIV
><P
>     The <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialogue is divided in two
     sections, one for general options and one for themes.
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Display time in 12 hours format (AM/PM) &#8212;  Check this
        button to show the time in 12-hour format. 
       </P
></LI
><LI
><P
>        Display time relative to GMT (Greenwich Mean Time) &#8212;
        This allows you to change the timezone
        <TT
CLASS="APPLICATION"
>Clock and Mailcheck</TT
> 
        uses.  The time can be anything from twelve hours
        ahead of GMT to twelve hours behind it. Remember also to select
        the <B
CLASS="GUIBUTTON"
>checkbox</B
>, to use the new
        timezone. Note that you can only alter the
        time by an integral number of hours.
       </P
></LI
><LI
><P
>        Mail file  &#8212; Enter you email inbox file which should be 
        checked for new mail. Typically, this is
        <TT
CLASS="FILENAME"
>/var/spool/mail/yourusername</TT
>
        or something similar. You can only enter one file.
       </P
></LI
><LI
><P
>        When new mail is received, run... &#8212; It is possible to
        execute commands when new mail arrives. 
        For example, it is very common for people to have a sound
        file played as mail arrives. You can put the command to 
        run and the file to run it on in this space and ensure the
        checkbox is checked for it to occur.
        If you have more than one command, you can separate them
        by a semi-colon. For example,
        <P
></P
><UL
><LI
><P
>           <B
CLASS="COMMAND"
>esdplay /full/path/to/file.wav</B
>
          </P
></LI
><LI
><P
>           <B
CLASS="COMMAND"
>cd /path/to/directory ; esdplay file.wav</B
>
          </P
></LI
></UL
>
        These two have the same effect. You will need the full path
        for this, without using shortcuts such as <B
CLASS="COMMAND"
>cd ~</B
>.
       </P
></LI
><LI
><P
>        Always blink when new mail is waiting &#8212; If you select
        this <B
CLASS="GUIBUTTON"
>checkbox</B
>, then the 
        red envelope will blink until you read your unread email. Normally,
        this is off, and the blinking lasts only a few seconds.
       </P
></LI
><LI
><P
>        Number of messages to consider mailbox full &#8212; Set the
        number of messages you mailbox must have to be considered
        <SPAN
CLASS="QUOTE"
>"full"</SPAN
>.  Certain themes will show a special
        symbol indicating the mailbox is full.
       </P
></LI
><LI
><P
>        When clicked, run... &#8212; When this is set, clicking
        the left mouse button on the applet will run a program. The default is
        to run the <TT
CLASS="APPLICATION"
>Balsa</TT
> mail client. (If
        <TT
CLASS="APPLICATION"
>Balsa</TT
> is not installed, nothing
        will happen.) Set this to be your favorite email program.
       </P
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Theme</B
></TT
> tab allows you
     to set the appearance of <TT
CLASS="APPLICATION"
>Clock and
     Mailcheck</TT
> applet. <TT
CLASS="APPLICATION"
>Clock and
     Mailcheck</TT
> applet comes with many themes which are
     stored in  <TT
CLASS="FILENAME"
>$PREFIX/clockmail/</TT
>. By 
     default, it does not use a theme. Note that not all of the themes
     show both the time and the state of your mailbox. 
    </P
><DIV
CLASS="FIGURE"
><A
NAME="CLOCKMAIL-SETTINGS-THEME-FIG"
></A
><P
><IMG
SRC="./figs/clockmail-prefs-theme.png"></P
><P
><B
>Figure 98. Properties dialog showing theme tab</B
></P
></DIV
><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"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CLOCKMAIL-BUGS"
>Known Bugs and Limitations</A
></H3
><P
></P
><OL
TYPE="1"
><LI
><P
>        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 <B
CLASS="COMMAND"
>        date</B
> command.
      </P
></LI
><LI
><P
>        If you adjust the system clock backwards using the <B
CLASS="COMMAND"
>        date</B
> command, the clock will stop working until the
        system time reaches the time the clock displays. It will start
        working normally then.
      </P
></LI
><LI
><P
>        The mailcounter theme gets the number of messages in your inbox
        wrong.
      </P
></LI
><LI
><P
>        Several themes do not reshape to the size of a vertical panel and
        force the panel to be wider.
      </P
></LI
><LI
><P
>        Doesn't handle multiple mailboxes.
      </P
></LI
></OL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="JBC"
>Jon's Binary Clock Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>Jon's Binary Clock</TT
> applet, shown in <A
HREF="clock-applets.html#JBCAPPLET-FIG"
>Figure 99</A
>, shows the time in an unusual form: binary
   coded decimal. It has twenty-four LEDs which represent the hours,
   minutes and seconds by illuminating the appropriate LED.  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"
>JBC Binary Clock</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="JBCAPPLET-FIG"
></A
><P
><IMG
SRC="./figs/jbc_applet.png"></P
><P
><B
>Figure 99. Jon's Binary Clock Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="APPLET-USAGE"
>Usage</A
></H3
><P
>    You don't need to do anything special to this clock. It just
    sits there and flashes lights at you.
   </P
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><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"
>Jon's Binary Clock
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="JBC-DECIPHERING"
>Deciphering the Lights</A
></H3
><P
>      BCD stands for binary-coded decimal, a way of representing 
      normal denary (0,1,2,3,4,5,6,7,8,9) numbers as what programmers
      call "a set of binary numbers in four bits, thus removing the
      numbers A to F". If this doesn't make sense, just be aware
      that this clock is an amusement for programmers, and serves
      no really useful purpose.
    </P
><P
>      It helps to read this clock upside-down! Start at the bottom and 
      read up to the top.
    </P
><P
>      The right-hand pair of columns shows the two digits of the seconds:
      the units on the right, the tens on the left. The centre pair of
      columns shows the two digits of the minutes. The left hand pair of
      columns shows the two digits of the hours.
    </P
><P
>      You add up the values of the illuminated LEDs in each column.
      You should get a number between zero to nine for each. That's
      the time.
    </P
><P
></P
><OL
TYPE="1"
><LI
><P
>         The bottom LED represents 1 when it is illuminated.
      </P
></LI
><LI
><P
>         The next LED represents 2 when it is illuminated.
      </P
></LI
><LI
><P
>         The next LED represents 4 when it is illuminated.
      </P
></LI
><LI
><P
>         The top LED represents 8 when it is illuminated.
      </P
></LI
></OL
><P
>      It is probably simplest to decipher the hours and minutes
      first before trying to follow the seconds, which are always 
      changing.
    </P
><P
>     As an example, we can read the time in <A
HREF="clock-applets.html#JBCAPPLET-FIG"
>Figure 99 in the section called <I
>Jon's Binary Clock Applet</I
></A
>. Let's start with the hour.  The first
     column has only 1 LED on, in the second lowest position, so this
     gives us <SPAN
CLASS="QUOTE"
>"2"</SPAN
> for the first digit of the hour.  The
     second column has no LEDs on, so we have a <SPAN
CLASS="QUOTE"
>"0"</SPAN
> for
     the second digit of the hour.  So the hour is <SPAN
CLASS="QUOTE"
>"20"</SPAN
>,
     or 8PM for people who like AM/PM notation.  Looking at the
     minutes, we have <SPAN
CLASS="QUOTE"
>"0"</SPAN
> for the first digit, and
     <SPAN
CLASS="QUOTE"
>"1"</SPAN
> for the second digit since only the bottom LED
     is lit.  This gives us "20:01" so far.  Lastly, we have the
     seconds.  For the first digit, we have the lowest two LED's
     lit. These have value 1 (for the lowest) and 2 (second lowest)
     for a total of <SPAN
CLASS="QUOTE"
>"3"</SPAN
>.  And the second column of the
     seconds has the top LED lit, with a value of
     <SPAN
CLASS="QUOTE"
>"8"</SPAN
>. Thus, the time is <SPAN
CLASS="QUOTE"
>"20:01:38"</SPAN
>, or
     <SPAN
CLASS="QUOTE"
>"8:01:38PM"</SPAN
>.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="JBC-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>    If you add it to a vertical panel, it is a nice size. If you then
    move it to a horizonal panel, it changes size in the  horizontal
    panel. If you move it back to a vertical panel, it doesn't change
    size back, and forces the panel to widen itself.
   </P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="utility-applets.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="newbies.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Utility Applets</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnome-applets.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>If you are new to Linux/UNIX</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>