NAME
cal - displays a calendar
SYNOPSIS
cal [options] [[num_month] year]
cal [options] [word_month] [year]
DESCRIPTION
By default, cal will display a calendar for the current month with the current day marked. By specifing certain arguments, cal will display a calendar for a whole year or a specified month and year.
The transition from the Julian to Gregorian calendar is assumed to have occured in 1752 on the 3rd of September. Ten days following that date were eliminated by the reformation, so the calendar for that month is a bit unusual.
If displaying a calendar in the single-month format, cal will look for a date file. If found, cal will read the file, looking for special date descriptions for that month which will be displayed to the right of the calendar. By default, up to 24 appointments may be displayed per month. If the current date happens to fall on one of these special dates, it will be flagged by an asterisk. If there is room, appointments for the next month may also be displayed with some limitations (currently, special dates such as the 3rd Thursday of will not be calculated for next month).
cal can also optionally use colors when displaying the calendar. It will not display colors any time the calendar is not directly displaying on the console. This is generally the desired behavior when your redirecting cal's output to another program or a file.