summaryrefslogtreecommitdiffstats
path: root/gnome-users-guide/gnome-users-guide-1.4/C/applets/asclock-ug.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'gnome-users-guide/gnome-users-guide-1.4/C/applets/asclock-ug.sgml')
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/asclock-ug.sgml260
1 files changed, 260 insertions, 0 deletions
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/asclock-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/asclock-ug.sgml
new file mode 100644
index 0000000..f832445
--- /dev/null
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/asclock-ug.sgml
@@ -0,0 +1,260 @@
+ <sect2 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 ================================ -->
+ <sect3 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>
+ </sect3>
+
+
+ <!-- ============= Customization ============================= -->
+ <sect3 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>
+ </sect3>
+
+
+ <!-- ============= 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 -->
+ <sect3 id="asclock-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>
+ </sect3>
+
+
+ <!-- ============= Authors ================================ -->
+
+ <sect3 id="asclock-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>
+
+ -->
+
+ </sect3>
+
+
+ <!-- ============= Application License ============================= -->
+
+ <!--
+ <sect3 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>
+ </sect3>
+
+ -->
+ </sect2>
+
+
+
+
+