1: .\"     $NetBSD: pom.6,v 1.12 2003/08/07 09:37:32 agc Exp $
    2: .\"
    3: .\" Copyright (c) 1989, 1993
    4: .\"     The Regents of the University of California.  All rights reserved.
    5: .\"
    6: .\" Redistribution and use in source and binary forms, with or without
    7: .\" modification, are permitted provided that the following conditions
    8: .\" are met:
    9: .\" 1. Redistributions of source code must retain the above copyright
   10: .\"    notice, this list of conditions and the following disclaimer.
   11: .\" 2. Redistributions in binary form must reproduce the above copyright
   12: .\"    notice, this list of conditions and the following disclaimer in the
   13: .\"    documentation and/or other materials provided with the distribution.
   14: .\" 3. Neither the name of the University nor the names of its contributors
   15: .\"    may be used to endorse or promote products derived from this software
   16: .\"    without specific prior written permission.
   17: .\"
   18: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
   19: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   20: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   21: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
   22: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   23: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   24: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   25: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   26: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   27: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   28: .\" SUCH DAMAGE.
   29: .\"
   30: .\"     @(#)pom.6   8.1 (Berkeley) 5/31/93
   31: .\"
   32: .Dd January 9, 1999
   33: .Dt POM 6
   34: .Os
   35: .Sh NAME
   36: .Nm pom
   37: .Nd display the phase of the moon
   38: .Sh SYNOPSIS
   39: .Nm
   40: .Op [[[[[cc]yy]mm]dd]HH]
   41: .Sh DESCRIPTION
   42: The
   43: .Nm
   44: utility displays the current phase of the moon.
   45: Useful for selecting software completion target dates and predicting
   46: managerial behavior.
   47: .Pp
   48: .Bl -tag -width [[[[[cc]yy]mm]dd]HH]
   49: .It Ar [[[[[cc]yy]mm]dd]HH]
   50: Display the phase of the moon for a given time.
   51: The format is similar to the canonical representation used by
   52: .Xr date 1 .
   53: .El
   54: .Sh SEE ALSO
   55: .Xr date 1
   56: .Sh AUTHOR
   57: .Nm
   58: was written by
   59: .An Keith E. Brandt .
   60: .Sh BUGS
   61: Times must be within range of the
   62: .Ux
   63: epoch.
   64: .Pp
   65: This program does not allow for the difference between the TDT and
   66: UTC timescales (about one minute at the time of writing).
   67: .Sh ACKNOWLEDGEMENTS
   68: This program is based on algorithms from
   69: .%B Practical Astronomy with Your Calculator, Third Edition
   70: by Peter Duffett-Smith
   71: .Aq pjds@mrao.cam.ac.uk .