xclock(1X)xclock(1X)NAMExclock - analog / digital clock for X
SYNOPSISxclock [-help] [-analog] [-digital] [-chime] [-hd color] [-hl color]
[-update seconds] [-padding number]
OPTIONSxclock accepts all of the standard X Toolkit command line options along
with the additional options listed below: This option indicates that a
brief summary of the allowed options should be printed on the standard
error. This option indicates that a conventional 12 hour clock face
with tick marks and hands should be used. This is the default. This
option indicates that a 24 hour digital clock should be used. This
option indicates that the clock should chime once on the half hour and
twice on the hour. This option specifies the color of the hands on an
analog clock. The default is black. 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. This option specifies the fre‐
quency 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 30 seconds or less will enable a second hand on an analog
clock. The default is 60 seconds. This option specifies the width in
pixels of the padding between the window border and clock text or pic‐
ture. The default is 10 on a digital clock and 8 on an analog clock.
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.
X DEFAULTS
This program uses the Clock widget. It understands all of the core
resource names and classes as well as: 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. 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.
Specifies the frequency in seconds at which the time should be redis‐
played. Specifies the color for the tic marks. The default depends on
whether reverseVideo is specified. If reverseVideo is specified the
default is lwhite, otherwise the default is black. Specifies the color
of the insides of the clock's hands. The default depends on whether
reverseVideo is specified. If reverseVideo is specified the default is
lwhite, otherwise the default is black. Specifies the color used to
highlight the clock's hands. The default depends on whether reverseV‐
ideo is specified. If reverseVideo is specified the default is lwhite,
otherwise the default is black. Specifies whether or not an analog
clock should be used instead of a digital one. The default is True.
Specifies whether or not a bell should be rung on the hour and half
hour. Specifies the amount of internal padding in pixels to be used.
The default is 8. Specifies the font to be used for the digital clock.
Note that variable width fonts currently will not always display cor‐
rectly.
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 by the widget instance name.
XClock xclock
Clock clock
ENVIRONMENT
to get the default host and display number. to get the name of a
resource file that overrides the global resources stored in the
RESOURCE_MANAGER property.
FILES
specifies required resources
BUGSxclock believes the system clock.
When in digital mode, the string should be centered automatically.
SEE ALSOX(1X), xrdb(1X), time(3)AUTHORS
Tony Della Fera (MIT-Athena, DEC)
Dave Mankins (MIT-Athena, BBN)
Ed Moy (UC Berkeley)
xclock(1X)