calendar(1)              USER COMMANDS                calendar(1)



NAME
     calendar - reminder service

SYNOPSIS
     calendar [ - ]

DESCRIPTION
     calendar consults the file calendar in the current directory
     and prints out lines that contain today's or tomorrow's date
     anywhere in the line.  Most reasonable month-day dates  such
     as  Aug.  24, august 24, 8/24, etc., are recognized, but not
     24 August or 24/8.  On weekends ``tomorrow'' extends through
     Monday.   calendar  can  be  invoked  regularly by using the
     crontab(1) or at(1) commands.

     When an argument is present, calendar does its job for every
     user  who  has a file calendar in his or her login directory
     and sends them any positive results  by  mail(1).   Normally
     this  is done daily by facilities in the UNIX operating sys-
     tem (see cron(1M)).  If the environment variable DATEMSK  is
     set,  calendar will use its value as the full path name of a
     template file containing format strings.  The  strings  con-
     sist  of  field descriptors and text characters and are used
     to provide a richer set of allowable date  formats  in  dif-
     ferent  languages by appropriate settings of the environment
     variable LANG or LCTIME (see environ(5)).  (See date(1) for
     the allowable list of field descriptors.)

EXAMPLES
     The following example shows the possible contents of a  tem-
     plate:
          %B %eth of the year %Y
     %B represents the full month name, %e the day of  month  and
     %Y the year (4 digits).  If DATEMSK is set to this template,
     the following calendar file would be valid:
          March 7th of the year 1989 < Reminder>

FILES
     /usr/lib/calprog    program used to figure out  today's  and
                         tomorrow's dates
     /etc/passwd
     /tmp/cal*

SEE ALSO
     at(1), date(1), crontab(1), mail(1).
     cron(1M), environ(5) in the System Administrator's Reference
     Manual .

NOTES
     Appropriate lines beginning with white  space  will  not  be
     printed.
     Your calendar must be public  information  for  you  to  get



                                                                1

calendar(1)              USER COMMANDS                calendar(1)



     reminder service.
     calendar's extended idea of ``tomorrow''  does  not  account
     for holidays.




















































                                                                2