Subject: | Astro-Sunrise Documention Bugs/Wishlist |
perl 5.8.4
astro-sunrise 0.80
Doumentation bugs, wishlist:
1. Typo in "-0.833 degrees, DEFAULT
Sun's supper limb touches the horizon; atmospheric refraction accounted for
": Should read "upper" not "supper?" Possible cut and paste bug from http://www.stjarnhimlen.se/comp/riset.html
2. Suggest adding wording in the documentation clarifying MM: Valid months are 1-12 (?), while
perl's localtime is 0-11 with resulting possible confusion and/or
inadvertant bugs.
3. Suggest underscoring in the documentation the order of lat and long parameters in the API. Is currently "longitude, latitude" but is often encountered as "latitude, longitude" with resulting possible confusion and/or inadvertant bugs?
4. Suggest changing example for sunset:
$sunrise = sun_set( -105.181, 41.324 );
to:
$sunset = sun_set( -105.181, 41.324 );
following the example for sunrise:
$sunrise = sun_rise( -105.181, 41.324 );