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