It may not be completely obvious what is going on here, but that format changes based on the locale, so it isn't exactly easy or maintainable to actually specify what each format is doing for each locale.
While it probably makes sense to you to put the format into US standards, it would totally trip up people writing GWT in french or someother standard. While this does add to the complexity, it also removes problems of if you're writing an i18n application, you can just use datetimeformat and get the desired results in the formats that you want. Also, if you look at the code, there is a TODO there to get the formats documented. So they are already aware that they need documentation. The short answer is, it isn't a useless javadoc comment, it is a non-existent comment. As always, you're welcome to submit a patch with javadoc. -- You received this message because you are subscribed to the Google Groups "Google Web Toolkit" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/google-web-toolkit?hl=en.
