# AfterStep Clock Applet

Copyright © 2000 by Telsa Gwynne and Helix Code, Inc.

# AfterStep Clock Applet

The `AfterStep Clock` applet, shown in Figure 1, 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 `AfterStep Clock`.

To add this applet to a Panel, right-click on the Panel and choose Panel->Add to panel->Applet->Clocks->AfterStep Clock.

Figure 1. AfterStep Clock Applet

## Usage

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.

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 `ASClock Applet`, inluding the applet's version and the author's name.

## Customization

You can customize `AfterStep 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

Your properties in the `General` tab are:

- Display time in 12 hour format (AM/PM) — Clicking this will display the time in a 12 hour format. The default state, off, uses a 24-hour clock.

- Blinking elements in clock — When the `AfterStep clock applet` starts up, by default it displays a blinking colon between the hour and minute display. Clicking this turns this blinking off.

- Clock theme — The `AS Clock` applet can take on a number of different appearances. Select the theme (appearance) from this list.

The `Timezone` tab is used to specify your timezone. Select the continent and city your are in or closest to.

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 Cancel button.

## Known Bugs and Limitations

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 date command.

If you adjust the system clock backwards using the date command, the clock will stop working until the system time reaches the time the clock displays. It will start working normally then.

Switching between a lot of themes or a lot of timezones seems to use up inordinate amounts of memory.

## Authors

The `AfterStep Clock applet` was written by Beat Christen (`<spiff@longstreet.ch>`) and Patrick Rogan (`<rogan@lycos.com>`). Please send all comments, suggestions, and bug reports regarding the software 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 Telsa Gwynne (`<hobbit@aloss.ukuu.org.uk>`) and Aaron Weber (`<aaron@helixcode.com>`. 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 as an appendix to the GNOME Users Guide. 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