Return to xclock.0 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1

Initial revision

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 9/15/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 9/15/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.

     BorderColor or 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



Printed 9/15/87            4 June 1986				3






XCLOCK(1)	    UNIX Programmer's Manual		XCLOCK(1)



     padding parameter to get it right.






















































Printed 9/15/87            4 June 1986				4

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.