dclock(X1) X Version 11 (Release 6.1)
dclock --
digital clock for X
Synopsis
dclock [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.
- d
-
Toggles the date format.
- m
-
Toggles the military time format.
- a
-
Toggles the alarm clock.
- q
-
quit the program.
Mouse button 3 puts the clock in the mode where the
alarm clock can be set.
The alarm must be set in 24-hour format to distinguish between
am and pm time.
Digits can be changed by selecting the digit with
mouse button 1 or 2.
Mouse button 1 advances the time and
mouse button 2 moves the time backwards.
Using mouse button 1 or 2 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.
- -scroll
-
- -noscroll
-
This option indicates that the clock
will scroll from the current digit to the
next digit. Since this is on by default,
the -noscroll option can turn it off.
- -date format
-
The date is printed under the time in the specified font.
The string displayed is in the format argument.
If the string contains a formatting character ``%'',
then the next character is examined and a value is inserted
into the string, for example:
dclock -date "Today is %W"
The date string will print Today is Friday
if the weekday name
happens to be friday. The formatting characters that are understood are:
- %W
-
Full weekday name
- %w
-
Three-char weekday name (Sun, Mon, Tue . . .)
- %M
-
Full month name
- %m
-
Three-char abbreviation for that month (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.
- -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 displaying text.
The default is ``black.''
- -fn font
-
This option specifies the font to be used for displaying normal text.
The default is ``Fixed.''
- -rv
-
This option indicates that reverse video should be simulated by swapping
the foreground and background colors.
- -geometry geometry
-
This option specifies the preferred size and position 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 normally would appear in the foreground color.
The default is ``black'' because the core default
for 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 colors should be reversed.
- scroll (class Boolean)
-
Specifies whether the digits should scroll or not.
- 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.
- 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.
Environment variables
- 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_MANAGER property.
Warnings
dclock believes the system clock.
References
X(X1M),
xrdb(X1),
time(1)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.