On Fri, Jul 16, 2010 at 04:10:10PM +1000, Rick Measham wrote:
> DateTime's strength is it's rigid adherence to being Correct. If you say
> there's a duration of 2 days, we don't assume you mean 48 hours as there
> could be a DST jump in that 2 days. The representation of data is
> handled by the ::Format:: classes -- including
> DateTime::Format::Duration which is aimed at formatting durations in a
> manner that makes sense to the user of the module.
Perhaps the real bug here is in documentation... there's rarely a case
where there can be *too much* documentation. :) The DateTime suite is
huge, so it can be challenging sometimes finding the right interface to
DWIM, while not knowing what terms to search for. So, more cross-indexing
between the main documentation pages might help: e.g. "if you want to do
this, see this section on this page..." etc.
tl;dr: I'm sure documentation patches to add such references would be
gratefully accepted.
--
"Even the voice of conscience undergoes mutation." - Stanislaus Lec
. . . . .
Karen Etheridge, [email protected] GCS C+++$ USL+++$ P+++$ w--- M++
http://etheridge.ca/ PS++ PE-- b++ DI++++ e++ h(-)
