DCLOCK(1)DCLOCK(1)NAMEdclock - digital clock for X
SYNOPSISdclock [-toolkitoption ...] [-option ...]
DESCRIPTION
The dclock program displays the time in digital format
only. The time is updated on a per second basis or on a
per minute basis. This program is nothing more than a
wrapper around the dclock widget not associated with any
particular widget set.
When the clock is running, the user may change attributes
by typing:
r Toggles Reverse Video.
s Toggles the seconds display.
b Toggles the bell attribute.
j Toggles the jump/scroll attribute.
f Toggles the fade attribute.
d Toggles the date format.
m Toggles the military time format.
a Toggles the alarm clock.
t Toggles the tails attribute.
l Toggles the language attribute (French
or English).
q quit the program.
The third mouse button puts the clock in the mode where
the alarm clock can be set. The alarm must be set in
24-hour format to distringuish between am and pm time.
Digits can be changed by selecting the digit with the left
or middle mouse button. The Left button advances the time
while the Middle button moves the time backwards. Using
the left or middle button over the text at the bottom of
the clock toggles the alarm from actually being set (or,
use the 'a' key).
OPTIONS
Dclock 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.
-bell This option indicates that the bell will beep once
on the half hour and twice on the hour.
-miltime
This option causes the clock to display the time
in 24 hour (military) time format.
-tails This option puts "tails" on the digits 6 and 9.
X Version 11 1 March 1988 1
DCLOCK(1)DCLOCK(1)-scroll
-noscroll
When the time changes, the digits scroll from the
previous digit to the next digit. Since this is
on by default, the -noscroll option can turn it
off.
-fade This option causes the display to fade from one
digit to the next instead of jumping or scrolling.
If fade is specified, the scroll attribute will be
forced to off.
-fadeRate n
The fadeRate attribute takes an integer value
which specifies the number of milliseconds to wait
between iterations when fading from one digit to
the next. A larger value will make the fade
slower and more pronounced. The default is 50.
-date "format"
The date is printed under the time in the speci-
fied font. The string displayed is in the "for-
mat" argument. If the string contains a format-
ting character (%), then the next character is
examined and a value is inserted into the string.
Example:
dclock-date "Today is %W"
The date string will print "Today is Friday" if
the weekday name happens to be friday. The for-
matting characters that are understood are:
%W Full weekday name
%w Three-char weekday name (Sun, Mon, Tue...)
%M Full month name
%m Three-char month name (Jan, Feb, Mar...)
%d The date (numerical day number of the month)
%Y Full year (4 digits)
%y 2-digit year number
-alarm
-noalarm
The alarm is turned on or off. Alarm rings bell
and toggles the reverse video five times.
-alarmTime HH:MM
If alarm is set, it goes off at time specified in
24-hour format.
-seconds
This option will update the clock every second and
display the time including the seconds.
X Version 11 1 March 1988 2
DCLOCK(1)DCLOCK(1)-bg color
This option specifies the color to use for the
background of the window. The default is
``white.''
-bd color
This option specifies the color to use for the
border of the window. The default is ``black.''
-bw number
This option specifies the width in pixels of the
border surrounding the window.
-fg color
This option specifies the color to use for dis-
playing text. The default is ``black''.
-fn font
This option specifies the font to be used for dis-
playing normal text. The default is ``Fixed.''
-rv This option indicates that reverse video should be
simulated by swapping the foreground and back-
ground colors.
-geometry geometry
This option specifies the prefered size and posi-
tion of the clock window.
-display host:display
This option specifies the X server to contact.
-xrm resourcestring
This option specifies a resource string to be
used. This is especially useful for setting
resources that do not have separate command line
options.
X DEFAULTS
It understands all of the core resource names and classes
as well as:
width (class Width)
Specifies the width of the clock.
height (class Height)
Specifies the height of the clock.
foreground (class Foreground)
Specifies the color for the tic marks. Using the
class specifies the color for all things that nor-
mally would appear in the foreground color. The
default is ``black'' since the core default for
X Version 11 1 March 1988 3
DCLOCK(1)DCLOCK(1)
background is ``white.''
bell (class Boolean)
Specifies whether or not a bell should be rung on
the hour and half hour.
font (class Font)
Specifies the font to be used for the date.
miltime (class Boolean)
Specifies whether the military (24hr) time format
should be used.
reverseVideo (class ReverseVideo)
Specifies that the foreground and background col-
ors should be reversed.
scroll (class Boolean)
Specifies whether the digits should scroll or not.
fade (class Boolean)
Specifies whether the digits should fade or not.
fadeRate (class Time)
The number of milliseconds of delay between itera-
tions of fading.
seconds (class Boolean)
Specifies whether the seconds should be displayed
or not.
bell (class Boolean)
Specifies whether the bell should sound on the
half hour and on the hour.
tails (class Boolean)
Specifies whether tails should be put on the dig-
its 6 and 9.
alarm (class Boolean)
Specifies whether the alarm should go off at the
specified time (alarmTime).
alarmTime (class String)
Specifies the time alarm goes off if alarm is set.
language (class String)
Specifies the language used to display the date
(French or English).
alarm_snd (class String)
Only available on Sun Sparc stations. Specifies
the full path of the sound played when alarm goes
off. If set to Bell, defaults to the beep of the
X Version 11 1 March 1988 4
DCLOCK(1)DCLOCK(1)
station.
hours_snd (class String)
Only available on Sun Sparc stations. Specifies
the full path of the sound played on the hour. If
set to Bell, defaults to the beep of the station.
half_hours_snd (class String)
Only available on Sun Sparc stations. Specifies
the full path of the sound played on half hour. If
set to Bell, defaults to the beep of the station.
ENVIRONMENT
DISPLAY to get the default host and display number. XEN-
VIRONMENT to get the name of a resource file that
overrides the global resources stored in the
RESOURCE_MANAGER property.
SEE ALSOX(1), xrdb(1), time(3C).
BUGS
Dclock believes the system clock.
Scrolling from 9 to 10 O'Clock seems weird, but chances
are you won't notice it.
If the window is too small, the seconds are tough to read.
This should be recognized by the program and should dis-
play seconds using a font rather than the bitmaps used by
the clock itself.
COPYRIGHT
Copyright (c) 1988, Dan Heller.
AUTHOR
Dan Heller -- <argv@sun.com> or <dheller@cory.berkeley.edu>
Fade & tails by Steve Reinhardt, <steven@fts.webo.dg.com>
Language & Sound by Herve Soulard, <soulard@sor.inria.fr>
X Version 11 1 March 1988 5