| Subject: | Need clear docs about writing a DateTime::Format object. |
I went to write a ctime formatter for DateTime and found I couldn't find
any documentation about writing a DateTime::Format object! The DateTime
documentation talks about DateTime::Format objects, but it never really
says what they are. There's no "SEE ALSO" and no information about what
methods should be defined. Where is the documentation about writing a
DateTime::Format object?
DateTime::Format::Builder provides an interface to making them, but only
documents the parsing part of it, not the formatting part. And it only
documents it in terms of its own builder.
There is only one mention, and its buried in the "constructor" docs.
The "formatter" can be either a scalar or an object, but the class
specified by the scalar or the object must implement a
"format_datetime()" method.