I think the javadoc is now more confusing than useful, due to the weird caveat about public/generated resources. How about we just kill all the javadoc from "The following two examples..." up to the @param list? Or else, give the most useful and common example, using a for-each loop with the result of a find().
On Mon, Mar 30, 2009 at 2:33 PM, John Tamplin <[email protected]> wrote: > On Mon, Mar 30, 2009 at 1:57 PM, Scott Blum <[email protected]> wrote: > >> John and I discussed this face to face. It turns out that the find() >> method has, perhaps, an unnecessarily complicated specification that pushes >> generic compile time sugar arguably past the point of usefulness --- and >> definitely past what OpenJDK allows. >> So our tentative resolution is to simplify the declaration of find() and >> make it slightly less powerful. It turns out none of our own code is making >> any use whatsoever of the extra flexibility it currently has. >> > > Here is the patch which does what Scott suggested. Any objections? > > > -- > John A. Tamplin > Software Engineer (GWT), Google > --~--~---------~--~----~------------~-------~--~----~ http://groups.google.com/group/Google-Web-Toolkit-Contributors -~----------~----~----~----~------~----~------~--~---
