.\" @(#)rclock.1 -*- nroff -*- .TH RCLOCK 1 "1 August 1996" "X Version 11" "X Tools" .UC .SH NAME rclock \- clock and appointment reminder for X11 .SH SYNOPSIS .B rclock .RI [ options ] .SH DESCRIPTION .B rclock \- version .B 2.18 \- is a simple analog clock for X intended as an .IR xclock (1) replacement that conserves memory and has extra features: .B rclock enters reverse video if there is mail waiting; an appointment reminder is also builtin. .SH OPTIONS The options supported by .BR rclock : .TP .BI -display " displayname" 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. .TP .BI -geometry " geom" Create the window with the specified X window geometry [default 80x80]. .TP .BI -bg " color" Window background color [default white]. .TP .BI -fg " color" Window foreground color [default black]. .TP .B -iconic Start iconified, if the window manager supports that option. .TP .BI -fn " fontname" Select font used for appointment reminders [default 7x14]. .TP .BI -update " n" Update clock face every .I n seconds [default 30]. A second hand is displayed if .IR n " = 1." .TP .BI -mail " n" Check for new mail every .I n seconds [default 60]. The actual time interval is a multiple of the clock update interval greater or equal to .IR n . .TP .BI "#" geom Specify the preferred size of the icon window [default 65x65]. .SH "X RESOURCES" No X resources \- only command-line options, .SH "TITLES AND ICONS" The window and icon titles are set to the day of the week and the date. The icon window is an "active icon," and is a miniature version of the un-iconifed clock face. If the window manager supports it, the iconified application will show the time, and the icon label will show the date. .SH "APPOINTMENT REMINDER" .B rclock reads the file .B "~/.rclock" at startup and again every 10 minutes, to look for changes. This file contains a list of times, dates, and messages to display at the specified times and dates. When the specified time is shown, rclock will pop-up a window in the center of the screen, and display the message. When the user clicks a mouse button on the window, it will be popped down, and rclock will re-read the .B "~/.rclock" file to find the next appointment. The format of the .B "~/.rclock" file is as follows: .sp .nf .B hh:mm dd MM/DD/YY msg; prgm .BR hh " \- two digit hour field, in 24 hour format (0-23)" .BR mm " \- two digit minute field (0-59)" .BR dd " \- days-of-week field (some or all of umtwrfs, or *)" .BR MM " \- two digit month field (1-12)" .BR DD " \- two digit day of the month field (1-31)" .BR YY " \- two digit year field (0-99)" .BR msg " \- the message text" .BR ; " \- delimiter before optional program" .BR prgm " \- the program to execute (optional)" .sp .fi A star (*) may be used in place of any numeric field or the days-of-week field, in which case the current value for that field will be used (except for the minutes field where it corresponds to zero). Blank lines and comment lines (starting with `#') will be ignored. The message text may contain escape values (\\n: newline, \\;: semicolon). If the message text is empty and a program has been specified, the program is executed without a dialog box \- sort of like .IR cron (1M) for non-root users. .sp The days-of-the-week field is used to specify on which days of the week an appointment can be posted. This is a string of letters, one for each day of the week with the following abbreviations: .BR u "=Sunday," .BR m "=Monday," .BR t "=Tuesday," .BR w "=Wednesday," .BR r "=Thursday," .BR f "=Friday," .BR s "=Saturday." For example a Monday and Wednesday appointment would have "mw" for this field. Here's a silly example file that show some of the permissible constructs: .nf .sp # My appointment file # cron functions 08:00 *;xsetroot -solid Black 16:00 *;xsetroot -solid SteelBlue4 # daily/weekly reminders 08:15 mtwrf * Good Morning!\\nRead News?; rxvt -e News 08:15 mtwrf * Embed\; semicolon 08:30 mtwrf * Still Awake? 11:45 mtwrf * Get Some Lunch 12:00 mtwrf * Lunch Time! 17:00 mtwrf * Go Home 23:00 mtwrf * Still Here? Geez, Go to bed 15:00 f * It's Friday, do your time card early! 08:10 twrf * Did you do your time card yesterday? 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) 16:00 06/12/* Julie's Birthday (next week) 16:00 06/15/* Julie's Birthday (in a few days) 16:00 08/15/* Kelsey's Birthday (next week) 16:00 08/18/* Kelsey's Birthday (in a few days) 16:00 09/17/* Andrew's Birthday (next week) 16:00 09/20/* Andrew's Birthday (in a few days) # once-of appointments 08:30 03/30/94 Dentist appointment today .sp .fi .SH ENVIRONMENT .B rclock uses the environment variable .B MAIL to determine the location of the user's mail spool file. .SH BUGS .B rclock is not very smart about what to do with errors encountered while reading the .B "~/.rclock" file. Each reminder must be a single line not exceeding 255 characters. .\" Only one reminder per minute can be scheduled. Even if appointments have .\" different days of the week scheduled, they must occur at different minutes. .SH AUTHOR Rob Nation .LP Modifications by mj olesen .SH "CURRENT MAINTAINER" Same as the current rxvt maintainer.