XCLOCK(1)           X Version 11 (Release 4)            XCLOCK(1)



  NAME
       xclock - analog / digital clock for X


  SYNOPSIS
       xclock  [-toolkitoption ...] [-help] [-analog] [-digital]
       [-chime] [-hd color]
               [-hl color] [-update seconds] [-padding number]

  DESCRIPTION
       The xclock program displays the time in analog or digital
       form.  The time is continuously updated at a frequency which
       may be specified by the user.  This program is nothing more
       than a wrapper around the Athena Clock widget.

  OPTIONS
       Xclock accepts all of the standard X Toolkit command line
       options along with the additional options listed below:

       -help   This option indicates that a brief summary of the
               allowed options should be printed on the standard
               error.

       -analog This option indicates that a conventional 12 hour
               clock face with tick marks and hands should be used.
               This is the default.

       -digital
               This option indicates that a 24 hour digital clock
               should be used.

       -chime  This option indicates that the clock should chime
               once on the half hour and twice on the hour.

       -hd color
               This option specifies the color of the hands on an
               analog clock.  The default is black.

       -hl color
               This option specifies the color of the edges of the


  Page 1                                          (printed 8/30/91)

  XCLOCK(1)           X Version 11 (Release 4)            XCLOCK(1)



               hands on an analog clock, and is only useful on
               color displays.  The default is black.

       -update seconds
               This option specifies the frequency in seconds at
               which xclock should update its display.  If the
               clock is obscured and then exposed, it will be
               updated immediately.  A value of less than 30
               seconds will enable a second hand on an analog
               clock.  The default is 60 seconds.

       -padding number
               This option specifies the width in pixels of the
               padding between the window border and clock text or
               picture.  The default is 10 on a digital clock and 8
               on an analog clock.

  X DEFAULTS
       This program uses the Athena Clock widget.  It understands
       all of the core resource names and classes as well as:

       width (class Width)
               Specifies the width of the clock.  The default for
               analog clocks is 164 pixels; the default for digital
               clocks is whatever is needed to hold the clock when
               displayed in the chosen font.

       height (class Height)
               Specifies the height of the clock.  The default for
               analog clocks is 164 pixels; the default for digital
               clocks is whatever is needed to hold the clock when
               displayed in the chosen font.

       update (class Interval)
               Specifies the frequency in seconds at which the time
               should be redisplayed.

       foreground (class Foreground)
               Specifies the color for the tic marks. The default
               is depends on whether reverseVideo is specified.  If


  Page 2                                          (printed 8/30/91)

  XCLOCK(1)           X Version 11 (Release 4)            XCLOCK(1)



               reverseVideo is specified the default is lwhite,
               otherwise the default is black.


       hands (class Foreground)
               Specifies the color of the insides of the clock's
               hands. The default is depends on whether
               reverseVideo is specified.  If reverseVideo is
               specified the default is lwhite, otherwise the
               default is black.

       highlight (class Foreground)
               Specifies the color used to highlight the clock's
               hands. The default is
                depends on whether reverseVideo is specified.  If
               reverseVideo is specified the default is lwhite,
               otherwise the default is black.

       analog (class Boolean)
               Specifies whether or not an analog clock should be
               used instead of a digital one.  The default is True.

       chime (class Boolean)
               Specifies whether or not a bell should be rung on
               the hour and half hour.

       padding (class Margin)
               Specifies the amount of internal padding in pixels
               to be used.  The default is 8.

       font (class Font)
               Specifies the font to be used for the digital clock.
               Note that variable width fonts currently will not
               always display correctly.

  WIDGETS
       In order to specify resources, it is useful to know the
       hierarchy of the widgets which compose xclock.  In the
       notation below, indentation indicates hierarchical
       structure.  The widget class name is given first, followed


  Page 3                                          (printed 8/30/91)

  XCLOCK(1)           X Version 11 (Release 4)            XCLOCK(1)



       by the widget instance name.

       XClock  xclock
            Clock  clock


  ENVIRONMENT
       DISPLAY to get the default host and display number.

       XENVIRONMENT
               to get the name of a resource file that overrides
               the global resources stored in the RESOURCE_MANAGER
               property.

  FILES
       /usr/lib/X11/app-defaults/XClock - specifies required
       resources

  SEE ALSO
       X(1), xrdb(1), time(3C), Athena Clock widget

  BUGS
       Xclock believes the system clock.

       When in digital mode, the string should be centered
       automatically.

  COPYRIGHT
       Copyright 1988, Massachusetts Institute of Technology.
       See X(1) for a full statement of rights and permissions.

  AUTHORS
       Tony Della Fera (MIT-Athena, DEC)
       Dave Mankins (MIT-Athena, BBN)
       Ed Moy (UC Berkeley)







  Page 4                                          (printed 8/30/91)