summaryrefslogtreecommitdiffstats
path: root/gnome-users-guide/gnome-users-guide-1.4/C/applets/anotherclock-ug.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'gnome-users-guide/gnome-users-guide-1.4/C/applets/anotherclock-ug.sgml')
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/anotherclock-ug.sgml247
1 files changed, 247 insertions, 0 deletions
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/anotherclock-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/anotherclock-ug.sgml
new file mode 100644
index 0000000..2382e9c
--- /dev/null
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/anotherclock-ug.sgml
@@ -0,0 +1,247 @@
+ <sect2 id="anotherclock">
+ <title>Another Clock</title>
+ <para>
+ <application>Another Clock</application> applet, shown in <xref
+ linkend="anotherclock-applet">, is a simple analog clock (similar
+ to that in the CDE, Common Desktop Environment, panel). 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>Another Clock</guimenuitem>
+ </menuchoice>.
+ </para>
+
+ <figure id="anotherclock-applet">
+ <title>Another Clock Applet</title>
+ <screenshot>
+ <screeninfo>Another Clock Applet</screeninfo>
+ <graphic format="png" fileref="figures/anotherclock-applet"
+ srccredit="Eric Baudais">
+ </graphic>
+ </screenshot>
+ </figure>
+
+ <!-- ============= Usage ================================ -->
+ <sect3 id="anotherclock-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 the time for you.
+ </para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ <guimenuitem>Properties&hellip;</guimenuitem> &mdash;
+ opens the <link linkend="anotherclock-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>Another Clock
+ Applet</application>, inluding the applet's version and the
+ author's name.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </sect3>
+
+
+ <!-- ============= Customization ============================= -->
+ <sect3 id="anotherclock-prefs">
+ <title>Customization</title>
+ <para>
+ You can customize <application>Another Clock</application> by
+ right-clicking on it and choosing
+ <guimenuitem>Properties&hellip;</guimenuitem>. This will open the
+ <interface>Properties</interface> dialog(shown in <xref
+ linkend="anotherclock-settings-fig">), which allows you to
+ change various settings.
+ </para>
+
+
+ <figure id="anotherclock-settings-fig">
+ <title>Properties dialog</title>
+ <screenshot>
+ <screeninfo>Properties dialog</screeninfo>
+ <graphic format="png" fileref="figures/anotherclock-properties"
+ srccredit="Eric Baudais">
+ </graphic>
+ </screenshot>
+ </figure>
+
+ <para>
+ The properties are:
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ Clock color &mdash; This is currently greyed-out, but in the
+ future it will be possible to adjust the colour of the clockface.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Hour needle color &mdash; Set this to the color you wish to
+ use for the hour needle (hand) of the clock.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Minute needle color &mdash; Set this to the color you wish to
+ use for the minute needle (hand) of the clock.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Second needle color &mdash; Set this to the color you wish to
+ use for the second needle (hand) of the clock.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Show seconds needle &mdash; If this button is checked, the
+ second needle (hand) of the clock will be shown.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </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="anotherclock-bugs">
+ <title>Known Bugs and Limitations</title>
+ <orderedlist>
+<!-- <listitem> Jacob says this should be fixed with GTK+-1.2.7.
+ <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>
+ </listitem>-->
+ <listitem>
+ <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>
+ </listitem>
+ </orderedlist>
+ </sect3>
+
+ <!-- ============= Authors ================================ -->
+
+ <sect3 id="anotherclock-authors">
+ <title>Authors</title>
+ <para>
+ <application>Another Clock</application> was written by
+ I&ntilde;igo Serna (<email>inigo@gazletan.bi.ehu.es</email>).
+ Please send all comments, suggestions, and bug
+ reports 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>telsa@linuxchix.org</email>)
+ and Eric Baudais (<email>baudais@okstate.edu</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 <ulink type="help" url="gnome-help:gpl">
+ <citetitle>GNU General Public License</citetitle></ulink> 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>
+ You may 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>
+
+
+