Bug #77710 for DateTime-Event-Sunrise: Rename "iterate" to "exact" or "precise"

Fri Jun 08 11:45:55 2012 DOHERTY [...] cpan.org - Ticket created

Subject:

Rename "iterate" to "exact" or "precise"

"iterate" described *how* you get the more precise result. The user shouldn't have to know or care about that - they just want the more accurate result (or not). By using the word "iterate", you imply to the casual user that they'll somehow get back a iterator object of some sort, which is a total red herring.

Fri Sep 27 01:36:02 2013 J2N-FORGET [...] orange.fr - Correspondence added

Likewise, the keyword "altitude" is misleading. An altitude is the length, in meters or in feet, between the sea level and the ground level. In this module, the parameter is the angle between the sun and the horizon. So it is measured in degrees with usually a negative number because we expect the sun to be below the horizon (e.g. for nautical and astronomical sunsets). This is why I prefer the astronomical term, "height" which, in astronomical context, is measured in degrees.

Fri Sep 27 01:36:02 2013 The RT System itself - Status changed from 'new' to 'open'

Thu Oct 10 14:18:37 2013 J2N-FORGET [...] orange.fr - Correspondence added

Le Ven 27 Sep 2013 01:36:02, JFORGET a écrit : Show quoted text

> Likewise, the keyword "altitude" is misleading. >[ cut ]

Well, I have done some checks on on-line dictionaries (http://dictionary.reference.com/browse/altitude?s=t&path=/) and I have found that in English, in an astronomical context, the altitude can be an angle between the horizontal plane and a celestial object. So this part of the ticket is canceled. The part with "precise" instead of "iteration" still holds and will be solved in the next release.

Fri Oct 18 00:53:59 2013 J2N-FORGET [...] orange.fr - Correspondence added

Le Ven 08 Juin 2012 17:45:55, DOHERTY a écrit : Show quoted text

> "iterate" described *how* you get the more precise result. The user > shouldn't have to know or care about that - they just want the more > accurate result (or not). By using the word "iterate", you imply to the > casual user that they'll somehow get back a iterator object of some sort, > which is a total red herring.

Version 0.0503 accepts the keyword "precise". For upward compatibility, the "iterate" keyword is still accepted, but it is no longer documenter in the POD text, except to say that it is deprecated.

Fri Oct 18 00:53:59 2013 J2N-FORGET [...] orange.fr - Status changed from 'open' to 'resolved'

Fri Oct 18 00:54:00 2013 J2N-FORGET [...] orange.fr - Taken

Fri Oct 18 00:54:00 2013 J2N-FORGET [...] orange.fr - Fixed in 0.0503 added