# Clock Applet Manual

Copyright © 2000 by Dan Mueth

# Clock Applet

`Clock` applet, shown in Figure 1, is a simple applet which shows the time (and optionally the date too) in any of several formats. To add this applet to a Panel, right-click on the Panel and choose Panel->Add to panel->Applet->Clocks->Clock.

Figure 1. Clock Applet

## Usage

`Clock` applet requires no user input. You may optionally configure it, as described below.

Right-clicking on the applet brings up a menu containing the following items:

- Properties… — opens the `Properties` dialog.

- Help — displays this document.

- About… — shows basic information about `Clock Applet`, including the applet's version and the author's name.

## Customization

You can customize `Clock` applet by right-clicking on it and choosing Properties…. This will open the Properties dialog(shown in Figure 2), which allows you to change various settings.

Figure 2. Properties dialog

The properties are:

- Time Format — Select either `12 hour` format for "AM/PM" formatted time, or `24 hour` for a 24 hour clock.

- Show date in applet — Select this to show the date inside the applet.

- Show date in tooltip — Select this to show the date in the tooltip that pops up when the mouse is briefly left over the applet.

- Use GMT — Select this to show the Greenwich Mean Time instead of the local time.

- Unix time — Select this to show the time, in seconds, that has elapsed since Jan 1, 1970.

After you have made all the changes you want, click on OK to apply the changes and close the Properties dialog. To cancel the changes and return to previous values, click the Close button.

| Setting the Time
| `Clock` 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 date command. For example, to set the time to 11:43:01PM and the date to April 4, use date --set="Apr 4 23:43:01". Note that you must be logged in as root to set the time. More information about the date command is available from the date manual page. You may set your timezone using the timeconfig or tzselect commands on some Linux distributions.

## Known Bugs and Limitations

This applet has no known bugs.

## Authors

`Clock` was written by Miguel de Icaza (`<miguel@kernel.org>`), Federico Mena (`<quartic@gimp.org>`), and Stuart Parmenter (`<pavlov@innerx.net>`). Please send all comments, suggestions, and bug reports to the GNOME bug tracking database. (Instructions for submitting bug reports can be found on-line. If you are using GNOME 1.1 or later, you can also use `Bug Report Tool` (bug-buddy), available in the Utilities submenu of Main Menu, for submitting bug reports.

This manual was written by Dan Mueth (`<d-mueth@uchicago.edu>`). Please send all comments and suggestions regarding this manual to the GNOME Documentation Project by sending an email to `<docs@gnome.org>`. You can also submit comments online by using the GNOME Documentation Status Table.

## License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

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 GNU General Public License for more details.

A copy of the GNU General Public License is included with the GNOME documentation. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

Free Software Foundation, Inc.
59 Temple Place - Suite 330
Boston, MA 02111-1307
USA