calendar(1)                                              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 variables LC_ALL, LC_TIME, and
             LANG [see environ(5)].  The LC_CTYPE environment variable is
             also examined for details of the codesets used in the format
             strings.  [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:





                           Copyright 1994 Novell, Inc.               Page 1

      calendar(1)                                              calendar(1)


                  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*
            /usr/lib/locale/locale/LC_MESSAGES/uxcore.abi
                                language-specific message file [See LANG
                                in environ(5).]

      REFERENCES
            at(1), cron(1M), crontab(1), date(1), environ(5), mail(1)

      NOTICES
            Appropriate lines beginning with white space will not be
            printed.

            Your calendar must be public information for you to get
            reminder service.

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

























                          Copyright 1994 Novell, Inc.               Page 2