Greg, If you think that the Javadoc is not correct, send a patch. If you think that the package is not usable, do not use it. If you think that gwt code is not good, do not use gwt... And write your clone with your best comments,
But please do not flame like this. 2011/5/17 Alain Ekambi <jazzmatad...@googlemail.com> > So Greg i still dont get what you are trying to achieve here ? > That the guyz on the gwt team are doing a poor job ? > > > 2011/5/17 Greg Dougherty <dougherty.greg...@mayo.edu> > >> Hi Jeff, >> >> > It may not be completely obvious what is going on here >> >> Congratulations, you win "understatement of the day". :-) >> >> And that's my point. The purpose of a JavaDoc comment is to make it >> so people CAN understand what's going on. Those "comments" say >> nothing. They don't say "this is a locale dependent format, go <here> >> to figure out what that format will be in your locale", they don't say >> ANYTHING. >> >> > that format changes based on the locale >> >> If that format changes with the locale, why am I getting an entirely >> non-US format? >> >> > 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 some other >> standard. >> >> If it's locale dependent, then, since I'm writing in a US locale, >> that's what I should be seeing. If it's not locale dependent, I don't >> see why defaulting to a non-US representation is better than >> defaulting to a US one. >> >> > The short answer is, it isn't a useless javadoc comment, it is a >> > non-existent comment. >> >> Well, I don't know how anyone else codes, but from my perspective, an >> undocumented constant in a library is a useless constant, since the >> amount of time and effort spent figuring out what it is and what it >> does could better be spent just making my own constant that does what >> I want. Which is what I've now done in this case. >> >> > As always, you're welcome to submit a patch with javadoc. >> >> Well, my understanding is that I can't do that w/o writing to the GWT >> "Coding Standards". They require you to write hideously ugly code, >> and I only do that when someone pays me, extra. So I don't foresee >> myself ever writing anything for GWT. >> >> Aside from that, I'd have to spend a fair amount of time trying to >> figure out what each of those constants MEAN. Presumably the person / >> people who wrote those comments did that in the first place. Which >> leaves me with the question of why they didn't write that information >> down, instead of writing down that some day they needed to do that? >> And the other question of why the GWT Team allowed them to submit the >> code when it was so obviously incomplete. Yes, I know that there's a >> lot of volunteer labor that goes into GWT. But I would expect that >> the pride and professionalism of all involved would demand that things >> be done right, or not at all. >> >> Greg >> >> On May 16, 1:12 pm, Jeff Larsen <larse...@gmail.com> wrote: >> > 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 google-web-toolkit@googlegroups.com. >> To unsubscribe from this group, send email to >> google-web-toolkit+unsubscr...@googlegroups.com. >> For more options, visit this group at >> http://groups.google.com/group/google-web-toolkit?hl=en. >> >> > > > -- > > GWT API for non Java based platforms > http://code.google.com/p/gwt4air/ > http://www.gwt4air.appspot.com/ > > > -- > You received this message because you are subscribed to the Google Groups > "Google Web Toolkit" group. > To post to this group, send email to google-web-toolkit@googlegroups.com. > To unsubscribe from this group, send email to > google-web-toolkit+unsubscr...@googlegroups.com. > For more options, visit this group at > http://groups.google.com/group/google-web-toolkit?hl=en. > -- You received this message because you are subscribed to the Google Groups "Google Web Toolkit" group. To post to this group, send email to google-web-toolkit@googlegroups.com. To unsubscribe from this group, send email to google-web-toolkit+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/google-web-toolkit?hl=en.