cal(1) [suse man page]

CAL(1)							    BSD General Commands Manual 						    CAL(1)

NAME

     cal -- displays a calendar

SYNOPSIS

     cal [-smjy13] [[[day] month] year]

DESCRIPTION

     Cal displays a simple calendar.  If arguments are not specified, the current month is displayed.  The options are as follows:

     -1      Display single month output.  (This is the default.)

     -3      Display prev/current/next month output.

     -s      Display Sunday as the first day of the week.

     -m      Display Monday as the first day of the week.

     -j      Display Julian dates (days one-based, numbered from January 1).

     -y      Display a calendar for the current year.

     -V      Display version information and exit.

     A single parameter specifies the year (1 - 9999) to be displayed; note the year must be fully specified: ``cal 89'' will not display a calen-
     dar for 1989.  Two parameters denote the month (1 - 12) and year.	Three parameters denote the day (1-31), month and year, and the day will
     be highlighted if the calendar is displayed on a terminal.  If no parameters are specified, the current month's calendar is displayed.

     A year starts on Jan 1. The first day of the week is determined by the locale.

     The Gregorian Reformation is assumed to have occurred in 1752 on the 3rd of September.  By this time, most countries had recognized the ref-
     ormation (although a few did not recognize it until the early 1900's.)  Ten days following that date were eliminated by the reformation, so
     the calendar for that month is a bit unusual.

HISTORY

     A cal command appeared in Version 6 AT&T UNIX.

OTHER VERSIONS

     Several much more elaborate versions of this program exist, with support for colors, holidays, birthdays, reminders and appointments, etc.
     For example, try the cal from http://home.sprynet.com/~cbagwell/projects.html or GNU gcal.

AVAILABILITY

     The cal command is part of the util-linux-ng package and is available from ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.

BSD
								   June 6, 1993 							       BSD

CAL(1)							    BSD General Commands Manual 						    CAL(1)

NAME

     cal, ncal -- displays a calendar and the date of Easter

SYNOPSIS

     cal [-3hjy] [-A number] [-B number] [[month] year]
     cal [-3hj] [-A number] [-B number] -m month [year]
     ncal [-3hjJpwy] [-A number] [-B number] [-s country_code] [[month] year]
     ncal [-3hJeo] [-A number] [-B number] [year]
     ncal [-CN] [-H yyyy-mm-dd] [-d yyyy-mm]

DESCRIPTION

     The cal utility displays a simple calendar in traditional format and ncal offers an alternative layout, more options and the date of Easter.
     The new format is a little cramped but it makes a year fit on a 25x80 terminal.  If arguments are not specified, the current month is dis-
     played.

     The options are as follows:

     -h      Turns off highlighting of today.

     -J      Display Julian Calendar, if combined with the -e option, display date of Easter according to the Julian Calendar.

     -e      Display date of Easter (for western churches).

     -j      Display Julian days (days one-based, numbered from January 1).

     -m month
	     Display the specified month.  If month is specified as a decimal number, it may be followed by the letter 'f' or 'p' to indicate the
	     following or preceding month of that number, respectively.

     -o      Display date of Orthodox Easter (Greek and Russian Orthodox Churches).

     -p      Print the country codes and switching days from Julian to Gregorian Calendar as they are assumed by ncal.	The country code as deter-
	     mined from the local environment is marked with an asterisk.

     -s country_code
	     Assume the switch from Julian to Gregorian Calendar at the date associated with the country_code.	If not specified, ncal tries to
	     guess the switch date from the local environment or falls back to September 2, 1752.  This was when Great Britain and her colonies
	     switched to the Gregorian Calendar.

     -w      Print the number of the week below each week column.

     -y      Display a calendar for the specified year.

     -3      Display the previous, current and next month surrounding today.

     -A number
	     Display the number of months after the current month.

     -B number
	     Display the number of months before the current month.

     -C      Switch to cal mode.

     -N      Switch to ncal mode.

     -d yyyy-mm
	     Use yyyy-mm as the current date (for debugging of date selection).

     -H yyyy-mm-dd
	     Use yyyy-mm-dd as the current date (for debugging of highlighting).

     A single parameter specifies the year (1-9999) to be displayed; note the year must be fully specified: ``cal 89'' will not display a calendar
     for 1989.	Two parameters denote the month and year; the month is either a number between 1 and 12, or a full or abbreviated name as speci-
     fied by the current locale.  Month and year default to those of the current system clock and time zone (so ``cal -m 8'' will display a calen-
     dar for the month of August in the current year).

     Not all options can be used together. For example ``-3 -A 2 -B 3 -y -m 7'' would mean: show me the three months around the seventh month,
     three before that, two after that and the whole year.  ncal will warn about these combinations.

     A year starts on January 1.

     Highlighting of dates is disabled if stdout is not a tty.

SEE ALSO

     calendar(3), strftime(3)

HISTORY

     A cal command appeared in Version 5 AT&T UNIX.  The ncal command appeared in FreeBSD 2.2.6.

AUTHORS

     The ncal command and manual were written by Wolfgang Helbig <helbig@FreeBSD.org>.

BUGS

     The assignment of Julian-Gregorian switching dates to country codes is historically naive for many countries.

     Not all options are compatible and using them in different orders will give varying results.

BSD
								  March 14, 2009							       BSD