wmmoonclock/src/wmMoonClock.1

   1 .TH WMMOONCLOCK 1 "21 December 1998"
   2 .SH NAME
   3 WMMOONCLOCK \- Dockable Moon Phase Clock
   4 .SH SYNOPSIS
   5 .B wmMoonClock
   6 [\-display <Display>] [\-bc <Color>] [\-lc <Color>] [\-dc <Color>] [\-low] [\-lat <Latitude>] [\-lon <Longitude>] [\-h]
   7 .SH DESCRIPTION
   8 .PP
   9 wmMoonClock displays the current phase of the moon. Clicking on the icon
  10 brings up different displays \-\- there are 5 in all. The different "pages"
  11 are;
  12
  13 .TP
  14 .B First Page
  15 Shows the Moon phase image.
  16 .TP
  17 .B Second Page
  18 Shows the current Local Time (LT) and Universal Time (UT), the Moon's Age
  19 (number of days since last new moon), the geometric (as opposed to temporal)
  20 fraction of the way through the current lunar cyle (e.g. 50\% for full moon), the
  21 fraction of the Moon's disc that is illuminated (ratio of area illuminated to
  22 total area of disc) and whether the Moon is (locally) visible of not (i.e. is
  23 it above the horizon?).
  24 .TP
  25 .B Third Page
  26 Shows the Rise and Set times for yesterday (first line), today (middle line), and
  27 tommorrow (last line). If the Moon does not rise or set on a given day a `null
  28 time' is shown (\-\-:\-\-). Note that these times should still be good for high
  29 latitude observers. Also note that there will always be at least one (\-\-:\-\-)
  30 showing up per month. This is because once per month the Moon will rise (set) on
  31 a given day but will set (rise) in the very early portion of the next day.
  32 .TP
  33 .B Fourth Page
  34 Shows the Moon's horizon coordinates (i.e. the Altitude/Azimuth system). Azimuth is
  35 measured in degrees CCW from due south, and altitude is measured in degrees from
  36 the horizon up to the Moon. Distance (Dist) is measured in units on Earth radii (1 Re is
  37 about 6370km). Note that this is a local coordinate system and will not be correct if the
  38 observer's latitude and longitude are not set correctly.
  39 .TP
  40 .B Fifth Page
  41 Shows the Moon's ecliptic coordinates. (i.e. the Right Ascention/Declination system).
  42 Useful for astronomers?
  43 .PP
  44 Many of the quantities shown will not be correct unless LT and UT are correct, and the user
  45 specifies the proper latitude and longitude.
  46 .SH OPTIONS
  47 .TP
  48 .B \-display <display>
  49 Use an alternate X Display.
  50 .TP
  51 .B \-bc
  52 Set background color. (E.g. #7e9e69 or blue)
  53 .TP
  54 .B \-lc
  55 Set color of text labels.
  56 .TP
  57 .B \-dc
  58 Set color of data values.
  59 .TP
  60 .B \-low
  61 Conserve colors. For 8\-bit displays, a lower\-color pixmap will be used automatically,
  62 but you can also force its use on higher\-color displays if necessary.
  63 .TP
  64 .B \-lat <Latitude>
  65 Observers Latitude in degrees. Positive in northern hemisphere, negative in southern hemisphere.
  66 .TP
  67 .B \-lon <Longitude>
  68 Observers Longitude in degrees. Greenwich is 0.0, and longitude increases positively
  69 toward the west. (Alternatively, negative numbers can also be used to specify
  70 longitudes to the east of Greenwich).
  71 .TP
  72 .B \-h
  73 Display list of command\-line options.
  74 .SH BUGS
  75 Who knows? (Let me know if you find any).
  76 .SH AUTHOR
  77 Michael G. Henderson <mghenderson@lanl.gov>