4.3BSD-UWisc/man/catn/xclock.n
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.
-bd _c_o_l_o_r Determines the color of the border.
-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.
-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.
-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 Cause _x_c_l_o_c_k to produce all output in white-on-
black instead of black-on-white. This is only
useful on Black and White displays.
Printed 12/6/86 18 August 1985 1
XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
-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.
=_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
Background
To determine the background color.
Border To determine the border color.
BorderWidth
To determine the border width.
BodyFont
To determine digital clock display font.
Foreground
To determine the foreground color.
Highlight
To determine the highlight color.
Printed 12/6/86 18 August 1985 2
XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
InternalBorder
To determine the internal padding value.
Mode To determine if ``analog'' or ``digital'' mode is
the default.
ReverseVideo
If ``on'', the clock should be white on black
instead of black on white. This is only useful on
Black and White 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)
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 12/6/86 18 August 1985 3