![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to calendar.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / calendar|
Return to calendar.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / calendar |
1.1 root 1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)calendar.1 6.9 (Berkeley) 7/24/90
19: .\"
20: .Dd July 24, 1990
21: .\"
22: .Dt CALENDAR 1
23: .Os BSD 4.4
24: .Sh NAME
25: .Nm calendar
26: .Nd reminder service
27: .Sh SYNOPSIS
28: .Nm calendar
29: .Op \-a
30: .Sh DESCRIPTION
31: .Nm Calendar
32: checks the current directory for a file named named
33: .Li calendar
34: and displays lines that begin with either today's date
35: or tomorrow's.
36: On Fridays, events on Friday through Monday are displayed.
37: .Pp
38: The following options are available:
39: .Tp Fl a
40: Process the ``calendar'' files of all users and mail the results
41: to them.
42: This requires super-user privileges.
43: .Tp
44: .Pp
45: A month and day should begin lines.
46: They may be entered in almost any format, either numeric or as character
47: strings.
48: A single asterisk (``*'') matches every month.
49: A day without a month matches that day of every week.
50: A month without a day matches the first of that month.
51: Two numbers default to the month followed by the day.
52: Lines with leading tabs default to the last entered date, allowing
53: multiple line specifications for a single date.
54: By convention, dates followed by an asterisk are not fixed, i.e. change
55: from year to year.
56: .Pp
57: The ``calendar'' file is preprocessed by
58: .Xr cpp 1 ,
59: allowing the inclusion of shared files such as company holidays or
60: meetings.
61: If the shared file is not referenced by a full pathname,
62: .Xr cpp 1
63: searches in the current (or home) directory first, and then in the
64: directory
65: .Pa /usr/share/calendar .
66: Empty lines and lines protected by the C commenting syntax (/* ... */)
67: are ignored.
68: .Pp
69: Some possible calendar entries:
70: .Pp
71: .Ds I
72: #include <calendar.usholiday>
73: #include <calendar.birthday>
74:
75: 6/15 ... June 15 (if ambiguous, will default to month/day).
76: Jun. 15 ... June 15.
77: 15 June ... June 15.
78: Thursday ... Every Thursday.
79: June ... Every June 1st.
80: 15 * ... 15th of every month.
81: .De
82: .Pp
83: .Sh FILES
84: The following default calendar files are provided:
85: .Dw calendar.christian
86: .Di L
87: .Dp Pa calendar.birthday
88: Births and deaths of famous ( and not- so- famous) people.
89: .Dp Pa calendar.christian
90: Christian holidays.
91: This calendar should be updated yearly by the local system administrator
92: so that roving holidays are set correctly for the current year.
93: .Dp Pa calendar.computer
94: Days of special significance to computer people.
95: .Dp Pa calendar.history
96: Everything else, mostly U. S. historical events.
97: .Dp Pa calendar.holiday
98: Other holidays, including the not-well-known, obscure, and
99: .Em really
100: obscure.
101: .Dp Pa calendar.judaic
102: Jewish holidays.
103: This calendar should be updated yearly by the local system administrator
104: so that roving holidays are set correctly for the current year.
105: .Dp Pa calendar.music
106: Musical events, births, and deaths.
107: Strongly oriented toward rock ' n' roll.
108: .Dp Pa calendar.usholiday
109: U.S. holidays.
110: This calendar should be updated yearly by the local system administrator
111: so that roving holidays are set correctly for the current year.
112: .Dp
113: .Sh SEE ALSO
114: .Xr at 1 ,
115: .Xr cpp 1 ,
116: .Xr cron 8
117: .Xr mail 1 ,
118: .Sh COMPATIBILITY
119: The
120: .Nm calendar
121: program previously selected lines which had the correct date anywhere
122: in the line.
123: This is no longer true, the date is only recognized when it occurs
124: first on the line.
125: .Sh HISTORY
126: A
127: .Nm
128: command appeared in Version 7 AT&T UNIX.
129: The version of
130: .Nm calendar
131: released with this man page
132: is unrelated.
133: .Sh BUGS
134: .Nm Calendar
135: doesn't handle events that move around from year to year, i.e.
136: ``the last Monday in April''.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.