Linux Certif

Toute la documentation sur la certification Linux LPI

rclock

NAME

rclock - clock and appointment reminder for X11

SYNOPSIS

rclock [options]

DESCRIPTION

rclock --- version 2.7.10 --- 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 specified by the DISPLAY environment variable is used.

-geometry geom

Create the window with the specified X window geometry [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].

-nodate

Do not display today's date on the face of the clock.

-iconic

Start iconified, if supported by the window manager.

-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.

-mailspawn cmd

Execute cmd when the face of the clock is clicked by the mouse button.

#geom

Specify the preferred icon window size [default 65x65].

Some of these options may not be available based on how rclock was compiled. Run rclock -help to determine which features are available.

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 date is also displayed on the lower half of the clock unless the -nodate option is specified. 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 permissible 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
 
 

ENVIRONMENT

rclock uses the environment variable MAIL to determine the location of the user's mail spool file unless the -mailfile option is specified.

BUGS

rclock is not very smart about dealing with errors encountered 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.