CALENDAR(1)

NAME
calendar - reminder service

SYNOPSIS
calendar [ - ]

DESCRIPTION
Calendar consults the file `calendar' in the user's home directory and prints out lines that contain today's, tomorrow's, or a proper future date at the beginning of the line. Most reasonable month-day dates such as `Dec. 7,' `december 7,' `12/7,' etc., are recognized, but not `7 December' or `7/12'. On weekends `tomorrow' extends through Monday.

Calendar also supports months and days of the week by themselves. This allows you to specify things on a weekly or monthly basis. The format for weekday names is the same as that for month names; Mon., monday, tues, tue, wed, etc. The month may be specified either by name, or by number. The weekday will only be recognized by name.

EXTENDED NOTIFICATION
If you wish to have extended notification of a previous or upcoming event, calendar supports a notation that extends a date by a week.

If "*w" is appended directly to the week day, I.E. 12/7*w, then you will be sent a reminder every day beginning approximately (depending on the weekend) 7 days prior to the date.

If "*W" (note the significance of case "w" or "W") is appended to the week day as in the above example, than you will be notified beginning one day before and extending up to 10 days after.

If you wish to have both of these features, I.E. a 2 week window around the given date, you can append "*Ww" or "*wW" to the week day.

EXTENDED MESSAGES
Calendar will recognize lines with leading blanks or tabs as extensions to a line with a matched (the date given is "today") date. This allows comments longer than one line to be present for any given date. Below is an example date specification.

Wednesday
    Backups...
    Check all printers for paper, ribbons, etc.

YOUR CALENDAR OR EVERYBODY'S
When an argument is present, calendar does its job for every user who has a file `calendar' in their login directory and sends them any positive results by mail(1). Normally this is done daily in the wee hours under control of cron(8).

SAMPLE FILE
July            Get the budget ready for the new fiscal year
Monday          Check all printers for paper...
                Check MMDF, MDQS, and UUCP
Wednesday       Backups are tonight...
Friday          Lets go party....
6/17            John's b'day
                Mark's b'day

FILES
$HOME/calendar The users' calendar, $HOME is taken
                      from /etc/passwd
/usr/lib/calendar processes each users' `calendar' file.
/etc/passwd Source of home directories.
/tmp/Cal* Output data file used to assure that
                      there are no null messages.
sed, mail Subprocesses

SEE ALSO
at(1), cron(8), mail(1)

BUGS
In general, your calendar must be readable by the public. See your system administrator for the specifics. Calendar's extended idea of `tomorrow' doesn't account for holidays. Lines containing erroneous data are silently ignored.

CREDITS TO
Gregg Wonderly
Oklahoma State University