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 ]