XCLOCK(1X10)            COMMAND REFERENCE            XCLOCK(1X10)



NAME
     xclock - X Window System, analog / digital clock

     For 4310, 4320, and 4330 series UTek products only.

     Public domain software distributed by M.I.T. Project Athena.
     Provided by Tektronix as is, without express or implied
     warranty.

     Not supported by Tektronix.

SYNOPSIS
     xclock [ option ] ...

DESCRIPTION
     The program 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.

     -bd color Determines the color of the border.

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

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





X Version 10             18 August 1985                         1

XCLOCK(1X10)            COMMAND REFERENCE            XCLOCK(1X10)



     -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       Cause xclock to produce all output in white-on-
               black instead of black-on-white.  This is only
               useful on Black and White displays.

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

     =geometry
             The clock window is created with the specified size
             according to the geometry specification.  See
             X(1x10) 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
     Background
             To determine the background color.

     Border  To determine the border color.

     BorderWidth
             To determine the border width.




X Version 10             18 August 1985                         2

XCLOCK(1X10)            COMMAND REFERENCE            XCLOCK(1X10)



     BodyFont
             To determine digital clock display font.

     Foreground
             To determine the foreground color.

     Highlight
             To determine the highlight color.

     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.

CAVEATS
     The program xclock believes the internal 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.

SEE ALSO
     X(1x10), xwm(1x10), select(2), time(3c).






















X Version 10             18 August 1985                         3

%%index%%
na:360,343;
sy:703,177;
de:880,7933;
ca:8813,383;
se:9196,266;
%%index%%000000000096