Hello Fellow Seam Users,

I'm stuck on trying implement/use certain Seam EntityQuery methods.  A fellow Seam user suggested I go to http://docs.jboss.org/seam/2.0.0.GA/api/.  I mean it's great that theres a actual "reference" to the methods of EntityQuery but as far as providing useful context and details on using the methods they might as well have shown me a blank page.  Are there books, DETAILED documentations or tutorials on using the EntityQuery methods?  Instead of just for example:

"protected void setRestrictionParameterValues(List<Object> restrictionParameterValues)"

and leaving that as the ultimate answer to life, the universe and everything in it?  A picture is worth a thousand words.  A good example . . . about three thousand.

One thing I don't understand about the java online documentation in general is why can't people post comments about the the methods or how it's implemented in general to provide guidance to new users about a particular technology?  PHP website does it, which is probally one reason why it has such a high adoption and low learning curve.  But for some reason any sort of Java Documentation online is quite sparse in information and tries to be as mysterious and arcane as possible.  This is just my personal observation about java online documentation in general.