.\" @(#)rclock.1	-*- nroff -*-.TH RCLOCK 1 @RXVT_DATE@ "X Version 11" "X Tools".UC.SH NAMErclock (ouR CLOCK)\(em clock and appointment reminder for X11.SH SYNOPSIS.B rclock.RI [ options ].SH DESCRIPTION.B rclock\(em version.B @RXVT_VERSION@\(em is an analog clock for X intended as an.IR xclock (1)replacement that conserves memory and has extra features:.B rclockenters reverse video if there is mail waiting; an appointment reminderis also builtin..SH OPTIONSThe 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 DISPLAYenvironment 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.BI -fn " fontname"Select font used for reminders [default 7x14]..TP.BI -nodateDo not display today's date on the face of the clock..TP.B -iconicStart iconified, if supported by the window manager..TP.BI -adjust " ddhhmm"Adjust the clock by +/\-.I ddhhmm.RI ( dd= days,.I hh= hours,.I mm =minutes) to fix an incorrect clock without being root or for working inanother time-zone..TP.BI -update " n"Update clock face every.I nseconds [default 30].If.IR n "=1,"a seconds hand is displayed..TP.BI -mail " n"Check for new mail every.I nseconds [default 60].The actual interval is a multiple of the clock update interval..TP.BI -mailfile " mailfile"Override environmental variable MAIL with.I mailfileas location for mail..TP.BI -mailspawn " cmd"Execute.I cmdwhen the face of the clock is clicked by the mouse button..TP.BI "#" geomSpecify the preferred icon window size [default 65x65]..PPSome of these options may not be available based on how rclock was compiled.Run.B rclock -helpto determine which features are available..SH "X RESOURCES"No X resources are used \(em 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 date is also displayed on the lower half of the clock unless the.B -nodateoption is specified.The icon window is "active" and will show the time, if supported bythe window manager..SH "REMINDERS"The.B "~/.rclock"file lists the messages to display and/or the programs to run atspecified times and dates.At the specified time,.B rclockwill pop-up a window in the center of the screen to display themessage or will simply run the scheduled program..Brclock will reads the.B "~/.rclock"file at startup, and every 10 minutes (to look for changes) and aftera message window has been dismissed (to find the next appointment).An entry in.B "~/.rclock"may be one of two formats (blank and comment lines will be ignored):.sp.nf.B hh:mm  [dd]  MM/DD/YY message[; program]or.B [hh:mm  [dd]  MM/DD/YY [message]]; program.sp.BR hh " \- hour (0-23; * = current)".BR mm " \- minute (0-59; * = 0)".BR dd " \- days-of-week (some/all/none of umtwrfs; * = all)".BR MM " \- month (1-12; * = current)".BR DD " \- day of month (1-31; * = current)".BR YY " \- year (0-99 or 1900-????; * = current)".BR message " \- message to display".BR program " \- program to execute".fi.spThe days-of-the-week use the following abbreviations:.BR u =Sunday,.BR m =Monday,.BR t =Tuesday,.BR w =Wednesday,.BR r =Thursday,.BR f =Friday,.BR s =Saturday,.BR * =all..spIf.B messageis empty and.B programhas been specified, it is executed without a dialog box.If time/date are also not specified,.B programis executed on start-up.Note.B messagemay contain escape values (\\n: newline, \\;: semicolon).Here's a silly example file that shows some of the permissibleconstructs:.nf.sp# ~/.rclock - My appointment file# startup functions; xsetroot -solid Black &# cron functions10:00; xsetroot -solid Grey25 &14:00; xsetroot -solid Grey75 &# daily/weekly reminders08:15 mtwrf *      Good Morning!\\nRead News?; rxvt -e News12:00 mtwrf *      Lunch Time!17:00 mtwrf *      Go Home23:00 mtwrf *      Still Here? Go to bed08:10 twrf  *      Did you do your time card yesterday?15:00 f     *      Friday, do your time card early!16:00 mtwr  *      Do your time card16: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...dkdfk8:16  *     4/1/*  April Fools!# birthdays/anniversaries16:00    05/21/*   Pam's Birthday (next week)16:00    05/24/*   Pam's Birthday (in a few days)# once-of appointments08:30    03/15/94    Dentist appointment08:30    03/15/1999  Dentist appointment08:30    03/15/2004  Dentist appointment.sp.fi.SH ENVIRONMENT.B rclockuses the environment variable.B MAILto determine the location of the user's mail spool file unlessthe.B -mailfileoption is specified..SH BUGS.B rclockis not very smart about dealing with errors encountered while reading the.B "~/.rclock"file.Each reminder must be a single line not exceeding 255 characters.Reminder windows are sometimes not redrawn (left blank) when raised oruncovered..SH AUTHORRob Nation <nation@rocket.sanders.lockheed.com>.LPModifications by mj olesen <olesen@me.QueensU.CA>.SH "CURRENT MAINTAINER"Same as the current rxvt maintainer.