calendar(1)            (User Environment Utilities)             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 system (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 consist of field descriptors and text
         characters and are used to provide a richer set of allowable date
         formats in different 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 template:

               %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), System Administrator's Reference Manual .
         environ(5) in the Programmer's Reference Manual
          .SH NOTES Appropriate lines beginning with white space will not be


   7/91                                                                 Page 1

   calendar(1)            (User Environment Utilities)             calendar(1)


         printed.
         Your calendar must be public information for you to get reminder
         service.
         calendar's extended idea of ``tomorrow'' does not account for
         holidays.
















































   Page 2                                                                 7/91