shithub: riscv

ref: e48a5c343d3ba76c6dfb949b5178e46a41792f72
dir: /sys/man/1/cal/

View raw version
.TH CAL 1
.SH NAME
cal \- print calendar
.SH SYNOPSIS
.B cal
[
.B -s
.I 1..7
] [
.I month
] [
.I year
]
.SH DESCRIPTION
.I Cal
prints a calendar.
.I Month
is either a number from 1 to 12,
a lower case month name,
or a lower case three-letter prefix of a month name.
.I Year
can be between 1
and 9999.
If either
.I month
or
.I year
is omitted, the current month or year is used.
If only one argument is given, and it is a number larger than 12,
a calendar for all twelve months of the given year is produced;
otherwise a calendar for just one month is printed.
The calendar
produced is that for England and her colonies.
.PP
.B -s
.I N
makes
.I cal
display
.I N,
specified as a number between 1 to 7 (Monday to Sunday), as the
first day of the week. The default is Sunday.
.PP
Try
.EX
	cal sep 1752
.EE
.SH SOURCE
.B /sys/src/cmd/cal.c
.SH BUGS
The year is always considered to start in January even though this
is historically naive.
.PP
Beware that
.L "cal 90"
refers to the early Christian era,
not the 20th century.