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