4.3BSD-UWisc/man/cat1/xclock.1
XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
NAME
xclock - X Window System, analog / digital clock
SYNOPSIS
xclock [ option ] ...
DESCRIPTION
_X_c_l_o_c_k is the _X window system clock. _X_c_l_o_c_k Continuously
displays the current time of day. The user is given a
choice of either an analog or a digital display (of course
there is nothing precluding the user from having more
than one clock). It creates a window and displays the time
in the chosen format.
ARGUMENTS
-analog Use analog display mode. Draw a conventional 12
hour clock face with ``ticks'' for each minute and
stroke marks on each hour. The default is digital
mode.
-bg _c_o_l_o_r Determines the color of the background. The
default color is ``white''. On monochrome
displays this is ignored.
-bd _c_o_l_o_r Determines the color of the border. The defaults
color is ``black''. On monochrome displays this
is ignored.
-bw _p_i_x_e_l_s
Specify the width in pixels of the border around
the _x_c_l_o_c_k window.
-digital Use digital display mode (default). Display
the date and time in digital format.
-fg _c_o_l_o_r Determines the color of the text in digital mode
and the tick marks in analog mode. The default
color is ``black''. On monochrome displays this
is ignored.
-hd _c_o_l_o_r Determines the color of the hands of the clock.
This is ignored on monchrome displays.
-fn _f_o_n_t The specified _f_o_n_t will be used as the output font
in digital mode. Any fixed width font may be
used, the default is ``6x10''.
-help Display a brief summary of _x_c_l_o_c_k'_s calling syntax
and options.
-hl _c_o_l_o_r Determines the color of the hands in analog mode.
The defaults is to make them the same as the
Printed 1/10/87 4 June 1986 1
XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
foreground color. On monochrome displays this is
ignored.
-padding _p_i_x_e_l_s
Specify the width in pixels of the padding ``white
space'' between the window border and anything
_x_c_l_o_c_k displays. The default padding is 10 in
digital mode and 8 in analog mode.
-rv Reverses the default color values (i.e., black
becomes white and white becomes black).
-update _s_e_c_o_n_d_s
Specify the frequency in seconds with which _x_c_l_o_c_k
updates its display. If the _x_c_l_o_c_k window is
obscured and then exposed, _x_c_l_o_c_k will override
this setting and redisplay immediately. The
default update frequency is 60 seconds. The
specification of an update frequency greater than
30 seconds disables the display of the second
hand in analog mode.
-chime Cause the clock to ``chime'' once on the half hour
and twice on the hour.
=_g_e_o_m_e_t_r_y
The clock window is created with the specified size
according to the geometry specification. See _X(_1)
for details. In digital mode if you do not specify
either height and width they are determined by the
font in use. In analog mode if you do not specify
either width or height they default to 164. The
default offset for any unspecified offset is -0.
All values are in pixels.
_h_o_s_t:_d_i_s_p_l_a_y
Normally, _x_c_l_o_c_k gets the host and display number
to use from the environment variable ``DISPLAY''.
One can, however specify them explicitly. The
_h_o_s_t specifies which machine to create the _x_c_l_o_c_k
window on, and the _d_i_s_p_l_a_y argument specifies the
display number. For example, ``mit-frobozz:1''
creates an _x_c_l_o_c_k on display one on the machine
mit-frobozz. If the host is omitted the local
host is assumed. If the display is omitted,
display 0 is assumed, the ``:'' is necessary in
either case.
X DEFAULTS
Foreground
To determine the foreground color. Ignored on mono-
chrome displays.
Printed 1/10/87 4 June 1986 2
XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
Background
To determine the background color. Ignored on mono-
chrome displays.
Hands Sets the color of the hands. Ignored on monochrome
displays.
Border To determine the border color. Ignored on mono-
chrome displays.
BorderWidth
To determine the border width.
BodyFont
To determine digital clock display font.
Highlight
To determine the highlight color. Ignored on mono-
chrome displays.
InternalBorder
To determine the internal padding value.
Mode To determine if ``analog'' or ``digital'' mode is
the default.
ReverseVideo
If ``on'', reverse the effect of the defaults
colors. Ignored on color displays.
Update To determine the update rate.
ENVIRONMENT
DISPLAY To get the default host and display number.
SEE ALSO
X(1), xwm(1), X(1), time(3C), select(2)
AUTHORS
Copyright 1985, Massachusetts Institute of Technology.
Tony Della Fera (MIT-Athena, DEC)
Dave Mankins (MIT-Athena, BBN)
Ed Moy (Berkeley) added the nicer hands.
BUGS
_X_c_l_o_c_k believes the Unix clock. When specifying the window
size manually in digital mode the string should be cen-
tered automatically, currently you have to fiddle with the
padding parameter to get it right.
Printed 1/10/87 4 June 1986 3