calendar(1)						      General Commands Manual						       calendar(1)

NAME

       calendar - Writes reminder messages to standard output

SYNOPSIS

       calendar [-]

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       calendar:  XCU5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

OPTIONS

       [Tru64 UNIX]   Calls calendar for all users who have a calendar file in their home directories and sends reminders by mail.

	      This flag is usually used only by the superuser as part of daily administrative procedures.

DESCRIPTION

       The  calendar  command  reads  a file named calendar in your current (usually home) directory and writes to standard output any line in the
       file that contains the current date or the next day's date.

       The calendar command recognizes date formats such as Dec. 7 or 12/7.  It also recognizes the special character * (asterisk)  to	match  any
       month.  For example, it interprets */7 or * 7 as the seventh day of every month.

       On Fridays, calendar writes all lines containing the dates for Friday, Saturday, Sunday, and Monday.  It does not recognize holidays, so if
       the next day is a holiday calendar prints lines for that day, rather than for the next working day.

       For you to get reminder service when other users run calendar -, your calendar file must be readable by others (see the chmod command).

NOTES

       The calendar utility is marked LEGACY in XCU Issue 5.

EXIT STATUS

       The following exit values are returned: Successful completion.  An error occurred.

EXAMPLES

       To display information in the calendar file that pertains to today and tomorrow, enter: calendar A typical calendar file  might	look  like
       this:

	      */25  -  Prepare monthly report Aug. 12 - Fly to Denver aug 23 - board meeting Martha out of town - 8/23, 8/24, 8/25 8/24 - Mail car
	      payment sat aug/25 - beach trip August 27 - Meet with Simmons August 28 - Meet with Wilson

	      If today is Friday, August 24, then the calendar command displays: */25 - Prepare monthly report Martha out of town  -  8/23,  8/24,
	      8/25 8/24 - Mail car payment sat aug/25 - beach trip August 27 - Meet with Simmons

ENVIRONMENT VARIABLES

       The  following environment variables affect the execution of calendar: [Tru64 UNIX]  If this variable is set, the calendar command uses its
       value as the full pathname of a template file that contains format strings.  The strings consist of field descriptors and  text	characters
       which are used to provide a more robust set of allowable date formats in different languages using the appropriate settings of the environ-
       ment variables LANG or LC_TIME.	See environ(5) for more information.  The list of allowable field descriptions is provided in the  date(1)
       reference page.	Provides a default value for the internationalization variables that are unset or null. If LANG is unset or null, the cor-
       responding value from the default locale is used.  If any of the internationalization variables contain an  invalid  setting,  the  utility
       behaves	as  if none of the variables had been defined.	If set to a non-empty string value, overrides the values of all the other interna-
       tionalization variables.  Determines the locale for the interpretation of sequences of bytes of text data as characters (for example,  sin-
       gle-byte  as  opposed  to  multibyte  characters in input files).  Determines the locale for the format and contents of diagnostic messages
       written to standard error.  Determines the format of date strings recognized by the calendar command.  Determines the location  of  message
       catalogues for the processing of LC_MESSAGES.

FILES

       Contains user calendar entries.	Determines dates.  Contains user information.

SEE ALSO

       Commands:  chmod(1), date(1), mail(1), mailx(1)

       Environment:  environ(5)

       Standards:  standards(5)

																       calendar(1)