version 1.17, 2001/10/11 20:10:30 |
version 1.31, 2005/12/15 16:30:29 |
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright |
.\" 2. Redistributions in binary form must reproduce the above copyright |
.\" notice, this list of conditions and the following disclaimer in the |
.\" notice, this list of conditions and the following disclaimer in the |
.\" documentation and/or other materials provided with the distribution. |
.\" documentation and/or other materials provided with the distribution. |
.\" 3. All advertising materials mentioning features or use of this software |
.\" 3. Neither the name of the University nor the names of its contributors |
.\" must display the following acknowledgement: |
|
.\" This product includes software developed by the University of |
|
.\" California, Berkeley and its contributors. |
|
.\" 4. Neither the name of the University nor the names of its contributors |
|
.\" may be used to endorse or promote products derived from this software |
.\" may be used to endorse or promote products derived from this software |
.\" without specific prior written permission. |
.\" without specific prior written permission. |
.\" |
.\" |
|
|
.Nd reminder service |
.Nd reminder service |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm calendar |
.Nm calendar |
.Op Fl a |
.Op Fl ab |
.Op Fl A Ar num |
.Op Fl A Ar num |
.Op Fl b |
|
.Op Fl B Ar num |
.Op Fl B Ar num |
.Op Fl f Ar calendarfile |
.Op Fl f Ar calendarfile |
.Op Fl t Ar [[[cc]yy][mm]]dd |
.Op Fl t Ar [[[cc]yy][mm]]dd |
|
|
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
.It Fl A Ar num |
|
Print lines from today and next |
|
.Ar num |
|
days (forward, future). |
.It Fl a |
.It Fl a |
Process the |
Process the |
.Dq calendar |
.Dq calendar |
files of all users and mail the results |
files of all users and mail the results |
to them. |
to them. |
This requires superuser privileges. |
This requires superuser privileges. |
.It Fl A Ar num |
|
Print lines from today and next |
|
.Ar num |
|
days (forward, future). |
|
.It Fl b |
|
Enforce special date calculation mode for KOI8 calendars. |
|
.It Fl B Ar num |
.It Fl B Ar num |
Print lines from today and previous |
Print lines from today and previous |
.Ar num |
.Ar num |
days (backward, past). |
days (backward, past). |
|
.It Fl b |
|
Enforce special date calculation mode for KOI8 calendars. |
.It Fl f Pa calendarfile |
.It Fl f Pa calendarfile |
Use |
Use |
.Pa calendarfile |
.Pa calendarfile |
|
|
.Dq Paskha=<national_name> |
.Dq Paskha=<national_name> |
(for Orthodox Easter) can be used. |
(for Orthodox Easter) can be used. |
.Pp |
.Pp |
|
The |
|
.Dq CALENDAR |
|
variable can be used to specify the style. |
|
Only |
|
.Sq Julian |
|
and |
|
.Sq Gregorian |
|
styles are currently supported. |
|
Use |
|
.Dq CALENDAR= |
|
to return to the default (Gregorian). |
|
.Pp |
To enforce special date calculation mode for Cyrillic calendars |
To enforce special date calculation mode for Cyrillic calendars |
you should specify |
you should specify |
.Dq LANG=<local_name> |
.Dq LANG=<local_name> |
|
|
.Pq Li /* ... */ |
.Pq Li /* ... */ |
are ignored. |
are ignored. |
.Pp |
.Pp |
Some possible calendar entries (<tab> characters are highlighted by a |
Some possible calendar entries |
\fB\et\fR sequence): |
(a \fB\et\fR sequence denotes a <tab> character): |
.Bd -unfilled -offset indent |
.Bd -unfilled -offset indent |
LANG=C |
LANG=C |
Easter=Ostern |
Easter=Ostern |
|
|
Jun. 15\fB\et\fRJune 15. |
Jun. 15\fB\et\fRJune 15. |
15 June\fB\et\fRJune 15. |
15 June\fB\et\fRJune 15. |
Thursday\fB\et\fREvery Thursday. |
Thursday\fB\et\fREvery Thursday. |
June\fB\et\fREvery June 1st. |
June\fB\et\fREvery June 1st. |
15 *\fB\et\fR15th of every month. |
15 *\fB\et\fR15th of every month. |
|
|
May Sun+2\fB\et\fRsecond Sunday in May (Muttertag) |
May Sun+2\fB\et\fRsecond Sunday in May (Muttertag) |
04/SunLast\fB\et\fRlast Sunday in April, |
04/SunLast\fB\et\fRlast Sunday in April, |
\fB\et\fRsummer time in Europe |
\fB\et\fRsummer time in Europe |
Easter\fB\et\fREaster |
Easter\fB\et\fREaster |
Ostern-2\fB\et\fRGood Friday (2 days before Easter) |
Ostern-2\fB\et\fRGood Friday (2 days before Easter) |
Paskha\fB\et\fROrthodox Easter |
Paskha\fB\et\fROrthodox Easter |
.Ed |
.Ed |
.Sh FILES |
.Sh FILES |
.Bl -tag -width ~/.calendar/calendar -compact |
.Bl -tag -width ~/.calendar/calendar -compact |
.It Pa calendar |
.It Pa calendar |
file in current directory |
File in current directory. |
.It Pa ~/.calendar |
.It Pa ~/.calendar |
file in home directory (which |
Directory in the user's home directory (which |
.Nm |
.Nm |
.Xr chdir 1 's |
changes into, if it exists). |
into if it exists) |
|
.It Pa ~/.calendar/calendar |
.It Pa ~/.calendar/calendar |
file to use if no calendar file exists in the current directory |
File to use if no calendar file exists in the current directory. |
.It Pa ~/.calendar/nomail |
.It Pa ~/.calendar/nomail |
.Nm |
.Nm |
will not send mail if this file exists |
will not send mail if this file exists. |
|
.It Pa calendar.all |
|
International and national calendar files. |
.It Pa calendar.birthday |
.It Pa calendar.birthday |
births and deaths of famous (and not-so-famous) people |
Births and deaths of famous (and not-so-famous) people. |
.It Pa calendar.christian |
.It Pa calendar.christian |
Christian holidays (should be updated yearly by the local system administrator |
Christian holidays (should be updated yearly by the local system administrator |
so that roving holidays are set correctly for the current year) |
so that roving holidays are set correctly for the current year). |
.It Pa calendar.computer |
.It Pa calendar.computer |
days of special significance to computer people |
Days of special significance to computer people. |
|
.It Pa calendar.croatian |
|
Croatian calendar. |
|
.It Pa calendar.discord |
|
Discordian calendar (all rites reversed). |
|
.It Pa calendar.fictional |
|
Fantasy and fiction dates (mostly LOTR). |
|
.It Pa calendar.french |
|
French calendar. |
|
.It Pa calendar.german |
|
German calendar. |
.It Pa calendar.history |
.It Pa calendar.history |
everything else, mostly U.S. historical events |
Everything else, mostly U.S. historical events. |
.It Pa calendar.holiday |
.It Pa calendar.holiday |
other holidays (including the not-well-known, obscure, and |
Other holidays (including the not-well-known, obscure, and |
.Em really |
.Em really |
obscure) |
obscure). |
.It Pa calendar.judaic |
.It Pa calendar.judaic |
Jewish holidays (should be updated yearly by the local system administrator |
Jewish holidays (should be updated yearly by the local system administrator |
so that roving holidays are set correctly for the current year) |
so that roving holidays are set correctly for the current year). |
.It Pa calendar.music |
.It Pa calendar.music |
musical events, births, and deaths (strongly oriented toward rock n' roll) |
Musical events, births, and deaths (strongly oriented toward rock n' roll). |
.It Pa calendar.usholiday |
.It Pa calendar.openbsd |
U.S. holidays |
.Ox |
.It Pa calendar.german |
related events. |
German calendar |
.It Pa calendar.pagan |
|
Pagan holidays, celebrations and festivals. |
.It Pa calendar.russian |
.It Pa calendar.russian |
Russian calendar |
Russian calendar. |
|
.It Pa calendar.usholiday |
|
U.S. holidays. |
|
.It Pa calendar.world |
|
World wide calendar. |
.El |
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr at 1 , |
.Xr at 1 , |
|
|
.Xr cpp 1 , |
.Xr cpp 1 , |
.Xr mail 1 , |
.Xr mail 1 , |
.Xr cron 8 |
.Xr cron 8 |
.Sh COMPATIBILITY |
.Sh STANDARDS |
The |
The |
.Nm |
.Nm |
program previously selected lines which had the correct date anywhere |
program previously selected lines which had the correct date anywhere |
|
|
.At v7 . |
.At v7 . |
.Sh BUGS |
.Sh BUGS |
.Nm |
.Nm |
doesn't handle Jewish holidays or moon phases. |
doesn't handle all Jewish holidays or moon phases. |