calendar(1)							   calendar(1)

NAME    [Toc]    [Back]

     calendar -	reminder service

SYNOPSIS    [Toc]    [Back]

     calendar [	- ]

DESCRIPTION    [Toc]    [Back]

     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).  If a argument	is not present,	calendar will display
     the current information in	the calendar file or if	the calendar file
     doesn't exist will	display	a message that the calendar file cannot	be
     found.  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 pathname 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    [Toc]    [Back]

     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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

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





									Page 1






calendar(1)							   calendar(1)

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 2222