1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
<!-- manual page source format generated by RosettaMan v3.0a3, -->
<!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
<HTML>
<HEAD>
<TITLE>RCLOCK(1) manual page</TITLE>
</HEAD>
<BODY>
<A HREF="#toc">Table of Contents</A><P>
<H2><A NAME="sect0" HREF="#toc0">NAME</A></H2>
rclock (ouR CLOCK) clock and appointment reminder for X11
<H2><A NAME="sect1" HREF="#toc1">SYNOPSIS</A></H2>
<B>rclock</B>
<P>
<H2><A NAME="sect2" HREF="#toc2">DESCRIPTION</A></H2>
<B>rclock</B> version <B>2.21a3</B> is an analog clock for X intended
as an <I><I>xclock</I>(1)</I> replacement that conserves memory and has extra features:
<B>rclock</B> enters reverse video if there is mail waiting; an appointment reminder
is also builtin. <P>
<H2><A NAME="sect3" HREF="#toc3">OPTIONS</A></H2>
The options supported by <B>rclock</B>:
<DL>
<DT><B>-display</B><I> displayname</I>
</DT>
<DD>Attempt to open a window on the named X display. In the absence of this
option, the display specified by the DISPLAY environment variable is used.
</DD>
<DT><B>-geometry</B><I> geom</I> </DT>
<DD>Create the window with the specified X window geometry [default
80x80]. </DD>
<DT><B>-bg</B><I> color</I> </DT>
<DD>Window background color [default white]. </DD>
<DT><B>-fg</B><I> color</I> </DT>
<DD>Window
foreground color [default black]. </DD>
<DT><B>-fn</B><I> fontname</I> </DT>
<DD>Select font used for reminders
[default 7x14]. </DD>
<DT><B>-iconic</B> </DT>
<DD>Start iconified, if supported by the window manager.
</DD>
<DT><B>-adjust</B><I> ddhhmm</I> </DT>
<DD>Adjust the clock by +/- <I>ddhhmm</I> = days, <I>hh</I> = hours, <I>mm</I> =
minutes) to fix an incorrect clock without being root or for working in
another time-zone. </DD>
<DT><B>-update</B><I> n</I> </DT>
<DD>Update clock face every <I>n</I> seconds [default 30].
If <I>n</I>=1, a seconds hand is displayed. </DD>
<DT><B>-mail</B><I> n</I> </DT>
<DD>Check for new mail every <I>n</I>
seconds [default 60]. The actual interval is a multiple of the clock update
interval. </DD>
<DT><B>#</B><I>geom</I> </DT>
<DD>Specify the preferred icon window size [default 65x65].
</DD>
</DL>
<P>
<H2><A NAME="sect4" HREF="#toc4">X RESOURCES</A></H2>
No X resources are used only command-line options. <P>
<H2><A NAME="sect5" HREF="#toc5">TITLES
AND ICONS</A></H2>
The window and icon titles are set to the day of the week and
the date. The icon window is "active" and will show the time, if supported
by the window manager. <P>
<H2><A NAME="sect6" HREF="#toc6">REMINDERS</A></H2>
The <B>~/.rclock</B> file lists the messages to
display and/or the programs to run at specified times and dates. At the
specified time, <B>rclock</B> will pop-up a window in the center of the screen
to display the message or will simply run the scheduled program. <B></B> rclock
will reads the <B>~/.rclock</B> file at startup, and every 10 minutes (to look
for changes) and after a message window has been dismissed (to find the
next appointment). <P>
An entry in <B>~/.rclock</B> may be one of two formats (blank
and comment lines will be ignored): <P>
<B>hh:mm [dd] MM/DD/YY message[; program]</B>
or<BR>
<B>[hh:mm [dd] MM/DD/YY [message]]; program</B> <BR>
<B>hh</B> - hour (0-23; * = current)
<B>mm</B> - minute (0-59; * = 0) <B>dd</B> - days-of-week (some/all/none of umtwrfs; * =
all) <B>MM</B> - month (1-12; * = current) <B>DD</B> - day of month (1-31; * = current)
<B>YY</B> - year (0-99 or 1900-????; * = current) <B>message</B> - message to display <B>program</B>
- program to execute <P>
The days-of-the-week use the following abbreviations:
<B>u</B>=Sunday, <B>m</B>=Monday, <B>t</B>=Tuesday, <B>w</B>=Wednesday, <B>r</B>=Thursday, <B>f</B>=Friday, <B>s</B>=Saturday,
<B>*</B>=all. <P>
If <B>message</B> is empty and <B>program</B> has been specified, it is executed
without a dialog box. If time/date are also not specified, <B>program</B> is executed
on start-up. Note <B>message</B> may contain escape values (\n: newline, \;: semicolon).
<P>
Here's a silly example file that shows some of the permissible constructs:
<BR>
# ~/.rclock - My appointment file<BR>
<P>
# startup functions<BR>
; xsetroot -solid
Black &<BR>
<P>
# cron functions<BR>
<P>
10:00; xsetroot -solid Grey25 &<BR>
14:00; xsetroot
-solid Grey75 &<BR>
<P>
# daily/weekly reminders<BR>
<P>
08:15 mtwrf * Good Morning!\nRead
News?; rxvt -e News<BR>
12:00 mtwrf * Lunch Time!<BR>
17:00 mtwrf * Go
Home<BR>
23:00 mtwrf * Still Here? Go to bed<BR>
08:10 twrf * Did you
do your time card yesterday?<BR>
15:00 f * Friday, do your time card
early!<BR>
16:00 mtwr * Do your time card<BR>
16:30 mtwrf * Did you
do your time card?<BR>
*:00 us * It's the weekend, why are you here?<BR>
8:15 f */13/* Friday the 13th! Careful!<BR>
8:15 * 4/1/* fkrkrmfismsmkd...dkdfk<BR>
8:16 * 4/1/* April Fools!<BR>
<P>
# birthdays/anniversaries<BR>
<P>
16:00 05/21/*
Pam's Birthday (next week)<BR>
16:00 05/24/* Pam's Birthday (in a few
days)<BR>
<P>
# once-of appointments<BR>
<P>
08:30 03/15/94 Dentist appointment<BR>
08:30 03/15/1999 Dentist appointment<BR>
08:30 03/15/2004 Dentist
appointment<BR>
<BR>
<P>
<H2><A NAME="sect7" HREF="#toc7">ENVIRONMENT</A></H2>
<B>rclock</B> uses the environment variable <B>MAIL</B> to determine
the location of the user's mail spool file. <P>
<H2><A NAME="sect8" HREF="#toc8">BUGS</A></H2>
<B>rclock</B> is not very smart
about dealing with errors encountered while reading the <B>~/.rclock</B> file.
Each reminder must be a single line not exceeding 255 characters. Reminder
windows are sometimes not redrawn (left blank) when raised or uncovered.
<P>
<H2><A NAME="sect9" HREF="#toc9">AUTHOR</A></H2>
Rob Nation <A HREF="mailto:nation@rocket.sanders.lockheed.com">nation@rocket.sanders.lockheed.com</A> <P>
Modifications by mj
olesen <A HREF="mailto:olesen@me.QueensU.CA">olesen@me.QueensU.CA</A> <P>
<H2><A NAME="sect10" HREF="#toc10">CURRENT MAINTAINER</A></H2>
Same as the current rxvt
maintainer. <P>
<HR><P>
<A NAME="toc"><B>Table of Contents</B></A><P>
<UL>
<LI><A NAME="toc1" HREF="#sect1">NAME</A></LI>
<LI><A NAME="toc2" HREF="#sect2">SYNOPSIS</A></LI>
<LI><A NAME="toc3" HREF="#sect3">DESCRIPTION</A></LI>
<LI><A NAME="toc4" HREF="#sect4">OPTIONS</A></LI>
<LI><A NAME="toc5" HREF="#sect5">X RESOURCES</A></LI>
<LI><A NAME="toc6" HREF="#sect6">TITLES AND ICONS</A></LI>
<LI><A NAME="toc7" HREF="#sect7">REMINDERS</A></LI>
<LI><A NAME="toc8" HREF="#sect8">ENVIRONMENT</A></LI>
<LI><A NAME="toc9" HREF="#sect9">BUGS</A></LI>
<LI><A NAME="toc10" HREF="#sect10">AUTHOR</A></LI>
<LI><A NAME="toc11" HREF="#sect11">CURRENT MAINTAINER</A></LI>
</UL>
</BODY></HTML>
|
