Penguin
Recent Changes
Annotated edit history of calendar(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 ----
2 __NAME__
3
4
5 calendar - reminder service
6 __SYNOPSIS__
7
8
9 calendar [[-a] [[-A num] [[-B num] [[-f calendarfile]
10 [[
11 -tdd
12 [[.mm[[.year]]
13 ] [[-l days] [[-w days]
14 __DESCRIPTION__
15
16
17 Calendar checks the current directory for a file named
18 calendar and displays lines that begin with either
19 today's date or tomorrow's. On Fridays, events on Friday
20 through Monday are displayed. If there is no configuration
21 file in the current directory, /etc/calendar/default is used
22 (if present).
23
24
25 The following options are available:
26 -a Process the ``calendar'' files of all users and mailthe results to them. This requires super-user privi-leges.
27
28
29 -A numPrint lines from today and the next num days (for-ward, future).-B numPrint lines from today and the previous num days(backward, past).-f calendarfileUse calendarfile as the default calendar file.
30
31
32 -t
33 dd[[.mm[[.year]]
34 For test purposes only: set date directly to argument
35 values.
36
37
38 -l days
39 Causes the program to ``look ahead'' a given number of days
40 (default one) from the specified date and display their
41 entries as well.
42
43
44 -w days
45 Causes the program to add the specified number of days to
46 the ``look ahead'' number if and only if the day specified
47 is a Friday. The default value is two, which causes calendar
48 to print entries through the weekend on
49 Fridays.
50
51
52 To handle calendars in your national code table you can
53 specify ``LANG=
54
55
56 Other lines should begin with a month and day. They may be
57 entered in almost any format, either numeric or as character
58 strings. If the proper locale is set, national month and
59 weekday names can be used. A single asterisk (``'') matches
60 every month. A day without a month matches that day of every
61 week. A month without a day matches the first of that month.
62 Two numbers default to the month followed by the day. Lines
63 with leading tabs default to the last entered date, allowing
64 multiple line specifications for a single date.
65
66
67 ``Easter'', is Easter for this year, and may be followed by
68 a positive or negative integer.
69
70
71 ``Paskha'', is Orthodox Easter for this year, and may be
72 followed by a positive or negative integer.
73
74
75 Weekdays may be followed by ``-4'' ... ``+5'' (aliases for
76 last, first, second, third, fourth) for moving events like
77 ``the last Monday in April''
78
79
80 By convention, dates followed by an asterisk are not fixed,
81 i.e., change from year to year.
82
83
84 Day descriptions start after the first
85
86
87 The ``calendar'' file is preprocessed by cpp(1),
88 allowing the inclusion of shared files such as lists of
89 company holi- days or meetings. If the shared file is not
90 referenced by a full pathname, cpp(1) searches in
91 the current (or home) directory first, and then in the
92 directory /etc/calendar/, then in
93 /etc/calendar, then in
94 /usr/share/calendar/ and finally in
95 /usr/share/calendar. Empty lines and lines
96 protected by the C commenting syntax (/ ... /) are
97 ignored.
98
99
100 Some possible calendar entries (
101 t__ sequence)
102
103
104 LANG=C
105 Easter=Ostern
106
107
108 #include
109 #include
110
111
112 6/15__t__June 15 (if ambiguous, will default to
113 month/day).
114 Jun. 15__t__June 15.
115 15 June__t__June 15.
116 Thursday__t__Every Thursday.
117 June__t__Every June 1st.
118 15 __t__15th of every month.
119
120
121 May Sun+2__t__second Sunday in May (Muttertag)
2 perry 122 04/!SunLast__t__last Sunday in April,__
1 perry 123 t__summer time in Europe
124 Easter__t__Easter
125 Ostern-2__t__Good Friday (2 days before Easter)
126 Paskha__t__Orthodox Easter
127 __FILES__
128 calendar
129 file in current
130 directory
131
132
133 ~/calendar
134 file in $HOME
135 ~/.calendar
136 calendar HOME directory. calendar does a chdir into
137 this directory if it exists.
138 ~/.calendar/calendar
139 calendar file to use if no calendar file exists in the
140 current directory.
141 ~/.calendar/nomail
142 do not send mail if this file exists.
143
144
145 The following default calendar files are provided:
146
147
148 calendar.birthday
149 Births and deaths of famous (and not-so-famous)
150 people.
151 calendar.christian
152 Christian holidays. This calendar should be updated yearly
153 by the local system administrator so that roving holidays
154 are set correctly for the current year.
155 calendar.computer
156 Days of special significance to computer people.
157 calendar.freebsd
158 Birthdays of FreeBSD committers.
159 calendar.history
160 Everything else, mostly U.S. historical events.
161 calendar.holiday
162 Other holidays, including the not-well-known, obscure, and
163 ''really'' obscure.
164 calendar.judaic
165 Jewish holidays. This calendar should be updated yearly by
166 the local system admin- istrator so that roving holidays are
167 set correctly for the current year.
168 calendar.discordian
169 Discordian holidays.
170 calendar.music
171 Musical events, births, and deaths. Strongly oriented toward
172 rock 'n' roll.
173 calendar.usholiday
174 U.S. holidays. This calendar should be updated yearly by the
175 local system admin- istrator so that roving holidays are set
176 correctly for the current year.
177 calendar.german
178 German calendar.
179 calendar.russian
180 Russian calendar.
181 calendar.croatian
182 Croatian calendar.
183 calendar.hindu
184 Major Hindu holidays. This calendar should be updated yearly
185 by the local system administrator so that roving holi- days
186 are set correctly for the current year.
187 default
188 The system-wide default, which #includes all the previous
189 calendars.
190
191
192 __SEE ALSO__
193
194
195 at(1), cpp(1), mail(1),
196 cron(8)
197 __COMPATIBILITY__
198
199
200 The calendar program previously selected lines which had the
201 correct date anywhere in the line. This is no longer true,
202 the date is only recognized when it occurs at the beginning
203 of a line.
204
205
206 Having a directory per year is a Debian-specific improvement over the standard BSD calendar.
207
208
209 Older calendar releases distributed with Debian supported
210 the -t option which has been superseded by the -A and -B
211 options and the ~/.calendar file which has been
212 superseded by the ~/.calendar
213 directory.
214 __HISTORY__
215
216
217 A calendar command appeared in Version 7 AT
218 .
219 __BUGS__
220
221
222 Calendar doesn't handle Jewish holidays and moon phases. The
223 -A and -l options do very similar things.
224
225
226 BSD October 1, 2001 1
227 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.