![[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] / 43BSD / contrib / X / man|
Return to xclock.1 CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / X / man |
1.1 root 1: .TH XCLOCK 1 "18 August 1985" "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: .PP
28: .TP 10
29: .B \-bd \fIcolor\fP
30: Determines the color of the border.
31: .PP
32: .TP 10
33: .B \-bw \fIpixels\fP
34: Specify the width in pixels of the border around the
35: .I xclock
36: window.
37: .PP
38: .TP 10
39: .B \-digital
40: Use digital display mode (default). Display the date and time in
41: digital format.
42: .PP
43: .TP 10
44: .B \-fg \fIcolor\fP
45: Determines the color of the text in digital mode and the
46: tick marks in analog mode.
47: .PP
48: .TP 10
49: .B \-fn \fIfont\fP
50: The specified
51: .I font
52: will be used as the output font
53: in digital mode. Any fixed width font may be used, the default is ``6x10''.
54: .PP
55: .TP 10
56: .B \-help
57: Display a brief summary of
58: .I xclock's
59: calling syntax and options.
60: .PP
61: .TP 10
62: .B \-hl \fIcolor\fP
63: Determines the color of the hands in analog mode.
64: .PP
65: .TP 10
66: .B \-padding \fIpixels\fP
67: Specify the width in pixels of the padding ``white space''
68: between the window border and anything
69: .I xclock
70: displays. The default padding is 10 in digital mode and 8 in analog mode.
71: .PP
72: .TP 10
73: .B \-rv
74: Cause
75: .I xclock
76: to produce all output in white-on-black instead of black-on-white. This
77: is only useful on Black and White displays.
78: .PP
79: .TP 10
80: .B \-update \fIseconds\fP
81: Specify the frequency in seconds with which
82: .I xclock
83: updates its display. If the
84: .I xclock
85: window is obscured and then exposed,
86: .I xclock
87: will override this setting and redisplay immediately. The default
88: update frequency is 60 seconds. The specification of an update
89: frequency greater than 30 seconds disables the display of the second
90: hand in analog mode.
91: .PP
92: .TP 8
93: .B =\fIgeometry\fP
94: The clock window is created with the specified
95: size according to the geometry specification.
96: See \fIX(1)\fP for details.
97: In digital mode if you do not specify either height and width they are
98: determined by the font in use. In analog mode if you do not specify
99: either width or height they default to 164. The default offset for
100: any unspecified offset is -0. All values are in pixels.
101: .PP
102: .TP 10
103: .B \fIhost\fP:\fIdisplay\fP
104: Normally,
105: .I xclock
106: gets the host and display number to use from the environment variable
107: ``DISPLAY''. One can, however specify them explicitly.
108: The
109: .I host
110: specifies which machine to create the
111: .I xclock
112: window on, and
113: the
114: .I display
115: argument specifies the display number.
116: For example,
117: ``mit-frobozz:1'' creates an
118: .I xclock
119: on display one on the machine mit-frobozz. If the host is omitted the
120: local host is assumed. If the display is omitted, display 0 is
121: assumed, the ``:'' is necessary in either case.
122: .SH X DEFAULTS
123: .PP
124: .PP
125: .TP 8
126: .B Background
127: To determine the background color.
128: .PP
129: .TP 8
130: .B Border
131: To determine the border color.
132: .PP
133: .TP 8
134: .B BorderWidth
135: To determine the border width.
136: .PP
137: .TP 8
138: .B BodyFont
139: To determine digital clock display font.
140: .PP
141: .TP 8
142: .B Foreground
143: To determine the foreground color.
144: .PP
145: .TP 8
146: .B Highlight
147: To determine the highlight color.
148: .PP
149: .TP 8
150: .B InternalBorder
151: To determine the internal padding value.
152: .PP
153: .TP 8
154: .B Mode
155: To determine if ``analog'' or ``digital'' mode is the default.
156: .PP
157: .TP 8
158: .B ReverseVideo
159: If ``on'', the clock should be white on black instead of black on white.
160: This is only useful on Black and White displays.
161: .PP
162: .TP 8
163: .B Update
164: To determine the update rate.
165: .SH ENVIRONMENT
166: .PP
167: .TP 8
168: .B DISPLAY
169: To get the default host and display number.
170: .SH SEE ALSO
171: X(1), xwm(1), X(1), time(3C), select(2)
172: .SH AUTHORS
173: .PP
174: Copyright 1985, Massachusetts Institute of Technology.
175: .PP
176: Tony Della Fera (MIT-Athena, DEC)
177: .PP
178: Dave Mankins (MIT-Athena, BBN)
179: .SH BUGS
180: .I Xclock
181: believes the Unix clock. When specifying the window size manually in
182: digital mode the string should be centered automatically, currently
183: 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.