calendar(1)        UNIX System V(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, and so
      on, 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), 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 reminder service.


10/89                                                                    Page 1

calendar(1)        UNIX System V(User Environment Utilities)        calendar(1)


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





















































Page 2                                                                    10/89