mirror of git://git.suckless.org/sbase
68 lines
1.3 KiB
Groff
68 lines
1.3 KiB
Groff
.Dd January 18, 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 Ar month Oc Ar year Oc
|
|
.Sh DESCRIPTION
|
|
Print
|
|
.Ar nmonths
|
|
calendars side by side beginning with
|
|
.Ar month
|
|
and
|
|
.Ar year .
|
|
Each row of calendars contains at most
|
|
.Ar columns
|
|
calendars. The date formatting is obtained using
|
|
.Xr localtime 3 .
|
|
.Pp
|
|
If
|
|
.Ar year
|
|
is given without
|
|
.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
|
|
Output current month. This is the default.
|
|
.It Fl 3
|
|
Output previous, current and next month.
|
|
.It Fl n Ar nmonths
|
|
Output in total
|
|
.Ar nmonths
|
|
starting from the current month.
|
|
.It Fl y Ar year
|
|
Output an entire
|
|
.Ar year .
|
|
.It Fl s
|
|
Output Sunday as first day of week.
|
|
.It Fl m
|
|
Output Monday as first day of week.
|
|
.It Fl f Ar firstday
|
|
Output
|
|
.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
|
|
are an extension to that specification.
|