dxclock(1X)
Name
dxclock − DECwindows interface to the clock
Syntax
dxclock [ options ]
Description
The dxclock command displays a window that continuously displays the system date and time. The clock can display time values in military style (0 through 23 hours) or in 12-hour AM and PM format. The dxclock window has an alarm and the following components:
Analog region
Digital region
Date region
Options
−bd color Specifies the color of the window’s border (color displays only). The default is specified by means of the Session Manager’s Customize Window dialog box.
−bg color Specifies the color of the window’s background (color displays only). The default is specified by means of the Session Manager’s Customize Window dialog box.
−d dispname Specifies the display screen on which dxclock displays its window. If the display option is not specified, dxclock uses the display screen specified by your DISPLAY environment variable. The display option has the format hostname:number. Using two colons (::) instead of one (:) indicates that DECnet is to be used for transport. The default is :0. For more information, see X(.).
−display dispname This option is the same as the −d option.
−fg color Specifies the color of the text (color displays only). The default is specified by means of the Session Manager’s Customize Window dialog box.
−fn font Specifies the font for all of the clock menus. (The analog and digital fonts are automatically scaled to match the clock size.) The default font is menu12. This option is overriden by the .Xdefaults file.
−geometry Specifies the width, length, and location of the dxclock window. If the geometry option is not specified, dxclock uses default values. The geometry option has the format [width][xlength][x][y]. For more information about the screen coordinate system, see X()
The dxclock window has one pop-up menu. To display this pop-up menu, position the pointer anywhere within the dxclock window and click MB2 (the middle mouse button unless you have redefined it). This menu contains the following menu items:
Settings...Displays the Settings dialog box that lets you specify the clock regions to display, turn on or turn off the use of 24-hour digital time, set the alarm, and enter a message that appears when the alarm goes off. You can also display this dialog box by placing the pointer at any position within the dxclock window and double-clicking MB1.
Save SettingsSaves the clock’s settings and its size and position, to use the next time you run the clock.
Use System SettingsRestores the use of system default values for the clock’s settings, size, and position.
HelpDisplays information about using the dxclock command.
ExitCloses the dxclock window.
Restrictions
The system time cannot be changed while the clock is running. The dxclock window must be closed and reopened if the system time is changed.
X Defaults
The dxclock application uses values in the .Xdefaults file when you logged in and uses the appropriate resource specification to customize the appearance dxclock window. A resource specification in the .Xdefaults file has the following format: [name*]resource: value
nameSpecifies the application name or the name string that restricts the resource assignment to that application or to a component of an application. If this argument is not specified, the resource assignment is globally available to all X applications.
resourceSpecifies the resource.
valueSpecifies the value that is to be assigned to the resource.
Because each toolkit-based application can consist of a combination of widgets (for example, push buttons and a scroll bar), you can form the name string by adding widget class and name identifiers to the string. For further information about adding class and name identifiers, see X(.).
For dxclock, the available class identifiers is:
Clock
For dxclock, the available name identifiers are:
Digital
FontFamily
In addition to the general resources listed in X(,), the resources available for dxclock are:
AlarmOnSpecifies that the alarm be turned on. If set to zero, the alarm is not turned on. If set to 1, the alarm is turned on. The default is zero.
AlarmHourSpecifies the hour the alarm is to go off (0 to 23). The default is 12.
AlarmMessageSpecifies the message to be displayed when the alarm goes off. The default is the string Alarm Message.
AlarmMinuteSpecifies the minute the alarm is to go off (00 to 59). The default is 00.
AlarmPMSpecifies that the alarm is set for PM. If set to zero, the alarm is set for AM. If set to 1, the alarm is set for PM. The default is zero.
AnalogOnSpecifies whether the analog portion of the dxclock window is displayed. If set to zero, the analog portion is not displayed. If set to 1, the analog portion is displayed. The default is 1.
DateOnSpecifies whether the date portion of the dxclock window is displayed. If set to zero, the date portion is not displayed. If set to 1, the date portion is displayed. The default is 1.
DigitalOnSpecifies whether the digital portion of the dxclock window is displayed. If set to zero, the digital portion is not displayed. If set to 1, the digital portion is displayed. The default is 1.
militaryOnSpecifies whether the digital portion of the dxclock window displays the date in 12-hour format or 24-hour format. If set to zero, 12-hour format is used. If set to 1, 24-hour format is used. The default is zero.
The fonts used by dxclock are specified by an asterisk (*). This is done so that a font family is chosen instead of a particular font. The asterisk (*) is a wildcard character that matches all font sizes.
Files
~/.Xdefaults
~/.DXclock
/usr/lib/X11/app-defaults/DXclock
~./DXclock