File: index.html

package info (click to toggle)
gnome-core 1.4.0.6-5
links: PTS
area: main
in suites: woody
size: 26,980 kB
ctags: 7,562
sloc: ansic: 90,216; sh: 8,414; makefile: 2,410; yacc: 318; perl: 241
file content (627 lines) | stat: -rw-r--r-- 9,057 bytes
parent folder | download | duplicates (2)
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML
><HEAD
><TITLE
>Clock Applet Manual</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.59"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>Clock Applet Manual</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by Dan Mueth</P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#clock"
>Clock Applet</A
></DT
></DL
></DIV
> 

 
 

 

  <DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="clock"
>Clock Applet</A
></H1
>  

   <P
>   <TT
CLASS="APPLICATION"
>Clock</TT
> applet, shown in , 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="figures/clock_applet.png"></P
>
   
  <P
><B
>Figure 1. Clock Applet</B
></P
></DIV
>

  
  <DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="clock-usage"
>Usage</A
></H2
>   
   <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</B
> 
       opens the        <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
> dialog.
      </P
>
     </LI
><LI
>      <P
>       <B
CLASS="GUIMENUITEM"
>Help</B
> 
       displays this document.
      </P
>
     </LI
><LI
>      <P
>       <B
CLASS="GUIMENUITEM"
>About</B
> 
       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="SECT2"
><H2
CLASS="SECT2"
><A
NAME="clock-prefs"
>Customization</A
></H2
>    
    <P
>      You can customize <TT
CLASS="APPLICATION"
>Clock</TT
>
      applet by right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog(shown in ), which allows you to
      change various settings.
    </P
>

    <DIV
CLASS="FIGURE"
><A
NAME="clock-settings-fig"
></A
>     
           
      <P
><IMG
SRC="figures/clock_settings.png"></P
>
     
    <P
><B
>Figure 2. Properties dialog</B
></P
></DIV
>

    <P
>     The properties are:
     <P
></P
><UL
><LI
>       <P
>        Time Format  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  Select this to show the date
        inside the applet.
       </P
>
      </LI
><LI
>       <P
>        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.
       </P
>
      </LI
><LI
>       <P
>        Use GMT  Select this to show the Greenwich Mean Time
        instead of the local time.
       </P
>
      </LI
><LI
>       <P
>        Unix time  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
>Setting the Time</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. More information about the <B
CLASS="COMMAND"
>date</B
> command is
     available from the <A
HREF="man:date"
TARGET="_top"
>date manual page</A
>.
     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="SECT2"
><H2
CLASS="SECT2"
><A
NAME="bugs"
>Known Bugs and Limitations</A
></H2
>   
   <P
>    This applet has no known bugs.
   </P
>
  </DIV
>


  

  <DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="authors"
>Authors</A
></H2
>   
   <P
>    <TT
CLASS="APPLICATION"
>Clock</TT
> was written by Miguel de Icaza
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:miguel@kernel.org"
>miguel@kernel.org</A
>&#62;</TT
>), Federico Mena
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:quartic@gimp.org"
>quartic@gimp.org</A
>&#62;</TT
>), and Stuart Parmenter
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:pavlov@innerx.net"
>pavlov@innerx.net</A
>&#62;</TT
>).  Please send all comments,
    suggestions, and bug 
    reports to the <A
HREF="http://bugs.gnome.org/"
TARGET="_top"
>GNOME
    bug tracking database</A
>. (Instructions for submitting bug
    reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>    on-line</A
>. If you are using
    GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
    Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
    <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
    Menu</B
>, for submitting bug reports.
   </P
>

   <P
>    This manual was written by Dan Mueth
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:d-mueth@uchicago.edu"
>d-mueth@uchicago.edu</A
>&#62;</TT
>). Please send all comments and
    suggestions regarding this manual to the <A
HREF="http://developer.gnome.org/projects/gdp/"
TARGET="_top"
>GNOME Documentation Project</A
> 
    by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
    submit comments online by using the <A
HREF="http://developer.gnome.org/projects/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
    Table</A
>.
   </P
>

   

  </DIV
>


  

  <DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="license"
>License</A
></H2
>   
   <P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <A
HREF="gnome-help:gpl"
TARGET="_top"
><I
CLASS="CITETITLE"
>GNU General Public
    License</I
></A
> as published by the Free Software
    Foundation; either version 2 of the License, or (at your option)
    any later version.
   </P
>
   <P
>    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
    <A
HREF="gnome-help:gpl"
TARGET="_top"
><I
CLASS="CITETITLE"
>GNU General
    Public License</I
></A
> for more details.
   </P
>
   <P
>    A copy of the <A
HREF="gnome-help:gpl"
TARGET="_top"
><I
CLASS="CITETITLE"
>GNU General Public
    License</I
></A
> is included with the GNOME
    documentation.  You may also obtain a copy of the <A
HREF="gnome-help:gpl"
TARGET="_top"
><I
CLASS="CITETITLE"
>GNU General Public
    License</I
></A
> from the Free Software Foundation by
    visiting <A
HREF="http://www.fsf.org/"
TARGET="_top"
>their Web
    site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
>
  </DIV
>

 </DIV
>




&#13;</DIV
></BODY
></HTML
>