1.\" $NetBSD: cal.1,v 1.20 2007/12/24 13:56:00 wiz Exp $ 2.\" 3.\" Copyright (c) 1989, 1990, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" This code is derived from software contributed to Berkeley by 7.\" Kim Letkeman. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 3. Neither the name of the University nor the names of its contributors 18.\" may be used to endorse or promote products derived from this software 19.\" without specific prior written permission. 20.\" 21.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 25.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" SUCH DAMAGE. 32.\" 33.\" @(#)cal.1 8.2 (Berkeley) 4/28/95 34.\" 35.Dd December 21, 2007 36.Dt CAL 1 37.Os 38.Sh NAME 39.Nm cal 40.Nd displays a calendar 41.Sh SYNOPSIS 42.Nm 43.Op Fl 3hjry 44.Op Fl A Ar after 45.Op Fl B Ar before 46.Op Fl d Ar day-of-week 47.Op Fl R Ar reform-spec 48.Op Oo Ar month Oc Ar year 49.Sh DESCRIPTION 50.Nm 51displays a simple calendar. 52If arguments are not specified, 53the current month is displayed. 54The options are as follows: 55.Bl -tag -width Ds 56.It Fl 3 57Same as 58.Dq Fl A Ar 1 Fl B Ar 1 . 59.It Fl A Ar after 60Display 61.Ar after 62months after the specified month. 63.It Fl B Ar before 64Display 65.Ar before 66months before the specified month. 67.It Fl d Ar day-of-week 68Specifies the day of the week on which the calendar should start. 69Valid values are 0 through 6, presenting Sunday through Saturday, 70inclusively. 71The default output starts on Sundays. 72.It Fl h 73Highlight the current day, if present in the displayed calendar. 74If output is to a terminal, then the appropriate terminal sequences 75are used, otherwise overstriking is used. 76If more than one 77.Fl h 78is used and output is to a terminal, the current date will be 79highlighted in inverse video instead of bold. 80.It Fl j 81Display Julian dates (days one-based, numbered from January 1). 82.It Fl R Ar reform-spec 83Selects an alternate Gregorian reform point from the default of 84September 3rd, 1752. 85The 86.Ar reform-spec 87can be selected by one of the built-in names (see 88.Sx NOTES 89for a list) or by a date of the form YYYY/MM/DD. 90The date and month may be omitted, provided that what is specified 91uniquely selects a given built-in reform point. 92If an exact date is specified, then that date is taken to be the first 93missing date of the Gregorian Reform to be applied. 94.It Fl r 95Display the month in which the Gregorian Reform adjustment was 96applied, if no other 97.Ar month 98or 99.Ar year 100information is given. 101If used in conjunction with 102.Fl y , 103then the entire year is displayed. 104.It Fl y 105Display a calendar for the current year. 106.El 107.Pp 108If no parameters are specified, the current month's calendar is 109displayed. 110A single parameter specifies the year and optionally the month 111in ISO format: 112.Dq Li cal 2007-12 113Two parameters denote the month (1 - 12) and year. 114Note that the century must be included in the year. 115.Pp 116A year starts on Jan 1. 117.Sh NOTES 118In the USA and Great Britain the Gregorian Reformation occurred in 1752. 119By this time, most countries had recognized the reformation (although a 120few did not recognize it until the 1900's.) 121Eleven days following September 2, 1752 were eliminated by the reformation, 122so the calendar for that month is a bit unusual. 123.Pp 124In view of the chaotic way the Gregorian calendar was adopted throughout 125the world in the years between 1582 and 1928 make sure to take into account 126the date of the Gregorian Reformation in your region if you are checking a 127calendar for a very old date. 128.Pp 129.Nm 130has a decent built-in list of Gregorian Reform dates and the names of 131the countries where the reform was adopted: 132.Pp 133.Bd -literal 134 Italy Oct. 5, 1582 Denmark Feb. 19, 1700 135 Spain Oct. 5, 1582 Great Britain Sep. 3, 1752 136 Portugal Oct. 5, 1582 Sweden Feb. 18, 1753 137 Poland Oct. 5, 1582 Finland Feb. 18, 1753 138 France Dec. 12, 1582 Japan Dec. 20, 1872 139 Luxembourg Dec. 22, 1582 China Nov. 7, 1911 140 Netherlands Dec. 22, 1582 Bulgaria Apr. 1, 1916 141 Bavaria Oct. 6, 1583 U.S.S.R. Feb. 1, 1918 142 Austria Jan. 7, 1584 Serbia Jan. 19, 1919 143 Switzerland Jan. 12, 1584 Romania Jan. 19, 1919 144 Hungary Oct. 22, 1587 Greece Mar. 10, 1924 145 Germany Feb. 19, 1700 Turkey Dec. 19, 1925 146 Norway Feb. 19, 1700 Egypt Sep. 18, 1928 147.Ed 148.Pp 149The country known as 150.Em Great Britain 151can also be referred to as 152.Em England 153since that has less letters and no spaces in it. 154This is meant only as a measure of expediency, not as a possible 155slight to anyone involved. 156.Sh HISTORY 157A 158.Nm 159command appeared in 160.At v6 . 161