mirror of
git://git.suckless.org/sbase
synced 2024-12-23 15:34:38 +00:00
e51a2e6d2f
The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org.
71 lines
1.2 KiB
Groff
71 lines
1.2 KiB
Groff
.Dd 2015-10-08
|
|
.Dt CAL 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm cal
|
|
.Nd show calendar
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl 1 | Fl 3 | Fl y | Fl n Ar num
|
|
.Op Fl s | Fl m | Fl f Ar num
|
|
.Op Fl c Ar num
|
|
.Oo Oo Ar month Oc Ar year Oc
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
writes a calendar of
|
|
.Ar month
|
|
and
|
|
.Ar year
|
|
or the current month to stdout.
|
|
If
|
|
.Ar year
|
|
is given without
|
|
.Ar month ,
|
|
.Nm
|
|
writes a 3-column calendar of the whole
|
|
year to stdout.
|
|
The date formatting is according to
|
|
.Xr localtime 3 .
|
|
.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
|
|
Print current month. This is the default.
|
|
.It Fl 3
|
|
Print previous, current and next month.
|
|
.It Fl c Ar num
|
|
Print
|
|
.Ar num
|
|
calendars in a row. The default is 3.
|
|
.It Fl f Ar num
|
|
Set
|
|
.Ar num
|
|
(0 is Sunday, 6 is Saturday) as first day of week.
|
|
.It Fl m
|
|
Set Monday as first day of week.
|
|
.It Fl n Ar num
|
|
Output
|
|
.Ar num
|
|
months starting from and including the current month.
|
|
.It Fl s
|
|
Set Sunday as first day of week.
|
|
.It Fl y
|
|
Print the entire
|
|
.Ar year
|
|
or current year.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr localtime 3
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility is compliant with the
|
|
.St -p1003.1-2013
|
|
specification.
|
|
.Pp
|
|
The flags
|
|
.Op Fl 13cfmnsy
|
|
are an extension to that specification.
|