76ad86b2a3
1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes.
71 lines
1.2 KiB
Groff
71 lines
1.2 KiB
Groff
.Dd March 8, 2015
|
|
.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-2008
|
|
specification.
|
|
.Pp
|
|
The flags
|
|
.Op Fl 13cfmnsy
|
|
are an extension to that specification.
|