version 1.11, 1999/07/04 11:53:51 |
version 1.40, 2015/12/07 18:46:35 |
|
|
.\" 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. |
.\" |
.\" |
|
|
.\" |
.\" |
.\" @(#)calendar.1 8.1 (Berkeley) 6/29/93 |
.\" @(#)calendar.1 8.1 (Berkeley) 6/29/93 |
.\" |
.\" |
.Dd June 29, 1993 |
.Dd $Mdocdate$ |
.Dt CALENDAR 1 |
.Dt CALENDAR 1 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
|
|
.Nd reminder service |
.Nd reminder service |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm calendar |
.Nm calendar |
.Op Fl a |
.Op Fl abw |
.Op Fl A Ar num |
.Op Fl A Ar num |
.Op Fl B Ar num |
.Op Fl B Ar num |
.Op Fl t Ar [[[cc]yy][mm]]dd |
|
.Op Fl f Ar calendarfile |
.Op Fl f Ar calendarfile |
|
.Op Fl t Oo Oo Oo Ar cc Oc Ns Ar yy Oc Ns Ar mm Oc Ns Ar dd |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
|
|
or tomorrow's. |
or tomorrow's. |
On Fridays, events on Friday through Monday are displayed. |
On Fridays, events on Friday through Monday are displayed. |
.Pp |
.Pp |
The following options are available: |
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 super-user privileges. |
This requires superuser privileges. |
.It Fl A Ar num |
|
Print lines from today and next |
|
.Ar num |
|
days (forward, future). |
|
.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 f Pa calendarfile |
.It Fl b |
|
Enforce special date calculation mode for Cyrillic calendars. |
|
.It Fl f Ar calendarfile |
Use |
Use |
.Pa calendarfile |
.Ar calendarfile |
as the default calendar file. |
as the default calendar file. |
.It Fl t Ar [[[cc]yy][mm]]dd |
.It Fl t Oo Oo Oo Ar cc Oc Ns Ar yy Oc Ns Ar mm Oc Ns Ar dd |
Act like the specified value is |
Act like the specified value is |
.Dq today |
.Dq today |
instead of using the current date. |
instead of using the current date. |
|
If yy is specified, but cc is not, |
|
a value for yy between 69 and 99 results in a cc value of 19. |
|
Otherwise, a cc value of 20 is used. |
|
.It Fl w |
|
Print day of the week name in front of each event. |
.El |
.El |
.Pp |
.Pp |
To handle calendars in your national code table you can specify |
To handle calendars in your national code table you can specify |
.Dq LANG=<locale_name> |
.Dq LANG=<locale_name> |
in the calendar file as early as possible. To handle national Easter |
in the calendar file as early as possible. |
names in the calendars, |
To handle national Easter names in the calendars, |
.Dq Easter=<national_name> |
.Dq Easter=<national_name> |
(for Catholic Easter) or |
(for Catholic Easter) or |
.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 |
|
you should specify |
|
.Dq LANG=<local_name> |
|
and |
|
.Dq BODUN=<bodun_prefix> |
|
where <local_name> can be ru_RU.UTF-8, uk_UA.UTF-8 or by_BY.UTF-8. |
|
.Pp |
Other lines should begin with a month and day. |
Other lines should begin with a month and day. |
They may be entered in almost any format, either numeric or as character |
They may be entered in almost any format, either numeric or as character |
strings. |
strings. |
|
|
.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.canada |
|
Canadian holidays. |
.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 |
Miscellaneous history. |
.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.space |
|
Cosmic history. |
|
.It Pa calendar.ushistory |
|
U.S. history. |
|
.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 cal 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 |
in the line. |
in the line. |
This is no longer true: the date is only recognized when it occurs |
This is no longer true: the date is only recognized when it occurs |
at the beginning of a line. |
at the beginning of a line. |
.Sh HISTORY |
.Sh HISTORY |
A |
A |
|
|
.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. |