2015-01-16 15:50:34 -05:00
|
|
|
.Dd January 16, 2015
|
|
|
|
|
.Dt CAL 1 sbase\-VERSION
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm cal
|
|
|
|
|
.Nd show calendar
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm cal
|
|
|
|
|
.Op Fl 1 | Fl 3 | Fl y | Fl n Ar nmonths
|
|
|
|
|
.Op Fl s | Fl m | Fl f Ar firstday
|
|
|
|
|
.Op Fl c Ar columns
|
|
|
|
|
.Oo Oo Oo Ar day Oc Ar month Oc Ar year Oc
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
Print
|
|
|
|
|
.Ar nmonths
|
|
|
|
|
calendars side by side beginning with
|
|
|
|
|
.Ar month
|
2013-06-19 14:13:50 -04:00
|
|
|
and
|
2015-01-16 15:50:34 -05:00
|
|
|
.Ar year .
|
|
|
|
|
Each row of calendars contains at most
|
|
|
|
|
.Ar columns
|
|
|
|
|
calendars. The date formatting is obtained using
|
|
|
|
|
.Xr localtime 3 .
|
|
|
|
|
.Pp
|
2015-01-08 14:21:37 -05:00
|
|
|
If
|
2015-01-16 15:50:34 -05:00
|
|
|
.Ar year
|
2015-01-08 14:21:37 -05:00
|
|
|
is given without
|
2015-01-16 15:50:34 -05:00
|
|
|
.Ar month ,
|
|
|
|
|
print the whole year, unless overridden by other options.
|
|
|
|
|
.Pp
|
|
|
|
|
The Julian calendar is used until Sep 2, 1752. The Gregorian calendar is used
|
|
|
|
|
starting the next day on Sep 14, 1752.
|
|
|
|
|
.Sh OPTIONS
|
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
|
.It Fl 1 | Fl 3 | Fl n Ar nmonths | Fl y
|
|
|
|
|
Show current month | previous, current and next month |
|
|
|
|
|
.Ar nmonths
|
|
|
|
|
months | year.
|
|
|
|
|
.It Fl s | Fl m | Fl f Ar firstday
|
|
|
|
|
Set Sunday | Monday |
|
|
|
|
|
.Ar firstday
|
|
|
|
|
(0 is Sunday, 6 is Saturday) as first day of week.
|
|
|
|
|
.It Fl c Ar columns
|
|
|
|
|
Set number of calendars in a row. The default is 3.
|
|
|
|
|
.El
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr localtime 3
|
|
|
|
|
.Sh STANDARDS
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility is compliant with the
|
|
|
|
|
.St -p1003.1-2008
|
|
|
|
|
specification.
|
|
|
|
|
.Pp
|
|
|
|
|
The flags
|
|
|
|
|
.Op Fl 13ynsmfc
|
|
|
|
|
and
|
|
|
|
|
.Op Ar day
|
|
|
|
|
are an extension to that specification.
|
