CALENDAR(1)                          BSD                           CALENDAR(1)



NAME
     calendar - reminder service

SYNOPSIS
     calendar [ - ]

DESCRIPTION
     calendar provides an individual reminder service by consulting the file
     calendar in the current directory and printing out lines that contain
     today's or tomorrow's date anywhere in the line.  You must create the
     file before calendar can successfully run.

     calendar recognizes most month-day entries, such as Dec. 7, december 7,
     12/7.  It does not recognize  day-month entries, such as 7 December or
     7/12.  If you give the month as an asterisk (*) with a date, for example,
     * 1, that day in any month will do.  On weekends "tomorrow" extends
     through Monday.

     When you specify an argument, calendar does its job for all users who
     have a file named calendar in their login directories and sends any
     positive results by mail.  Normally calendar does this early every day,
     under the control of cron(8).

     The file calendar is first run through the C preprocessor, /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.

EXAMPLE
     A typical line in your calendar file may look like this:

          12/15 Departmental meeting at 3 p.m.

BUGS
     calendar's extended idea of "tomorrow" doesn't account for holidays.

FILES
     ~/calendar
     /usr/lib/calendar          To figure out today's and tomorrow's dates
     /etc/passwd
     /tmp/cal*
     /lib/cpp, egrep, sed, mail As subprocesses

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