CALENDAR(1)
NAME
calendar − reminder service
USAGE
calendar [ − ]
DESCRIPTION
Calendar provides an individual reminder service by consulting the file calendar in the current directory and printing out lines containing today’s or tomorrow’s date. You must create the file before calendar can successfully run.
A typical line in your calendar file may look like this:
12 15 Departmental meeting at 3 p.m.
Calendar recognizes most month-day entries (e.g., 12 15, Dec. 15, december 15). It does not, however, recognize day-month items (e.g., 15 December, etc.). If you give the month as an asterisk (*) with a date (e.g., *1), that day in any month will do. On weekends, “tomorrow” extends through Monday.
When an argument is present, calendar looks in all users’ log-in directories for a file named calendar and sends any positive results by mail (1) to the user executing calendar. Normally, this is done early every day under the control of cron (8).
The file calendar is first run through the C preprocessor, /usr/lib/cpp, to include any other calendar files specified with the usual #include syntax. Included calendars are usually shared by all users, and maintained and documented by the local administration.
CAUTIONS
Your calendar must be public information for you to get reminder service.
Calendar’s idea of “tomorrow" does not account for holidays.
FILES
calendar
/usr/lib/calendar to figure out today’s and tomorrow’s dates
/etc/passwd
/tmp/cal∗
/usr/lib/cpp, egrep, sed, mail as subprocesses