calendar.1

.TH CALENDAR 1
.SH NAME
calendar \- print upcoming events
.SH SYNOPSIS
.B calendar
[
.B -A
.I num
]
[
.B -B
.I num
]
[
.B -f
.I file
]
[
.B -t
.I YYYY-MM-DD
]
.SH DESCRIPTION
.I Calendar
reads a file named
.I calendar
from the current directory and displays lines that begin begin with a
datetime string that matches today's or tomorrows date.
.PP
.I Calendar
processes datetime strings using
.IR date(1).
Examples of datetime formats recognized by GNU
.IR date(1)
are
"@1365631200",
"4/11",
"April 11",
"Apr 11",
"2013-04-11" and
"Thursday 12:34".
.PP
If the
.B -A
flag is given, its argument is the number of days ahead to match dates.
.PP
If the
.B -B
flag is given, its argument is the number of days back to match dates.
.PP
If the
.B -f
flag is given, its argument is the name of a file to use instead of a file
named
.I calendar
from the current directory.
.PP
if the
.B -t
flag is given, its argument is a date and
.I calendar
acts as if that date were today's date.
.SH COMPATIBILITY
The
.I calendar
command will only display reminders that use a <tab> character
to separate the date and description or that begin with a <tab>.
.PP
This version of
.I calendar
does not have the
.B -l
or
.B -p
options found in Debian and Plan 9 from Bell Labs; use the
.B -A
option instead.
.SH HISTORY
A
.I calendar
command appeared in Version 7 AT&T Unix. This version of
.I calendar
is inspired by the version found in in Plan 9 from Bell Labs.
.PP
A previous version of
.I calendar
used
.I cdate(1)
to interpret locale-specific datetime strings.
To aid portability, this feature was removed.
.SH AUTHOR
.I calendar
and this man page were written by Nils Dagsson Moskopp.
.SH COPYRIGHT
Copyright © 2013 Nils Dagsson Moskopp.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.SH SEE ALSO
.I date(1)