Re^2: calculate date difference

[SBECK]

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.

[BrowserUk]

The very first paragraph in the DateCalc description ends with:

I acknowledge I was wrong about that.

However, a long-time, but infrequent user of your powerful module, I always have to look up how to do things, and always find myself scrolling up and down the page trying to find the information I need.

I do understand how difficult it is to write good documentation, and I do not have any simple suggestions for improvement. I note also that you have made considerable changes in that regard in recent builds. I will contact you by email.