NAME

calendar - reminder service

SYNOPSIS

calendar [ - ]

AVAILABILITY

SUNWesu

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 forth, 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 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 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>

ENVIRONMENT

If any of the LC_ *variables ( LC_CTYPE, LC_MESSAGES, LC_TIME, LC_COLLATE, LC_NUMERIC, and LC_MONETARY ) (see environ(5)) are not set in the environment, the operational behavior of calendar for each corresponding locale category is determined by the value of the LANG environment variable. If LC_ALL is set, its contents are used to override both the LANG and the other LC_ *variables. If none of the above variables is set in the environment, the "C" (U.S. style) locale determines how calendar behaves.

LC_CTYPE

Determines how calendar handles characters. When LC_CTYPE is set to a valid value, calendar can display and handle text and filenames containing valid characters for that locale. calendar can display and handle Extended Unix Code (EUC) characters where any individual character can be 1, 2, or 3 bytes wide. calendar can also handle EUC characters of 1, 2, or more column widths. In the "C" locale, only characters from ISO 8859-1 are valid.

LC_TIME

Determines how calendar handles date and time formats. In the "C" locale, date and time handling follows the U.S. rules.

FILES

/etc/passwd

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

SEE ALSO

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

NOTES

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.