XCLOCK(1)           RISC/os Reference Manual            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
             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



                         Printed 1/24/91         Release 4 Page 1

XCLOCK(1)           RISC/os Reference Manual            XCLOCK(1)



             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
             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 reverseVi-
             deo 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.




Release 4 Page 2         Printed 1/24/91

XCLOCK(1)           RISC/os Reference Manual            XCLOCK(1)



     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 nota-
     tion below, indentation indicates hierarchical structure.
     The widget class name is given first, followed 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 automat-
     ically.

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)






                         Printed 1/24/91         Release 4 Page 3