XCLOCK(1)

NAME
xclock - X Window System, analog / digital clock

SYNOPSIS
xclock [ option ] ...

DESCRIPTION
Xclock is the X window system clock. Xclock 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 color
    Determines the color of the background. The default color is ``white''. On monochrome displays this is ignored.

-bd color
    Determines the color of the border. The defaults color is ``black''. On monochrome displays this is ignored.

-bw pixels
    Specify the width in pixels of the border around the xclock window.

-digital
    Use digital display mode (default). Display the date and time in digital format.

-fg color
    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 color
    Determines the color of the hands of the clock. This is ignored on monchrome displays.

-fn font
    The specified font 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 xclock's calling syntax and options.

-hl color
    Determines the color of the hands in analog mode. The defaults is to make them the same as the foreground color. On monochrome displays this is ignored.

-padding pixels
    Specify the width in pixels of the padding ``white space'' between the window border and anything xclock 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 seconds
    Specify the frequency in seconds with which xclock updates its display. If the xclock window is obscured and then exposed, xclock 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.

=geometry
    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.

host:display
    Normally, xclock gets the host and display number to use from the environment variable ``DISPLAY''. One can, however specify them explicitly. The host specifies which machine to create the xclock window on, and the display argument specifies the display number. For example, ``mit-frobozz:1'' creates an xclock 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 monochrome displays.

Background
    To determine the background color. Ignored on monochrome displays.

Hands
    Sets the color of the hands. Ignored on monochrome displays.

Border
    To determine the border color. Ignored on monochrome displays.

BorderWidth
    To determine the border width.

BodyFont
    To determine digital clock display font.

Highlight
    To determine the highlight color. Ignored on monochrome 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
Xclock believes the Unix clock. When specifying the window size manually in digital mode the string should be centered automatically, currently you have to fiddle with the padding parameter to get it right.