| Subject: | clarify meaning of format option |
Right now, in 1.10, it reads:
* Specifies the format of numeric dates, defaults to 'd/m/y'.
I think it should note:
* what values are permissible (is it just d/m/y and m/d/y? say so!)
* what is affected (dates with years? any time there are two-to-three numbers divided by slashes or dashes? say so!)
As I'm not exactly sure of its behavior, I can't provide an exact piece of text to use, but something like this probably gets my point across:
----
format — This can be either m/d/y or d/m/y or y/m/d. It's used to influence how numeric dates are parsed. Given two numbers separated by a dash or slash, the month/date order expected comes from this option. If there's a third number, this option describes where to expect the year. When this format can't be used to interpret the date, some unambiguous dates may be parsed, but there is no form guarantee. (For example, 92/12/30 may be December 30th, 1992 even with format m/d/y, but under that same format, 14/10/10 may not be parsed.)
----
--
rjbs