xclock man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



XCLOCK(1)						XCLOCK(1)

NAME
       xclock - analog / digital clock for X

SYNOPSIS
       xclock  [  -help ]  [ -analog ] [ -digital ] [ -brief ] [
       -chime ] [ -hd color ] [ -hl color ] [ -update seconds ] [
       -padding number ]

DESCRIPTION
       The  xclock program displays the time in analog or digital
       form.  The time is continuously	updated at  a	frequency
       which may be specified by the user.

OPTIONS
       Xclock  accepts all of the standard X Toolkit command line
       options along with the additional options listed below:

       -help   This option indicates that a brief summary of  the
	       allowed	options should be printed on the standard
	       error.

       -analog This option indicates that a conventional 12  hour
	       clock  face  with  tick	marks and hands should be
	       used.  This is the default.

       -digital or -d
	       This option indicates that a 24 hour digital clock
	       should be used.

       -brief  This  option  indicates	that  the  digital  clock
	       should only display the hours and minutes  fields.
	       The  default  is to  show  the full time and date
	       information.

       -utime or -d
	       This option indicates that a digital clock  should
	       display	seconds	  since	 the  Epoch  (in  format
	       '970012340 seconds since Epoch' instead of a stan-
	       dard 24-hour time.

       -chime  This  option indicates that the clock should chime
	       once on the half hour and twice on the hour.

       -hands color (or -hd color)
	       This option specifies the color of the hands on an
	       analog clock.  The default is black.

       -highlight color (or -hl color)
	       This  option  specifies	the color of the edges of
	       the hands on an analog clock, and is  only  useful
	       on color displays.  The default is black.

       -update seconds
	       This  option specifies the frequency in seconds at

X Version 11		Release 6.4				1

XCLOCK(1)						XCLOCK(1)

	       which xclock should update its  display. If  the
	       clock  is  obscured  and then exposed, it will be
	       updated immediately.  A value  of  30  seconds  or
	       less will enable a second hand on an analog clock.
	       The default is 60 seconds.

       -padding number
	       This option specifies the width in pixels  of  the
	       padding	between the window border and clock text
	       or picture.  The default is 10 on a digital  clock
	       and 8 on an analog clock.

X DEFAULTS
       This program uses the Clock widget.  It understands all of
       the core resource names and classes as well as:

       width (class Width)
	       Specifies the width of the clock.  The default for
	       analog clocks is 164 pixels; the default for digi-
	       tal clocks is whatever is needed to hold the clock
	       when displayed in the chosen font.

       height (class Height)
	       Specifies  the  height  of the clock.  The default
	       for analog clocks is 164 pixels; the  default  for
	       digital	clocks	is whatever is needed to hold the
	       clock when displayed in the chosen font.

       update (class Interval)
	       Specifies the frequency in seconds  at  which  the
	       time should be redisplayed.

       foreground (class Foreground)
	       Specifies the color for the tic marks. The default
	       is depends on whether reverseVideo  is  specified.
	       If   reverseVideo  is  specified the  default  is
	       lwhite, otherwise the default is black.

       hands (class Foreground)
	       Specifies the color of the insides of the  clock's
	       hands. The default is depends on whether reverseV-
	       ideo is specified.  If reverseVideo  is	specified
	       the  default  is lwhite, otherwise the default is
	       black.

       highlight (class Foreground)
	       Specifies the color used to highlight the  clock's
	       hands. The default is
		depends on whether reverseVideo is specified.  If
	       reverseVideo is specified the default  is  lwhite,
	       otherwise the default is black.

X Version 11		Release 6.4				2

XCLOCK(1)						XCLOCK(1)

       analog (class Boolean)
	       Specifies whether or not an analog clock should be
	       used instead of a digital  one.	The  default  is
	       True.

       chime (class Boolean)
	       Specifies  whether or not a bell should be rung on
	       the hour and half hour.

       padding (class Margin)
	       Specifies the amount of internal padding in pixels
	       to be used.  The default is 8.

       font (class Font)
	       Specifies  the  font  to be  used for the digital
	       clock.  Note that variable width fonts	currently
	       will not always display correctly.

WIDGETS
       In  order  to  specify resources, it is useful to know the
       hierarchy of the widgets which  compose	xclock. In  the
       notation below, indentation indicates hierarchical struc-
       ture.  The widget class name is given first,  followed  by
       the widget instance name.

       XClock  xclock
	    Clock  clock

ENVIRONMENT
       DISPLAY to get the default host and display number.

       XENVIRONMENT
	       to  get the name of a resource file that overrides
	       the global resources stored in  the  RESOURCE_MAN-
	       AGER property.

FILES
       <XRoot>/lib/X11/app-defaults/XClock  -  specifies required
       resources

SEE ALSO
       X(1), xrdb(1), time(3C)

BUGS
       Xclock believes the system clock.

       When in digital mode, the string should be centered  auto-
       matically.

AUTHORS
       Tony Della Fera (MIT-Athena, DEC)
       Dave Mankins (MIT-Athena, BBN)
       Ed Moy (UC Berkeley)

X Version 11		Release 6.4				3

XCLOCK(1)						XCLOCK(1)

X Version 11		Release 6.4				4

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net