118 lines
3.4 KiB
Groff
118 lines
3.4 KiB
Groff
|
/*-
|
||
|
|
* Copyright (c) 1997 Wolfgang Helbig
|
||
|
|
* All rights reserved.
|
||
|
|
*
|
||
|
|
* Redistribution and use in source and binary forms, with or without
|
||
|
|
* modification, are permitted provided that the following conditions
|
||
|
|
* are met:
|
||
|
|
* 1. Redistributions of source code must retain the above copyright
|
||
|
|
* notice, this list of conditions and the following disclaimer.
|
||
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||
|
|
* notice, this list of conditions and the following disclaimer in the
|
||
|
|
* documentation and/or other materials provided with the distribution.
|
||
|
|
*
|
||
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||
|
|
* SUCH DAMAGE.
|
||
|
|
*
|
||
|
|
* $Id$
|
||
|
|
*/
|
||
|
|
.Dd December 16, 1997
|
||
|
|
.Dt CAL 1
|
||
|
|
.Os
|
||
|
|
.Sh NAME
|
||
|
|
.Nm cal ,
|
||
|
|
.Nm ncal
|
||
|
|
.Nd displays a calendar and the date of easter
|
||
|
|
.Sh SYNOPSIS
|
||
|
|
.Nm cal
|
||
|
|
.Op Fl jy
|
||
|
|
.Op Oo Ar month Oc Ar \ year
|
||
|
|
.Nm ncal
|
||
|
|
.Op Fl jJpwy
|
||
|
|
.Op Fl s Ar country code
|
||
|
|
.Op Oo Ar month Oc Ar \ year
|
||
|
|
.Nm ncal
|
||
|
|
.Op Fl Jeo
|
||
|
|
.Op Ar year
|
||
|
|
.Sh DESCRIPTION
|
||
|
|
.Nm Cal
|
||
|
|
displays a simple calendar in traditional format and
|
||
|
|
.Nm ncal
|
||
|
|
offers an alternative layout, more options and the date of easter.
|
||
|
|
The new format is a little cramped but it makes a year fit
|
||
|
|
on a 25x80 terminal.
|
||
|
|
If arguments are not specified,
|
||
|
|
the current month is displayed.
|
||
|
|
The options are as follows:
|
||
|
|
.Bl -tag -width Ds
|
||
|
|
.It Fl J
|
||
|
|
Display Julian Calendar, if combined with the
|
||
|
|
.Fl e
|
||
|
|
option, display date of easter according in the Julian Calendar.
|
||
|
|
If not specified, the Gregorian Calendar is assumed after
|
||
|
|
the switch date and Julian before. (See below)
|
||
|
|
.It Fl e
|
||
|
|
Display date of easter (for western churches).
|
||
|
|
.It Fl j
|
||
|
|
Display julian days (days one-based, numbered from January 1).
|
||
|
|
.It Fl o
|
||
|
|
Display date of orthodox easter (Greek and Russian
|
||
|
|
Orthodox Churches).
|
||
|
|
.It Fl p
|
||
|
|
Print the country codes and switch dates from Julian to Gregorian
|
||
|
|
Calendar as they are assumed by
|
||
|
|
.Nm ncal .
|
||
|
|
.It Fl s Ar country-code
|
||
|
|
Assume the switch from Julian to Gregorian Calendar at the date
|
||
|
|
associated with the
|
||
|
|
.Ar country-code .
|
||
|
|
If not specified,
|
||
|
|
.Nm ncal
|
||
|
|
assumes October 4, 1582 (on this day the Catholic Church switched to Gregorian
|
||
|
|
Calendar) and
|
||
|
|
.Nm cal
|
||
|
|
thinks with Great Britain and her colonies that
|
||
|
|
September 2, 1752 was the date to switch.
|
||
|
|
.It Fl w
|
||
|
|
Print the number of the week in the year below each week displayed.
|
||
|
|
.It Fl y
|
||
|
|
Display a calendar for the current year.
|
||
|
|
.El
|
||
|
|
.Pp
|
||
|
|
A single parameter specifies the year (1 - 9999) to be displayed;
|
||
|
|
note the year must be fully specified:
|
||
|
|
.Dq Li cal 89
|
||
|
|
will
|
||
|
|
.Em not
|
||
|
|
display a calendar for 1989.
|
||
|
|
Two parameters denote the month (1 - 12) and year.
|
||
|
|
.Pp
|
||
|
|
A year starts on Jan 1.
|
||
|
|
.Pp
|
||
|
|
.Sh SEE ALSO
|
||
|
|
.Xr calendar 3 ,
|
||
|
|
.Xr strftime 3
|
||
|
|
.Rs
|
||
|
|
.Sh HISTORY
|
||
|
|
A
|
||
|
|
.Nm cal
|
||
|
|
command appeared in
|
||
|
|
.At v6 .
|
||
|
|
The
|
||
|
|
.Nm ncal
|
||
|
|
command appeared in
|
||
|
|
.Fx 3.0 .
|
||
|
|
.Sh AUTHOR
|
||
|
|
This
|
||
|
|
manual page and the command was written by
|
||
|
|
.An Wolfgang Helbig Aq helbig@FreeBSD.ORG .
|