CALENDAR(1)         RISC/os Reference Manual          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 con-
     taining 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
     LC_TIME (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).



                        Printed 11/19/92                   Page 1

CALENDAR(1)         RISC/os Reference Manual          CALENDAR(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 rem-
     inder service.
     calendar's extended idea of tomorrow does not account for
     holidays.













































 Page 2                 Printed 11/19/92