<html><head><title></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:26 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>
<pre lang='und' xml:lang='und'> pom - display the phase of the moon</pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>
<pre lang='und' xml:lang='und'> pom [-d] [-e] [[[[[[cc]yy]mm]dd]HH]]</pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p>The pom utility displays the current phase of the moon. This is useful for selecting software completion target dates, predicting managerial behavior, or determining thoth's current mood. :)</p>
<p>Pom will display the current moon phase, unless a new time is specified on the command line. The parameter's format is similar to the canonical representation used by date(1).</p>
<p>Pom has two modes: "standard" and "enhanced". Standard mode presents a brief description of the moon's phase. It is the default. Enhanced mode shows the phase's date and time, the brief description, and an ASCII art representation of the moon's phase.</p>
<p>Current options:</p>
<pre lang='und' xml:lang='und'> -d Enable debugging. This calculates phase information every
hour for a month.
-e Enable enhanced mode. Turns on the ASCII art feature.</pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SEE_ALSO"
>SEE ALSO</a></h1>
<pre lang='und' xml:lang='und'> date(1)</pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="BUGS"
>BUGS</a></h1>
<p>Times must be within the range of the Unix epoch.</p>
<p>The local timezone and coordinates are not considered.</p>
<p>Day validation does not consider the current month, or leap days.</p>
<p>The default character cell aspect ratio is likely to be wrong.</p>
<p>There is some jitter in the current calculations. It may only be noticeable while debugging.</p>
<p>The calculations in this version are a few percent different from the original pom.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="ACKNOWLEDGEMENTS"
>ACKNOWLEDGEMENTS</a></h1>
<p>A lot of the documentation was cribbed from the OpenBSD Reference Manual.</p>
<p>The moon phase calculations were ported from pcal, which is available from <ftp://www.decus.org/pub/lib/vs0174/pcal/>.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR_and_COPYRIGHT"
>AUTHOR and COPYRIGHT</a></h1>
<p>Pom is Copyright 1999 Rocco Caputo <troc@netrus.net>. All rights reserved. Pom is free software; you may redistribute it and/or modify it under the same terms as Perl itself.</p>
<!-- end doc -->
</body></html>