|
|
1.1 root 1: .TH CALENDAR 1
2: .CT 1 time_man
3: .SH NAME
4: calendar \- reminder service
5: .SH SYNOPSIS
6: .B calendar
7: [
8: .B -
9: ]
10: [
11: .I n
12: ]
13: .SH DESCRIPTION
14: .I Calendar
15: consults calendar files
16: and prints out lines that contain today's date or
17: any date up through the
18: .IR n th
19: working day hence
20: .RI ( n =1
21: by default).
22: Most American-style month-day dates such as
23: .BR "Aug. 19" ,\
24: .BR "august 19" ,\
25: .BR "8/19" ,
26: etc., are recognized, but not
27: .LR 19/8 .
28: The symbol
29: .L *
30: denotes every month as in
31: .B *
32: 19 or
33: .BR */19 .
34: A year may follow the day, as in
35: .BR "August 19 86" ,\
36: .BR "8/19/86" ,
37: or
38: .BR "Aug. 19, 1986" .
39: .PP
40: By default, the program consults the file
41: .F calendar
42: in directory
43: .B $HOME
44: (see
45: .IR sh (1)),
46: or in the current directory if a home directory is not known.
47: Other calendar files to be consulted may be specified by calendar
48: lines in one of the forms
49: .IP
50: .B #include
51: \f5\fIfile\^\f5
52: .br
53: .B #include
54: \f5\fImachine\f5!\fIfile\^\f5\fR
55: .LP
56: where
57: .I file
58: is the name of some other calendar and
59: .I machine
60: is the name of a machine or service accessible via
61: .IR con (1).
62: Includes do not nest.
63: .PP
64: When the optional
65: .L -
66: argument is present,
67: .I calendar
68: reminds all users of their calendar engagements by
69: .IR mail (1).
70: Normally this happens daily in the wee hours under control of
71: .IR cron (8).
72: Calendars not in home directories, or recipients not registered
73: as users, may be registered
74: for reminder service by placing lines of the form
75: .I calendarfile mailname
76: in file
77: .FR /usr/lib/calendar .
78: .SH EXAMPLES
79: .EX
80: #include /usr/pub/btlcalendar
81: #include /n/coma/usr/pub/btlcalendar
82: #include mh/astro/coma.calendar!/usr/pub/btlcalendar
83: .EE
84: .ns
85: .IP
86: Ways to subscribe to a public calendar by
87: (1) users of
88: .LR mh/astro/coma ,
89: (2) users elsewhere who have
90: .IR netfs (8)
91: access to
92: .BR coma ,
93: and (3) users elsewhere without
94: .I netfs
95: access.
96: .SH FILES
97: .TF
98: .TP
99: .F calendar
100: .PD0
101: .TP
102: .F /usr/lib/calendar?
103: .TP
104: .F /etc/passwd
105: .TP
106: .F /tmp/cal*
107: .SH "SEE ALSO"
108: .IR at (1)
109: .SH BUGS
110: The mail reminder service doesn't work when
111: it finds fewer than two calendars.
112: .br
113: Your calendar must be public information for you
114: to get reminder service.
115: .br
116: Holidays are what the program says they are.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.