1 .TH CALENDAR 1
2 .SH NAME
3 calendar \- print upcoming events
4 .SH SYNOPSIS
5 .B calendar
6 [
7 .B \-y
8 ]
9 [
10 .B \-p days
11 ]
12 [
13 .I file ...
14 ]
15 .SH DESCRIPTION
16 .I Calendar
17 reads the named files, default
18 .BR $HOME/lib/calendar ,
19 and writes to standard output any lines
20 containing today's or tomorrow's date.
21 Examples of recognized date formats are 
22 "4/11",
23 "April 11",
24 "Apr 11",
25 "11 April",
26 and
27 "11 Apr".
28 All comparisons are case insensitive.
29 .PP
30 If the
31 .B \-y
32 flag is given, an attempt is made to match on year too.  In this case,
33 dates of the forms listed above will be accepted if they are followed
34 by the current year (or last two digits thereof) or not a year —
35 digits not followed by white space or non-digits.
36 .PP
37 If the
38 .B \-p
39 flag is given, its argument is the number of days ahead to match
40 dates.  This flag is not repeatable, and it performs no special
41 processing at the end of the week.
42 .PP
43 On Friday and Saturday, events through Monday are printed.
44 .PP
45 To have your calendar mailed to you every day, use
46 .MR cron (8) .
47 .SH FILES
48 .TF $HOME/lib/calendar
49 .TP
50 .B $HOME/lib/calendar
51 personal calendar
52 .SH SOURCE
53 .B \*9/src/cmd/calendar.c