Xclock
Name
xclock - analog / digital clock for X
Synopsis
xclock [ -help ] [ -analog | -digital ] [ -brief ] [ -chime ] [ -hd color ] [ -hl color ] [ -update seconds ] [ -strftime format ] [ -twelve | -twentyfour | -utime ] [ -padding number ] [ -norender ] [ -render ] [ -sharp ] [ -face pattern ]
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
This option indicates that a digital clock should display seconds since the Epoch (in format '970012340 seconds since Epoch' instead of a standard 24-hour time.
-strftime format This option allows an strftime(3) format string to be specified for the digital clock's display. -twelve This option indicates that a digital clock should display the time in twelve hour format.
-twentyfour This option indicates that a digital clock should display the time in twenty-four hour format. This is the default when a digital clock is used. -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. This option is effectively ignored when Xrender is in use. -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. This option is effectively ignored when Xrender is in use. -update seconds This option specifies the frequency in seconds at 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. -render This option tells xclock to use the Xrender extension to draw an anti-aliased face. This is the default if xclock has been compiled with Xrender support. Note that the color selection options and resources used when Xrender is in effect differ from the standard options.
-norender This option turns off the use of Xrender to draw the clock. -sharp This option tells xclock to use sharper edges when drawn using the Xrender extension.
-face pattern This option specifies the font to use in digital mode when the Xrender extension is used. Patterns are specified using the fontconfig face format described in the Font Names section of fonts.conf(5).