1.\" $NetBSD: cal.1,v 1.18 2003/08/07 11:13:13 agc 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 July 23, 2003 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 hjry3 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 A Ar after 57Display 58.Ar after 59months after the specified month. 60.It Fl B Ar before 61Display 62.Ar before 63months before the specified month. 64.It Fl d Ar day-of-week 65Specifies the day of the week on which the calendar should start. 66Valid values are 0 through 6, presenting Sunday through Saturday, 67inclusively. 68The default output starts on Sundays. 69.It Fl h 70Highlight the current day, if present in the displayed calendar. 71If output is to a terminal, then the appropriate terminal sequences 72are used, otherwise overstriking is used. 73If more than one 74.Fl h 75is used and output is to a terminal, the current date will be 76highlighted in inverse video instead of bold. 77.It Fl j 78Display Julian dates (days one-based, numbered from January 1). 79.It Fl R Ar reform-spec 80Selects an alternate Gregorian reform point from the default of 81September 3rd, 1752. 82The 83.Ar reform-spec 84can be selected by one of the built-in names (see 85.Sx NOTES 86for a list) or by a date of the form YYYY/MM/DD. 87The date and month may be omitted, provided that what is specified 88uniquely selects a given built-in reform point. 89If an exact date is specified, then that date is taken to be the first 90missing date of the Gregorian Reform to be applied. 91.It Fl r 92Display the month in which the Gregorian Reform adjustment was 93applied, if no other 94.Ar month 95or 96.Ar year 97information is given. 98If used in conjunction with 99.Fl y , 100then the entire year is displayed. 101.It Fl y 102Display a calendar for the current year. 103.It Fl 3 104Same as 105.Dq Fl A Ar 1 Fl B Ar 1 . 106.El 107.Pp 108A single parameter specifies the year (1 - 9999) to be displayed; 109note the year must be fully specified: 110.Dq Li cal 89 111will 112.Em not 113display a calendar for 1989. 114Two parameters denote the month (1 - 12) and year. 115If no parameters are specified, the current month's calendar is 116displayed. 117.Pp 118A year starts on Jan 1. 119.Sh NOTES 120In the USA and Great Britain the Gregorian Reformation occurred in 1752. 121By this time, most countries had recognized the reformation (although a 122few did not recognize it until the 1900's.) 123Eleven days following September 2, 1752 were eliminated by the reformation, 124so the calendar for that month is a bit unusual. 125.Pp 126In view of the chaotic way the Gregorian calendar was adopted throughout 127the world in the years between 1582 and 1928 make sure to take into account 128the date of the Gregorian Reformation in your region if you are checking a 129calendar for a very old date. 130.Pp 131.Nm 132has a decent built-in list of Gregorian Reform dates and the names of 133the countries where the reform was adopted: 134.Pp 135.Bd -literal 136 Italy Oct. 5, 1582 Denmark Feb. 19, 1700 137 Spain Oct. 5, 1582 Great Britain Sep. 3, 1752 138 Portugal Oct. 5, 1582 Sweden Feb. 18, 1753 139 Poland Oct. 5, 1582 Finland Feb. 18, 1753 140 France Dec. 12, 1582 Japan Dec. 20, 1872 141 Luxembourg Dec. 22, 1582 China Nov. 7, 1911 142 Netherlands Dec. 22, 1582 Bulgaria Apr. 1, 1916 143 Bavaria Oct. 6, 1583 U.S.S.R. Feb. 1, 1918 144 Austria Jan. 7, 1584 Serbia Jan. 19, 1919 145 Switzerland Jan. 12, 1584 Romania Jan. 19, 1919 146 Hungary Oct. 22, 1587 Greece Mar. 10, 1924 147 Germany Feb. 19, 1700 Turkey Dec. 19, 1925 148 Norway Feb. 19, 1700 Egypt Sep. 18, 1928 149.Ed 150.Pp 151The country known as 152.Em Great Britain 153can also be referred to as 154.Em England 155since that has less letters and no spaces in it. 156This is meant only as a measure of expediency, not as a possible 157slight to anyone involved. 158.Sh HISTORY 159A 160.Nm 161command appeared in 162.At v6 . 163