![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xclock.0 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1|
Return to xclock.0 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1 |
1.1 root 1:
2:
3:
4: XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
5:
6:
7:
8: NAME
9: xclock - X Window System, analog / digital clock
10:
11: SYNOPSIS
12: xclock [ option ] ...
13:
14: DESCRIPTION
15: _X_c_l_o_c_k is the _X window system clock. _X_c_l_o_c_k Continuously
16: displays the current time of day. The user is given a
17: choice of either an analog or a digital display (of course
18: there is nothing precluding the user from having more
19: than one clock). It creates a window and displays the time
20: in the chosen format.
21:
22: ARGUMENTS
23: -analog Use analog display mode. Draw a conventional 12
24: hour clock face with ``ticks'' for each minute and
25: stroke marks on each hour. The default is digital
26: mode.
27:
28: -bg _c_o_l_o_r Determines the color of the background. The
29: default color is ``white''. On monochrome
30: displays this is ignored.
31:
32: -bd _c_o_l_o_r Determines the color of the border. The defaults
33: color is ``black''. On monochrome displays this
34: is ignored.
35:
36: -bw _p_i_x_e_l_s
37: Specify the width in pixels of the border around
38: the _x_c_l_o_c_k window.
39:
40: -digital Use digital display mode (default). Display
41: the date and time in digital format.
42:
43: -fg _c_o_l_o_r Determines the color of the text in digital mode
44: and the tick marks in analog mode. The default
45: color is ``black''. On monochrome displays this
46: is ignored.
47:
48: -hd _c_o_l_o_r Determines the color of the hands of the clock.
49: This is ignored on monchrome displays.
50:
51: -fn _f_o_n_t The specified _f_o_n_t will be used as the output font
52: in digital mode. Any fixed width font may be
53: used, the default is ``6x10''.
54:
55: -help Display a brief summary of _x_c_l_o_c_k'_s calling syntax
56: and options.
57:
58: -hl _c_o_l_o_r Determines the color of the hands in analog mode.
59: The defaults is to make them the same as the
60:
61:
62:
63: Printed 9/15/87 4 June 1986 1
64:
65:
66:
67:
68:
69:
70: XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
71:
72:
73:
74: foreground color. On monochrome displays this is
75: ignored.
76:
77: -padding _p_i_x_e_l_s
78: Specify the width in pixels of the padding ``white
79: space'' between the window border and anything
80: _x_c_l_o_c_k displays. The default padding is 10 in
81: digital mode and 8 in analog mode.
82:
83: -rv Reverses the default color values (i.e., black
84: becomes white and white becomes black).
85:
86: -update _s_e_c_o_n_d_s
87: Specify the frequency in seconds with which _x_c_l_o_c_k
88: updates its display. If the _x_c_l_o_c_k window is
89: obscured and then exposed, _x_c_l_o_c_k will override
90: this setting and redisplay immediately. The
91: default update frequency is 60 seconds. The
92: specification of an update frequency greater than
93: 30 seconds disables the display of the second
94: hand in analog mode.
95:
96: -chime Cause the clock to ``chime'' once on the half hour
97: and twice on the hour.
98:
99: =_g_e_o_m_e_t_r_y
100: The clock window is created with the specified size
101: according to the geometry specification. See _X(_1)
102: for details. In digital mode if you do not specify
103: either height and width they are determined by the
104: font in use. In analog mode if you do not specify
105: either width or height they default to 164. The
106: default offset for any unspecified offset is -0.
107: All values are in pixels.
108:
109: _h_o_s_t:_d_i_s_p_l_a_y
110: Normally, _x_c_l_o_c_k gets the host and display number
111: to use from the environment variable ``DISPLAY''.
112: One can, however specify them explicitly. The
113: _h_o_s_t specifies which machine to create the _x_c_l_o_c_k
114: window on, and the _d_i_s_p_l_a_y argument specifies the
115: display number. For example, ``mit-frobozz:1''
116: creates an _x_c_l_o_c_k on display one on the machine
117: mit-frobozz. If the host is omitted the local
118: host is assumed. If the display is omitted,
119: display 0 is assumed, the ``:'' is necessary in
120: either case.
121:
122: X DEFAULTS
123: Foreground
124: To determine the foreground color. Ignored on mono-
125: chrome displays.
126:
127:
128:
129: Printed 9/15/87 4 June 1986 2
130:
131:
132:
133:
134:
135:
136: XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
137:
138:
139:
140: Background
141: To determine the background color. Ignored on mono-
142: chrome displays.
143:
144: Hands Sets the color of the hands. Ignored on monochrome
145: displays.
146:
147: BorderColor or Border
148: To determine the border color. Ignored on mono-
149: chrome displays.
150:
151: BorderWidth
152: To determine the border width.
153:
154: BodyFont
155: To determine digital clock display font.
156:
157: Highlight
158: To determine the highlight color. Ignored on mono-
159: chrome displays.
160:
161: InternalBorder
162: To determine the internal padding value.
163:
164: Mode To determine if ``analog'' or ``digital'' mode is
165: the default.
166:
167: ReverseVideo
168: If ``on'', reverse the effect of the defaults
169: colors. Ignored on color displays.
170:
171: Update To determine the update rate.
172:
173: ENVIRONMENT
174: DISPLAY To get the default host and display number.
175:
176: SEE ALSO
177: X(1), xwm(1), X(1), time(3C), select(2)
178:
179: AUTHORS
180: Copyright 1985, Massachusetts Institute of Technology.
181:
182: Tony Della Fera (MIT-Athena, DEC)
183:
184: Dave Mankins (MIT-Athena, BBN)
185:
186: Ed Moy (Berkeley) added the nicer hands.
187:
188: BUGS
189: _X_c_l_o_c_k believes the Unix clock. When specifying the window
190: size manually in digital mode the string should be cen-
191: tered automatically, currently you have to fiddle with the
192:
193:
194:
195: Printed 9/15/87 4 June 1986 3
196:
197:
198:
199:
200:
201:
202: XCLOCK(1) UNIX Programmer's Manual XCLOCK(1)
203:
204:
205:
206: padding parameter to get it right.
207:
208:
209:
210:
211:
212:
213:
214:
215:
216:
217:
218:
219:
220:
221:
222:
223:
224:
225:
226:
227:
228:
229:
230:
231:
232:
233:
234:
235:
236:
237:
238:
239:
240:
241:
242:
243:
244:
245:
246:
247:
248:
249:
250:
251:
252:
253:
254:
255:
256:
257:
258:
259:
260:
261: Printed 9/15/87 4 June 1986 4
262:
263:
264:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.