|
|
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: .PP
63: When the optional
64: .L -
65: argument is present,
66: .I calendar
67: reminds all users of their calendar engagements by
68: .IR mail (1).
69: Normally this happens daily in the wee hours under control of
70: .IR cron (8).
71: Calendars not in home directories, or recipients not registered
72: as users, may be registered
73: for reminder service by placing lines of the form
74: .I calendarfile mailname
75: in file
76: .FR /usr/lib/calendar .
77: .SH EXAMPLES
78: .EX
79: #include /usr/pub/btlcalendar
80: #include /n/coma/usr/pub/btlcalendar
81: #include mh/astro/coma.calendar!/usr/pub/btlcalendar
82: .EE
83: .ns
84: .IP
85: Ways to subscribe to a public calendar by
86: (1) users of
87: .LR mh/astro/coma ,
88: (2) users elsewhere who have
89: .IR netfs (8)
90: access to
91: .BR coma ,
92: and (3) users elsewhere without
93: .I netfs
94: access.
95: .SH FILES
96: .TF
97: .TP
98: .F calendar
99: .PD0
100: .TP
101: .F /usr/lib/calendar?
102: .TP
103: .F /etc/passwd
104: .TP
105: .F /tmp/cal*
106: .SH "SEE ALSO"
107: .IR at (1)
108: .SH BUGS
109: .BR #include s
110: do not nest.
111: .br
112: The mail reminder service doesn't work when
113: it finds fewer than two calendars.
114: .br
115: Your calendar must be public information for you
116: to get reminder service.
117: .br
118: 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.