shithub: riscv

ref: 4a92a8f6b2502750a69e87d398ffb2f069103bf4
dir: /sys/man/1/calendar/

View raw version
.TH CALENDAR 1
.SH NAME
calendar \- print upcoming events
.SH SYNOPSIS
.B calendar
[
.B -dy
]
[
.B -p
.I days
]
[
.I file ...
]
.SH DESCRIPTION
.I Calendar
reads the named files, default
.BR /usr/$user/lib/calendar ,
and writes to standard output any lines
containing today's or tomorrow's date.
Examples of recognized date formats are 
"4/11",
"April 11",
"Apr 11",
"11 April",
and
"11 Apr".
A special form may be used to represent weekly and
monthly events:
"Every Tuesday"
"The third Wednesday"
All comparisons are case insensitive.
.PP
If the
.B -y
flag is given, an attempt is made to match on year too.  In this case,
dates of the forms listed above will be accepted if they are followed
by the current year (or last two digits thereof) or not a year —
digits not followed by white space or non-digits.
.PP
If the
.B -p
flag is given, its argument is the number of days ahead to match
dates.  This flag is not repeatable, and it performs no special
processing at the end of the week.
.PP
The
.B -d
flag enables debugging output.
.PP
On Friday and Saturday, events through Monday are printed.
.PP
To have your calendar mailed to you every day, use
.IR cron (8).
.SH FILES
.TF /usr/$user/lib/calendar
.TP
.B /usr/$user/lib/calendar
personal calendar
.SH SOURCE
.B /sys/src/cmd/calendar.c