This used to be just the code from wmSun warmed over and stuffed into
the gkrellmoon plugin. Now it's got a bit more original stuff in it.
But it's also got a bit more of gkrellmoon, too. So it's still mostly
from somewhere else.

The gkrellsun plugin displays the sunrise and sunset times for the
specified latitude and longitude in the current timezone. It also
displays a graph showing the trajectory of the sun across the sky (at
both the current latitude and longitude and as it would appear if it
went directly overhead at solar noon). Finally, it displays a little
rising and setting moon.

The suninfo program prints the sunrise and sunset times on stdout.
If you use the -v option, it prints a bunch of other stuff, too.

The gkrellsun plugin now has several options:

* Latitude/Longitude in decimal degrees

  This indicates your position on the earth. If you don't know your
  position, these sites may help you figure it out:

        World:  http://www.calle.com/world/
	USA:    http://www.census.gov/cgi-bin/gazetteer
	Info:   http://www.wunderground.com

* UVSUN/ORANGESUN

  You can select one of two solar images. You can also specify the
  font and color of the sunrise/sunset/ETA information.

* Use 24 hour clock

  Display times of day in 24 hour style instead of am/pm style

* Show relative position

  This option controls the display of a little sun icon on the panel.
  If show relative position is enabled, a small "star" will be drawn
  on top of the display. The star will progress from left to right
  across the display as the day passes. Its height is calculated
  according to the sun's relative altitude in the sky. On a day when
  (and at a position where) the sun will be directly overhead at solar
  noon, this star will follow a semi-circular course passing through
  the center of the display. On all other days, it'll follow a
  "flattened" circle across the display.

* Show sun rise/set ETA

  If this option is enabled, the estimated time of arrival of sunrise
  will be shown before the sun rises and the ETA of the sunset will be
  shown after the sun has risen.

* Show path

  If this option is enabled, a dotted line is added to the display
  showing the arc that the star follows across the display (see
  "Show relative position")
  
* Show apogee path

  If this option is enabled, a dotted line is added to the display
  showing the "apogee sun" arc. That is, the path that would be
  followed if the sun were to pass directly overhead at solar noon.

* Show mini moon

  If this option is enabled, a small moon image is displayed on the
  right hand side of the sun image if the moon is visible in the sky.
  The phase of the moon and it's relative altitude in the sky are
  thus shown along with the sun info.

* Change to moon at night

  If this option is enabled, the moon will be displayed by default
  between sunset and sunrise.

* Minutes to toggle between Sun and Moon images (0 to disable).

  If you specify a non-zero value here, the sun and moon will
  alternate every "n" minutes (where "n" is the number of minutes you
  specify.

  You can switch between the sun and the moon at any time by clicking
  on the display.

