<html><head><title>cal.pl</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >
</head>
<body class='pod'>
<!--
generated by Pod::Simple::HTML v3.01,
using Pod::Simple::PullParser v2.02,
under Perl v5.008002 at Thu Aug 5 13:56:25 2004 GMT.
If you want to change this HTML document, you probably shouldn't do that
by changing it directly. Instead, see about changing the calling options
to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
then reconverting this document from the Pod source.
When in doubt, email the author of Pod::Simple::HTML for advice.
See 'perldoc Pod::Simple::HTML' for more info.
-->
<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>
<p>cal.pl - member of the Perl Power Tools.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>
<p>cal.pl [-jy?] [[month] year]</p>
<p>If no arguments are supplied,
the current month will be displayed.
If only the -j flag is passed as an argument,
the current month will be displayed with julian day numbering (see below).</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="FLAGS"
>FLAGS</a></h2>
<p>Below is a list of the flags that can be passed to cal.pl,
and their meanings.</p>
<dl>
<dt><a name="-j"
>-j</a></dt><p class="pad"></p>
<dd>displays the requested date using julian days for the numbers.
That is,
each day number is the day of the year for that day.
Thus,
in non leap-years,
December 31 is day 365.</dd><p class="pad"></p>
<dt><a name="-y"
>-y</a></dt><p class="pad"></p>
<dd>displays the calendar for the current year.
Note this is mutually exclusive with the -n flag above.</dd><p class="pad"></p>
<dt><a name="-?"
>-?</a></dt><p class="pad"></p>
<dd>displays information and usage instructions for the program.
If this flag is included in any flag combination,
it overrides all other flags.</dd><p class="pad"></p>
</dl>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="MONTH/YEAR"
>MONTH/YEAR</a></h2>
<p>If only one number is supplied,
this number will be used as the year.
If two numbers are supplied,
the first will be the month,
and the second will be the year.
Valid months are 1 through 12,
and valid years are 1 through 9999.</p>
<p><b>NOTE:</b> dates must be fully defined.
Entering a year of 99 means 99 AD,
not 1999 AD.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p>cal.pl generates calendars from 1 AD through 9999 AD,
in the following format.</p>
<p> March 1999 Su M Tu W Th F Sa 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 </p>
<p>It takes into account the conversion from the Julian Calendar to the Gregorian Calendar in September,
1752.
Note that this was the date used in the UK and all of her colonies (including the U.S.).
Thus,
in September,
1752,
there were only 19 days.
Eleven days had to be removed from the calendar to make up for inaccuracies in the Julian Calendar.
So,
September 2,
1752 was followed by September 14,
1752 in the UK and all colonies,
as shown below.</p>
<p> September 1752 Su M Tu W Th F Sa 1 2 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 </p>
<p>The Julian calendar has a leap year every 4 years.
The Gregorian calendar has a leap year based on the following: If the year is evenly divisible by 400,
it is a leap year,
else,
if the year is evenly divisible by 4,
and not evenly divisible by 100,
it is a leap year.
All other years are not leap years.
There is some contention over whether 4 AD was a leap year or not.
Not all the experts agree,
as there was a counting error in the beginning of the Julian calendar with regards to leap years that had to be corrected,
and thus some years that would normally have been leap years were not.
This calendar assumes that 4 AD was indeed a leap year.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="FURTHER_READING"
>FURTHER READING</a></h1>
<p>The calculations used in this calendar,
as well as information on when the calendar was switched over,
and the implications thereof,
were obtained from information found at the following URL.
If you would like to find out more about calendars,
I highly suggest taking a look.</p>
<p><em lang='und' xml:lang='und'>URL: http://www.pip.dknet.dk/~c-t/calendar.html</em></p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR"
>AUTHOR</a></h1>
<p>Michael E.
Schechter mschechter@earthlink.net</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="COPYRIGHT_INFORMATION"
>COPYRIGHT INFORMATION</a></h1>
<p>This application is distributed as part of the Perl Power Tools.
Feel free to copy,
modify,
delete,
or whatever you would like with this file,
under the information contained in the GNU GPL.</p>
<!-- end doc -->
</body></html>