The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 NAME

calendar - reminder service (LEGACY)

 SYNOPSIS



calendar 

 DESCRIPTION

The calendar utility consults the file calendar in the current directory and writes lines that contain today's or tomorrow's date anywhere in the line to standard output. On Fridays and weekends, tomorrow extends to the following Monday, inclusive.

 OPTIONS

None.

 OPERANDS

None.

 STDIN

Not used.

 INPUT FILES

The calendar file in the current directory is a text file. Each line can contain text that includes a string, in any location, that is interpreted as today's or tomorrow's date. Month-day date formats such as Aug. 24, august 24 and 8/24 are recognised.

 ENVIRONMENT VARIABLES

The following environment variables may affect the execution of calendar:
LANG
Provide a default value for the internationalisation variables that are unset or null. If LANG is unset or null, the corresponding value from the implementation-dependent default locale will be used. If any of the internationalisation variables contains an invalid setting, the utility will behave as if none of the variables had been defined.
LC_ALL
If set to a non-empty string value, override the values of all the other internationalisation variables.
LC_CTYPE
Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single- as opposed to multi-byte characters in input files).
LC_MESSAGES
Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.
LC_TIME
Determine the format of the date strings recognised by the calendar utility.
NLSPATH
Determine the location of message catalogues for the processing of LC_MESSAGES .
TZ
Determine the timezone used to qualify the date strings recognised by the calendar utility.

 ASYNCHRONOUS EVENTS

Default.

 STDOUT

The standard output contains all of the selected lines from the calendar file.

 STDERR

Not used.

 OUTPUT FILES

None.

 EXTENDED DESCRIPTION

None.

 EXIT STATUS

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

 CONSEQUENCES OF ERRORS

Default.

 APPLICATION USAGE

Some implementations support extensions that use operands. Portable applications must not use any operands to calendar.

 EXAMPLES

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

None.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]