ncal.1 revision 31745 
1/*-
2 * Copyright (c) 1997 Wolfgang Helbig
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 *	$Id$
27 */
28.Dd December 16, 1997
29.Dt CAL 1
30.Os
31.Sh NAME
32.Nm cal ,
33.Nm ncal
34.Nd displays a calendar and the date of easter
35.Sh SYNOPSIS
36.Nm cal
37.Op Fl jy
38.Op Oo Ar month Oc Ar \ year
39.Nm ncal
40.Op Fl jJpwy
41.Op Fl s Ar country code
42.Op Oo Ar month Oc Ar \ year
43.Nm ncal
44.Op Fl Jeo
45.Op Ar year
46.Sh DESCRIPTION
47.Nm Cal
48displays a simple calendar in traditional format and
49.Nm ncal
50offers an alternative layout, more options and the date of easter.
51The new format is a little cramped but it makes a year fit
52on a 25x80 terminal.
53If arguments are not specified,
54the current month is displayed.
55The options are as follows:
56.Bl -tag -width Ds
57.It Fl J
58Display Julian Calendar, if combined with the
59.Fl e
60option, display date of easter according in the Julian Calendar.
61If not specified, the Gregorian Calendar is assumed after
62the switch date and Julian before. (See below)
63.It Fl e
64Display date of easter (for western churches).
65.It Fl j
66Display julian days (days one-based, numbered from January 1).
67.It Fl o
68Display date of orthodox easter (Greek and Russian
69Orthodox Churches).
70.It Fl p
71Print the country codes and switch dates from Julian to Gregorian
72Calendar as they are assumed by
73.Nm ncal .
74.It Fl s Ar country-code
75Assume the switch from Julian to Gregorian Calendar at the date
76associated with the
77.Ar country-code .
78If not specified,
79.Nm ncal
80assumes October 4, 1582 (on this day the Catholic Church switched to Gregorian
81Calendar) and
82.Nm cal
83thinks with Great Britain and her colonies that
84September 2, 1752 was the date to switch.
85.It Fl w
86Print the number of the week in the year below each week displayed.
87.It Fl y
88Display a calendar for the current year.
89.El
90.Pp
91A single parameter specifies the year (1 - 9999) to be displayed;
92note the year must be fully specified:
93.Dq Li cal 89
94will
95.Em not
96display a calendar for 1989.
97Two parameters denote the month (1 - 12) and year.
98.Pp
99A year starts on Jan 1.
100.Pp
101.Sh SEE ALSO
102.Xr calendar 3 ,
103.Xr strftime 3
104.Rs
105.Sh HISTORY
106A
107.Nm cal
108command appeared in
109.At v6 .
110The
111.Nm ncal
112command appeared in
113.Fx 3.0 .
114.Sh AUTHOR
115This
116manual page and the command was written by
117.An Wolfgang Helbig Aq helbig@FreeBSD.ORG .
118