


CALENDAR(1)	    UNIX Programmer's Manual	      CALENDAR(1)



NAME
     calendar - reminder service

SYNOPSIS
     calendar [ - ]

DESCRIPTION
     _C_a_l_e_n_d_a_r consults the file `calendar' in the current direc-
     tory and prints out lines that contain today's or tomorrow's
     date anywhere in the line.  Most reasonable month-day dates
     such as `Dec. 7,' `december 7,' `12/7,' etc., are recog-
     nized, but not `7 December' or `7/12'.  If you give the
     month as ``*'' with a date, i.e. ``* 1'', that day in any
     month will do.  On weekends `tomorrow' extends through Mon-
     day.

     When an argument is present, _c_a_l_e_n_d_a_r does its job for every
     user who has a file `calendar' in his login directory and
     sends him any positive results by _m_a_i_l(1).  Normally this is
     done daily in the wee hours under control of _c_r_o_n(8).

     The file `calendar' is first run through the ``C'' prepro-
     cessor, /_l_i_b/_c_p_p, to include any other calendar files speci-
     fied with the usual ``#include'' syntax.  Included calendars
     will usually be shared by all users, maintained and docu-
     mented by the local administration.

FILES
     calendar
     /usr/libexec/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)

BUGS
     _C_a_l_e_n_d_a_r'_s extended idea of `tomorrow' doesn't account for
     holidays.














Printed 11/26/99	October 21, 1996			1



