RCLOCK(1) 2001 RCLOCK(1)NAMErclock (ouR CLOCK) -- clock and appointment reminder for
X11
SYNOPSISrclock [options]
DESCRIPTIONrclock-- version 2.7.8 -- is an analog clock for X
intended as an xclock(1) replacement that conserves memory
and has extra features: rclock enters reverse video if
there is mail waiting; an appointment reminder is also
builtin.
OPTIONS
The options supported by rclock:
-display displayname
Attempt to open a window on the named X display.
In the absence of this option, the display speci
fied by the DISPLAY environment variable is used.
-geometry geom
Create the window with the specified X window geom
etry [default 80x80].
-bg color
Window background color [default white].
-fg color
Window foreground color [default black].
-fn fontname
Select font used for reminders [default 7x14].
-iconic
Start iconified, if supported by the window man
ager.
-adjust ddhhmm
Adjust the clock by +/- ddhhmm (dd = days, hh =
hours, mm = minutes) to fix an incorrect clock
without being root or for working in another time-
zone.
-update n
Update clock face every n seconds [default 30]. If
n=1, a seconds hand is displayed.
-mail n
Check for new mail every n seconds [default 60].
The actual interval is a multiple of the clock
update interval.
-mailfile mailfile
Override environmental variable MAIL with mailfile
as location for mail.
#geom Specify the preferred icon window size [default
65x65].
X RESOURCES
No X resources are used -- only command-line options.
TITLES AND ICONS
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.
REMINDERS
The ~/.rclock file lists the messages to display and/or
the programs to run at specified times and dates. At the
specified time, rclock will pop-up a window in the center
of the screen to display the message or will simply run
the scheduled program. rclock will reads the ~/.rclock
file at startup, and every 10 minutes (to look for
changes) and after a message window has been dismissed (to
find the next appointment).
An entry in ~/.rclock may be one of two formats (blank and
comment lines will be ignored):
hh:mm [dd] MM/DD/YY message[; program]
or
[hh:mm [dd] MM/DD/YY [message]]; program
hh - hour (0-23; * = current)
mm - minute (0-59; * = 0)
dd - days-of-week (some/all/none of umtwrfs; * = all)
MM - month (1-12; * = current)
DD - day of month (1-31; * = current)
YY - year (0-99 or 1900-????; * = current)
message - message to display
program - program to execute
The days-of-the-week use the following abbreviations:
u=Sunday, m=Monday, t=Tuesday, w=Wednesday, r=Thursday,
f=Friday, s=Saturday, *=all.
If message is empty and program has been specified, it is
executed without a dialog box. If time/date are also not
specified, program is executed on start-up. Note message
may contain escape values (\n: newline, \;: semicolon).
Here's a silly example file that shows some of the permis
sible constructs:
# ~/.rclock - My appointment file
# startup functions
; xsetroot -solid Black &
# cron functions
10:00; xsetroot -solid Grey25 &
14:00; xsetroot -solid Grey75 &
# daily/weekly reminders
08:15 mtwrf * Good Morning!\nRead News?; rxvt -e News
12:00 mtwrf * Lunch Time!
17:00 mtwrf * Go Home
23:00 mtwrf * Still Here? Go to bed
08:10 twrf * Did you do your time card yesterday?
15:00 f * Friday, do your time card early!
16:00 mtwr * Do your time card
16:30 mtwrf * Did you do your time card?
*:00 us * It's the weekend, why are you here?
8:15 f */13/* Friday the 13th! Careful!
8:15 * 4/1/* fkrkrmfismsmkd...dkdfk
8:16 * 4/1/* April Fools!
# birthdays/anniversaries
16:00 05/21/* Pam's Birthday (next week)
16:00 05/24/* Pam's Birthday (in a few days)
# once-of appointments
08:30 03/15/94 Dentist appointment
08:30 03/15/1999 Dentist appointment
08:30 03/15/2004 Dentist appointment
ENVIRONMENTrclock uses the environment variable MAIL to determine the
location of the user's mail spool file unless the -mail
file option is specified.
BUGSrclock is not very smart about dealing with errors encoun
tered while reading the ~/.rclock file. Each reminder
must be a single line not exceeding 255 characters.
Reminder windows are sometimes not redrawn (left blank)
when raised or uncovered.
AUTHOR
Rob Nation <nation@rocket.sanders.lockheed.com>
Modifications by mj olesen <olesen@me.QueensU.CA>
CURRENT MAINTAINER
Same as the current rxvt maintainer.
NOVEMBER 29 RCLOCK(1)
