>>>>> "DR" == Dave Rolsky <[EMAIL PROTECTED]> writes:
RM> Rather than this, maybe we need to add a note to all modules
RM> to signify that $datetime and $dt refer to DateTime.pm
RM> objects.
>> That's ok, but _something_ should be said about $datetime. I
>> passed time() at first, and was surprised to see the
>> diagnostics.
DR> I just noticed that every method's docs says this:
DR> Given an object which implements the DateTime.pm API, ...
DR> That's pretty clear, I think.
At the very least I think that the Synopsis must be updated.
I've just noticed that too! I guess that's a suggestion for
improvement (no jokes about improvement of my cognitive abilities,
please).
I believe that arguments description could be moved after the
function description. Current situation is an RPL-ism.
--alexm