Penguin
Recent Changes
Annotated edit history of rclock(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 RCLOCK
2 !!!RCLOCK
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 X RESOURCES
8 TITLES AND ICONS
9 REMINDERS
10 ENVIRONMENT
11 BUGS
12 AUTHOR
13 CURRENT MAINTAINER
14 ----
15 !!NAME
16
17
18 rclock (ouR CLOCK) -- clock and appointment reminder for X11
19 !!SYNOPSIS
20
21
22 __rclock__ [[''options'']
23 !!DESCRIPTION
24
25
26 __rclock__ -- version __2.6.4__ -- is an analog clock
27 for X intended as an xclock(1) replacement that
28 conserves memory and has extra features: __rclock__
29 enters reverse video if there is mail waiting; an
30 appointment reminder is also builtin.
31 !!OPTIONS
32
33
34 The options supported by __rclock__:
35
36
37 __-display__ ''displayname''
38
39
40 Attempt to open a window on the named X display. In the
41 absence of this option, the display specified by the DISPLAY
42 environment variable is used.
43
44
45 __-geometry__ ''geom''
46
47
48 Create the window with the specified X window geometry
49 [[default 80x80].
50
51
52 __-bg__ ''color''
53
54
55 Window background color [[default white].
56
57
58 __-fg__ ''color''
59
60
61 Window foreground color [[default black].
62
63
64 __-fn__ ''fontname''
65
66
67 Select font used for reminders [[default 7x14].
68
69
70 __-iconic__
71
72
73 Start iconified, if supported by the window
74 manager.
75
76
77 __-adjust__ ''ddhhmm''
78
79
80 Adjust the clock by +/- ''ddhhmm'' (''dd'' = days,
81 ''hh'' = hours, ''mm ='' minutes) to fix an incorrect
82 clock without being root or for working in another
83 time-zone.
84
85
86 __-update__ ''n''
87
88
89 Update clock face every ''n'' seconds [[default 30]. If
90 ''n''=1, a seconds hand is displayed.
91
92
93 __-mail__ ''n''
94
95
96 Check for new mail every ''n'' seconds [[default 60]. The
97 actual interval is a multiple of the clock update
98 interval.
99
100
101 __#__''geom''
102
103
104 Specify the preferred icon window size [[default
105 65x65].
106 !!X RESOURCES
107
108
109 No X resources are used -- only command-line
110 options.
111 !!TITLES AND ICONS
112
113
114 The window and icon titles are set to the day of the week
115 and the date. The icon window is
116 !!REMINDERS
117
118
119 The __~/.rclock__ file lists the messages to display
120 and/or the programs to run at specified times and dates. At
121 the specified time, __rclock__ will pop-up a window in
122 the center of the screen to display the message or will
123 simply run the scheduled program. __rclock will reads the
124 ~/.rclock__ file at startup, and every 10 minutes (to look
125 for changes) and after a message window has been dismissed
126 (to find the next appointment).
127
128
129 An entry in __~/.rclock__ may be one of two formats
130 (blank and comment lines will be ignored):
131
132
133 __hh:mm [[dd] MM/DD/YY message[[; program]
134 __or
135 __[[hh:mm [[dd] MM/DD/YY [[message]]; program
136 hh__ - hour (0-23; * = current)
137 __mm__ - minute (0-59; * = 0)
138 __dd__ - days-of-week (some/all/none of umtwrfs; * = all)
139 __MM__ - month (1-12; * = current)
140 __DD__ - day of month (1-31; * = current)
141 __YY__ - year (0-99 or 1900-????; * = current)
142 __message__ - message to display
143 __program__ - program to execute
144 The days-of-the-week use the following abbreviations: __u__=Sunday, __m__=Monday, __t__=Tuesday, __w__=Wednesday, __r__=Thursday, __f__=Friday, __s__=Saturday, __*__=all.
145
146
147 If __message__ is empty and __program__ has been
148 specified, it is executed without a dialog box. If time/date
149 are also not specified, __program__ is executed on
150 start-up. Note __message__ may contain escape values (n:
151 newline, ;: semicolon).
152
153
154 Here's a silly example file that shows some of the
155 permissible constructs:
156
157
158 # ~/.rclock - My appointment file
159 # startup functions
160 ; xsetroot -solid Black
161 !!ENVIRONMENT
162
163
164 __rclock__ uses the environment variable __MAIL__ to
165 determine the location of the user's mail spool
166 file.
167 !!BUGS
168
169
170 __rclock__ is not very smart about dealing with errors
171 encountered while reading the __~/.rclock__ file. Each
172 reminder must be a single line not exceeding 255 characters.
173 Reminder windows are sometimes not redrawn (left blank) when
174 raised or uncovered.
175 !!AUTHOR
176
177
178 Rob Nation
179
180
181 Modifications by mj olesen
182 !!CURRENT MAINTAINER
183
184
185 Same as the current rxvt maintainer.
186 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.