usr.bin/cal/cal.1

   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
  52 displays a simple calendar.
  53 If arguments are not specified,
  54 the current month is displayed.
  55 The options are as follows:
  56 .Bl -tag -width Ds
  57 .It Fl 3
  58 Same as
  59 .Dq Fl A Ar 1 Fl B Ar 1 .
  60 .It Fl A Ar after
  61 Display
  62 .Ar after
  63 months after the specified month.
  64 .It Fl B Ar before
  65 Display
  66 .Ar before
  67 months before the specified month.
  68 .It Fl C Ar context
  69 Display
  70 .Ar context
  71 months before and after the specified month.
  72 .It Fl d Ar day-of-week
  73 Specifies the day of the week on which the calendar should start.
  74 Valid values are 0 through 6, presenting Sunday through Saturday,
  75 inclusively.
  76 The default output starts on Sundays.
  77 .It Fl h
  78 Highlight the current day, if present in the displayed calendar.
  79 If output is to a terminal, then the appropriate terminal sequences
  80 are used, otherwise overstriking is used.
  81 If more than one
  82 .Fl h
  83 is used and output is to a terminal, the current date will be
  84 highlighted in inverse video instead of bold.
  85 .It Fl j
  86 Display Julian dates (days one-based, numbered from January 1).
  87 .It Fl R Ar reform-spec
  88 Selects an alternate Gregorian reform point from the default of
  89 September 3rd, 1752.
  90 The
  91 .Ar reform-spec
  92 can be selected by one of the built-in names (see
  93 .Sx NOTES
  94 for a list) or by a date of the form YYYY/MM/DD.
  95 The date and month may be omitted, provided that what is specified
  96 uniquely selects a given built-in reform point.
  97 If an exact date is specified, then that date is taken to be the first
  98 missing date of the Gregorian Reform to be applied.
  99 .It Fl r
 100 Display the month in which the Gregorian Reform adjustment was
 101 applied, if no other
 102 .Ar month
 103 or
 104 .Ar year
 105 information is given.
 106 If used in conjunction with
 107 .Fl y ,
 108 then the entire year is displayed.
 109 .It Fl y
 110 Display a calendar for the current year.
 111 .El
 112 .Pp
 113 If no parameters are specified, the current month's calendar is
 114 displayed.
 115 A single parameter specifies the year and optionally the month
 116 in ISO format:
 117 .Dq Li cal 2007-12
 118 Two parameters denote the month (1 - 12) and year.
 119 Note that the century must be included in the year.
 120 .Pp
 121 A year starts on Jan 1.
 122 .Sh NOTES
 123 In the USA and Great Britain the Gregorian Reformation occurred in 1752.
 124 By this time, most countries had recognized the reformation (although a
 125 few did not recognize it until the 1900's.)
 126 Eleven days following September 2, 1752 were eliminated by the reformation,
 127 so the calendar for that month is a bit unusual.
 128 .Pp
 129 In view of the chaotic way the Gregorian calendar was adopted throughout
 130 the world in the years between 1582 and 1928 make sure to take into account
 131 the date of the Gregorian Reformation in your region if you are checking a
 132 calendar for a very old date.
 133 .Pp
 134 .Nm
 135 has a decent built-in list of Gregorian Reform dates and the names of
 136 the 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
 154 The country known as
 155 .Em Great Britain
 156 can also be referred to as
 157 .Em England
 158 since that has less letters and no spaces in it.
 159 This is meant only as a measure of expediency, not as a possible
 160 slight to anyone involved.
 161 .Sh HISTORY
 162 A
 163 .Nm
 164 command appeared in
 165 .At v6 .