Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

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