NAME clock - display the time in an icon or window SYNOPSIS clock [ -Wn ] [ +Wn ] [ -T ] [ -TZ timezone ] [ -12 ] [ -24 ] [ -alarm setting ] [ -alarmtime hr:min ] [ -alarmcmd cmd ] [ -analog ] [ -digital ] [ +date ] [ -date ] [ -help ] [ -hourcmd cmd ] [ -name app-name ] [ -r ] [ +seconds ] [ -seconds ] [ -v ] [ -? ] AVAILABILITY Although this command is available with both the SunView software installation option and the OpenWindows environ- ment, its appearance is not the same for both environments. The man page you are currently viewing refers to the clock that is available with OpenWindows. The primary difference between this and the SunView clock is the user interface. All OpenWindows standard tools use the OPEN LOOK Graphical User Interface. DESCRIPTION clock is an OpenWindows XView utility that displays the current time in a window or icon. When the window is open, clock can display the time in either analog or digital for- mat. The clock window is scalable in either format. OPTIONS -Wn Start clock with no title line. +Wn Start clock with a title line present. -T Start the clock in test mode. Test mode ignores the real time, and instead runs in a loop continuously incrementing the time by one minute and displaying it. -TZ timezone Start the clock with an alternate time zone. -12 If the digital clock is being displayed in the open window, then use a 12 hour clock. -24 If the digital clock is being displayed in the open window, then use a 24 hour clock. -alarm setting Set how often you want the alarm to go off. Choices are "none", "once" and "daily". -alarmtime hr:min The time you want the alarm to go off. -alarmcmd cmd The command you want to run, when the alarm does go off. -analog Start up the open window display with the analog clock. -digital Start up the open window display with the digital clock. +date Show the current date in the open window. -date Do not show the current date in the open window. -help Lists generic XView options that can be applied to the clock. -hourcmd cmd The command you would like run every hour, on the hour. -name app-name This option specifies the application name under which resources are to be obtained, rather than the default executable file name. app-name should not contain ``.'' or ``*'' characters. -r Use a face with roman numerals in the iconic state. This replaces the default round face. +seconds Show the number of seconds. For the analog clock (and in the iconic state), the seconds are shown by display- ing a second hand. For the digital display, seconds are shown as a numeric value. -seconds Do not show the number of seconds. -v Show the version number and the usage message for this version of clock. -? Show the version number and the usage message for this version of clock. USAGE When the clock window is open, it has a floating menu from which you can bring up a property window. From this pro- perty sheet, you can modify the open window clock face of the tool by selecting either the Analog or Digital choice box. The icon displayed, can be either an analog or roman clock face. With the digital display, you can select between a 12-hour or a 24-hour display. Seconds: On the analog version, this selection starts a second hand on the face of the clock. On the digi- tal version, it adds two digits to the digital readout. Date: Turns on a date display for both analog and digi- tal versions of clock. You can select a local timezone or set it to monitor a remote timezone by clicking SELECT on other, then choosing a timezone by pressing MENU over the abbreviated menu button displayed. The stopwatch is an automatic function, and allows you to reset, start and stop a stopwatch to second accuracy. This should be set to none, to disable it. An alarm can be set, and when that time occurs, then a com- mand can be run. The alarm can be triggered once or daily. If no alarm command is present, then the clock will just beep. You can also set a command that will be run every hour on the hour. There are various keyboard accelerators that can be used with the clock. These are: 1 set 12hr mode if currently showing a digital display. 2 set 24hr mode if currently showing a digital display. c toggle clock face between analog and digital. d toggle on and off the date display. i toggle icon face between analog and roman. s toggle on and off the seconds display. S set stopwatch. Cycles between reset, start and stop. Hit c to continue in normal clock display. t toggle the timezone between local and other. Note that you have to have a valid other timezone for this to work properly. T toggle test mode on and off. q quit the clock On startup, the clock will use the following X resources: Resource: deskset.clock.faceAnalog Values: True, False (True) Description Setting for the open clock face. Choices are analog and digital. Resource: deskset.clock.iconAnalog Values: True, False (True) Description Setting for the closed clock icon. Choices are analog and roman. Resource: deskset.clock.iconHasWindowColor Values: True, False (False) Description Determines whether the clock icon should use the window background color. By default, it uses the workspace color. Resource: deskset.clock.digital12Hour Values: True, False (True) Description Setting for digital displays. Choices are 12 hour and 24 hour display. Resource: deskset.clock.showLocal Values: True, False (True) Description Indicates whether the local or other timezone should be initially displayed. Resource: deskset.clock.secondHand Values: True, False (False) Description When True, a second hand (for analog) or a seconds value (for digital) will be displayed. Resource: deskset.clock.date Values: True, False (False) Description When True, the current date will be displayed. Resource: deskset.clock.timeZone Values: Timezone (string) Description If present, the timezone to monitor. Resource: deskset.clock.alarmHrValue Values: Hour value (numeric) Description The hour value for the alarm command. Resource: deskset.clock.alarmMinValue Values: Minute value (numeric) Description The minute value for the alarm command. Resource: deskset.clock.alarmChoice Values: None, Once, Daily (None) Description How often the alarm should go off. Choices are none, once and daily. Resource: deskset.clock.alarmCommand Values: Command (string) Description The command that should be run when the alarm goes off. Resource: deskset.clock.hourlyCommand Values: Command (string) Description The command that should be run every hour, on the hour. Resource: deskset.clock.dateFont Values: Font name string Description The name of the font used to display the date and timezone, irrespective of the current size and scale of clock Resource: deskset.clock.secondsFont Values: Font name string Description The name of the font used to display the number of seconds when in digital mode, plus the am/pm values if in 12 hour mode, irrespective of the current size and scale of clock Resource: deskset.clock.hasTitle Values: True, False (True) Description Indicates whether the clock window has a title line. ENVIRONMENT The clock uses the TZ environment variable to determine the local time, and the initial setting for the other timezone. The latter can be over-ridden in a variety of ways. SEE ALSO OpenWindows user documentation "About the Clock" in the Help Handbook available through the Help option on the Workspace menu. NOTES The OpenWindows environment may no longer be supported in a future release. You may want to migrate to CDE, the Common Desktop Environment.
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |