xclock(X) X Version 11 (11 July 1990) xclock(X)
NAME
xclock - analog and digital clock for X
SYNOPSIS
xclock [-options...]
DESCRIPTION
The xclock program displays the time in analog or digital
form. You can specify how often the time is updated.
OPTIONS
The xclock program accepts all of the standard X Toolkit
command-line options along with the additional options
listed below:
-help
Prints a brief summary of options on the standard
error.
-analog
Specifies a conventional 12-hour clock face with tick
marks and hands. This is the default.
-digital
Specifies a 24-hour digital clock.
-chime
Makes the clock chime once on the half hour and twice
on the hour.
-hd color
Specifies the color of the hands on the analog clock.
The default is "black."
-hl color
Specifies the color of the edges of the analog clock's
hands. This option is useful only on color displays.
The default is "black."
-update seconds
Specifies how often (in seconds) xclock updates its
display. If the clock is obscured and then exposed, it
is updated immediately. A value of less than 30
seconds enables a second hand on the 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.
Page 1 (printed 7/3/90)
xclock(X) X Version 11 (11 July 1990) xclock(X)
The following standard X Toolkit command-line options are
commonly used with xclock:
-bg color
Specifies the color for the window background. The
default is "white."
-bd color
Specifies the color for the window border. The default
is "black."
-bw number
Specifies the width of the window border in pixels.
-fg color
Specifies the color for displaying text. The default
is "black."
-fn font
Specifies the font used for displaying normal text.
The default is "6x10."
-rv Simulates reverse video by swapping the foreground and
background colors.
-geometry geometry
Specifies the preferred size and position of the clock
window.
-display host:display
Specifies the X server to contact.
-xrm resourcestring
Specifies a resource string to use.
X DEFAULTS
This program uses the Clock widget in the X Toolkit. It
understands all of the core resource names and classes as
well as the following:
width (class Width)
Specifies the width of the clock. The default for
analog clocks is 164 pixels; the default for digital
clocks depends on how much space the font you choose
requires.
height (class Height)
Specifies the height of the clock. The default for
analog clocks is 164 pixels; the default for digital
clocks depends on how much space the font you choose
requires.
Page 2 (printed 7/3/90)
xclock(X) X Version 11 (11 July 1990) xclock(X)
update (class Interval)
Specifies how frequently in seconds the time
redisplays.
foreground (class Foreground)
Specifies the color for the tick marks. The default is
"black" since the core default for background is
"white."
hands (class Foreground)
Specifies the color for the inside of the clock's
hands.
highlight (class Foreground)
Specifies the color to highlight the clock's hands.
analog (class Boolean)
Specifies an analog clock instead of a digital one.
The default is True.
chime (class Boolean)
Rings the bell on the hour and half hour.
padding (class Margin)
Specifies the number of pixels for internal padding.
The default is 8 for the analog clock and 10 for the
digital clock.
font (class Font)
Specifies the font for the digital clock. Note that
variable width-fonts do not always display correctly.
reverseVideo (class ReverseVideo)
Switches the foreground and background colors.
LIMITATIONS
This program does not automatically center the string in
digital mode.
When specifying an offset, the grammar requires an hours
field, but if only minutes are given xclock ignores them. A
negative offset of less than one hour is treated as a
positive offset.
Digital clock windows default to the analog clock size.
You must specify the border color when you use reverse
video.
SEE ALSO
X(X)
xrdb(X)
Page 3 (printed 7/3/90)
xclock(X) X Version 11 (11 July 1990) xclock(X)
Athena Clock widget
COPYRIGHT
Copyright 1988, Massachusetts Institute of Technology.
See X(X) 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 7/3/90)