1wmclock(1) General Commands Manual wmclock(1)
2
6 wmclock - A dockable clock for the Window Maker window manager
7
9 wmclock [{-12|-24|-year}] [-noblink] [-version] [-exe program] [-led
10 color] [-monthxpm filename] [-weekdayxpm filename]
11
13 Wmclock is an applet which displays the date and time in a dockable
14 tile in the same style as the clock from the NEXTSTEP(tm) operating
15 system. Wmclock is specially designed for the Window Maker window man‐
16 ager, by Alfredo Kojima, and features multiple language support,
17 twenty-four-hour and twelve-hour (am/pm) time display, and, optionally,
18 can run a user-specified program on a mouse click. Wmclock is derived
19 from asclock, a similar clock for the AfterStep window manager.
20
22 -12 or -24
23 Display the time in either twelve-hour format (with am/pm) or
24 twenty-four-hour format. Defaults to twenty-four-hour display.
25 -year Display the current year in the LED display instead of the time.
27 -noblink
29 The separator between the hours and minutes in the time display
30 blinks by default. This option turns off the blinking and dis‐
31 plays a steadily lit separator instead.
32 -interval n
34 Set the blink cycle to n seconds. The default is 2 (1 second
35 on, 1 second off).
36 -version
38 Displays the version of Wmclock.
39 -exe command
41 Run command in the background when a mouse button is pressed
42 over wmclock. See below for details.
43 -led color
45 Use color as the foreground color of the LED display. Color may
46 be either a named color from the rgb.txt database (for example,
47 `red' or `chartreuse') or a numeric color specification in any
48 of the usual X11 formats (for example, `#ff0000' or
49 `rgb:7f/ff/00'). See the X(1) man page for more information.
50 -monthxpm filename
52 Get month abbreviations from filename, which is expected to be
53 in the XPM format. See below for details.
54 -weekdayxpm filename
56 Get weekday abbreviations from filename, which is expected to be
57 in the XPM format. See below for details.
58
60 The simplest way to start wmclock is:
61 wmclock
63 Wmclock displays in its own appicon, which you can place in Window
65 Maker's dock by holding down the [Alt] or [Meta] key and dragging
66 wmclock to the dock with the primary mouse button (usually the left
67 one).
68 For a more complicated example:
70 wmclock -12 -led gold -exe /usr/GNUstep/Apps/WPrefs.app/WPrefs
72 This displays 12-hour time in an amber-colored LED display, and starts
74 Window Maker's preferences utility when you click on wmclock.
75
77 Running Commands
78 When you use wmclock with the -exe option, wmclock will run the command
79 you specify whenever you press a mouse button while the mouse cursor is
80 over wmclock. Wmclock uses the system(3) function from the C library
81 (and ultimately /bin/sh) to run the command; hence, the command must be
82 in Bourne-shell syntax.
83 Using Alternate Month and Weekday Abbreviations
85 You can use the -monthxpm and -weekdayxpm options to convince wmclock
86 to display month and day-of-week abbreviations in a language besides
87 the one it was compiled with, or to display them in a language that
88 wmclock does not yet support. The files you specify must be in the XPM
89 format, and they must follow the same strict size and placement as the
90 month and weekday XPMs that come in the wmclock source package. Each
91 weekday abbreviation must be 21 pixels wide and 6 pixels high; each
92 month abbreviation must be 22 pixels wide and 6 pixels high. The month
93 abbreviations must be arranged vertically, beginning with January at
94 the top and continuing down to December at the bottom. The weekday
95 abbreviations must also be arranged vertically, beginning with Monday
96 at the top and continuing to Sunday at the bottom.
97 You can find XPM files for a variety of languages in:
99 /usr/share/wmclock
101 For example, to have a French display, you could use the following com‐
103 mand line:
104 wmclock -monthxpm /usr/share/wmclock/lang.french/month.xpm
106 -weekdayxpm /usr/share/wmclock/lang.french/weekday.xpm
107 Obsolete Options
109 In order to maintain command-line compatibility (mostly) with asclock,
110 wmclock accepts a few options on the command line without complaining,
111 even though they don't have any effect. The options which wmclock
112 accepts in this manner are -shape and -iconic. Some dockable versions
113 of asclock required one or both of these options to become properly
114 dockable. However, Since wmclock is designed for Window Maker's dock,
115 it already displays in a shaped window in its own dockable appicon.
116
118 Wmclock shouldn't run a command on a single click; should use a double
119 click instead.
120 Wmclock should use Alfredo Kojima's libdockapp library instead of
122 inventing its own wheel.
123
125 X(1), asclock(1x), wmaker(1x), system(3)
126
128 Copyright (C) 1999 by Jim Knoble <jmknoble@pobox.com>. Significant
129 portions of wmclock are directly derived from asclock by Beat Christen,
130 who, along with asclock's other authors, owns the copyright to those
131 portions of wmclock.
132 Wmclock is licensed under the GNU General Public License, version 2, or
134 (at your option) any later version. See <http://www.gnu.org/> for more
135 information.
136
138 Jim Knoble <jmknoble@pobox.com>
139 Beat Christen <spiff@longstreet.ch>, author of asclock
140
142 The software is provided ``as is'', without warranty of any kind,
143 express or implied, including but not limited to the warranties of mer‐
144 chantability, fitness for a particular purpose and noninfringement. In
145 no event shall the author(s) be liable for any claim, damages or other
146 liability, whether in an action of contract, tort or otherwise, arising
147 from, out of or in connection with the software or the use or other
148 dealings in the software.
149 Your mileage may vary. Eat your vegetables.
151Version 1.0.16 2015-09-24 wmclock(1)