I'm not sure how you can say that the return value of DateCalc is not documented. The very first paragraph in the DateCalc description ends with:

Two deltas add together to form a third delta. A date and a delta returns a 2nd date. Two dates return a delta (the difference between the two dates).

True, the format of a delta or a date isn't explicitly described there, but that's not a bad thing. Almost all of Date::Manip functions return either a date or a delta, so it's not appropriate to describe them here.

I am certainly open to suggestions as to how to improve the documentation for Date::Manip. It IS large, and could probably be better organized... but I've spent a lot of time trying to make it reasonably clear. If you don't, please send me specific examples of what you don't think is clear, and I'll be happy to consider them.

However, as you said, I don't spend a lot of time on these forums (and it's outside of the scope of this question), so that should probably be done by email.

In reply to Re^2: calculate date difference by SBECK
in thread calculate date difference by hujunsimon

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.