Better JavaDoc

[toggle57]

I would really like to see the javadoc beefed up to provide more information about:

1. When a method/class should be used.
2. What the preconditions for using it is.
3. Common conditions underwhich it might fail (or silently do nothing).
4. Related classes/methods that might also be of use/interest.

[iurii]

I would also include here adding javadocs for the basic classes.
For example, almost all the methods of com.smartgwt.client.widgets.BaseWidget do not have javadocs

Regards,
Iurii