643 lines
10 KiB
HTML
643 lines
10 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of CALENDAR</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>CALENDAR</H1>
|
|
Section: User Commands (1)<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
<BR>BSD mandoc<BR>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
|
|
|
|
<B>calendar</B>
|
|
|
|
- reminder service
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>calendar</B>
|
|
|
|
[-<B>abw</B>
|
|
|
|
]
|
|
|
|
[-<B>A </B><I>num</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>B </B><I>num</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>l </B><I>num</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>e </B><I>num</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>f </B><I>calendarfile</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>t </B>[[[<I>cc </I><B></B><I>yy </I><B></B><I>mm </I><B></B><I>dd</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
]
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>calendar</B>
|
|
|
|
|
|
utility checks the current directory or the directory specified by the
|
|
<B>CALENDAR_DIR</B>
|
|
|
|
environment variable for a file named
|
|
calendar
|
|
|
|
and displays lines that begin with either today's date
|
|
or tomorrow's.
|
|
On Fridays, events on Friday through Monday are displayed.
|
|
<P>
|
|
|
|
The options are as follows:
|
|
<DL COMPACT>
|
|
<P>
|
|
|
|
<DT id="1"><B>-A </B><I>num</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Print lines from today and next
|
|
<I>num</I>
|
|
|
|
days (forward, future).
|
|
Defaults to one. (same as -l)
|
|
<DT id="2"><B>-a</B>
|
|
|
|
|
|
<DD>
|
|
Process the
|
|
``calendar''
|
|
|
|
files of all users and mail the results
|
|
to them.
|
|
This requires superuser privileges.
|
|
<DT id="3"><B>-B </B><I>num</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Print lines from today and previous
|
|
<I>num</I>
|
|
|
|
days (backward, past).
|
|
<DT id="4"><B>-b</B>
|
|
|
|
|
|
<DD>
|
|
Enforce special date calculation mode for Cyrillic calendars.
|
|
<DT id="5"><B>-l </B><I>num</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Print lines from today and next
|
|
<I>num</I>
|
|
|
|
days (forward, future). Defaults to one. (same as -A)
|
|
<DT id="6"><B>-e </B><I>num</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Print lines from today and next
|
|
<I>num</I>
|
|
|
|
days, only if today is Friday (forward, future). Defaults to two, which causes
|
|
<B>calendar</B>
|
|
|
|
|
|
to print entries through the weekend on Fridays.
|
|
<DT id="7"><B>-f </B><I>calendarfile</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Use
|
|
<I>calendarfile</I>
|
|
|
|
as the default calendar file. If this file is not accessible, the system-wide default is used.
|
|
<DT id="8"><B>-t </B>[[[<I>cc </I><B></B><I>yy </I><B></B><I>mm </I><B></B><I>dd</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Act like the specified value is
|
|
``today''
|
|
|
|
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.
|
|
<DT id="9"><B>-w</B>
|
|
|
|
|
|
<DD>
|
|
Print day of the week name in front of each event.
|
|
</DL>
|
|
<P>
|
|
|
|
<P>
|
|
|
|
To handle calendars in your national code table you can specify
|
|
``LANG=<locale_name>''
|
|
|
|
in the calendar file as early as possible.
|
|
To handle national Easter names in the calendars,
|
|
``Easter=<national_name>''
|
|
|
|
(for Catholic Easter) or
|
|
``Paskha=<national_name>''
|
|
|
|
(for Orthodox Easter) can be used.
|
|
<P>
|
|
|
|
A special locale name exists:
|
|
`utf-8'
|
|
|
|
|
|
Specifying
|
|
``LANG=utf-8''
|
|
|
|
indicates that the dates will be read using the C locale, and the descriptions
|
|
will be encoded in UTF-8. This is usually used for the distributed calendar
|
|
files.
|
|
The
|
|
``CALENDAR''
|
|
|
|
variable can be used to specify the style.
|
|
Only
|
|
`Julian'
|
|
|
|
and
|
|
`Gregorian'
|
|
|
|
styles are currently supported.
|
|
Use
|
|
``CALENDAR=''
|
|
|
|
to return to the default (Gregorian).
|
|
<P>
|
|
|
|
To enforce special date calculation mode for Cyrillic calendars
|
|
you should specify
|
|
``LANG=<local_name>''
|
|
|
|
and
|
|
``BODUN=<bodun_prefix>''
|
|
|
|
where <local_name> can be ru_RU.UTF-8, uk_UA.UTF-8 or by_BY.UTF-8.
|
|
<P>
|
|
|
|
Note that the locale is reset to the user's default for each new file that is
|
|
read. This is so that locales from one file do not accidentally carry over into
|
|
another file.
|
|
<P>
|
|
|
|
Other lines should begin with a month and day.
|
|
They may be entered in almost any format, either numeric or as character
|
|
strings.
|
|
If proper locale is set, national months and weekdays
|
|
names can be used.
|
|
A single asterisk (`*') matches every month.
|
|
A day without a month matches that day of every week.
|
|
A month without a day matches the first of that month.
|
|
Two numbers default to the month followed by the day.
|
|
Lines with leading tabs default to the last entered date, allowing
|
|
multiple line specifications for a single date.
|
|
``Easter''
|
|
|
|
(may be followed by a positive or negative integer) is Easter for this year.
|
|
``Paskha''
|
|
|
|
(may be followed by a positive or negative integer) is
|
|
Orthodox Easter for this year.
|
|
Weekdays may be followed by
|
|
``-4''
|
|
|
|
<B>...</B>
|
|
|
|
``+5''
|
|
|
|
(aliases last, first, second, third, fourth) for moving events like
|
|
``the last Monday in April''
|
|
|
|
|
|
<P>
|
|
|
|
By convention, dates followed by an asterisk
|
|
(`*'
|
|
|
|
)
|
|
|
|
are not fixed, i.e., change
|
|
from year to year.
|
|
<P>
|
|
|
|
Day descriptions start after the first <tab> character in the line;
|
|
if the line does not contain a <tab> character, it isn't printed out.
|
|
If the first character in the line is a <tab> character, it is treated as
|
|
the continuation of the previous description.
|
|
<P>
|
|
|
|
The calendar file is preprocessed by
|
|
<A HREF="/cgi-bin/man/man2html?1+cpp">cpp</A>(1),
|
|
|
|
|
|
allowing the inclusion of shared files such as company holidays or
|
|
meetings.
|
|
If the shared file is not referenced by a full pathname,
|
|
<A HREF="/cgi-bin/man/man2html?1+cpp">cpp</A>(1)
|
|
|
|
|
|
searches in the current (or home) directory first, and then in the
|
|
directory
|
|
/etc/calendar
|
|
|
|
|
|
and finally in
|
|
/usr/share/calendar
|
|
|
|
|
|
Empty lines and lines protected by the C commenting syntax
|
|
(<B>/* ... */</B>
|
|
|
|
)
|
|
|
|
are ignored.
|
|
<P>
|
|
|
|
Some possible calendar entries
|
|
(a <B>\t</B> sequence denotes a <tab> character):
|
|
|
|
<BLOCKQUOTE>
|
|
<PRE>
|
|
LANG=C
|
|
Easter=Ostern
|
|
|
|
#include <calendar.usholiday>
|
|
#include <calendar.birthday>
|
|
|
|
6/15<B>\t</B>June 15 (if ambiguous, will default to month/day).
|
|
Jun. 15<B>\t</B>June 15.
|
|
15 June<B>\t</B>June 15.
|
|
Thursday<B>\t</B>Every Thursday.
|
|
June<B>\t</B>Every June 1st.
|
|
15 *<B>\t</B>15th of every month.
|
|
|
|
May Sun+2<B>\t</B>second Sunday in May (Muttertag)
|
|
04/SunLast<B>\t</B>last Sunday in April,
|
|
<B>\t</B>summer time in Europe
|
|
Easter<B>\t</B>Easter
|
|
Ostern-2<B>\t</B>Good Friday (2 days before Easter)
|
|
Paskha<B>\t</B>Orthodox Easter
|
|
</PRE>
|
|
</BLOCKQUOTE>
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<P>
|
|
|
|
<DT id="10"><B>calendar
|
|
|
|
</B>
|
|
<DD>
|
|
File in current directory.
|
|
<DT id="11"><B>~/.calendar
|
|
|
|
</B>
|
|
<DD>
|
|
Directory in the user's home directory (which
|
|
<B>calendar</B>
|
|
|
|
|
|
changes into, if it exists).
|
|
<DT id="12"><B>~/.calendar/calendar
|
|
|
|
</B>
|
|
<DD>
|
|
File to use if no calendar file exists in the current directory.
|
|
<DT id="13"><B>~/.calendar/nomail
|
|
|
|
</B>
|
|
<DD>
|
|
<B>calendar</B>
|
|
|
|
|
|
will not send mail if this file exists.
|
|
<DT id="14"><B>calendar.all
|
|
|
|
</B>
|
|
<DD>
|
|
International and national calendar files.
|
|
<DT id="15"><B>calendar.birthday
|
|
|
|
</B>
|
|
<DD>
|
|
Births and deaths of famous (and not-so-famous) people.
|
|
<DT id="16"><B>calendar.canada
|
|
|
|
</B>
|
|
<DD>
|
|
Canadian holidays.
|
|
<DT id="17"><B>calendar.christian
|
|
|
|
</B>
|
|
<DD>
|
|
Christian holidays (should be updated yearly by the local system administrator
|
|
so that roving holidays are set correctly for the current year).
|
|
<DT id="18"><B>calendar.computer
|
|
|
|
</B>
|
|
<DD>
|
|
Days of special significance to computer people.
|
|
<DT id="19"><B>calendar.croatian
|
|
|
|
</B>
|
|
<DD>
|
|
Croatian calendar.
|
|
<DT id="20"><B>calendar.discord
|
|
|
|
</B>
|
|
<DD>
|
|
Discordian calendar (all rites reversed).
|
|
<DT id="21"><B>calendar.fictional
|
|
|
|
</B>
|
|
<DD>
|
|
Fantasy and fiction dates (mostly LOTR).
|
|
<DT id="22"><B>calendar.french
|
|
|
|
</B>
|
|
<DD>
|
|
French calendar.
|
|
<DT id="23"><B>calendar.german
|
|
|
|
</B>
|
|
<DD>
|
|
German calendar.
|
|
<DT id="24"><B>calendar.history
|
|
|
|
</B>
|
|
<DD>
|
|
Miscellaneous history.
|
|
<DT id="25"><B>calendar.holiday
|
|
|
|
</B>
|
|
<DD>
|
|
Other holidays (including the not-well-known, obscure, and
|
|
<I>really</I>
|
|
|
|
obscure).
|
|
<DT id="26"><B>calendar.judaic
|
|
|
|
</B>
|
|
<DD>
|
|
Jewish holidays (should be updated yearly by the local system administrator
|
|
so that roving holidays are set correctly for the current year).
|
|
<DT id="27"><B>calendar.music
|
|
|
|
</B>
|
|
<DD>
|
|
Musical events, births, and deaths (strongly oriented toward rock n' roll).
|
|
<DT id="28"><B>calendar.nz
|
|
|
|
</B>
|
|
<DD>
|
|
New Zealand calendar.
|
|
<DT id="29"><B>calendar.openbsd
|
|
|
|
</B>
|
|
<DD>
|
|
Ox related events.
|
|
|
|
<DT id="30"><B>calendar.pagan
|
|
|
|
</B>
|
|
<DD>
|
|
Pagan holidays, celebrations and festivals.
|
|
<DT id="31"><B>calendar.russian
|
|
|
|
</B>
|
|
<DD>
|
|
Russian calendar.
|
|
<DT id="32"><B>calendar.space
|
|
|
|
</B>
|
|
<DD>
|
|
Cosmic history.
|
|
<DT id="33"><B>calendar.uk
|
|
|
|
</B>
|
|
<DD>
|
|
UK calendar.
|
|
<DT id="34"><B>calendar.ushistory
|
|
|
|
</B>
|
|
<DD>
|
|
U.S. history.
|
|
<DT id="35"><B>calendar.usholiday
|
|
|
|
</B>
|
|
<DD>
|
|
U.S. holidays.
|
|
<DT id="36"><B>calendar.world
|
|
|
|
</B>
|
|
<DD>
|
|
World wide calendar.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+at">at</A>(1),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+cal">cal</A>(1),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+cpp">cpp</A>(1),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+mail">mail</A>(1),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?8+cron">cron</A>(8)
|
|
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>STANDARDS</H2>
|
|
|
|
The
|
|
<B>calendar</B>
|
|
|
|
|
|
program previously selected lines which had the correct date anywhere
|
|
in the line.
|
|
This is no longer true: the date is only recognized when it occurs
|
|
at the beginning of a line.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>COMPATIBILITY</H2>
|
|
|
|
The
|
|
<B>calendar</B>
|
|
|
|
|
|
command will only display lines that use a <tab> character to separate the date
|
|
and description, or that begin with a <tab>. This is different than in previous
|
|
releases.
|
|
<P>
|
|
|
|
The
|
|
Fl t
|
|
flag argument syntax is from the original FreeBSD
|
|
<B>calendar</B>
|
|
|
|
|
|
program.
|
|
<P>
|
|
|
|
The
|
|
-<B>l</B>
|
|
|
|
and
|
|
-<B>e</B>
|
|
|
|
flags are Debian-specific enhancements. Option
|
|
-<B>e</B>
|
|
|
|
used to be called
|
|
|
|
in Debian, but this option is now used differently by upstream. Also, the original
|
|
<B>calendar</B>
|
|
|
|
|
|
program did not accept
|
|
<B>0</B>
|
|
|
|
as an argument to the
|
|
-<B>A</B>
|
|
|
|
flag.
|
|
<P>
|
|
|
|
Using
|
|
`utf-8'
|
|
|
|
as a locale name is a Debian-specific enhancement.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>HISTORY</H2>
|
|
|
|
A
|
|
<B>calendar</B>
|
|
|
|
|
|
command appeared in
|
|
AT&T System
|
|
v7 .
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
<B>calendar</B>
|
|
|
|
|
|
doesn't handle all Jewish holidays or moon phases.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="37"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="38"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="39"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="40"><A HREF="#lbAE">FILES</A><DD>
|
|
<DT id="41"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="42"><A HREF="#lbAG">STANDARDS</A><DD>
|
|
<DT id="43"><A HREF="#lbAH">COMPATIBILITY</A><DD>
|
|
<DT id="44"><A HREF="#lbAI">HISTORY</A><DD>
|
|
<DT id="45"><A HREF="#lbAJ">BUGS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:08 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|